Сообщения карточки Маркета в API: разделите errors и warnings

В отчёте интеграции появились сообщения по карточке Маркета. До массового исправления разделите ошибки, предупреждения и состояние проверки. Сообщение в ответе API ещё не объясняет, почему конкретное предложение недоступно покупателю.

Метод getOfferCardsContentStatus возвращает состояние контента товаров. В его описании errors обозначает ошибки контента, препятствующие размещению на витрине, а warnings предупреждения, которые размещению не препятствуют. Это различие относится к контенту карточки и не заменяет проверку условий продажи.

Соберите ответ по нужному товару

Передайте специалисту идентификатор кабинета и точный offerId спорного товара. Сохраните время запроса и исходный ответ. Не объединяйте сообщения разных SKU только потому, что у них одинаковое название.

Метод использует POST /v2/businesses/{businessId}/offer-cards. В документации доступны права на просмотр товаров и карточек; для диагностики не требуется автоматически расширять токен до полного управления кабинетом. Проверку доступа согласуйте с владельцем интеграции.

Попросите выгрузить для выбранного товара cardStatus, errors и warnings отдельными колонками. Сохраните текст message и comment, если они возвращены. Одна общая колонка «ошибка» скрывает различие между блокирующим замечанием и рекомендацией к доработке.

Прочитайте статус до повторной отправки

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

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

Проверьте исправление по тому же offerId

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

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

Отдельно проверьте продажу

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

В результате у каждой строки очереди должны быть точный SKU, состояние карточки, раздельные ошибки и предупреждения, ответственный и следующий шаг. Так блокирующая проблема не потеряется среди улучшений контента, а ещё не завершённая проверка не станет поводом для бесконечного повторения отправки.