Создание новой поставки кодов

Поставщик регистрирует новую партию в PROMANTA до отправки файла — как «накладная» с номером и датой.

Зачем нужен метод

Поставщик регистрирует новую партию в PROMANTA до отправки файла — как «накладная» с номером и датой. Без этого шага нельзя загрузить xlsx.

Когда использовать

Каждый новый файл от ERP = новое поступление. Рекомендуется Idempotency-Key по documentNumber.

Типовой сценарий

ERP формирует documentNumber (уникальный в вашей учётной системе).
create → получаете incomingId.
upload-url → PUT файла.
import → poll get.

Эндпоинт

POST /v1/supplier/incoming/create

Аутентификация: API-ключ в заголовке X-Api-Key (префикс bk_sup_). projectId и actor id в body не передаются — берутся из ключа.

Scope: supplier:incoming:write

Пример запроса

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

Пример ответа

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

Ошибки

UNAUTHORIZED / ACCESS_DENIED — нет доступа
VALIDATION_ERROR — некорректное тело
NOT_FOUND — сущность не найдена
RATE_LIMIT_EXCEEDED (429) — превышен лимит

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 май" }}'