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