Переход интеграции Яндекс Маркета на Business Orders API
Переводим получение заказов Яндекс Маркета с устаревших магазинных методов на актуальный Business Orders API — POST v1/businesses/{businessId}/orders. Новый коннектор получает заказы на уровне кабинета, обходит страницы через pageToken, учитывает кампании и модели продаж и переносит данные в CRM, OMS, WMS или учётную систему. Перед переключением оба потока сравниваются на контрольном периоде, а уведомления дополняются регулярной сверкой.
Когда стоит обратиться
Обычно к нам обращаются в таких ситуациях:
- Интеграция использует GET v2/campaigns/{campaignId}/orders или получение отдельного заказа, которые Яндекс Маркет пометил устаревшими.
- В одном кабинете работает несколько магазинов, а действующий коннектор опрашивает каждую кампанию отдельным кодом и расписанием.
- CRM получает заказы и изменения статусов с задержкой, а после временной ошибки API сотрудникам приходится вручную искать пропущенный период.
- Самописный модуль давно оставался без обновления и с трудом обрабатывает возвраты, новые статусы, маркировку или разные модели FBY, FBS, DBS и Экспресс.
Что именно мы сделаем
Находим старые методы заказов, связанные расписания, уведомления и преобразования в учётной системе.
Настраиваем businessId, campaignId и API-Key с подходящими правами для выбранных магазинов.
Создаём кабинетную выборку с фильтрами, интервалами до 30 дней, pageToken и устойчивой повторной обработкой.
Сравниваем старый и новый потоки, проверяем тестовые заказы и переключаем интеграцию с мониторингом.
Что входит в стоимость
69 900 ₽ за всю работу
Аудируем старые методы, токен, кампании и преобразование заказов. Настраиваем Business Orders API, интервалы до 30 дней, pageToken, фильтры и идемпотентность, связываем уведомления с резервным опросом, сравниваем потоки и проводим тестовые заказы перед переключением.
Что будет готово
Передадим вам
- Рабочий коннектор Business Orders API на POST v1/businesses/{businessId}/orders для выбранных магазинов.
- Обработка диапазонов дат, pageToken, повторов, лимитов и точки продолжения с диагностическим журналом.
- Приёмник API-уведомлений, резервный опрос и идемпотентное обновление заказов во внутренней системе.
- Таблица соответствия полей, отчёт параллельной сверки и инструкция по мониторингу и повторной загрузке.
Перед сдачей проверим
- Новый метод получает за контрольный период заказы всех выбранных кампаний и проходит каждую страницу до конца.
- Количество, суммы, позиции и статусы контрольной выборки сходятся с кабинетом Маркета и исходным потоком по выбранным правилам.
- Уведомление и последующий опрос обновляют внутренний заказ один раз, сохраняя campaignId и программу продаж.
- Тест с разрывом соединения продолжает загрузку с сохранённой точки, а временная ошибка и неизвестный статус отражаются в журнале.
Как это выглядит на практике
Три магазина переходят на единый кабинетный поток
В одном кабинете продавца работают три магазина по FBS и DBS. Старый модуль опрашивал каждую кампанию отдельно и после сбоя расписания пропустил несколько изменений. Новый адаптер запросил обновлённые заказы на уровне businessId, прошёл все страницы по pageToken и сохранил campaignId в каждой карточке OMS. API-уведомление ускорило обновление отмены, а ночная сверка подтвердила полноту периода. Перед рабочим переключением результаты двух потоков сравнили по количеству, суммам и статусам.
- 01
Собираем businessId и три campaignId и получаем контрольную выборку нового метода.
- 02
Проходим все страницы, сохраняем магазин и программу продаж в каждой внутренней карточке.
- 03
Обрабатываем тестовую отмену по уведомлению и подтверждаем её резервным опросом.
- 04
Сравниваем оба потока по заказам, суммам и статусам и переключаем расписание.
Что понадобится для работы
От вас
- Исходный код или настройки текущей интеграции, тестовый контур и журналы обмена.
- API-Key Яндекс Маркета с подходящими правами, businessId и перечень campaignId.
- Описание моделей FBY, FBS, DBS или Экспресс и зависимых процессов во внутренней системе.
- Контрольный период с заказами разных статусов и сотрудник для сверки с кабинетом.
Если у вас немного другая ситуация
Небольшие уточнения, которые помогают довести согласованный результат до рабочего состояния, уже учитываем в цене. Если по ходу работы появится отдельный крупный блок или понадобится платная лицензия, сначала обсудим варианты и стоимость. Расскажите о своей ситуации — подстроим план под неё.
- 3 000 ₽после подписания договора через Диадок
- 66 900 ₽после выполнения, демонстрации и приёмки результата
Предоплата входит в общую стоимость. Оставшуюся сумму оплачиваете после демонстрации и приёмки готовой работы.
Часто спрашивают
Об этой услуге
Почему переход на Business Orders API уже актуален?
Яндекс Маркет пометил методы GET v2/campaigns/{campaignId}/orders и отдельного заказа устаревшими и указывает POST v1/businesses/{businessId}/orders как замену. Спокойная миграция даёт время сопоставить поля и проверить заказы до окончательного отключения старых вызовов.
Подходит ли новый метод для нескольких магазинов?
Да. Запрос работает на уровне кабинета и поддерживает фильтр по campaignId. Во внутренней системе мы сохраняем идентификатор конкретной кампании, поэтому единый коннектор распределяет заказы по нужным складам и учётным контурам.
Заменяют ли API-уведомления регулярный опрос?
Уведомление помогает быстро отреагировать на событие, а контрольный опрос подтверждает полноту после временного сбоя сети или приёмника. Вместе эти механизмы дают быстрый и проверяемый поток изменений.
Сохранятся ли доработки нашей CRM, OMS или 1С?
Адаптер преобразует кабинетный ответ в действующую внутреннюю модель. Прикладные правила сохраняются, а изменения затрагивают места, где новый API требует businessId, campaignId, другую пагинацию или расширенный состав данных.
Цена и изменения по ходу работы
Цена на странице окончательная?
Да. Перед началом мы сверяем исходные данные и фиксируем результат в договоре. Указанная на странице сумма покрывает согласованную работу целиком, даже если её техническая реализация потребует больше времени, чем ожидалось при оценке.
Что означает резерв незапланированных работ?
Это уже включённый в цену запас времени на небольшие связанные уточнения заказчика, которые появляются после старта: например, добавить поле, изменить формат уведомления или учесть ещё одно условие обработки.
Резерв рассчитывается по формуле: стоимость услуги × 30% ÷ 1 500 ₽. Для услуги за 30 000 ₽ это 6 часов. Эти часы относятся только к дополнительным, заранее незапланированным уточнениям. Они не являются сроком проекта и не ограничивают время на основную работу: согласованный результат мы выполняем полностью.
Можно уточнять детали уже во время работы?
Да. Небольшие связанные изменения обычно помещаются во включённый резерв и не требуют доплаты. Если новая идея заметно меняет результат или превращается в самостоятельную задачу, сначала обсудим подход и стоимость. Любое решение согласуем до выполнения.
Начало работы и оплата
Как оформляются договор и оплата?
Подписываем договор через Диадок. Предоплата составляет 3 000 ₽ и входит в общую стоимость услуги. Остаток оплачивается после демонстрации и приёмки готового результата.
Когда начинается срок выполнения?
Срок отсчитывается после согласования задачи, получения необходимых доступов и материалов, подписания договора и поступления предоплаты. Конкретную дату старта и плановый день готовности подтверждаем перед началом.
Как учитываются платные лицензии и внешние сервисы?
До старта проверяем, нужны ли тарифы, лицензии, сертификаты или дополнительные ресурсы внешних систем. Если они потребуются, заранее покажем варианты и стоимость. По возможности аккаунты и лицензии оформляются сразу на заказчика.
Проверка результата и гарантия
Как принимается готовая работа?
Вместе проверяем согласованные сценарии на контрольных данных или тестовой копии, а затем демонстрируем результат. Для интеграций сверяем передачу данных и обработку ошибок, для сайта — работу нужных страниц и действий пользователя, для отчёта — расчёты и обновление данных.
Какая гарантия действует после сдачи?
На выполненные изменения действует гарантия 3 месяца. Если в изменённой нами части обнаружится ошибка нашей реализации, проверим и исправим её без дополнительной оплаты. Переданные материалы, настройки и код остаются у заказчика.