Orders

Changed on

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

  • Base URL
    https://api.retraced.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.retraced.com/api/orders/
  • Auth
    none declared

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
tracingAttachmentTemplateIdstring nullable
orderType'PURCHASE_ORDER' | 'SALES_ORDER' | 'INTERNAL_ORDER' nullable
tracingStatusstring nullable
isArchivedboolean

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

Changes

  • bd8a92f5afd9Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

  • 26dc623d4f5bRevision changes
    • warning

      removed the request property

    • info

      added the optional property / to the response with the status