API · SDK · SSO · Вебхуки
Интеграция: автоматизация заказа мерча
Если программа мерча живёт в корпоративной системе, ручной перенос данных рано или поздно ломается: список сотрудников расходится с системой, заказ создаётся дважды, статус никто не видит. Интеграция решает это, но требует понимания, что именно автоматизируется и что остаётся под контролем человека. В разделе пять технических материалов: два по API, один по SDK и два по единому входу и вебхукам.
Что обычно автоматизируют
Первый и самый частый сценарий — выгрузка списка получателей из кадровой системы. Он убирает главный источник ошибок: данные берутся из системы, где они уже актуальны, а не из таблицы, которую кто-то обновлял последний раз в марте.
Второй сценарий — создание заказа изнутри корпоративной системы. Это удобно, когда закупка оформляется по внутреннему регламенту, а мерч выступает одной из строк. Здесь важнее всего идемпотентность: повторный вызов не должен создавать второй заказ.
Третий сценарий — обратная связь по статусу. Вебхуки решают задачу автоматически: смена статуса производства или готовность отгрузки приходит в вашу систему событием, а не письмом, которое кто-то должен переслать.
Единый вход бывает нужен, когда доступ к заказам должен быть у всей команды, а заводить отдельные учётные записи не хочется. Он снимает вопросы с отзывами доступа, но требует согласования на стороне обеих систем.
Что нужно до интеграции
- Сценарий. Что именно автоматизируется и что остаётся ручным.
- Среда. Тестовая и боевая, с отдельными ключами и отдельными данными.
- Идентификатор заказа. Как ваша система будет сопоставлять свой номер с нашим.
- Идемпотентность. Повторный вызов не должен создавать дубликат.
- События. Какие статусы передавать вебхуками и в каком порядке.
- Доступы. Кто у сторон заказчика будет обращаться к интеграции.
Технические материалы
Пять документов: два по API, один по SDK, один по единому входу и один по вебхукам.
Кем мы не являемся
Corp-Merch.MX — производственная мастерская корпоративного мерча с фактурированием CFDI 4.0 в SAT. Технические материалы описывают нашу публичную интеграционную поверхность на момент публикации; состав и версии методов могут меняться, и перед интеграцией нужно сверяться с актуальной документацией. Мы не являемся официальным партнёром, спонсором или одобренным поставщиком ИТ-вендоров и поставщиков облачных платформ, названных в материалах.
Обсудить интеграцию
Опишите систему, сценарий и сроки — вернём оценку объёма работ, список необходимых доступов и рекомендации по порядку интеграции, чтобы не блокировать тестовый контур.