API для фулфилмента: приёмки и отгрузки
Обновлено: 2026-10-11
GET /documents — журнал склада. Нитроселлер проводит его как обычные приёмки и отгрузки селлера. Повторный синк пишет только разницу.
Запрос
curl "https://wms.example/api/nitroseller/v1/documents?changed_since=2026-10-11T00:00:00%2B03:00" \
-H "Authorization: Bearer ns_example_..."
Курсор пагинации — query cursor, в ответе next_cursor. Документ: id, type, subtype, number, status, stage, channel_id, marketplace, destination, warehouse_id, changed_at, posted_at, deleted_at, request_ref, lines.
Тип и стадия
| Поле | Значения |
|---|---|
type |
receipt, shipment, transfer, adjustment |
subtype |
Как называет WMS: receiving, return, inventory, relocation и другие |
stage |
planned, in_progress, packed, completed, cancelled |
destination |
{kind, title} — куда уехал товар |
request_ref |
ULID заявки Нитроселлера или null. С версии 1.2 |
Строка: item_id, code_id (может быть null), qty_plan, qty_posted. Количество — на товар, не на коробку. code_id — id кода из /items.
Как документ попадает в учёт
| Документ WMS | Что видит селлер |
|---|---|
| Приёмка товара | Приход «Приёмка фулфилмента» |
| Возврат на склад | Приход «Возврат по данным фулфилмента» |
| Излишек инвентаризации | Приход «Излишек» |
| Отгрузка, которую ещё не сдали | Запланированная отгрузка. Товар на складе, заявка его резервирует |
| Отгрузка сдана на склад маркетплейса | Расход на маркетплейс |
| Вывоз клиентом | Расход «Вывоз клиентом» |
| Отгрузка в брак | Перемещение на склад брака |
| Недостача инвентаризации | Списание «Недостача» |
| Документ из заявки | Проводится тот документ, который селлер уже создал. Дубля нет |
Если фулфилмент отгрузил больше, чем числится у селлера, перед расходом появляется приход «Излишек». Синк из-за этого не останавливается. Себестоимость прихода берётся из карточки или последней партии и помечается примерной.