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

Внимание. Маркет постепенно перестает поддерживать XML. Поэтому мы рекомендуем переходить на JSON. Сейчас XML можно использовать, если добавить в запрос Content-Type: application/xml. Без этого будут ошибки.

Размещение товаров на Маркете по модели DBS предполагает обмен данными между Маркетом, где пользователь оформляет заказ, и магазином. Запросы могут поступать как от Маркета к магазину, так и от магазина к Маркету. В данном разделе описаны ресурсы API для обмена данными по заказам.

Список запросов

Запросы, которые Маркет отправляет магазину:

Метод

Краткое описание

POST /cart

Запрашивает у магазина информацию о товарах в корзине.

POST /order/accept

Передает заказ магазину и запрашивает у магазина подтверждение принятия заказа.

POST /order/status

Уведомляет магазин о смене статуса заказа.

POST /order/cancellation/notify

Уведомляет магазин об отмене заказа покупателем.

Запросы, которые Маркет отправляет магазину:

Метод

Краткое описание

POST /cart

Запрашивает у магазина информацию о товарах в корзине.

POST /order/accept

Передает заказ магазину и запрашивает у магазина подтверждение принятия заказа.

POST /order/status

Уведомляет магазин о смене статуса заказа.

POST /order/cancellation/notify

Уведомляет магазин об отмене заказа покупателем.

Магазин должен уметь обрабатывать данные запросы и возвращать корректный ответ. Формат ответа и обязательные параметры описаны на страницах ресурсов.

Запросы, которые магазин отправляет Маркету:

Метод

Краткое описание

PUT /campaigns/{campaignId}/orders/{orderId}/status

Изменяет статус заказа: в обработке (готов к отправке/отгружен) или отменен (магазин не может выполнить заказ).

PUT /campaigns/{campaignId}/orders/{orderId}/delivery/date

Изменяет дату доставки заказа: покупатель просил перенести дату, или магазин не может доставить в текущие даты.

PUT /campaigns/{campaignId}/orders/{orderId}/items

Изменяет состав заказа: покупатель уменьшил количество товара, или магазин не может доставить все заказанные товары.

PUT /campaigns/{campaignId}/orders/{orderId}/cis

Передает коды идентификации товаров, чтобы Маркет указал коды в чеке.

GET /campaigns/{campaignId}/orders/{orderId}

Запрашивает информацию о конкретном заказе в магазине на Маркете.

GET /campaigns/{campaignId}/orders

Запрашивает информацию о заказах с товарами магазина.

GET /delivery/services

Возвращает справочник служб доставки: идентификаторы и наименования.

POST /campaigns/{campaignId}/orders/{orderId}/delivery/track

Передает Маркету трек‑номер, по которому покупатель может отследить посылку со своим заказом через службу доставки.

PUT /campaigns/{campaignId}/orders/{orderId}/cancellation/accept

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

PUT /campaigns/{campaignId}/orders/{orderId}/delivery/storage-limit

Продлевает срок хранения заказа в пункте выдачи.

Запросы, которые магазин отправляет Маркету:

Метод

Краткое описание

PUT /campaigns/{campaignId}/orders/{orderId}/status

Изменяет статус заказа: в обработке (готов к отправке/отгружен) или отменен (магазин не может выполнить заказ).

PUT /campaigns/{campaignId}/orders/{orderId}/delivery/date

Изменяет дату доставки заказа: покупатель просил перенести дату, или магазин не может доставить в текущие даты.

PUT /campaigns/{campaignId}/orders/{orderId}/items

Изменяет состав заказа: покупатель уменьшил количество товара, или магазин не может доставить все заказанные товары.

PUT /campaigns/{campaignId}/orders/{orderId}/cis

Передает коды идентификации товаров, чтобы Маркет указал коды в чеке.

GET /campaigns/{campaignId}/orders/{orderId}

Запрашивает информацию о конкретном заказе в магазине на Маркете.

GET /campaigns/{campaignId}/orders

Запрашивает информацию о заказах с товарами магазина.

GET /delivery/services

Возвращает справочник служб доставки: идентификаторы и наименования.

POST /campaigns/{campaignId}/orders/{orderId}/delivery/track

Передает Маркету трек‑номер, по которому покупатель может отследить посылку со своим заказом через службу доставки.

PUT /campaigns/{campaignId}/orders/{orderId}/cancellation/accept

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

PUT /campaigns/{campaignId}/orders/{orderId}/delivery/storage-limit

Продлевает срок хранения заказа в пункте выдачи.