Карантин цен через API Маркета: проверьте область подтверждения

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

Зафиксируйте согласованную область

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

Если согласование относится только к одному магазину, не переносите его автоматически на весь кабинет. Передайте интегратору именно это ограничение вместе с перечнем товаров.

Прочитайте путь метода

В документации Маркета метод POST v2/businesses/{businessId}/price-quarantine/confirm подтверждает цену во всех магазинах. Он доступен для FBY, FBS, Экспресс и DBS. Для API-Key требуется доступ pricing либо all-methods.

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

Сверьте список offerIds

Тело запроса содержит offerIds: ваши SKU, а не идентификаторы карточек каталога Маркета. По контракту в списке от 1 до 200 уникальных значений. Пробелы по краям SKU удаляются автоматически.

Проверьте выгрузку до отправки:

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

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

Отправьте и сохраните ответ

Документация определяет HTTP 200 как подтверждение цен; стандартный успешный ответ содержит status: OK. Сохраните время, путь метода, businessId, точный список SKU и ответ без секретного токена. Так можно связать согласование с фактически выполненной операцией.

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

Проверьте результат в магазинах

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

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