Ⓜ️🚚 Заказы со склада (extendedPickup) для Партнёров мега-схемы #

Чеклист для Партнёров, которые уже работают с Ютекой по мега-схеме и хотят подключить заказы со склада (самовывоз на следующий день, extendedPickup): Партнёр доставляет товары со своего склада в выбранную клиентом аптеку, клиент забирает заказ после доставки.

Всё, что уже работает у Партнёра, не меняется: авторизация, выгрузки аптек и остатков, обмен обычными заказами продолжают работать как раньше. Ниже — только то, что нужно добавить.

1. Выгрузка складов #

Новый эндпоинт POST /warehouses: список складов (id, name), до 1 раза в сутки.

Подробнее: Склады

2. Привязка аптек к складам и даты доставки #

В существующей выгрузке аптек POST /stores для аптек, в которые доставляются заказы со склада, добавляются поля:

warehouse_id — ID склада, с которого аптека получает остатки. Одна аптека может получать остатки только с одного склада; один склад может обслуживать несколько аптек и регионов;
delivery_dates — ближайшая дата доставки (delivery_date), крайний срок оформления заказа для этой даты (delivery_date_expires) и следующая дата доставки (next_delivery_date).

Даты доставки должны обновляться ежедневно.

Подробнее: Привязка аптек к складам и даты доставки

3. Выгрузка остатков складов #

Новый эндпоинт POST /warehouses/prices: остатки и цены склада, формат позиций тот же, что в обычной выгрузке остатков. Не чаще 1 раза в 15 минут, не реже 1 раза в час, один склад на запрос.

Поддерживаются и частичные выгрузки PUT /warehouses/prices (по аналогии с частичными выгрузками остатков аптек): при их постоянном использовании полную выгрузку можно делать 1 раз в сутки.

Подробнее: Остатки складов

4. Обмен заказами со склада #

Заказы со склада приходят в общем списке GET /orders. Необязательный параметр type (pickup / extendedPickup) позволяет обрабатывать потоки раздельно: на время перехода переведите текущий опрос на type=pickup, заказы со склада обкатайте отдельным опросом с type=extendedPickup, после стабилизации объединяйте в один запрос без параметра.
В таких заказах появляются поля type и warehouse_id (откуда везти).
Подтверждение обработки — тот же POST /orders/exported.
Статусы — тот же справочник и тот же POST /orders, плюс два новых опциональных поля: shipping_started_date (заказ отправлен со склада) и delivery_date (дата доставки изменилась).

Ожидаемые этапы по заказу: принят (6) - при необходимости частичная сборка (7) - отправлен со склада (6 + shipping_started_date) - доставлен в аптеку и готов к выдаче (5 + reservation_end_date) - выдан (2) или отменён (3).

Подробнее: Обмен заказами со склада

Порядок подключения #

Сообщите Ютеке о желании подключить заказы со склада — согласуем детали и включим новые эндпоинты для вашего partnerID.
Настройте выгрузки складов, привязок аптек и остатков складов (пункты 1-3).
После проверки выгрузок Ютекой подключите обмен заказами (пункт 4) на тестовом окружении.
После совместного тестирования включаем заказы со склада на боевом окружении.