Создание документа поступления

Создаёт пустое поступление в статусе draft — первый шаг перед загрузкой файла с кодами.

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

Создаёт пустое поступление в статусе draft — первый шаг перед загрузкой файла с кодами. В UI это кнопка «Новое поступление».

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

Начало цепочки: create → upload/upload-url → import. Без create нельзя привязать файл.

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

Выберите поставщика и номер/дату документа.
Сохраните — получите incomingId.
Загрузите файл через upload или upload-url.
Запустите import.

Эндпоинт

POST /v1/internal/promo-code-incoming/create

Аутентификация: JWT — заголовок Authorization: Bearer <token>. Пользователь должен иметь доступ к проекту и permission inventory_promo_codes.

Permission: inventory_promo_codes.create

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

{
  "meta": { "requestId": "optional-uuid" },
  "data": { "projectId": "a1b2…", "supplierId": "c219ef09-…", "documentNumber": "PM-2026-07-002", "documentDate": "2026-07-13", "importMaskId": null, "notes": "Подписка QUEEN14" }
}

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

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

Ошибки

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

cURL

curl -X POST "https://api-external.promanta.ru/v1/internal/promo-code-incoming/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT" \
  -d '{"data": { "projectId": "a1b2…", "supplierId": "c219ef09-…", "documentNumber": "PM-2026-07-002", "documentDate": "2026-07-13", "importMaskId": null, "notes": "Подписка QUEEN14" }}'