Перейти к содержимому

Складские процессы

Все складские операции в BILLZ устроены одинаково: это документ, который наполняется позициями и затем завершается.

создать документ ──> добавить позиции ──> отправить / завершить ──> принять / отменить
Шаг Метод
Список GET /v2/transfer
Создать POST /v2/transfer
Добавить товар POST /v2/transfer/:id/add
Отправить POST /v2/transfer/:id/send
Принять (завершить) PUT /v2/transfer/finish/:id
Изменить PUT /v2/transfer/update/:id
Удалить черновик DELETE /v2/transfer/:id
Список позиций GET /v2/transfer-items/:id

Удалить документ в статусах «отправлен», «на проверке», «завершён» нельзя. Завершение требует доступа к магазину назначения: без него ответ — 400 с сообщением о недоступном магазине.

Шаг Метод
Создать POST /v2/write-off
Добавить товар POST /v2/write-off/:id/add
Завершить PUT /v2/write-off/finish/:id
Отклонить PUT /v2/write-off/cancel/:id
Справочник причин GET /v2/write-off-reason

Причина списания обязательна и берётся из справочника компании по id. Новые причины заводятся в интерфейсе BILLZ. Часть причин служебные — списание по итогам инвентаризации и списание из каталога.

Шаг Метод
Создать POST /v2/supplier-order
Добавить товар (по одному) PUT /v2/supplier-order/add-item
Изменить неотправленный PUT /v2/supplier-order/update/:id
Отправить (сменить статус) PATCH /v2/supplier-order/change-status
Список GET /v2/supplier-order
Позиции заказа GET /v2/supplier-order-products/:id

Создание импорта сразу с позициями — POST /v2/product-import/create-with-products, список — GET /v2/import, создание одного товара — POST /v2/product.

Складские методы асинхронные: для получения результата передаётся Billz-Response-Channel: HTTP