Commerce Objects

The Essence

The Order is where commercial commitment becomes real. Not the conversation (that's the Deal). Not the proposal (that's the Quote). The Order is the record of what was actually purchased, at what terms, by whom.

It's the foundation of revenue truth โ€” the object that accounting systems recognize, that fulfillment teams work from, that financial reports rely on.

"The Deal tells the sales story; the Order tells the commercial truth. When you understand Orders correctly, you stop treating Deal 'close' as revenue and start treating Order creation as the moment commercial reality begins."


The Critical Distinction

Why Order โ‰  Deal

Deal

  • โ€ข Tracks the sales process
  • โ€ข Represents opportunity
  • โ€ข Amount = potential value
  • โ€ข Requires sales conversation
  • โ€ข Historical record of sales journey

Order

  • Records actual commitment
  • Represents revenue
  • Amount = contracted value
  • Can be created directly (no Deal)
  • Foundation for financial systems

The key insight: Not all revenue comes through Deals. Self-service purchases, subscription renewals, e-commerce transactions โ€” these create Orders directly. If your revenue reports pull from Deals, you're missing revenue. If they pull from Orders, you see everything.


Unified View Contribution


Sarah's Story

When Sarah's organization committed to CVP Implementation, the Deal moved to "Value Activated." But for Value-First's operations, that Deal stage change was just a trigger โ€” what mattered was the Order that got created.

The Order captured what actually happened:

Order Number: VF-2024-0847
Order Date: The moment of commitment
Order Amount: $47,500
Payment Terms: Net 30, milestone-based
Billing Contact: Sarah's CFO
Billing Address: Chicago headquarters

This Order became the source of truth for everything that followed:

For Finance

  • Revenue recognition based on Order amount
  • Invoice generation tied to Order milestones
  • Payment tracking against Order balance
  • Financial reporting pulling from Order data

For Delivery

  • Deliverables created from Order Line Items
  • Service activation triggered by Order
  • Project kickoff scheduled based on Order date
  • Resource allocation informed by Order scope

Six months later, when Sarah's organization expanded their engagement, a new Order was created โ€” not a modification to the original Deal. This new Order (VF-2024-1203) captured the expansion commitment separately, maintaining clean commercial history.

When Value-First's CFO runs revenue reports, they pull from Orders โ€” not Deals. When the accounting system reconciles, it matches against Orders. When auditors ask about revenue recognition, Orders provide the documentation. The Deal told the sales story; the Order tells the commercial truth.


What It Holds

Commercial Identity

Order number, date, status โ€” the basics that identify this specific commercial transaction. Every Order has a unique identifier that flows through invoicing, payment, and fulfillment. This is the record of what actually happened.

Financial Terms

Total amount, payment terms, currency, tax treatment. The Order captures the agreed commercial terms that govern billing and collection. These terms become the foundation for all downstream financial activity.

Line Items

What was purchased, in what quantities, at what prices. Line Items on the Order represent the actual commitment (as configured) โ€” these may have originated from Products or been created as custom items. This is the substance of the commercial agreement.

Billing Information

Who gets the invoice? Where does it go? What payment method will be used? Orders capture billing details that may differ from the Company's general information. The CFO at headquarters receives the invoice even if services deliver to branch locations.

Fulfillment Information

For physical products, where do items ship? For services, what are the delivery specifications? Orders capture fulfillment requirements that trigger downstream delivery activities.

Source Context

Where did this Order come from? Deal-originated? Self-service? Subscription renewal? Source tracking enables attribution and process analysis. Not all Orders need Deals โ€” and that's the point.

Status and Pipeline

Orders progress through stages: Received โ†’ Processing โ†’ Fulfilled โ†’ Complete. Pipeline functionality on Orders enables operational tracking beyond simple status fields. Each stage triggers appropriate activities.

What It Connects To

Primary Associations

To Company

The organization that placed this Order. The commercial entity responsible for payment.

To Contacts

Billing contact, shipping contact, stakeholders. Different people for different purposes.

To Deal

If Order originated from a Deal. Maintains attribution to sales process.

To Line Items

What was purchased. The Order's content โ€” products, quantities, prices.

To Invoices

Billing documents generated from this Order. One Order may spawn multiple Invoices.

To Services & Deliverables

Activated services and fulfillment items. What gets delivered because of this Order.

Contact-to-Order Labels

Billing Contact
1

Receives invoices

Shipping Contact
1

Receives deliveries

Order Stakeholder
โˆž

Visibility interest

Authorized Signer
1

Approved the Order

Order-to-Object Labels

Primary Company
1

Organization that ordered

Source Deal
1

If Deal-originated

Source Quote
1

If Quote-originated

Line Items
โˆž

What was purchased

Generated Invoices
โˆž

Billing documents

Resulting Services
โˆž

Activated services


Common Patterns

The Deal โ†’ Order Pattern

When Deals close, Orders are created:
  1. Deal reaches "Value Activated" stage
  2. Order record created automatically
  3. Line Items copied from Deal to Order
  4. Order associated to Deal (maintains attribution)
  5. Order associated to Company and Contacts
  6. Fulfillment workflow triggered

The Deal stays at "Value Activated" as historical record. The Order carries commercial activity forward.

The Direct Order Pattern

Not all Orders need Deals:
  • Customer places order through portal (self-service)
  • Repeat purchase from existing customer
  • E-commerce transaction
  • Subscription renewal generates Order

In these cases, Orders are created directly โ€” no Deal required. This is why Order (not Deal) must be the revenue foundation.

The Milestone Billing Pattern

For complex Orders, billing ties to milestones:
  1. Order created with milestone payment terms
  2. Milestone 1 complete โ†’ Invoice 1 generated
  3. Milestone 2 complete โ†’ Invoice 2 generated
  4. Milestone 3 complete โ†’ Invoice 3 generated

Each Invoice associates to the Order; payments associate to Invoices. The Order tracks total commitment; Invoices track billing events; Payments track collection.

The Subscription Order Pattern

Recurring revenue generates Orders:
  1. Subscription active
  2. Billing period ends โ†’ Order created for that period
  3. Order โ†’ Invoice โ†’ Payment
  4. Next billing period โ†’ Next Order

This creates clean revenue recognition per period while the Subscription tracks the ongoing relationship.

The Order Pipeline Pattern

Orders support pipeline stages for operational tracking:
  • Received: Order created, awaiting processing
  • Processing: Payment verification, resource allocation
  • In Fulfillment: Delivery/execution in progress
  • Complete: Delivered, accepted, closed

Value-First vs. Industrial-Age

โœ— Traditional Thinking โœ“ Value-First Thinking
Deal amount = Revenue Order amount = Revenue
"Closed-won" = Success metric Order creation = Commercial reality begins
Revenue reports from Deals Revenue reports from Orders
Orders are "fulfillment details" Orders are commercial foundation
ERP is source of truth, HubSpot tracks sales HubSpot Orders can be source of truth
Direct purchases bypass CRM All purchases create Orders in CRM

Why This Shift Matters

When Deals own revenue, HubSpot can never be financially authoritative. Every revenue report requires reconciliation with "real" systems. E-commerce and self-service purchases exist outside CRM visibility. Finance teams don't trust CRM data.

When Orders own revenue, HubSpot becomes capable of financial authority. Revenue reports pull from Order data. All commercial activity โ€” Deal-originated or not โ€” flows through Orders. Integration with accounting becomes Order-to-Order matching. Finance teams can trust CRM data because it speaks their language.


In Practice

Implementation details and configuration

What You'll See in HubSpot

Orders live in Commerce Hub under Sales โ†’ Orders. Each Order has:

  • Left sidebar: Order properties, status, owner
  • Middle column: Activity timeline, Line Items
  • Right sidebar: Associations to Company, Contacts, Deal, Invoices, Payments

The Order index supports filtering by status, date range, amount, and source.

Key Properties

Key Properties

Native HubSpot Properties

Property Type Purpose
hs_order_name Native Text Order identifier/number
hs_order_date Native Date When Order was placed
hs_total_amount Native Currency Total Order value
hs_subtotal Native Currency Pre-tax amount
hs_tax Native Currency Tax amount
hs_discount_amount Native Currency Discounts applied
hs_currency_code Native Enumeration Transaction currency
hs_payment_status Native Enumeration Paid, Pending, Partial, etc.
hs_fulfillment_status Native Enumeration Delivery/fulfillment status

Value-First Custom Properties

Property Type Purpose
vf_order_source Enumeration Deal, Self-Service, Subscription, Direct
vf_payment_terms Enumeration Net 30, Due on Receipt, Milestone, etc.
vf_billing_milestone_count Number How many billing milestones
vf_revenue_recognition_status Enumeration Pending, Partial, Complete
vf_delivery_timeline Text Expected fulfillment timeframe
vf_special_terms Text Any non-standard terms

Order Pipeline

1

Received

Initial verification, resource planning

Entry Criteria

Order created and validated

Exit Criteria

Payment verified, team assigned

Portal Experience

In the My Value Path Portal, Sarah sees her Orders:

My Orders

  • Complete Order history
  • Order details (what was purchased, when, at what price)
  • Status (processing, fulfilled, complete)
  • Connected Invoices and payment status
  • Delivery/fulfillment progress

Order Detail View

  • Line Items with descriptions
  • Billing and delivery information
  • Timeline of Order activity
  • Connected Deliverables and their status
  • Invoice and payment history

"Sarah can see her complete commercial history. No surprises, no hidden charges, no wondering 'what did we actually buy?'"


See It In Action

Experience in the Value Path Simulator

โ†’ Order Creation Flow: Watch the Deal "Value Activated" trigger Order creation. See how Order captures the commercial commitment while Deal records the sales journey.
โ†’ Revenue Dashboard: See revenue reports pulling from Order data, not Deal data. Notice how this includes Deal-originated and direct Orders in one view.
โ†’ Order โ†’ Fulfillment: Watch Order creation trigger Deliverable generation, Service activation, and Project kickoff.

Key Moment: Toggle between "Deal-Based Revenue" and "Order-Based Revenue" views. Notice how the Order view includes all commercial activity โ€” Deal-originated and direct โ€” while the Deal view misses self-service and renewal revenue.

Experience Order in the Value Path Simulator


Explore Further