API · Вебхуки · SSO · ERP · CRM · HR
SDK и интеграция с системами клиента
Как Corp-Merch.MX подключается к ERP, CRM, HR-платформе и порталу поставщика клиента. SDK и интеграции поддерживают токен-аутентификацию, вебхуки для уведомлений о событиях, SSO для корпоративных порталов и экспорт данных в стандартных форматах.
Подключение к ERP клиента
Корпоративные клиенты со зрелым ERP — SAP S/4HANA, Oracle Cloud ERP, Microsoft Dynamics 365, Infor LN — запрашивают интеграцию через REST API с аутентификацией OAuth 2.0 или сервисным токеном. Интеграция поддерживает три основных сценария использования. Первый — автоматическое создание заказов на покупку по событию системы клиента, обычно утверждённый запрос на униформу, приветственные наборы или замены персонала. Второй — запрос статуса заказа для отображения покупателю на его собственном экране без входа в портал мастерской.
Третий — выгрузка счетов CFDI 4.0 и дополнений платежа непосредственно в модуль кредиторской задолженности клиента. Счёт предоставляется в формате XML и PDF, подписанный SAT, со ссылкой на заказ, получателя и UUID. Для клиентов со схемой утверждения трёх уровней — покупатель, менеджер, директор — интеграция уважает внутренние потоки клиента и уведомляет мастерскую при достижении финального утверждения.
Подключение к CRM и платформам продаж
Для клиентов с CRM — Salesforce, HubSpot, Pipedrive, Zoho — интеграция используется в основном в мерче для кампаний признания, подарков ключевым клиентам и наборов для выставок. CRM создаёт коммерческое событие — закрытие сделки, продление контракта, реферал, посещение выставки — и интеграция запускает соответствующий заказ мерча с данными получателя, адресом доставки и ссылкой на кампанию. Получатель получает мерч без ручного вмешательства коммерческого отдела.
Для маркетинговых кампаний с высоким объёмом — более тысячи получателей в месяц — интеграция подключается к маркетинговой платформе для координации отправки с коммуникацией. Получатель получает письмо или сообщение с номером отслеживания и может подтвердить доставку из своего интерфейса.
Подключение к HR-платформам
HR-платформы — Workday, BambooHR, Rippling, SAP SuccessFactors — являются основным источником событий, запускающих мерч: приём сотрудника, годовщина, повышение, увольнение. Интеграция с HR позволяет настраивать правила — например, приветственный набор в течение пяти дней после приёма, подарок на годовщину, кратную пяти, признание за повышение начиная с определённого уровня — и позволить системе работать без ручного вмешательства.
Для корпоративных клиентов с более чем тысячей сотрудников в Мексике и зрелой HR-платформой интеграция с Corp-Merch.MX происходит в процессе онбординга клиента. Типичная длительность интеграции — четыре-восемь недель в зависимости от схемы безопасности клиента, объёма и внутренних валидаций. Поставка включает техническую документацию, тестовые сценарии, среды песочницы и продуктивную, а также поддержку после запуска в течение первых тридцати дней.
SSO и корпоративные порталы
Для клиентов, которые предпочитают работать из своего корпоративного портала, мы предлагаем аутентификацию SAML 2.0 или OpenID Connect против их корпоративного IdP — Okta, Azure AD, Google Workspace, Auth0, Ping Identity. Пользователь клиента получает доступ к порталу Corp-Merch.MX со своими корпоративными учётными данными, без необходимости поддерживать дополнительного пользователя. Авторизация управляется группами в IdP и сопоставляется с ролями портала.
Для клиентов с настроенным порталом поставщика интеграция происходит через iframe или REST API с SSO в заголовке. Пользователь клиента остаётся в своём портале, и информация мастерской отрисовывается как встроенный модуль. Для клиентов с внутренним мобильным приложением мы публикуем REST-эндпоинты, оптимизированные для мобильных устройств, с компактным ответом и краткосрочной JWT-аутентификацией.
Вебхуки и события
Система публикует вебхуки, чтобы клиент получал уведомления о релевантных событиях — заказ создан, макет утверждён, производство начато, контроль качества, отправка выполнена, доставка подтверждена. Каждое событие несёт JSON-пейлоад с минимально необходимой информацией и уникальным идентификатором для дедупликации. Клиент настраивает эндпоинт и набор событий, которые хочет получать; необработанные события повторяются с экспоненциальным откатом в течение двадцати четырёх часов.
Безопасность вебхуков гарантируется подписью HMAC-SHA256 на пейлоаде с общим ключом, ротируемым каждые девяносто дней. Клиент проверяет подпись до обработки события; события с недействительной подписью отклоняются и логируются. Документация включает примеры пейлоадов для каждого типа события и коды ошибок, которые клиент может получить.
Каталог данных и формат экспорта
Каталог продуктов предоставляется через REST API с пагинацией, фильтрами и поиском. Каждый продукт включает внутреннюю ссылку, название, описание, варианты, MOQ, срок поставки, базовую цену, применимые нормативные ограничения и опции кастомизации. Синхронизация с каталогом клиента происходит по событию — создание, удаление, изменение цены, изменение варианта — или по полному снимку по запросу.
Экспорт данных поддерживает форматы JSON, CSV и XML с кодировкой UTF-8 и стандартными разделителями. Для клиентов с хранилищами данных предлагается экспорт в формате Parquet. Документация включает словарь данных, примеры форматов и рекомендации по интеграции с системами аналитики клиента.
FAQ — блок SDK
Сколько занимает интеграция с SAP?
Интеграция с SAP S/4HANA занимает от шести до десяти недель в зависимости от сложности сценария и внутренних валидаций клиента. Включает среды песочницы и продуктивную, а также тридцать дней поддержки после запуска.
Поддерживаете ли вы Workday?
Да. Мы интегрируемся с Workday для приветственного набора, годовщины и признания. Подключение через REST API с аутентификацией OAuth 2.0.
Имеют ли вебхуки повторы?
Да. Необработанные события повторяются с экспоненциальным откатом в течение двадцати четырёх часов. Подпись HMAC-SHA256 гарантирует подлинность пейлоада.
Берёте ли вы оплату за интеграцию?
Базовая интеграция включена в программу клиента. Сложные интеграции с SAP, Oracle или HR-платформами тарифицируются отдельно по объёму и включаются в коммерческое предложение.
Обсудим вашу интеграцию
Если ваша компания оценивает подключение программы мерча к ERP, CRM или HR-платформе, давайте обсудим. Мы предоставляем техническую спецификацию, поддерживаемые сценарии использования и первоначальное предложение на основе объёма интеграции.
Интеграции, описанные на этой странице, отражают поддерживаемые сценарии на момент публикации. Доступность каждой интеграции зависит от исходной системы клиента, схемы безопасности и внутренних валидаций. Corp-Merch.MX — мексиканская мастерская по производству корпоративного мерча; мы работаем независимо, и техническая информация на этой странице не является консультацией по интеграции или контрактным обязательством до письменного подтверждения коммерческим и техническим отделами.