Accounting Code3

Attachment7

Attachment Certification1

Auth1

CAPAs2

Chart Of Accounts2

Company Info2

Custom Field2

Customer6

Customer Address5

Customer Contact5

Customer Tier2

Department4

Equipment4

Gauge Code2

Grade Code2

InProcessTrackingFieldType2

Inventory6

Inventory Event2

Inventory Event Details3

Inventory Lot3

Inventory Transactions1

Invoice6

Invoice Deposit Adjustment Line Item2

Invoice Deposit Line Item2

Invoice Discount Line Item1

Invoice Fee Line Item4

Invoice Line Item2

Invoice Note1

Invoice Part Line Item4

Invoice Refund Line Item4

Invoice Shipping Charge Line Item1

Invoice Tax Line Item2

Item11

Item Category2

Item Class2

Item Custom Fields2

Item Customer4

Item Material Vendor3

Item PriceBreaks4

Item Routing26

Item Tag5

Item Vendor3

Job9

Job Custom Fields2

Job Full Routing18

Job Item To Make3

Job Item To Make Operation8

Job Operation1

Job Part Line Item Full Routing1

Job Tracking Timers3

Location3

Material4

Material Code2

Material Vendor6

NCRs2

Note3

Operation4

Payment Term3

Purchase Order8

Purchase Order Custom Fields2

Purchase Order Discount Line Item1

Purchase Order Fee Line Item7

Purchase Order Line Item3

Purchase Order Outside Processing Line Item7

Purchase Order Part Line Item7

Purchase Order Tax Line Item2

Purchase Order Vendor Credit Line Item4

Quote10

Quote Custom Fields2

Quote Discount Line Item3

Quote Fee Line Item5

Quote Part Line Item7

Quote Part Line Item Custom Fields2

Quote Part Line Item Full Routing19

Quote Tax Line Item5

Receiving Receipt5

Receiving Receipt Line Item5

Refund Reason Code2

Reporting9

Sales Order8

Sales Order Blanket Line Item4

Sales Order Custom Fields2

Sales Order Discount Line Item3

Sales Order Fee Line Item6

Sales Order Line Item2

Sales Order Part Line Item8

Sales Order Part Line Item Custom Fields2

Sales Order Part Line Item Full Routing19

Sales Order Refund Line Item4

Sales Order Shipping Charge Line Item1

Sales Order Tax Line Item5

ScrapReport1

Shape Code2

Shipment Custom Fields1

Shipment Line Items (V3)1

Shipments5

Shipping Method2

Tag5

Tax Rate4

Time Clock Timers3

Timer4

Tool8

Tool Calibration5

User2

User Status2

Vendor5

Vendor Address5

Vendor Contact5

Work Order2

WorkCenter4

Sales Order

Update a sales order

put/api/sales-orders/{salesOrderId}

Path parameters

salesOrderIdstring required

Request body

externalReferencesobject nullable

Arbitrary key-value-pair like data that can be used to later on search for this line item.

customerPoNumberstring nullable

CustomerPoNumber

priority'low' | 'moderate' | 'high'

Priority of the sales order

deliveryDueDatestring date-time nullable

The date the SO needs to be delivered to the customer. Note: this does not affect individual line update delivery dates. Only the calendar date is used, exactly as written; any time or UTC offset is ignored.

publicNotestring nullable

Note to customer. This will appear on PDFs.

dropshipboolean nullable

Indicates the order is dropshipped: fulfilled by shipping directly to the end customer. Omit (or send null) to leave both dropship fields untouched.

dropshipCustomerPoNumberstring nullable

The end customer's purchase order number for a dropshipped order. Written only when FulcrumProduct.PublicApi.Dto.SalesOrder.SalesOrderUpdateDto.Dropship is supplied: send a dropship value with no PO number to clear the stored one. Omitting the dropship flag leaves this field as it is.

Response

Sales order item

idstring required

Unique id associated to this entity.

numberinteger required

Number

orderedDatestring date-time required

Sales order ordered date (generally the creation date but can be post/pre-dated).

customerPoNumberstring nullable

CustomerPoNumber

externalQuoteUrlstring nullable

A reference URL that points to an external quote entity.

createdFromQuoteIdstring nullable

Unique identifier of the quote that this sales order was created from. Please reference /api/quotes endpoints.

customerIdstring required

The id of the customer that the sales order is for

deliveryDueDatestring date-time nullable

The date the SO needs to be delivered to the customer

productionDueDatestring date-time nullable

The date that production needs to be completed by

sentToProductionDateUtcstring date-time nullable

The datetime in UTC that the SO status was updated to Send to Production

dropshipboolean

Indicates the order is dropshipped: fulfilled by shipping directly to the end customer.

dropshipCustomerPoNumberstring nullable

The end customer's purchase order number for a dropshipped order.

paymentTermsIdstring nullable

The payment terms assigned to this sales order.

discountnumber double nullable

Total discount for the SO when a Discount Line as been aded

subtotalnumber double

Subtotal for the SO

salesPersonIdstring nullable

Unique identifier of the sales person attached to this sales order. Please reference /api/users endpoints.

publicNotestring nullable

Note to customer. This will appear on PDFs.

deletedboolean

Indicates whether this sales order has been deleted

companyIdstring nullable

Company identifier. Please reference /api/companies endpoint.

createdUtcstring date-time required

Date this record was created (UTC).

modifiedUtcstring date-time nullable

Date this record was modified (UTC). Of note, this does account for children items (line items).

usesV3Shippingboolean

Indicate if this sales order uses V3 shipping.

status'draft' | 'needsApproval' | 'approved' | 'inProgress' | 'complete' required

Sales order status

priority'low' | 'moderate' | 'high'

Priority of the sales order

shipByDatestring date-time nullable

The date this sales order should ship by, as shown on the sales order in the app: the earliest ship by date across the order's non-cancelled shipments, or, when no shipment has one, the earliest delivery due date less the customer's shipping lead time.

externalReferencesobject nullable

External references associated with this entity.

customFieldsobject nullable

Custom fields that have been defined on this entity.

Changes

Changed in 1 of the 13 revisions of this API.12

Aug 28, 2026eab32f188c8412See the full diff
- ○
  added the new optional request property (media type: application/json-patch+json)
  new-optional-request-property
- ○
  added the new optional request property (media type: application/json)
  new-optional-request-property
- ○
  added the new optional request property (media type: text/json)
  new-optional-request-property
- ○
  added the new optional request property (media type: application/*+json)
  new-optional-request-property
- ○
  added the new optional request property (media type: application/json-patch+json)
  new-optional-request-property
- ○
  added the new optional request property (media type: application/json)
  new-optional-request-property
- ○
  added the new optional request property (media type: text/json)
  new-optional-request-property
- ○
  added the new optional request property (media type: application/*+json)
  new-optional-request-property
- ○
  added the optional property to the response with the status (media type: application/json)
  response-optional-property-added
- ○
  added the optional property to the response with the status (media type: application/problem+json)
  response-optional-property-added
- ○
  added the optional property to the response with the status (media type: application/json)
  response-optional-property-added
- ○
  added the optional property to the response with the status (media type: application/problem+json)
  response-optional-property-added

Full history