Ответственное хранение
responsible-storage управляет товарами клиента на хранении: остатками и маркировками, инвентаризациями, выкупом, возвратами и документами. Заказы обслуживает отдельный сервис — b2b-orders.
Основные сущности
- Остатки — товары и коды маркировки на складах клиента.
- Инвентаризация — зафиксированный результат пересчёта товаров.
- Заказ на выкуп — выкуп конкретных единиц товара с хранения.
- Заявка на возврат — возврат товара с хранения; это не отмена выкупа.
- Документы — МХ-1 о приёме на хранение, МХ-3 о возврате с хранения и УПД.
Выкуп, возврат и инвентаризация имеют отдельные идентификаторы и статусы. Связанные документы могут появиться позже самой заявки.
С чего начать
- Согласуйте доступ, свой идентификатор клиента, склад и окружение.
- Получите склады клиента и остатки.
- Выберите сценарий ниже и создайте соответствующую заявку.
- Отслеживайте её обработку и готовность документов отдельно.
Сценарии
Инвентаризация
Создайте инвентаризацию по результатам пересчёта. До подтверждения её можно проверить и исправить, затем подтвердить или отменить. История доступна в списке инвентаризаций.
Выкуп с хранения
Создайте заказ на выкуп и следите за обработкой. Для уведомлений можно настроить вебхук; он не заменяет проверку состояния заказа. Вебхук можно отключить.
Все выкупы доступны в списке заказов. Для прекращения обработки используйте отмену выкупа.
Возврат с хранения
Создайте заявку на возврат и проверяйте результат. При необходимости измените и подтвердите её состав. Подтверждённые товары можно выкупить полностью или частично; ненужную заявку — отменить. История доступна в списке возвратов.
Документы
Данные документов доступны через API:
- МХ-1: список и состав акта.
- МХ-3: список и состав акта.
- УПД: список и строки документа.
Окружения
На общем сервере из API Reference:
/responsible-storage/v1-sandbox— testing, выбран по умолчанию в спецификации./responsible-storage/v1— основное окружение.
Testing
Для responsible-storage опубликован адрес тестового окружения. Доступ, тестовые данные, их сброс и ограничения внешних интеграций согласуйте отдельно. Успешный вызов в testing не подтверждает права и поведение в основном окружении; проверяйте авторизацию и готовность документов отдельно.
Авторизация и идентификатор клиента
Создайте авторизационный токен на странице Токены интеграций. Передавайте его в Authorization: Bearer <API_TOKEN>, а ERP ID клиента — в заголовке X-Client-ID.
Например: GET /orders с X-Client-ID: 00-00002323 относительно префикса сервиса.
Токен должен предоставлять доступ к указанному клиенту.
См. общие правила авторизации и идентификации клиента.
Параметры, примеры запросов, статусы и ограничения находятся на страницах соответствующих методов.