POST /api/orders/ – Retraced API Reference

Administration/Attachment Templates6

Administration/Audit Types1

Administration/Claims2

Administration/Companies12

Administration/Companies/Templates1

Administration/Document Types5

Administration/Files6

Administration/Network Onboarding8

Administration/Platform Features4

Administration/Questionnaire Templates7

Administration/Styles1

Administration/Tracing AI1

Administration/User Companies5

Administration/Users12

Agent2

AI Extraction Feedback1

AI Feedback1

AI Processing3

AI Processing Status1

Assets1

Attachment Templates10

Audit Types1

Audits8

Authentication8

Automation Rules12

CAPA25

CAPA Actions15

CAPA Findings9

Certificate AI4

CertifiedMaterials/AI4

CertifiedMaterials/Companies3

CertifiedMaterials/Documents9

CertifiedMaterials/Evidence2

CertifiedMaterials/FieldMatching6

CertifiedMaterials/FilterOptions1

CertifiedMaterials/Orders11

CertifiedMaterials/Products1

CertifiedMaterials/Requests7

CertifiedMaterials/Users1

Claims6

collaboration information patch1

Companies15

Companies/Data Point Answers1

Companies/Impact Areas1

Companies/Templates4

Company Certifications1

Company Chains25

Company Documents5

Company Profiles1

companyChain collaborations4

companyChains invitation reminder1

CompanyProfilesUnlink2

Dashboard Analytics/Audits Drill Down1

Dashboard Analytics/Certification Drill Down1

Dashboard Analytics/Certification Metrics1

Document Types1

Entity Screening3

Entity Tags4

Entity Tags Links1

entity-screening3

Files5

Impact Areas1

Integrations - Amfori12

Natural languages to Automation Rules1

Order Documents2

Order Lines2

Order Tracing - Calculations2

Order Tracing - Internal Orders1

Order Tracing - Order Lines1

Order Tracing - Orders1

Order Tracing - Purchase Orders7

Order Tracing - Sales Orders6

Order Tracing - Trace6

Orders12

OrderTracing - Transactions12

Permissions25

Product Mapping22

Product Mapping - Communications4

Products - Styles1

Products/Badges2

Products/Batches8

Products/BOM-Headers5

Products/BOM-Import1

Products/BOM-Lines4

Products/BOM-Placements3

Products/Cascade-Tracing1

Products/Certifications1

Products/DPP1

Products/Exports1

Products/Map2

Products/Material-Headers5

Products/Material-Lines4

Products/StyleProperties2

Products/Styles9

Products/StyleTypeFieldValues2

Products/StyleTypes1

Products/Variant-SKUs6

Products/Variants6

Profile4

Questionnaire16

Questionnaire Comments4

Questionnaire request8

Questionnaire Responses7

Risk Analysis35

SLCP1

SLCP Assessments1

SLCP/Assessments/SuggestedCAPAs1

slcps8

Status1

StyleLinks1

Styles/Documents10

Styles/OrderDocuments2

Supplier Statistics4

Supply Chain Collaborator1

Supply Chains1

SupplyChain1

SupplyChain Nodes1

SupplyChain status patch1

System/Cache1

System/Emails3

System/Files1

System/QueueJobs3

Terms and Conditions1

Tracing AI6

User Companies2

Users8

Webshop16

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

tracingAttachmentTemplateIdstring nullable

orderType'PURCHASE_ORDER' | 'SALES_ORDER' | 'INTERNAL_ORDER' nullable

tracingStatusstring nullable

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

Changes

Changed in 3 of the 49 revisions of this API.49657

Aug 31, 202697e51f27dc7749654See the full diff
- ▲
  request property was restricted to a list of enum values
  request-property-became-enum
- ▲
  request property list-of-types was narrowed by removing types null from media type application/json
  request-property-list-of-types-narrowed
- ▲
  request property list-of-types was narrowed by removing types null from media type application/json
  request-property-list-of-types-narrowed
- ▲
  request property list-of-types was narrowed by removing types null from media type application/json
  request-property-list-of-types-narrowed
- ▲
  the request property's minLength was increased from 0 to 1
  request-property-min-length-increased
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property /// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /// became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ●
  the request property's maxLength was set to 36
  request-property-max-length-set
- ●
  the request property's maxLength was set to 255
  request-property-max-length-set
- ●
  the // request property's max was set to 100000000000000000.00
  request-property-max-set
- ●
  the // request property's max was set to 100000000000000000.00
  request-property-max-set
- ●
  the // request property's min was set to 0.00
  request-property-min-set
- ●
  the // request property's min was set to 0.00
  request-property-min-set
- ○
  the request property became nullable
  request-property-became-nullable
- ○
  the request property became nullable
  request-property-became-nullable
- ○
  the request property became nullable
  request-property-became-nullable
- ○
  added the new INTERNAL_ORDER enum value to the request property
  request-property-enum-value-added
- ○
  added the new PURCHASE_ORDER enum value to the request property
  request-property-enum-value-added
- ○
  added the new SALES_ORDER enum value to the request property
  request-property-enum-value-added
- ○
  the // request property's exclusiveMaximum was increased from 100000000000000000.00 to true
  request-property-exclusive-max-increased
- ○
  the // request property's exclusiveMaximum was increased from 100000000000000000.00 to true
  request-property-exclusive-max-increased
- ○
  the // request property's exclusiveMinimum was decreased from 0.00 to true
  request-property-exclusive-min-decreased
- ○
  the // request property's exclusiveMinimum was decreased from 0.00 to true
  request-property-exclusive-min-decreased
- ○
  response property data/actualDeliveryDate list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/agreedDeliveryDate list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/buyerFacilityProcess list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/counterpartyOrderNumberRef list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/createdAt list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/createdByApiKeyId list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/createdByApiKeyLabel list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/createdByCompanyId list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/createdByCompanyName list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/createdByImpersonateId list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/createdByImpersonateName list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/createdByUserId list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/createdByUserName list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/deliveryDate list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/expectedShippingDate list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/factory list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/handoverDate list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/lastTracingRequestedAt list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/lines/items/lineNo list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/lines/items/orderLineNumber list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/lines/items/secondaryQuantity list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/lines/items/secondaryUnit list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/lines/items/tracingOrderRequestedAt list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/lines/items/tracingReflectionOrderId list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/orderDate list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/orderSubType list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/receiverFacilityProcess list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/shipmentReference list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/shippingDate list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/source list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/status list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/supplierFacilityProcess list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/tracingAttachmentTemplateId list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/tracingStatus list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/updatedAt list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/updatedByApiKeyId list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/updatedByApiKeyLabel list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/updatedByCompanyId list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/updatedByCompanyName list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/updatedByImpersonateId list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/updatedByImpersonateName list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/updatedByUserId list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/updatedByUserName list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/vendorCompanyId list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
Aug 25, 2026dacbff173c492See the full diff
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the required property / to the response with the status
  response-required-property-added
Aug 14, 2026838f3ea6647d1See the full diff
- ○
  the request property default value INTERNAL_API was added
  request-property-default-value-added

Of the 49 revisions, 1 has no diff computed.

Full history