Инвентаризация
Создание инвентаризации
Сохраняет инвентаризацию: склад и пересчитанные товары с артикулом, наименованием, количеством и ценой.
Ответ содержит inventory_number вида INV-123; начальный статус — pending. До подтверждения состав можно заменить через PUT, затем подтвердить через PATCH статуса. Создание не меняет остатки и не отправляет документ в ЭДО.
path Parameters
versionHeaders
X-Client-IDERP ID клиента
Создание инвентаризации › Request Body
storage_idИдентификатор склада
Список товаров для проверки
Создание инвентаризации › Responses
Успешно
inventory_numberНомер инвентаризации
Получение списка инвентаризаций
Возвращает инвентаризации клиента, их статусы и товары.
name содержит номер инвентаризации для последующих запросов, total_products — число товарных строк. В детальном ответе эти поля имеют другое значение.
Если у клиента нет инвентаризаций, первая страница возвращает 404.
path Parameters
versionquery Parameters
pageНомер страницы
per_pageКоличество элементов на странице
sort_byПоле и направление сортировки. Доступные значения зависят от endpoint, формат как в products <field>_asc или <field>_desc.
Headers
X-Client-IDERP ID клиента
Получение списка инвентаризаций › Responses
Успешно
Получение инвентаризации по идентификатору
Возвращает инвентаризацию по inventory_number, например INV-123, из ответа создания или поля name списка.
В ответе name — наименование компании, total_products — сумма количеств, total_price — сумма price × quantity. Также возвращаются дата, статус и товары.
Если клиент или инвентаризация не найдены, возвращается 404.
path Parameters
versioninventory_numberИдентификатор инвентаризации
Headers
X-Client-IDERP ID клиента
Получение инвентаризации по идентификатору › Responses
Успешно
nameНаименование товара
dateДата
statusСписок товаров на складе
total_productsОбщее количество товаров
total_priceОбщая стоимость товаров
Обновление инвентаризации
Заменяет товары инвентаризации. Доступно только в статусе pending; иначе возвращается 400.
Передавайте полный products: отсутствующие позиции удаляются. Метод не подтверждает инвентаризацию и не отправляет документ в ЭДО.
path Parameters
versioninventory_numberИдентификатор инвентаризации
Headers
X-Client-IDERP ID клиента
Обновление инвентаризации › Responses
Успешно
Обновление статуса инвентаризации
Меняет статус инвентаризации: confirmed — подтверждение, cancelled — отмена.
При подтверждении возвращается PDF, при отмене — пустое тело. Отправку в ЭДО метод не выполняет.
Статус сохраняется до генерации PDF. Если она завершилась ошибкой, проверьте инвентаризацию через GET перед повтором.
path Parameters
versioninventory_numberИдентификатор инвентаризации
Headers
X-Client-IDERP ID клиента
Обновление статуса инвентаризации › Request Body
statusНовый статус инвентаризации
Обновление статуса инвентаризации › Responses
Статус сохранён. Для confirmed возвращается PDF, для cancelled — пустое тело.
Получение остатков
Возвращает остатки клиента по складам и артикулам.
По умолчанию возвращаются cises со статусами; пагинация page / perPage выбирает артикулы, не отдельные CIS. При without_cises=true пагинация отключена, возвращаются count и available_count — общее количество и доступное для возврата с учётом активных заявок.
При пустой выборке возвращаются items: [] и pages.total: 0. В режиме without_cises=true метаданные пустой выборки — page: 1, per_page: 1, total_pages: 1.
Чтение остатков не резервирует товар.
path Parameters
versionquery Parameters
storage_idНомер склада
product_codeФильтр по артикулу
cis[ABCDEFGHIJKLMNOPQRS…Фильтр по коду маркировки
Код маркировки
pageНомер страницы
perPageКоличество товаров на странице
without_cisesЕсли true — возвращается только список товаров без cises и одной страницей (page и perPage игнорируются).
sort_byПоле и направление сортировки. Доступные значения зависят от endpoint, формат как в products <field>_asc или <field>_desc.
Headers
X-Client-IDERP ID клиента
Получение остатков › Responses
Успешно
Получение списка складов из балансов CIS
Возвращает массив storages — уникальные идентификаторы складов с записями в балансах клиента. Пагинации нет.
Используйте их как storage_id в запросе остатков. Наличие склада в списке не означает наличие свободного товара.
path Parameters
versionHeaders
X-Client-IDERP ID клиента
Получение списка складов из балансов CIS › Responses
Успешно
storages