Пятый фактор Обсудить задачу
CRM, 1С и интеграции

Переход каталога Яндекс Маркета с offer-mapping-entries

Переход каталога Яндекс Маркета с offer-mapping-entries восстанавливает обмен товарами после удаления устаревших методов. 12 марта 2026 года Маркет удалил GET /v2/campaigns/{campaignId}/offer-mapping-entries, POST /offer-mapping-entries/updates и POST /offer-mapping-entries/suggestions.

Актуальная модель работает на уровне кабинета продавца: товары читаются через POST /v2/businesses/{businessId}/offer-mappings, а добавляются и обновляются через POST /v2/businesses/{businessId}/offer-mappings/update. Новый запрос использует offerId из вашей системы, данные товара, категорию Маркета, parameterValues и при необходимости mapping с marketSku.

Для проверки заполненности и категорийных характеристик используются методы offer-cards, дерева категорий и параметров категории. Мы находим все места, где старый ответ превращается в товар, связь с карточкой, цену, изображение или статус синхронизации. Затем создаём новую карту данных, связываем campaignId с businessId и обновляем пакетную обработку.

Особое внимание получает onlyPartnerMediaContent: его значение влияет на использование изображений, добавленных Маркетом, поэтому настройка фиксируется осознанно. На контрольной выборке сравниваем offerId, marketSku, категорию, основные характеристики, цену и медиа. После запуска журнал показывает кабинет, порцию, товар, операцию и результат проверки.

Срок: 10 рабочих дней

Когда стоит обратиться

Обычно к нам обращаются в таких ситуациях:

  • Интеграция получает 404 или перестала обновлять каталог после удаления offer-mapping-entries.
  • В коде используются campaignId и методы /offer-mapping-entries/updates или /suggestions.
  • Товары читаются из Маркета, а связи offerId, marketSku и категорий хранятся в собственной системе.
  • После частичного перехода характеристики, изображения или цены обновляются в другом кабинете либо карточке.

Что именно мы сделаем

01

Находим вызовы offer-mapping-entries и все таблицы, экраны и задания, которые используют старый ответ.

02

Связываем магазины campaignId с кабинетом businessId и строим карту полей актуального каталога.

03

Подключаем чтение offer-mappings, обновление offer-mappings/update и категорийные parameterValues.

04

Проверяем карточки, mapping, цены, изображения, пакетную загрузку и обработку ошибок товара.

05

Переключаем синхронизацию и передаём карту методов, протокол и инструкцию контроля каталога.

Что входит в стоимость

59 900 ₽ за всю работу

Находим вызовы offer-mapping-entries, локальные таблицы сопоставлений, campaignId и зависимые задания. Переводим модель каталога на businessId и актуальные методы offer-mappings, обновляем получение, добавление, изменение и категорийные характеристики. Отдельно разбираем прежний сценарий suggestions, параметры карточки и работу изображений. Сверяем товарную выборку, выполняем контрольное обновление и запускаем рабочую синхронизацию с журналом.

Что будет готово

Материалы

Передадим вам

  • Рабочая синхронизация каталога через актуальные методы offer-mappings на уровне businessId.
  • Карта campaignId, businessId, offerId, marketSku, категорий и полей товарной системы.
  • Пакетное обновление товаров и parameterValues с журналом ошибок и предупреждений.
  • Протокол контрольных карточек и инструкция по категориям, mapping, ценам и изображениям.
Проверка

Перед сдачей проверим

  • Интеграция читает полный выбранный каталог кабинета и связывает каждый товар с исходным offerId.
  • Контрольный товар создаётся или обновляется через offer-mappings/update с правильной категорией и характеристиками.
  • MarketSku, mapping, цена и изображения совпадают с утверждённым сценарием в кабинете Маркета.
  • Повтор пакета обновляет существующие товары, а журнал показывает результат и поля с замечаниями API.

Как это выглядит на практике

Схема перехода каталога Яндекс Маркета с offer-mapping-entries на offer-mappings

Товар из PIM получает актуальную карточку Яндекс Маркета

  1. 01

    PIM передаёт offerId, название, описание, изображения и внутреннюю категорию товара.

  2. 02

    Интеграция выбирает категорию Маркета, сопоставляет parameterValues и формирует пакет update по businessId.

  3. 03

    Маркет возвращает карточку и mapping, которые сохраняются рядом с товаром в PIM.

  4. 04

    Повторное чтение offer-mappings подтверждает цену, характеристики, изображения и устойчивую связь offerId.

Что понадобится для работы

От вас

  • Код, модуль или журнал интеграции с вызовами offer-mapping-entries и описанием расписания.
  • API-Key либо действующий токен Partner API с доступом к кабинету и управлению товарами.
  • Список businessId, campaignId и контрольные товары разных категорий и состояний карточки.
  • Схема PIM, 1С, ERP или CMS с offerId, характеристиками, ценами, изображениями и текущими mapping.

Если у вас немного другая ситуация

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

Стоимость работ 59 900 ₽ полная стоимость известна заранее
  1. 3 000 ₽после подписания договора через Диадок
  2. 56 900 ₽после выполнения, демонстрации и приёмки результата

Предоплата входит в общую стоимость. Оставшуюся сумму оплачиваете после демонстрации и приёмки готовой работы.

Часто спрашивают

Об этой услуге

Когда Яндекс Маркет удалил методы offer-mapping-entries?

Устаревшие GET offer-mapping-entries, POST updates и POST suggestions удалены 12 марта 2026 года согласно журналу изменений Partner API.

Какой метод используется для чтения каталога сейчас?

Товары кабинета читаются через POST /v2/businesses/{businessId}/offer-mappings. Запрос работает на уровне businessId и поддерживает выбор контрольных товаров или всего каталога.

Как теперь добавлять и обновлять товары?

Для этого используется POST /v2/businesses/{businessId}/offer-mappings/update. Метод принимает offerId, данные товара, категорию, характеристики, цены и mapping по выбранному сценарию.

Чем businessId отличается от campaignId в этой миграции?

campaignId относится к конкретному магазину, а актуальный каталог управляется на уровне кабинета businessId. Мы создаём явную связь магазинов с кабинетом и обновляем конфигурацию заданий.

Как передаются характеристики категории Маркета?

Значения помещаются в parameterValues с идентификатором параметра и подходящим значением. Допустимые поля и варианты берутся из методов категории и проверяются через offer-cards.

Что происходит со старым сценарием suggestions?

Его заменяет работа с актуальными методами категорий, параметров, offer-cards и mapping. Выбор получает понятные правила и подтверждается на контрольных товарах.

Как сохранить изображения, добавленные Маркетом?

Настраиваем onlyPartnerMediaContent осознанно. При значении true Маркет использует только медиа продавца, поэтому перед выпуском сравниваем текущие pictures и выбранную политику изображений.

Как принимается переход каталога?

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

Цена и изменения по ходу работы

Цена на странице окончательная?

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

Что означает резерв незапланированных работ?

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

Резерв рассчитывается по формуле: стоимость услуги × 30% ÷ 1 500 ₽. Для услуги за 30 000 ₽ это 6 часов. Эти часы относятся только к дополнительным, заранее незапланированным уточнениям. Они не являются сроком проекта и не ограничивают время на основную работу: согласованный результат мы выполняем полностью.

Можно уточнять детали уже во время работы?

Да. Небольшие связанные изменения обычно помещаются во включённый резерв и не требуют доплаты. Если новая идея заметно меняет результат или превращается в самостоятельную задачу, сначала обсудим подход и стоимость. Любое решение согласуем до выполнения.

Начало работы и оплата

Как оформляются договор и оплата?

Подписываем договор через Диадок. Предоплата составляет 3 000 ₽ и входит в общую стоимость услуги. Остаток оплачивается после демонстрации и приёмки готового результата.

Когда начинается срок выполнения?

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

Как учитываются платные лицензии и внешние сервисы?

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

Проверка результата и гарантия

Как принимается готовая работа?

Вместе проверяем согласованные сценарии на контрольных данных или тестовой копии, а затем демонстрируем результат. Для интеграций сверяем передачу данных и обработку ошибок, для сайта — работу нужных страниц и действий пользователя, для отчёта — расчёты и обновление данных.

Какая гарантия действует после сдачи?

На выполненные изменения действует гарантия 3 месяца. Если в изменённой нами части обнаружится ошибка нашей реализации, проверим и исправим её без дополнительной оплаты. Переданные материалы, настройки и код остаются у заказчика.

Следующий шаг

Опишите задачу

Опишите задачу и желаемый результат. Можно указать сайт, CMS, 1С, CRM, ERP или другую систему — разберёмся в ситуации и предложим подходящий следующий шаг.

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