ERP, PIM и API
Интеграция ERP, PIM и собственной системы с Яндекс KIT
API Яндекс KIT позволяет обновлять товары, цены и остатки и работать с заказами. В проекте определяем владельца данных, сопоставление сущностей, обработку конфликтов и контроль ошибок до публикации неверного остатка.
Фиксируем владельца данных
Для каждого объекта выбираем одну систему записи и правила приоритета.
- Товары, названия, описания, изображения и характеристики — ERP, PIM или KIT.
- Цены — один источник и расписание обновления.
- Остатки и склады — ключи склада, допустимая задержка и действие при нулевом значении.
- Категории и варианты — правила создания, переименования и удаления.
- Заказы и статусы — кто принимает заказ, кто меняет статус и что возвращается в KIT.
Идентификаторы и границы записи
Для каждой сущности нужен устойчивый ключ: артикул, штрихкод, внешний ID или согласованный состав полей. По ключу система должна понимать, обновляет она существующий товар или создаёт новый. Ошибка здесь превращает повторную выгрузку в дубликаты.
Прописываем поля, которые внешняя система может перезаписывать в KIT. Например, PIM может владеть описанием и изображениями, а SEO-заголовок редактируется в KIT.
Как выглядит рабочий обмен
Подготовить данные
Нормализуем сущности, проверяем обязательные поля и отбрасываем записи без надёжного идентификатора.
Отправить изменения
Выбираем частоту, размер пакета и порядок обновления так, чтобы цена не ушла раньше товара.
Принять ответ
Сохраняем результат запроса, код ошибки и trace_id.
Повторить безопасно
Определяем, что можно повторить автоматически, что требует паузы, а что передаётся менеджеру.
Заказы и статусы
Для заказа фиксируем допустимые переходы, отмену, возврат, резерв, оплату и передачу в учётную систему. Неподдержанное состояние обрабатывается вручную или отдельным решением.
API KIT работает с токеном и ограничениями запросов. Секреты храним в серверном контуре; частоту и повтор запросов определяем после просмотра вашей схемы.