С 31 декабря push-API методы будут недоступны. С 1 октября они могут работать нестабильно.
Обработка заказов с помощью push-компонента
Маркет может сам отправлять вам запросы, когда приходят новые заказы, изменяются их статусы или, например, покупатель отменяет заказ. Чтобы это работало, вам нужно настроить push-компонент API Маркета.
Если push-компонент включен, нужно обязательно отвечать на запросы. Нельзя включить уведомления и не отвечать на них. Пользуйтесь push-компонентом, только если уверены в стабильности своего сервера и системы на нем.
Запросы от Маркета нужно включить в кабинете
Чтобы Маркет начал отправлять вам запросы об изменениях, связанных с заказами, в кабинете продавца на Маркете нажмите на иконку вашего аккаунта → Настройки и в меню слева выберите API и модули. На вкладке Push API активируйте опцию Включить запросы от Маркета.
Если вкладки Push API нет, обратитесь в поддержку и опишите ваши задачи — в кабинете продавца на Маркете выберите Общение → Поддержка → Создать обращение → Работа через API.
⚠️ Делайте это после того как настроите интеграцию и проверите ее на тестовых заказах. Как выполнять отладку на тестовых заказах
Подтверждение получения заказа
Получив оформленный клиентом заказ, Маркет будет отправлять вам запрос на подтверждение заказа POST order/accept.
В order, который приходит в теле запроса, очень много разной информации, предназначенной для решения разных задач и работы по разным моделям. Чтобы обработать заказ, необходима лишь часть из них:
- Идентификатор заказа
id, который вам понадобится в ваших последующих запросах к Маркету. - Список товаров
items, в котором передается список заказанных товаров. В нем для каждого товара вам важны:id— идентификатор конкретного товара в корзине. Понадобится, например, чтобы передать для него коды «Честного знака».shopSKU— идентификатор товара в вашем каталоге, который показывает, что заказали.count— сколько заказано.
- Дата отгрузки
shipmentDate— в эту дату Маркет будет ждать от вас заказ.
Если вы работаете с тестовыми заказами, понадобится еще признак такого заказа — fake.
Просмотрите описания всех полей запроса
Возможно, вы захотите использовать еще какие-то из них немедленно или в будущем, развивая интеграцию.
Дальнейшие шаги
Дальше вам понадобится только pull-компонент API. Просто следуйте основной инструкции по обработке заказов, начиная со второго шага.