curl --request POST \
  --url https://app.polygon-one.com/api/v1/orders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "supplierId": "5a1d8c3e-7f24-4b9a-a6e0-1c3f5b8d2e94",
  "orderNumber": "PO-2026-0042",
  "orderDate": "2026-02-16T00:00:00.000Z",
  "deliveryDate": "2026-04-30T00:00:00.000Z",
  "orderType": "purchase",
  "lines": [
    {
      "positionId": "00010",
      "articleId": "7c4e2b19-3a85-4d6f-b210-8e9a5c1d7f36",
      "quantity": 12500,
      "pieceCount": 5000,
      "volumeM3": 25
    }
  ]
}
'

{
  "order": {
    "id": "1b7f3e9d-4a26-4c85-b9e1-5d0a8c3f7e42",
    "supplier": {
      "id": "5a1d8c3e-7f24-4b9a-a6e0-1c3f5b8d2e94",
      "name": "Sawmill Example GmbH",
      "contactName": "Alex Example",
      "country": "Germany",
      "status": "data_complete",
      "externalSupplierId": "LIEF-4711",
      "address": {
        "street": "Industriestraße 12",
        "city": "Musterstadt",
        "postalCode": "12345"
      },
      "email": "sales@sawmill.example",
      "articles": [],
      "plots": [],
      "complianceResults": [],
      "isCompanySelf": false,
      "supplierArticles": [],
      "deletedAt": null,
      "assignedToUserId": null,
      "otpContactEmail": null,
      "otpContactConfirmedAt": null,
      "otpExemptUntil": null
    },
    "orderNumber": "PO-2026-0042",
    "orderDate": "2026-02-16T00:00:00.000Z",
    "deliveryDate": "2026-04-30T00:00:00.000Z",
    "orderType": "purchase",
    "lines": [
      {
        "id": "6e2a9c4f-1b73-4d58-8f06-9c3e7a1b5d28",
        "article": {
          "id": "7c4e2b19-3a85-4d6f-b210-8e9a5c1d7f36",
          "name": "Pine plank 20 mm",
          "shortDescription": "Kiln-dried pine plank, 20 × 100 × 2400 mm",
          "internalArticleNr": "ART-1001",
          "externalArticleNr": null,
          "ean": null,
          "hsCode": "4407.11",
          "articleType": "purchase",
          "eudrRelevant": true,
          "needsManualCheck": false,
          "sourceScope": "standing",
          "hsPlausibility": null,
          "geoComplianceResults": [],
          "legalComplianceResults": [],
          "legalDocuments": [],
          "legalCategoryResults": [],
          "questionnaires": [],
          "commodityGroup": "wood",
          "weightPerPieceKg": 2.5,
          "deletedAt": null,
          "suppliers": [],
          "plots": [],
          "complianceResults": [],
          "countryOfProduction": null,
          "supplierLinks": [
            {
              "supplierId": "5a1d8c3e-7f24-4b9a-a6e0-1c3f5b8d2e94",
              "supplierArticleId": "2e8f6a3c-9d17-4b52-8c4a-7f1e3d9b0a65"
            }
          ]
        },
        "quantity": 12500,
        "pieceCount": 5000,
        "volumeM3": 25,
        "dryWeight90Kg": null,
        "positionId": "00010",
        "deliveryDate": "2026-04-30T00:00:00.000Z"
      }
    ],
    "totalVolume": 12500,
    "ddsReferences": [],
    "status": "open"
  }
}

{
  "jobId": "d2f7a4c9-8e15-4b63-9a2d-1c6e5f0b8d37",
  "status": "queued",
  "statusUrl": "/api/import-jobs/d2f7a4c9-8e15-4b63-9a2d-1c6e5f0b8d37"
}

{
  "error": "Validation failed",
  "details": [
    {
      "origin": "string",
      "code": "too_small",
      "minimum": 1,
      "inclusive": true,
      "path": [
        "address",
        "street"
      ],
      "message": "Address is required."
    }
  ]
}

{
  "error": "Invalid or expired API key"
}

{
  "error": "Forbidden"
}

{
  "error": "<string>",
  "code": "<string>",
  "details": [
    {
      "code": "<string>",
      "path": [
        "<string>"
      ],
      "message": "<string>"
    }
  ],
  "warnings": [
    {
      "type": "duplicateName",
      "existingInternalArticleNr": "<string>",
      "existingArticleName": "<string>"
    }
  ]
}

{
  "error": "batchTooLarge",
  "maxBatchSize": 5000
}

{
  "error": {
    "code": "rate_limited",
    "message": "…"
  }
}

{
  "error": "Internal server error"
}

Orders

Create Order

Create a single order (synchronous), or bulk-import orders (asynchronous). Batch imports use a flat structure — each row is one order line, grouped by orderNumber; supplier/article are resolved by name/number; orders upsert idempotently on orderNumber. After import, the system automatically attempts to assign each order to a matching DDS statement if auto-assignment is enabled. A batch that names an order must carry ALL of that order’s lines — a batch that would delete stored lines fails with lineReplacementRequired unless the envelope sets "replaceLines": true. positionId works in both forms: every line of an order carries one or none does (positionIdMixed), and an id appears once per order (duplicatePositionId) — in the single-object form both answer 400 with that code. Batch form (array, or {"rows": […]} envelope, max 5000 rows) is asynchronous: it stages an import job and returns 202 with a jobId — poll GET /api/v1/import-jobs/{jobId} for progress and the final result. A single object stays synchronous (201). See the Batch Import guide.

POST

api

orders

curl --request POST \
  --url https://app.polygon-one.com/api/v1/orders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "supplierId": "5a1d8c3e-7f24-4b9a-a6e0-1c3f5b8d2e94",
  "orderNumber": "PO-2026-0042",
  "orderDate": "2026-02-16T00:00:00.000Z",
  "deliveryDate": "2026-04-30T00:00:00.000Z",
  "orderType": "purchase",
  "lines": [
    {
      "positionId": "00010",
      "articleId": "7c4e2b19-3a85-4d6f-b210-8e9a5c1d7f36",
      "quantity": 12500,
      "pieceCount": 5000,
      "volumeM3": 25
    }
  ]
}
'

{
  "order": {
    "id": "1b7f3e9d-4a26-4c85-b9e1-5d0a8c3f7e42",
    "supplier": {
      "id": "5a1d8c3e-7f24-4b9a-a6e0-1c3f5b8d2e94",
      "name": "Sawmill Example GmbH",
      "contactName": "Alex Example",
      "country": "Germany",
      "status": "data_complete",
      "externalSupplierId": "LIEF-4711",
      "address": {
        "street": "Industriestraße 12",
        "city": "Musterstadt",
        "postalCode": "12345"
      },
      "email": "sales@sawmill.example",
      "articles": [],
      "plots": [],
      "complianceResults": [],
      "isCompanySelf": false,
      "supplierArticles": [],
      "deletedAt": null,
      "assignedToUserId": null,
      "otpContactEmail": null,
      "otpContactConfirmedAt": null,
      "otpExemptUntil": null
    },
    "orderNumber": "PO-2026-0042",
    "orderDate": "2026-02-16T00:00:00.000Z",
    "deliveryDate": "2026-04-30T00:00:00.000Z",
    "orderType": "purchase",
    "lines": [
      {
        "id": "6e2a9c4f-1b73-4d58-8f06-9c3e7a1b5d28",
        "article": {
          "id": "7c4e2b19-3a85-4d6f-b210-8e9a5c1d7f36",
          "name": "Pine plank 20 mm",
          "shortDescription": "Kiln-dried pine plank, 20 × 100 × 2400 mm",
          "internalArticleNr": "ART-1001",
          "externalArticleNr": null,
          "ean": null,
          "hsCode": "4407.11",
          "articleType": "purchase",
          "eudrRelevant": true,
          "needsManualCheck": false,
          "sourceScope": "standing",
          "hsPlausibility": null,
          "geoComplianceResults": [],
          "legalComplianceResults": [],
          "legalDocuments": [],
          "legalCategoryResults": [],
          "questionnaires": [],
          "commodityGroup": "wood",
          "weightPerPieceKg": 2.5,
          "deletedAt": null,
          "suppliers": [],
          "plots": [],
          "complianceResults": [],
          "countryOfProduction": null,
          "supplierLinks": [
            {
              "supplierId": "5a1d8c3e-7f24-4b9a-a6e0-1c3f5b8d2e94",
              "supplierArticleId": "2e8f6a3c-9d17-4b52-8c4a-7f1e3d9b0a65"
            }
          ]
        },
        "quantity": 12500,
        "pieceCount": 5000,
        "volumeM3": 25,
        "dryWeight90Kg": null,
        "positionId": "00010",
        "deliveryDate": "2026-04-30T00:00:00.000Z"
      }
    ],
    "totalVolume": 12500,
    "ddsReferences": [],
    "status": "open"
  }
}

{
  "jobId": "d2f7a4c9-8e15-4b63-9a2d-1c6e5f0b8d37",
  "status": "queued",
  "statusUrl": "/api/import-jobs/d2f7a4c9-8e15-4b63-9a2d-1c6e5f0b8d37"
}

{
  "error": "Validation failed",
  "details": [
    {
      "origin": "string",
      "code": "too_small",
      "minimum": 1,
      "inclusive": true,
      "path": [
        "address",
        "street"
      ],
      "message": "Address is required."
    }
  ]
}

{
  "error": "Invalid or expired API key"
}

{
  "error": "Forbidden"
}

{
  "error": "<string>",
  "code": "<string>",
  "details": [
    {
      "code": "<string>",
      "path": [
        "<string>"
      ],
      "message": "<string>"
    }
  ],
  "warnings": [
    {
      "type": "duplicateName",
      "existingInternalArticleNr": "<string>",
      "existingArticleName": "<string>"
    }
  ]
}

{
  "error": "batchTooLarge",
  "maxBatchSize": 5000
}

{
  "error": {
    "code": "rate_limited",
    "message": "…"
  }
}

{
  "error": "Internal server error"
}

Authorizations

Authorization

string

header

required

API key generated in Settings > API Keys. Include as Authorization: Bearer <key>.

Body

application/json

Option 1 · object
Option 2 · object[]
Option 3 · object

supplierId

string

required

UUID of an existing supplier of your company.

Minimum string length: 1

orderNumber

string

required

Your order number, unique per company.

Minimum string length: 1

orderType

enum<string>

required

purchase (inbound from a supplier) or sale (outbound to a customer).

Available options:

purchase,

sale

lines

object[]

required

The order lines (at least one).

Minimum array length: 1

Show child attributes

orderDate

string

ISO 8601 date string

deliveryDate

string

Optional ISO 8601 delivery date. Often unknown at order time.

Response

Order created successfully (single)

order

object

required

Show child attributes

API Documentation

Articles

Suppliers

Plots

Evidence

Orders

Import Jobs

DDS Statements

PPWR – Packaging Data

PPWR – Documents

PPWR – Declarations of Conformity

PPWR – Quantities & Volume Reports

Create Order

Authorizations

Body

Response