Sign in
latestOpenAPI 3.0.32026-08-22505302.1 MB

60d6c901bc4e

Orders

Create an order for the current company, optionally with nested order lines (created atomically with the order). The order number must be unique within the company for the same order type — a duplicate returns 400 (order_number_already_existing).

post/api/orders/

Request body

orderNumberstring required
orderSubType'STANDARD' | 'REPEAT' | 'COMMIT' | 'SAMPLE' | 'EXTRACTION_SPLIT'
status'IN_PROGRESS' | 'IN_REVIEW' | 'COMPLETED'
tagsstring[]
source'PUBLIC_API' | 'IMPORTER' | 'INTERNAL_API'
buyerCompanyIdstring required
supplierCompanyIdstring required
receiverCompanyIdstring
vendorCompanyIdstring
factorystring
buyerFacilityProcessstring
supplierFacilityProcessstring
receiverFacilityProcessstring
orderDatestring date
deliveryDatestring date
agreedDeliveryDatestring date
expectedShippingDatestring date
shippingDatestring date
handoverDatestring date
actualDeliveryDatestring date
shipmentReferencestring
internalResponsiblePersonsstring[]
counterpartyOrderNumberRefstring
orderType'PURCHASE_ORDER' | 'SALES_ORDER' | 'INTERNAL_ORDER'
tracingStatusstring
isArchivedboolean
isAutoboolean

Example request

{
  "orderDate": "2026-07-21",
  "deliveryDate": "2026-07-21",
  "agreedDeliveryDate": "2026-07-21",
  "expectedShippingDate": "2026-07-21",
  "shippingDate": "2026-07-21",
  "handoverDate": "2026-07-21",
  "actualDeliveryDate": "2026-07-21"
}

Response

Default Response