Подключение по схеме DBS

DBS (Delivery by Seller) – схема, при которой продавец самостоятельно управляет логистикой: создаёт склады, определяет полигоны доставки, обрабатывает заказы.

Типовой поток

1. Создать локации (склады хранения/отгрузки, ПВЗ) – метод /v1/location/create.
   Локации создаются в статусе DRAFT. После модерации статус меняется на ACTIVE (или FAILED). Актуальный статус можно получить через /v1/location/list.

2. Обновлять локации при изменении данных – /v1/location/update (адрес, часы работы, платёжные методы и т.д.).

3. Создать полигоны доставки – /v1/polygon/create.
   Полигоны создаются в статусе DRAFT, затем проходят модерацию → PENDING → ACTIVE (или FAILED). Статус отслеживается через /v1/polygon/list.

4. Обновлять полигоны:

   • Координаты – /v1/polygon/coordinates/update
   • Опции доставки (цены, временные слоты, расписание) – /v1/polygon/delivery-options/update

5. Загрузить остатки и цены Общие методы:

   • /v1/product/price/update
   • /v1/product/stock/update

6. Получать и обрабатывать заказы – /v1/order/dbs/list.

7. Обновлять статус заказа – /v1/order/dbs/status/update.

8. Обрабатывать отмены – /v1/cancellation/list и /v1/cancellation/update.

9. Обрабатывать возвраты – методы группы Returns

Примечания

• Локации создаются в статусе DRAFT. После проверки модерацией они переходят в ACTIVE (или FAILED). Статус можно отслеживать через POST /v1/location/list. Только активные локации участвуют в логистике.
• Полигоны доставки также создаются в DRAFT и после модерации становятся ACTIVE. Только активные полигоны влияют на расчёт стоимости и сроков доставки.
• Заказы в DBS содержат один товар (модель “one item / one order”). Данные товара возвращаются на верхнем уровне заказа.
• Для работы с ценами и остатками используйте общие методы.

Полный справочник методов DBS

Все методы DBS с детальными параметрами и ответами доступны в разделе API Reference DBS.