Работа с LaaS-заказом

С помощью API Маркета вы можете получать, создавать, изменять и отменять заказы.

Создать заказ

1. Для самовывоза: при необходимости вызовите метод POST v1/businesses/{businessId}/logistics-points, который возвращает список пунктов выдачи заказов Маркета.

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

2. Проверьте остатки на складах — метод POST v2/campaigns/{campaignId}/offers/stocks.

   В ответе также вернутся идентификаторы складов, на которых хранятся товары.

3. Получите доступные варианты доставки. Для этого в методе POST v1/campaigns/{campaignId}/delivery-options передайте все товары в заказе и информацию для курьерской доставки или самовывоза.

   При необходимости также передайте идентификаторы складов, с которых нужно забрать товары. Если этого не сделать, Маркет сам выберет склады.

4. Создайте заказ с помощью метода POST v1/campaigns/{campaignId}/orders/create. Для доставки курьером передайте полный адрес, в том числе регион.

   Значение параметра draft:

   • true — Маркет создаст заказ в статусе RESERVED и будет ждать подтверждения от магазина.
   • false — Маркет создаст заказ в статусе PROCESSING с подстатусом STARTED и начнёт его обработку, подтверждение не требуется.

5. Если заказ находится в статусе RESERVED и вы готовы его подтвердить, передайте статус PROCESSING с подстатусом STARTED в методе PUT v2/campaigns/{campaignId}/orders/{orderId}/status. Если не сделать это в течение часа после создания заказа, Маркет отменит заказ.

   В ответе вернется идентификатор операции.

6. Проверьте статус операции с помощью метода POST v1/businesses/{businessId}/operations.

Изменить заказ

Вы можете изменить:

• данные получателя;
• интервал дат курьерской доставки.

1. Для изменения интервала дат курьерской доставки: получите доступные временные интервалы с помощью метода POST v1/campaigns/{campaignId}/orders/update-options.

2. Запустите операцию по изменению заказа. Для этого укажите идентификатор заказа и новые данные в методе POST v1/campaigns/{campaignId}/orders/update.

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

3. Проверьте статус операции с помощью метода POST v1/businesses/{businessId}/operations.

Отменить заказ

1. Запустите операцию по отмене заказа. Для этого передайте статус CANCELLED с причиной отмены SHOP_FAILED в методе:

   • PUT v2/campaigns/{campaignId}/orders/{orderId}/status — для одного заказа;
   • POST v2/campaigns/{campaignId}/orders/status-update — для нескольких заказов.

   Не передавайте другие статусы.

2. Проверьте статус операции — метод POST v1/businesses/{businessId}/operations.

3. При необходимости проверьте статус заказа: используйте метод POST v1/businesses/{businessId}/orders с фильтром orderIds.