Как передавать настройки из своей системы в репрайсеры INDEEPA по API
Для кого: для технических специалистов и менеджеров, которые настраивают автоматическую передачу цен, остатков, себестоимости и других параметров из своей системы в INDEEPA.
Как работает интеграция
Вы размещаете JSON-массив с данными о товарах на своём API-эндпоинте. INDEEPA периодически обращается к указанному URL, получает значения и после проверки применяет их в выбранном репрайсере.
Частота обновления
Для репрайсеров Ozon, WB и ЯМ плановый запрос выполняется каждые 2 часа. Изменение на вашем сервере может появиться в INDEEPA не сразу, а в течение ближайшего цикла синхронизации. Эндпоинт должен быть доступен круглосуточно.
Перед началом
Подготовьте URL эндпоинта, с которого INDEEPA сможет получать данные.
Настройте доступ по Bearer-токену.
Сформируйте валидный JSON-массив с товарами и нужными полями.
Определите маркетплейс: Ozon, WB или ЯМ.
Заранее перечислите дополнительные поля, которых нет в стандартной структуре.
Безопасность токена
Передавайте токен только в официальном чате поддержки INDEEPA. Не размещайте его в открытых документах и не показывайте на скриншотах. Для интеграции лучше использовать отдельный токен, который можно заменить или отозвать без влияния на другие системы.
Шаг 1. Подготовьте эндпоинт
Эндпоинт должен возвращать валидный JSON-массив. Каждый элемент массива — отдельный товар. Пример URL:
https://your-domain.com/api/products.json
Доступ к данным защищается Bearer-токеном. Точный формат заголовка авторизации и дополнительные технические требования подтверждаются при подключении.
Шаг 2. Подготовьте структуру данных
Используйте названия полей в том виде, в котором они указаны ниже. Для дробных значений используйте точку: 150.50. Количество передавайте целым числом: 100.
Общие требования к данным
Дополнительные поля можно не передавать. Заполняйте только значения, которые планируете использовать в INDEEPA. JSON должен быть валидным: со всеми закрывающими скобками, кавычками и запятыми. Нестандартные поля согласуйте до подключения через чат поддержки.
Ozon
Поле
Тип
Обязательность
Что передавать
Article
String
Обязательно
Артикул товара — OfferId.
CostPrice
Float
Необязательно
Себестоимость товара.
RetailPrice
Float
Необязательно
Базовая цена.
WarehouseName
String
Необязательно
Название склада.
Stock
Integer
Необязательно
Количество товара на складе.
Comment
String
Необязательно
Комментарий или внутренний идентификатор.
Пример JSON-массива для Ozon
WB
Для идентификации товара передайте NmId или VendorCode.
Поле
Тип
Обязательность
Что передавать
NmId
Integer
Один из двух
Артикул товара WB.
VendorCode
String
Один из двух
Артикул поставщика; можно использовать вместо NmId.
ChrtId
String
Необязательно
Идентификатор характеристики или размера товара.
CostPrice
Float
Необязательно
Себестоимость товара.
WarehouseName
String
Необязательно
Название склада.
Stock
Integer
Необязательно
Количество товара на складе.
MinPrice
Integer
Необязательно
Минимальная цена.
MaxPrice
Integer
Необязательно
Базовая или максимальная цена.
Пример JSON-массива для WB
Яндекс.Маркет
Поле
Тип
Обязательность
Что передавать
OfferId
String
Обязательно
Артикул товара в ЯМ.
CostPrice
Integer
Необязательно
Себестоимость товара.
WarehouseName
String
Необязательно
Название склада.
Stock
Integer
Необязательно
Количество товара на складе.
MinPrice
Integer
Необязательно
Минимальная цена.
MaxPrice
Integer
Необязательно
Базовая или максимальная цена.
AdditionalField
String
Необязательно
Дополнительная информация, согласованная при подключении.
Пример JSON-массива для ЯМ
Шаг 3. Отправьте запрос в поддержку
Отправьте запрос в службу поддержку INDEEPA. В запросе укажите:
Подключение интеграции по API.
URL вашего эндпоинта, чтобы наша система знала, откуда забирать данные. Пример: https://your-domain.com/api/products.json
Токен доступа (Bearer Authentication). Это современный метод защиты доступа к вашему API с помощью токена (специального ключа). При каждом запросе система автоматически передает этот токен, что позволяет убедиться, что только авторизованные пользователи (в данном случае — наш сервис) могут получить доступ к вашим данным. Пример: a1b2c3d4-e5f6-7890-xxxx-xxxxxxxxxxxx
Маркетплейс. От этого зависит формат данных и процесс подтверждения. Пример: Wildberries/ Ozon/ Яндекс Маркет
Необходимые поля. Какие стандартные и дополнительные поля нужно использовать.
Шаг 4. Дождитесь тестового запроса
После получения данных специалисты INDEEPA:
добавят подключение к вашему эндпоинту;
выполнят тестовый запрос;
проверят, что JSON получен и распознан;
сообщат результат в том же чате.
Дальнейшие действия зависят от вашего маркетплейса.
Подключение "Данных интеграции API"
Если вы подключаете OZON
Специалисты напишут в чат и пришлют ссылку на отчёт.
Вы переходите по ссылке и проверяете: корректно ли система распознала артикулы, цены, остатки.
Если всё верно — отвечаете в чат: «Данные подтверждены, можно активировать».
После вашего подтверждения специалисты активируют интеграцию.
Данные будут обновляться автоматически каждые 2 часа. Вы можете в любой момент посмотреть в отчете, когда последний раз были получены и применены данные.
Отчет доступен для просмотра через репрайсер (альтернатива прямой ссылке):
Перейдите в раздел «Настройки» → «Расширения».
Активируйте ползунок напротив расширения «Информация. Расширения для проверки настроек передачи данных по API».
Перейдите во вкладку «Товары» и найдите нужный артикул, нажмите правой кнопкой мыши в пустом поле его строки и выберите «Настройки передачи данных по API». Это позволит увидеть дату и время последнего обновления, а также при необходимости открыть массив данных для анализа.
Если вы подключаете WB
Специалисты напишут в чат и пришлют ссылку на отчёт.
Вы переходите по ссылке и проверяете: корректно ли система распознала артикулы, цены, остатки.
Если всё верно, активируете применение данных самостоятельно в личном кабинете:
Перейдите в настройки на кабинет;
В столбце «Индивидуальные условия» вы увидите дату последнего забора информации.
Для активации полученных данных поставьте галочку «Использовать данные интеграции АПИ» и нажмите «Сохранить».
Данные будут обновляться автоматически каждые 2 часа. Вы можете в любой момент посмотреть в отчете, когда последний раз были получены и применены данные.
Вы можете в любой момент снять галочку «Использовать данные интеграции АПИ» — данные продолжат забираться, но не будут применяться, пока вы снова не активируете опцию.
Если вы подключаете Яндекс.Маркет
Специалисты напишут в чат: «Данные получены» и попросят подтвердить корректность (текстовым описанием или скриншотом).
Вы проверяете информацию и, если всё верно, отвечаете: «Данные подтверждены, можно активировать».
После вашего подтверждения специалисты активируют интеграцию.
Данные будут обновляться автоматически каждые 2 часа.
На данный момент для Яндекс Маркет отчёт для мониторинга истории обновлений находится в разработке. Отслеживать дату последнего изменения данных через интерфейс пока невозможно. Если вам критично видеть эту информацию — напишите в поддержку, мы предоставим данные вручную по запросу.
ЧАСТО ЗАДАВАЕМЫЕ ВОПРОСЫ (FAQ)
Как часто вы будете запрашивать данные?
Система запрашивает данные каждые 2 часа. Эндпоинт должен быть доступен 24/7 для внеплановых синхронизаций при ручных обновлениях или изменении настроек.
Можно ли отдавать данные только для части товаров?
Да. Вы можете включить в JSON-массив только те товары, которые хотите отслеживать или обновлять через API. По таким товарам будут действовать настройки, заданные вручную в репрайсере. Товары, отсутствующие в выгрузке, не будут затронуты нашей системой.
Что делать, если у товара нет остатка (Stock = 0)?
Если товар закончился, передавайте "Stock": 0. Не удаляйте товар из массива совсем, если хотите, чтобы система знала, что он «в наличии, но закончился», а не «перестал существовать».
Можно ли использовать один эндпоинт для нескольких маркетплейсов?
Технически — да, если структура данных позволяет однозначно определить товар. Однако мы рекомендуем создавать отдельные эндпоинты (разные URL) для каждого маркетплейса (Ozon, WB, ЯМ), чтобы избежать путаницы с полями и упростить отладку.
Что если мне нужно передать поле, которого нет в стандартном списке?
Напишите об этом в запросе в техническую поддержку: укажите название поля, его тип и для чего оно нужно. Наши специалисты проверят возможность и согласуют формат. Не добавляйте кастомные поля без согласования — они могут быть проигнорированы системой.
Последнее обновление
Это было полезно?