Идентификатор публикации Ozon: что это и где найти

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

⚠️ Внимание: При обновлении информации о товаре через API никогда не используйте название товара как ключевой идентификатор. Названия могут содержать пробелы, спецсимволы или быть изменены модерацией, что приведет к рассинхронизации. Используйте только числовой ID или связку артикулов.

Использование идентификатора в API и автоматизации

Для разработчиков и владельцев бизнеса, внедряющих автоматизацию, идентификатор публикации является ключевым элементом. Большинство методов API Ozon требуют передачи этого параметра для выполнения действий с товаром: изменение цены, обновление остатков, получение информации о рейтинге или ответах на отзывы.

Рассмотрим типичный сценарий: вам нужно обновить цену на товар. Вы не можете просто сказать системе «измени цену на товар "Футболка"». Вам нужно отправить запрос, в теле которого будет указан product_id (идентификатор публикации) и новая цена. Это гарантирует, что изменение применится именно к той карточке, которую вы планировали, даже если в вашем каталоге есть товары с похожими названиями.

При работе с методом POST /v2/product/info вы можете получить детальную информацию о товаре, передав в запросе его ID. Ответ сервера придет в формате JSON, где в поле id будет содержаться искомое числовое значение. Это основной способ программной верификации существования карточки в системе.

{
"result": {
"id": 73920184,
"name": "Смартфон XYZ",
"offer_id": "SELLER-SKU-001",
"price": {
"price": "15000",
"currency_code": "RUB"
}
}
}

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

• 🔄 Для обновления остатков используйте метод /v2/stocks, передавая список объектов с полями product_id и present.
• 📉 Для получения истории изменений цены также потребуется указать ID публикации в соответствующих фильтрах запроса.
• 📦 При формировании заданий на отгрузку на FBO идентификатор помогает точно определить, какой именно товар упаковывать, если артикулы визуально похожи.

Типичные ошибки при работе с идентификаторами

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

Еще одна распространенная проблема — использование старых идентификаторов. Если карточка товара была удалена и создана заново (например, из-за блокировки или ошибки модерации), она получит новый ID публикации, даже если артикул продавца и штрихкод останутся прежними. Попытка обновить остатки по старому ID приведет к ошибке «Товар не найден», что может остановить продажи.

Чтобы избежать этих проблем, рекомендуется вести локальный реестр. Это может быть простая Google-таблица или база данных, где хранятся три колонки: Артикул продавца, Название товара и ID публикации Ozon. Регулярно (раз в неделю или месяц) обновляйте этот файл, сверяя данные через API или выгрузку.