Обзор / Руководства
Руководства
Три сценария закрывают почти всякую интеграцию. Каждый разобран целиком: что отправить, что придёт в ответ и что делать, когда пошло не так.
Сценарии
| Руководство | О чём | Чтение |
|---|---|---|
| Приём вебхуков | Подпись, повторы, идемпотентность и журнал доставок | 9 мин |
| Остатки и цены | Пакетная загрузка, формат CSV, резервы, расписание выгрузок | 7 мин |
| Заказы | Статусы и переходы, частичная отмена, блокировка на сборке | 6 мин |
С чего начать
- Заведите ключ песочницы и повторите первый запрос: он покажет, что ключ жив и каталог виден.
- Залейте пробную выгрузку остатков на десяток позиций и сверьте их в кабинете.
- Поднимите приём вебхуков и отправьте себе тестовое событие из кабинета. До этого шага заказы в вашей системе не появятся.
- Переключите ключ на рабочий контур и включите расписание.
Порядок не случайный: вебхуки без залитого каталога приходят на товары, которых у вас ещё нет, и первая же интеграция начинается с разбора чужих ошибок.
Перед переходом на рабочий контурПроверьте три вещи: приёмник отвечает 2xx быстрее пяти секунд, повтор события с тем же
X-Event-Id ничего не меняет, а ночная выгрузка остатков укладывается до 03:00.Чего здесь нет
Мы не описываем настройку конкретных учётных систем и не даём готовых модулей для них: у каждой свои поля и свои правила выгрузки. Всё, что нужно для такого модуля, лежит в справочнике, а типичные ответы сервиса на кривые данные - в кодах ошибок.