DemandFlow Support Centre

SCON: Sales Order

The SCON entity: A sales order capturing customer orders with deliverables, financials, fulfillment, approvals, and commission tracking.

Default definition. This article describes the default SCON definition shipped with DemandFlow. Administrators can add, remove, rename, or re-type fields, change which ones are required, and alter the layout from the Definitions screen in Settings. Your tenant's current schema may differ from what is shown here. To read the current definition at any time, GET the DEFINITION object whose id matches SCON.

Entity properties

Property	Value
Entity code	`SCON`
Display name	Sales Order
Plural	Sales Orders
Level	500

Use cases

SCON is the primary revenue-side transaction entity, representing a confirmed or in-progress sales order from a customer. It links to COM (customer) rather than CLIENT because sales orders may originate from companies not yet formalised as clients. The entity covers the full order-to-cash lifecycle: order creation (type, priority, PO number), customer information (contact details, billing/shipping addresses), financial summary (subtotal, discounts, tax, shipping, total, paid, balance due), deliverables (via SDEL relatedlist with SUB|ENT|SCON|SDEL comboKey), payment terms and contract details, fulfillment logistics (delivery scheduling, warehouse, inventory reservation, pick lists, tracking), multi-step approval workflows (credit approval and manager approval), commission tracking for sales reps, audit history via AUDIT entity, and document management.

The toolbar provides actions for invoice generation, order confirmation, duplication, and printing. Bulk actions support batch approval, status updates, and Excel export. The shipping carrier field links to VEN, reusing the vendor entity for logistics providers.

Fields

Order Information

Field	Type	Required	Notes
`name`	text	Yes	Name
`ref`	text		Read-only. Order reference
`orderDate`	date	Yes	Order Date
`status`	enum	Yes	Status Valid ids: `draft` (Draft), `pending` (Pending Approval), `approved` (Approved), `confirmed` (Confirmed), `inprogress` (In Progress), `partialdelivered` (Partially Delivered), `delivered` (Delivered), `completed` (Completed), `cancelled` (Cancelled), `onhold` (On Hold).
`priority`	enum		Priority Valid ids: `urgent` (Urgent), `high` (High), `normal` (Normal), `low` (Low).
`orderType`	enum	Yes	Order Type Valid ids: `standard` (Standard Order), `rush` (Rush Order), `blanket` (Blanket Order), `scheduled` (Scheduled Release), `dropship` (Drop Ship), `internal` (Internal).
`poNumber`	text		Customer PO Number
`salesRep`	reference → user	Yes	Sales Representative
`accountManager`	reference → user		Account Manager
`deal`	reference → `DEAL`		Deal

Customer Information

Field	Type	Required	Notes
`customer`	reference → `COM`	Yes	Customer
`customerContact`	text		Contact Name
`customerEmail`	text		Contact Email
`customerPhone`	text		Contact Phone
`billingAddress`	text (multi-line)		Billing Address
`shippingAddress`	text (multi-line)		Shipping Address
`sameAsBilling`	boolean		Shipping same as Billing

Financial Summary

Field	Type	Notes
`currency`	reference → `CURRENCY`	Currency
`subtotal`	number	Subtotal
`discountPercent`	number	Discount %
`discountAmount`	number	Discount Amount
`taxRate`	number	Tax Rate %
`taxAmount`	number	Read-only. Tax Amount
`shippingCost`	number	Shipping Cost
`totalAmount`	number	Total Amount
`paidAmount`	number	Paid Amount
`balanceDue`	number	Balance Due

Payment Information

Field	Type	Required	Notes
`paymentTerms`	enum	Yes	Payment Terms Valid ids: `net15` (Net 15), `net21` (Net 21), `net30` (Net 30), `net60` (Net 60), `net90` (Net 90), `due_on_receipt` (Due on Receipt), `prepaid` (Prepaid), `2_10_net30` (2/10 Net 30), `cod` (COD), `credit_card` (Credit Card), `wire_transfer` (Wire Transfer), `custom` (Custom Terms).
`customPaymentTerms`	text (multi-line)		Custom Payment Terms
`paymentMethod`	enum		Payment Method Valid ids: `check` (Check), `wire` (Wire Transfer), `ach` (ACH), `credit_card` (Credit Card), `paypal` (PayPal), `other` (Other).
`paymentDueDate`	date		Payment Due Date
`creditLimit`	number		Read-only. Customer Credit Limit
`creditAvailable`	number		Read-only. Available Credit

Contract & Legal

Field	Type	Notes
`contractNumber`	text	Contract Number
`contractStartDate`	date	Contract Start Date
`contractEndDate`	date	Contract End Date
`termsAndConditions`	text (multi-line)	Terms & Conditions
`specialInstructions`	text (multi-line)	Special Instructions
`internalNotes`	text (multi-line)	Internal Notes

Delivery Schedule

Field	Type	Notes
`requestedDeliveryDate`	date	Requested Delivery Date
`promisedDeliveryDate`	date	Promised Delivery Date
`actualShipDate`	date	Actual Ship Date
`actualDeliveryDate`	date	Actual Delivery Date
`deliveryMethod`	enum	Delivery Method Valid ids: `standard` (Standard Shipping), `express` (Express Shipping), `overnight` (Overnight), `twoday` (2-Day Shipping), `freight` (Freight), `white_glove` (White Glove Service), `pickup` (Customer Pickup), `digital` (Digital Delivery).
`shippingCarrier`	reference → `VEN`	Shipping Carrier
`masterTrackingNumber`	text	Master Tracking Number

Warehouse & Inventory

Field	Type	Notes
`warehouse`	reference → `WAREHOUSE`	Fulfillment Warehouse
`inventoryReserved`	boolean	Inventory Reserved
`inventoryReservationDate`	datetime	Read-only. Reservation Date
`pickListGenerated`	boolean	Pick List Generated
`pickListDate`	datetime	Read-only. Pick List Date
`packingSlipNumber`	text	Packing Slip Number
`shippingInstructions`	text (multi-line)	Shipping Instructions

Approval Workflow

Field	Type	Notes
`creditApproval`	enum	Credit Approval Valid ids: `pending` (Pending), `approved` (Approved), `rejected` (Rejected), `not_required` (Not Required).
`creditApprovedBy`	reference → user	Read-only. Credit Approved By
`creditApprovalDate`	datetime	Read-only. Credit Approval Date
`managerApproval`	enum	Manager Approval Valid ids: `pending` (Pending), `approved` (Approved), `rejected` (Rejected), `not_required` (Not Required).
`managerApprovedBy`	reference → user	Read-only. Manager Approved By
`managerApprovalDate`	datetime	Read-only. Manager Approval Date

Order Confirmation

Field	Type	Notes
`customerConfirmation`	boolean	Customer Confirmed
`customerConfirmationDate`	datetime	Confirmation Date
`orderAcknowledgementSent`	boolean	Order Acknowledgement Sent
`acknowledgementSentDate`	datetime	Read-only. Acknowledgement Sent Date
`signedOrderForm`	text (URL)	Signed Order Form URL
`approvalNotes`	text (multi-line)	Approval Notes

Commission Details

Field	Type	Notes
`commissionRate`	number	Commission Rate %
`commissionAmount`	number	Read-only. Commission Amount
`commissionStatus`	enum	Commission Status Valid ids: `pending` (Pending), `approved` (Approved), `paid` (Paid), `cancelled` (Cancelled).
`commissionPaidDate`	date	Commission Paid Date
`commissionPaymentRef`	text	Payment Reference

Attachments

orderDocuments: file attachment field.
invoiceDocuments: file attachment field.

Additional panels

Activity timeline panel attached.

Relationships

Lookups: salesRep points at a user; accountManager points at a user; deal points at a DEAL record; customer points at a COM record; currency points at a CURRENCY record; shippingCarrier points at a VEN record; warehouse points at a WAREHOUSE record; creditApprovedBy points at a user; managerApprovedBy points at a user.
Related lists: SDEL (format SUB|ENT|SCON|SDEL), AUDIT (format comboKeyEntity).

Creating a Sales Order via the API

POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json

{
  "entity":   "SCON",
  "level":    500,
  "comboKey": "SUB:|ENT:",
  "name":    "Example name",
  "orderDate":    "2026-01-01",
  "status":    "draft",
  "orderType":    "standard"
}

Listing Sales Orders records

GET /v1/entities/SCON/SUB

DemandFlow Support Centre

SCON: Sales Order

SCON: Sales Order

Entity properties

Use cases

Fields

Relationships

Creating a Sales Order via the API

Listing Sales Orders records

See also

Was this article helpful?