---
title: "Принять товар по отправке"
method: POST
path: "/api/v1/stock/transit-shipments/{id}/receipts"
tags: ["Stock documents"]
---

# Принять товар по отправке

`POST /api/v1/stock/transit-shipments/{id}/receipts`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/stock/transit-shipments/{id}/receipts`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)
  - HTTP bearer

Приёмка по перемещению (ERP-2179): перемещение со склада «в пути» на
склад-получатель на основании отправки. Без строк — «принять всё как
отправлено»: хвост каждой строки с её ожидаемой серией и сроком. Со
строками — факт: строка отправки (`basis_line_id`) или товар без неё,
количество, серия, выпуск, срок и состояние по факту. Серия или срок
по факту рождают новую партию со стоимостью отправки; без них партии
отправки переезжают как есть. Принятое сверх того, что в пути, —
излишек (`surplus_qty` в разложении проведения), его приходуют
решением. `final: true` — «приёмка закончена»: остаток в пути —
недостача. `post: true` проводит сразу, иначе черновик.

Строка с `qty: "0"` — «по строке ничего не приехало»; допустима только
с `final: true` и в документ не идёт (без `final` — 400). Если с
`final: true` все строки — 0 (больше ничего не приехало), документа нет:
приёмку без строк не провести, и отправка закрывается отметкой — ответ
`status: marked`, `action: close`, `qty` — весь остаток в пути, он
становится недостачей (отправка — `discrepancy`, в «Расхождениях
приёмки» — недостача «нужно решить»). Пустой список строк по-прежнему
значит «принять всё как отправлено». Закрывать нечего (в пути пусто) —
400.

Дата приёмки (`date`) — задним числом можно: не раньше даты отправки
и не позже сегодняшнего дня в поясе кабинета, иначе 400; пусто —
рабочая дата, не раньше отправки. Сторож хронологии проведения
действует как обычно. С `post: true` отказ проведения не оставляет
черновика: заведённая этим запросом приёмка снимается, повтор после
исправления заводит одну приёмку.

Серия по факту — подсказка, а не сверка: серия не та, что ожидали, —
не расхождение; такие строки показывает отчёт
`stockListTransitSeriesMismatches`.

Читает `Idempotency-Key`: повтор с тем же ключом отдаёт тот же документ.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Tenant` string, required
- `Idempotency-Key` string

## Request body

- StockTransitReceiptInput
  - `date` string, date: Дата приёмки: не раньше даты отправки и не позже сегодняшнего дня в поясе кабинета (иначе 400); пусто — рабочая дата кабинета, не раньше даты отправки
  - `comment` string
  - `post` boolean: true — провести сразу; по умолчанию черновик
  - `final` boolean: «Приёмка закончена»: остаток в пути — недостача. С final все строки с qty 0 — закрыть отправку без документа: больше ничего не приехало
  - `lines` StockTransitInputLine[]: Пусто — принять всё как отправлено. Строка с qty 0 — ничего не приехало, только с final
    - `basis_line_id` string, uuid
    - `product_id` string, uuid
    - `qty` string: Количество в базовой единице, decimal string; у решения пусто — весь открытый хвост строки. У приёмки 0 — по строке ничего не приехало, только с final
    - `batch_code` string: Серия по факту; без поля — ожидаемая серия строки отправки. Пустая строка — без серии
    - `produced_at` string, date
    - `expires_at` string, date
    - `condition_id` string, uuid
    - `bin_allocations` StockDocumentLineBinAllocation[]: Ячейки склада-получателя. У приёмки (ERP-2575) — куда кладут принятое из пути; ложатся в ячейки «куда» (bin_allocations_to) перемещения приёмки, в режиме strict их сумма равна перемещённому — количеству строки без излишка сверх отправленного (ERP-2578). У решения surplus_receipt (ERP-2578) — куда кладут излишек; в режиме strict сумма равна оприходуемому. У решения regrade (ERP-2579) — куда кладут принятый товар на получателе; в режиме strict сумма равна количеству пары. Ячейка принадлежит складу-получателю, в нём включены ячейки; иначе проведение отказывает. У решения return (ERP-2579) — ячейки склада-отправителя, куда возвращают недостачу; в режиме strict сумма равна возвращаемому. У списания и претензии не указываются
      - `bin_id` string, uuid, required
      - `qty` string, required: Положительная decimal string в базовой единице номенклатуры
      - `bin_code` string: Только в ответе: код ячейки. При сохранении игнорируется
      - `bin_name` string: Только в ответе: название ячейки. При сохранении игнорируется
      - `handling_unit_id` string, uuid
    - `to_basis_line_id` string, uuid

## Response `201`

Заведённая приёмка — черновик или проведённая

- StockTransitDocumentResult: Документ, заведённый по отправке. У решения-отметки (wait) и у «приёмка закончена», когда больше ничего не приехало (close), документа нет: status — marked, action — что отмечено
  - `document_id` string, uuid
  - `number` string
  - `type_key` string
  - `status` string, required: Статус документа (draft, posted) или marked у отметки
  - `action` 'wait' | 'close': Только у отметки: что отмечено; close — отправка закрыта без документа, qty — остаток, ставший недостачей
  - `lines` integer, required
  - `qty` string, required: Сумма количеств строк

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `409`: Конфликт версии, идемпотентности или бизнес-состояния
- `422`: Idempotency-Key уже использован для другого запроса: другое тело, другой адрес или другая операция. Код `idempotency.key_mismatch`; сохранённый ответ не раскрывается. Для новой команды берут новый ключ.
- `503`: Хранилище ключей идемпотентности недоступно, команда с заголовком Idempotency-Key не выполнялась. Код `idempotency.unavailable`; Retry-After говорит, когда повторить.

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/a99574d597cc?raw)