API остатков Маркета: сначала проверьте группы складов

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

Какую ветку документации выбрать

В официальной инструкции Маркета указаны две ветки:

Для группы инструкция предписывает передавать остатки одному любому складу: остальные склады группы обновятся автоматически. Это правило относится к группе Маркета. Не переносите его на произвольные склады вашей учётной системы.

Ветка без групп включает получение складов через POST v3/businesses/{businessId}/warehouses, передачу количества и при необходимости чтение остатков через POST v3/businesses/{businessId}/offers/stocks.

Что передать специалисту до изменения обмена

Подготовьте таблицу по фактическому кабинету, а не по названиям настроек старого модуля. Рекомендуем зафиксировать:

• идентификатор кабинета и магазина;
• наличие групп и состав нужной группы;
• идентификаторы складов Маркета и их соответствие складам учёта;
• текущий HTTP-метод и путь запроса из журнала интеграции;
• SKU и ожидаемое доступное количество на выбранный момент.

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

Проверка запроса без групп

Описание метода передачи ограничивает его моделями FBS, Экспресс и DBS и кабинетами без групп. В каждой записи передаются sku, partnerWarehouseId и count; пары SKU и склада внутри запроса должны быть уникальны. Значение count означает доступное количество. SKU с ведущим нулём нельзя подменять числом без этого нуля.

Время updatedAt имеет формат ISO 8601 с часовым поясом. Если его не передать, используется текущее время. Обновление каталога занимает несколько минут.

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

Как принять результат

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

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