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

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

С помощью партнерского API вы можете обрабатывать заказы, поступающие от пользователей Маркета. Процесс обработки заказов предполагает обмен данными между Маркетом и магазином. Запросы могут поступать как от Маркета к магазину, так и от магазина к Маркету. В данном разделе описаны ресурсы API для обмена данными по заказам.

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

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


Метод	Краткое описание
`POST /cart`	Запрашивает у магазина информацию о товарах в корзине.
`POST /order/accept`	Передает заказ магазину и запрашивает у магазина подтверждение принятия заказа.
`POST /order/status`	Уведомляет магазин о смене статуса заказа.


Метод	Краткое описание
`POST /cart`	Запрашивает у магазина информацию о товарах в корзине.
`POST /order/accept`	Передает заказ магазину и запрашивает у магазина подтверждение принятия заказа.
`POST /order/status`	Уведомляет магазин о смене статуса заказа.

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

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


Метод	Краткое описание
`PUT /campaigns/{campaignId}/orders/{orderId}/status`	Изменяет статус заказа: в обработке (готов к отправке/отгружен) или отменен (магазин не может выполнить заказ).
`POST /campaigns/{campaignId}/orders/status‑update`	Изменяет статусы нескольких заказов: в обработке (готов к отправке/отгружен) или отменен (магазин не может выполнить заказ).
`PUT /campaigns/{campaignId}/orders/{orderId}/cis`	Передает Маркету коды идентификации товаров, чтобы Маркет указал коды в чеке.
`PUT /campaigns/{campaignId}/orders/{orderId}/items`	Изменяет состав заказа, если покупатель уменьшил количество товара или магазин не может поставить все товары в заказе.
`PUT /campaigns/{campaignId}/orders/{orderId} /delivery/shipments/{shipmentId}/boxes`	Передает Маркету информацию о распределении товаров, входящих в заказ, по грузовым местам.
`GET /campaigns/{campaignId}/orders/{orderId} /delivery/labels`	Возвращает ярлыки‑наклейки на все грузовые места в заказе в виде PDF‑файла.
`GET /campaigns/{campaignId}/orders/{orderId} /delivery/shipments/{shipmentId}/boxes/{boxId}/label`	Возвращает ярлык‑наклейку на отдельное грузовое место в заказе в виде PDF‑файла.
`GET /campaigns/{campaignId}/orders/{orderId} /delivery/labels/data`	Возвращает информацию на ярлыках, которые клеятся на грузовые места в заказе.
`GET /campaigns/{campaignId}/shipments /reception-transfer-act`	Формирует акт приема-передачи заказов, отгружаемых в сортировочный центр / пункт приема или курьерам Маркета сегодня, и возвращает акт в формате PDF.
`GET /campaigns/{campaignId}/orders/{orderId}`	Запрашивает информацию о конкретном заказе, оформленном в магазине на Маркете.
`GET /campaigns/{campaignId}/orders`	Запрашивает информацию о заказах, оформленных в магазине на Маркете.
`GET /delivery/services`	(Опциональный.) Возвращает справочник служб доставки: идентификаторы и наименования.


Метод	Краткое описание
`PUT /campaigns/{campaignId}/orders/{orderId}/status`	Изменяет статус заказа: в обработке (готов к отправке/отгружен) или отменен (магазин не может выполнить заказ).
`POST /campaigns/{campaignId}/orders/status‑update`	Изменяет статусы нескольких заказов: в обработке (готов к отправке/отгружен) или отменен (магазин не может выполнить заказ).
`PUT /campaigns/{campaignId}/orders/{orderId}/cis`	Передает Маркету коды идентификации товаров, чтобы Маркет указал коды в чеке.
`PUT /campaigns/{campaignId}/orders/{orderId}/items`	Изменяет состав заказа, если покупатель уменьшил количество товара или магазин не может поставить все товары в заказе.
`PUT /campaigns/{campaignId}/orders/{orderId} /delivery/shipments/{shipmentId}/boxes`	Передает Маркету информацию о распределении товаров, входящих в заказ, по грузовым местам.
`GET /campaigns/{campaignId}/orders/{orderId} /delivery/labels`	Возвращает ярлыки‑наклейки на все грузовые места в заказе в виде PDF‑файла.
`GET /campaigns/{campaignId}/orders/{orderId} /delivery/shipments/{shipmentId}/boxes/{boxId}/label`	Возвращает ярлык‑наклейку на отдельное грузовое место в заказе в виде PDF‑файла.
`GET /campaigns/{campaignId}/orders/{orderId} /delivery/labels/data`	Возвращает информацию на ярлыках, которые клеятся на грузовые места в заказе.
`GET /campaigns/{campaignId}/shipments /reception-transfer-act`	Формирует акт приема-передачи заказов, отгружаемых в сортировочный центр / пункт приема или курьерам Маркета сегодня, и возвращает акт в формате PDF.
`GET /campaigns/{campaignId}/orders/{orderId}`	Запрашивает информацию о конкретном заказе, оформленном в магазине на Маркете.
`GET /campaigns/{campaignId}/orders`	Запрашивает информацию о заказах, оформленных в магазине на Маркете.
`GET /delivery/services`	(Опциональный.) Возвращает справочник служб доставки: идентификаторы и наименования.