Обработка FBS-заказов

API Маркета позволяет выполнять все те же действия, что выполняются в кабинете: смотреть новые заказы, получать для них ярлыки, что-то менять в них при необходимости и так далее.

Шаг 1. Регулярная проверка новых заказов

1. Регулярно проверяйте, появились ли новые заказы, — запрос GET v2/campaigns/{campaignId}/orders. Делайте это не реже чем раз в час.

   Используйте диапазон дат доставки — параметры fromDate и toDate. Если не передать toDate, будет указана текущая дата.

   Чтобы получить информацию о заказах, в которых были изменения

   Используйте фильтры updatedAtFrom и updatedAtTo. Если не передать updatedAtTo, будет указана текущая дата.

2. Убедитесь, что все товары есть в наличии. Если все в порядке, переходите к шагу 2. Если чего-то не хватает, сначала прочитайте инструкцию Перенос, отмена и сокращение заказа.

Шаг 2. Генерация листа сборки

Генерация занимает время, поэтому сначала нужно сделать запрос на саму генерацию, а потом на получение готового листа сборки.

1. Сделайте запрос POST v2/reports/documents/shipment-list/generate.
2. Чтобы узнать, готов ли лист сборки, выполните запрос GET v2/reports/info/{reportId}. Вы получите статус генерации и примерное время, оставшееся до ее завершения.
3. После того как время на генерацию закончится, повторите запрос GET v2/reports/info/{reportId}. Если лист сборки удалось сгенерировать, вы получите ссылку на его скачивание.

Шаг 3. Передача кодов маркировки и распределения товаров по коробкам

Эти сведения передаются одновременно одним запросом: PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes.

Коды маркировки

Если для товара предусмотрена маркировка в «Честном знаке» или других системах маркировки, передайте Маркету код каждого проданного экземпляра.

Например, если человек заказал три пары одинаковых домашних тапочек, для этой позиции в заказе нужно передать три кода.

Распределение по коробкам

Перед отгрузкой заказа нужно передать Маркету информацию о том, как товары распределены по коробкам. Эти сведения бывают нужны, если что-то идет не так.

Шаг 4. Печать ярлыков и передача статуса «Готов к отгрузке»

Собранный заказ нужно упаковать — это делается согласно правилам, подробно описанным в Справке Маркета для продавцов.

На упакованный заказ наклеивается специальный стандартный ярлык с номером, штрих-кодами и другой информацией — по нему службы доставки определяют, куда везти посылку. Ярлык можно получить через API с помощью запроса:

• GET v2/campaigns/{campaignId}/orders/{orderId}/delivery/labels — для одного заказа.
• POST v2/reports/documents/labels/generate — для нескольких заказов.

Подготовив заказ, переведите его в статус Готов к отгрузке ("status": "PROCESSING" "substatus": "READY_TO_SHIP" ). Это делается с помощью запросов PUT v2/campaigns/{campaignId}/orders/{orderId}/status (если хочется передавать по одному заказу) или POST v2/campaigns/{campaignId}/orders/status-update (если хочется передавать массово).

Переводя заказ в статус Готов к отгрузке, вы подтверждаете Маркету, что товар есть и будет отгружен. Товары в статусе Готов к отгрузке попадают в акт приема-передачи.

Шаг 5. Работа с отгрузкой

Чтобы отгрузить заказы, водителю понадобится акт приема-передачи. С помощью запроса GET v2/campaigns/{campaignId}/shipments/reception-transfer-act вы можете:

1. Получить и подписать акт приема-передачи через API. О том, как подключить работу с электронными актами приема-передачи, читайте в Справке Маркета для продавцов.

2. Подтвердить отгрузку. При работе в кабинете такого шага нет, а при работе через API — есть.

Если товара не хватает: перенос, отмена и сокращение заказа

Во время подготовки заказа на вашем складе могут обнаружить, что одного или нескольких товаров нет. Если так случится, придется перенести доставку заказа или отменить его целиком или частично.

Перенос даты доставки и полная отмена заказа делаются отдельными запросами.

Для изменения состава заказа используется PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes — тот же запрос, что передает коды маркировки и распределение товаров по коробкам.