Содержание
Категория для Assortment API Мегамаркета: проверьте шестой уровень
Специалист нашёл в дереве Мегамаркета подходящее название и передал его ID при подготовке карточки. До массовой загрузки проверьте уровень категории: знакомое название родительской ветки ещё не означает, что в ней можно создавать товар.
Получите дерево нужного API
В документации Assortment API Мегамаркета дерево описано как иерархия с первого по шестой уровень. Создание товара предусмотрено только в категории шестого уровня. Этот порядок относится к Assortment API, а не к произвольному файлу или старому интерфейсу кабинета.
Попросите специалиста интеграции получить актуальное дерево предусмотренным методом GET /api/merchantIntegration/assortment/v1/categoryTree/get. Для выбора ветки запишите товар, его назначение и ключевые характеристики. Не используйте только название из прайса поставщика: оно может не уточнять вид товара.
Доступ к API проверяется отдельно. Секрет X-Merchant-Token не нужен в рабочем реестре сопоставлений; достаточно указать источник дерева, дату получения и ответственного специалиста.
Проверьте путь и уровень
У категории в примере ответа есть id, name и level, а вложенные категории находятся в children. Сохраните полный путь выбранной ветки вместе с конечным ID. Это помогает разобрать выбор, когда похожие названия встречаются на разных уровнях.
Не определяйте уровень только числом вложений в показанном фрагменте. Смотрите значение level и описание конкретного ответа. Если копия дерева неполная, получите недостающие данные, прежде чем подставлять ID в карточку.
| Что сохранить | Что проверяет |
|---|---|
| Код товара продавца | К какому предложению относится выбор |
| Путь категории | Почему выбрана именно эта ветка |
ID и level конечной категории | Не передан ли ID родительского уровня |
| Дата и источник дерева | На какой версии основано сопоставление |
Таблица является рекомендуемым внутренним реестром. Она не заменяет запросы и формат карточки, описанные в API.
Не путайте усечённое дерево с полным
У API также есть запрос списка категорий первого уровня и получение вложенных категорий выбранной ветки. Для последнего документация описывает skipIntermediateCategory: при true возвращаются только категории шестого уровня, при false сохраняются уровни с первого по шестой.
Поэтому короткий список из выгрузки может быть результатом фильтрации, а не исчезновения категорий. Перед выводом об ошибке дерева сохраните использованный метод и параметры. Если для команды важен путь, используйте ответ, позволяющий его восстановить, а не угадывайте родителей по названиям.
Проверьте требования карточки отдельно
Правильная категория не делает все атрибуты заполненными. Документация отдельно предупреждает: для создания карточки достаточно offerId, но для публикации нужны непустые значения обязательных атрибутов с isRequired: true. Неверно заполненная карточка может быть создана без публикации на витрине.
До массовой отправки согласуйте с интегратором перечень обязательных атрибутов выбранной категории и источник каждого значения. Не заполняйте неизвестную характеристику данными соседнего товара только ради успешной проверки.
После обработки проверьте конкретную карточку и замечания к ней. Сохранённый ID или успешный ответ на создание сами по себе не подтверждают доступность товара покупателю. Если причина связана с категорией, передайте специалисту путь, ID, уровень, отправленные данные и ответ обработки.
Результат подготовки: у товара есть подтверждённая категория шестого уровня, объяснимый путь выбора и список обязательных сведений. Только после этого переносите сопоставление на остальные товары с теми же проверенными признаками.
Комментарии 0