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"
}

Bestellungen

Bestellungen erstellen

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"
}

Autorisierungen

Authorization

string

header

erforderlich

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

erforderlich

UUID of an existing supplier of your company.

Minimum string length: 1

orderNumber

string

erforderlich

Your order number, unique per company.

Minimum string length: 1

orderType

enum<string>

erforderlich

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

Verfügbare Optionen:

purchase,

sale

lines

object[]

erforderlich

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.

Antwort

Order created successfully (single)

order

object

erforderlich

Show child attributes

API-Dokumentation

Artikel

Lieferanten

Parzellen

Nachweise

Bestellungen

Import-Jobs

DDS-Erklärungen

PPWR – Verpackungsdaten

PPWR – Dokumente

PPWR – Konformitätserklärungen

PPWR – Mengen & Mengenmeldung

Bestellungen erstellen

Autorisierungen

Body

Antwort