API для фулфилмента: коробки и КИЗ
Обновлено: 2026-10-11
GET /documents/{type}/{id}/boxes отдаёт, как отгрузка разложена по коробкам. Тип в пути обязателен: id приёмки и отгрузки в WMS могут совпасть. Сейчас Нитроселлер запрашивает раскладку у отгрузок.
Ответ
json
{
"document_id": "512",
"type": "shipment",
"stage": "packed",
"boxes": [
{
"id": "c:9001",
"barcode": "MPRC-109001",
"number": 1,
"items": [
{ "item_id": "77", "code_id": "listing:5", "qty": 12, "kiz": ["0104..."] }
]
}
]
}| Поле | Смысл |
|---|---|
id |
Стабильный id коробки |
barcode |
Штрихкод коробки, который клеят на грузоместо |
number |
Порядковый номер коробки в отгрузке |
items[].item_id |
Товар из /items |
items[].code_id |
Код товара или null |
items[].qty |
Сколько штук этого товара в коробке |
items[].kiz |
Полные строки КИЗ. Пустой массив, если маркировки нет |
Ошибки
| Ответ | Когда |
|---|---|
409 layout_not_ready |
Отгрузка ещё не разложена по коробкам |
404 |
Документа нет или он чужой |
Если коробок-контейнеров нет, можно отдать прежнюю раскладку упаковки в том же поле boxes. Пустой boxes значит, что упакованная отгрузка без коробок.