Интеграция “сломалась” обычно не потому, что всё плохо, а потому что изменился один небольшой параметр: токен, лимит, формат данных, справочник, склад.
Вот 7 типовых проблем и быстрые точки проверки.
1) Остатки не обновляются. Проверьте частоту синхронизации, очереди/ошибки и совпадение складов. Часто интеграция шлёт остаток не в тот склад или не учитывает резерв.
2) Цены “прыгают”. Проверьте, откуда берётся базовая цена (прайс/ERP), и нет ли второго источника (ручные правки, промо-цены). Важно исключить “двойное управление”.
3) Заказы приходят, но статусы не уходят. Частая причина — неверный формат статуса, просроченный токен или превышение лимита API.
4) Отмены “нет в наличии”. Это почти всегда рассинхрон остатков или задержка обновления. Смотрите лаг между фактическим изменением и отправкой в площадку.
5) Ошибки авторизации. Токены и ключи имеют срок действия. Добавьте простой мониторинг: если за час накопилось N ошибок 401/403 — нужна переавторизация.
6) Лимиты API. Если вырос объём — вы можете упереться в rate limit. Решение: батчить запросы, уменьшать частоту, кешировать справочники.
7) Несоответствие SKU/артикулов. Самая болезненная штука: один и тот же товар в разных системах имеет разные идентификаторы. Нужен единый справочник соответствий.
Лучшее, что можно сделать для стабильности — вести лог ошибок интеграции и раз в неделю разбирать топ-3 причины. Это даёт больше эффекта, чем бесконечно “переписывать всё с нуля”.