Create new code delivery

Supplier registers delivery document before file upload.

Why this method exists

Supplier registers delivery document before file upload.

When to use

Each ERP file batch = new incoming; use Idempotency-Key.

Typical workflow

ERP sets documentNumber.
create → incomingId.
upload-url → PUT.
import → poll get.

Endpoint

POST /v1/supplier/incoming/create

Authentication: X-Api-Key header (prefix bk_sup_). Do not send projectId or actor id in body — they come from the key.

Scope: supplier:incoming:write

Request example

{
  "meta": { "requestId": "optional-uuid" },
  "data": { "documentNumber": "PM-2026-07-001", "documentDate": "2026-07-13", "notes": "Подписка QUEEN14 май" }
}

Response example

{
  "success": true,
  "data": {
    "incomingId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "status": "draft",
    "supplierId": "c219ef09-ae2f-4d08-af11-7cd51006fae4",
    "documentNumber": "PM-2026-07-001",
    "documentDate": "2026-07-13",
    "createdAt": "2026-07-13T10:00:00Z"
  }
}

Errors

UNAUTHORIZED / ACCESS_DENIED — access denied
VALIDATION_ERROR — invalid body
NOT_FOUND — resource not found
RATE_LIMIT_EXCEEDED (429) — rate limit

cURL

curl -X POST "https://api-external.promanta.ru/v1/supplier/incoming/create" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{"data": { "documentNumber": "PM-2026-07-001", "documentDate": "2026-07-13", "notes": "Подписка QUEEN14 май" }}'