Підключення ERP до API третіх сторін
ERP до третіх сторін: CRM, логістика, податки й ідентичність
Підключення REST, SOAP, вебхуків і iPaaS між вашою ERP і сервісами навколо неї з повторними спробами й оповіщеннями.
Архітектурний план
Прокрутіть убік, щоб побачити весь малюнок.
ERP до зовнішніх систем: одна платформа, багато партнерів
Бізнес-події виходять з ERP один раз, а інтеграційна платформа доставляє їх кожному партнеру в очікуваному форматі. Зворотні виклики повертаються тим самим шляхом. Повідомлення, яке досі збоїть після повторних спроб, потрапляє в чергу недоставлених і піднімає оповіщення з доданим вмістом.
- Основний потік
- Асинхронний
- Шлях винятків
Потік у 9 кроках
Потік крок за кроком
- Від ERP до Інтеграційна платформа: Бізнес-події, через REST · OData · webhook (основний потік).
- Від Інтеграційна платформа до CRM: Клієнти та замовлення, через REST/JSON (основний потік).
- Від Інтеграційна платформа до Логістика й перевізники: Відправлення заброньовано, через REST/JSON (основний потік).
- Від Логістика й перевізники до Інтеграційна платформа: Події відстеження, через webhook (асинхронний).
- Від Інтеграційна платформа до Платформа електронного фактурування й податків: Рахунки для підтвердження, через SOAP/XML · REST (основний потік).
- Від Інтеграційна платформа до Постачальник KYC та ідентифікації: Перевірки особи, через REST/JSON (основний потік).
- Від Постачальник KYC та ідентифікації до Інтеграційна платформа: Результати перевірок, через webhook (асинхронний).
- Від Інтеграційна платформа до Черга недоставлених і оповіщення: Збій після повторних спроб, до черги недоставлених (шлях винятків).
- Від Черга недоставлених і оповіщення до Команда підтримки: Оповіщення з вмістом і помилкою (шлях винятків).
Огляд
Це потік між вашою ERP і сервісами навколо неї: CRM, перевізниками й провайдерами логістики, платформами електронного фактурування й податків та провайдерами ідентичності й KYC. Кожен партнер має власний API, власний формат і власні збої, і кожен зазвичай стає окремим проєктом.
Еталонний проєкт надсилає бізнес-події з ERP один раз до інтеграційної платформи, яка доставляє їх кожному партнеру в очікуваному форматі через REST, SOAP, вебхуки чи EDI поверх AS2, де цього вимагають торгові партнери. Зворотні виклики, як-от події відстеження чи результати перевірок, повертаються через ту саму платформу.
Недоступність партнера є звичайною подією, а не надзвичайною ситуацією. Тимчасові збої обробляються повторами. Повідомлення, яке не пройшло й після повторів, потрапляє в чергу недоставлених повідомлень, а команда підтримки отримує оповіщення з вмістом і помилкою, тож його можна виправити й надіслати повторно.
Як працює потік
ERP публікує подію
Коли змінюється клієнт, замовлення чи фактура, ERP публікує одну бізнес-подію до інтеграційної платформи через свій API, сервіси OData чи вебхуки.
CRM залишається актуальною
Платформа оновлює облікові записи, контакти й замовлення в CRM, щоб команди продажів і сервісу бачили те, що знає ERP.
Відправлення бронюються
Замовлення, готові до відправлення, бронюються в перевізника чи провайдера логістики через його API, а етикетки й посилання повертаються.
Відстеження повертається
Перевізник надсилає події відстеження й підтвердження доставки вебхуком, а платформа оновлює замовлення в ERP.
Фактури затверджуються
Фактури надсилаються на платформу електронного фактурування чи податків у форматі, якого вимагає орган, а статус затвердження зберігається з фактурою.
Ідентичності перевіряються
Нові клієнти чи постачальники надсилаються до провайдера KYC чи ідентичності, а результат повертається вебхуком до активації облікового запису.
Коли щось збоїть
Партнер тимчасово недоступний
Виклик повторюється з наростаючими затримками. Ключ ідемпотентності на кожному записі означає, що повтор ніколи не створює друге відправлення чи фактуру.
Повідомлення все одно збоїть після повторів
Воно потрапляє в чергу недоставлених повідомлень із вмістом і помилкою партнера, а команду підтримки оповіщають. Після виправлення воно відтворюється з черги.
Партнер змінює свій API
Контрактні тести виконуються в тестовому середовищі кожного партнера й ловлять зміну. Оголошені зміни плануються й тестуються до строку партнера.
Дані відхилено
Партнер, що відмовляє в даних із бізнес-причини, як-от відсутній податковий номер, надсилає помилку назад у запис ERP, де власник може її виправити.
Стандарти й системи
- Інтеграція
- REST
- SOAP
- Webhooks
- OpenAPI
- EDI (EDIFACT, ANSI X12)
- AS2
- MuleSoft
- Boomi
- Azure Logic Apps
- Ідентичність і доступ
- OAuth 2.0
Запитання й відповіді
Які сервіси третіх сторін ви можете підключити?
Будь-який сервіс із задокументованим API чи файловим інтерфейсом. Типові приклади: CRM-платформи, перевізники й логістичні провайдери, маркетплейси, платформи електронного фактурування й податків, розрахунок заробітної плати, провайдери KYC та ідентифікації й торгові партнери, що обмінюються документами EDI через AS2. Ми вивчаємо API, ліміти й тестове середовище кожного партнера, перш ніж погодити план.
Чи потрібна нам для цього інтеграційна платформа?
Коли кілька партнерів підключені до однієї ERP, платформа, як-от MuleSoft, Boomi чи Azure Logic Apps, або набір замовних сервісів на черзі повідомлень тримає зіставлення, повтори й моніторинг в одному місці. З одним-двома партнерами може вистачити прямих підключень. Ми викладаємо компроміси, зокрема ліцензійні витрати, для вашого випадку.
Чи можете ви підключити нас до платформ електронного фактурування й податкового затвердження?
Так. Багато країн тепер вимагають, щоб фактури виставлялися чи затверджувалися через урядову чи акредитовану платформу у визначеному форматі. Ми інтегруємо ERP із платформою, якої вимагає ваша країна, чи з акредитованим провайдером, зберігаємо статус затвердження й ідентифікатори з кожною фактурою та обробляємо відхилення. Ваші податкові радники підтверджують застосовні до вас правила.
Як ви захищаєте вхідні вебхуки?
Кожен вхідний вебхук перевіряється до обробки: підписом, де партнер підписує свої повідомлення, і перевірками токена, джерела й позначки часу, де ні. Вміст перевіряється щодо контракту, а події обробляються один раз, навіть якщо партнер надсилає їх більше ніж один раз.
Що відбувається, коли в партнера збій?
Решта потоків продовжує працювати. Повідомлення для цього партнера повторюються, а потім ставляться в чергу, команду підтримки оповіщають, і ніщо не втрачається. Коли партнер відновлюється, повідомлення з черги відтворюються за порядком. Панель показує, який партнер уражений і скільки повідомлень чекає.
Кому належать створені вами конектори?
Інтелектуальна власність на роботу, яку ми створюємо для вас, належить вам із першого коміту, без окремого кроку передавання наприкінці. Конектори постачаються з вихідним кодом, тестами й документацією, тож ваша команда чи інший постачальник можуть їх підтримувати. Інструменти XSIS, що існували раніше, залишаються нашими й надаються вам за ліцензією. API партнерів і ліцензії інтеграційних платформ залишаються на власних умовах цих постачальників.
Почніть із розмови, а не з договору.
Розкажіть, що вам треба побудувати, зʼєднати чи захистити. Архітектор пройде це з вами, а потім порадить, з чого почати.
Що буде далі
Узгодження часу
Наша команда напише вам, щоб узгодити час сесії.
Попередня консультація
Формат: безкоштовна 30-хвилинна онлайн-консультація перед співпрацею. Ми разом розбираємо ваші цілі, системи й обмеження.
Оцінка готовності
На кроці «безкоштовна 48-годинна оцінка готовності» головний архітектор перевіряє ваш проєкт за 6 пунктами Definition of Ready і рекомендує відповідний трек.
Вибір треку
Проєкти з готовим обсягом отримують обовʼязкову пропозицію протягом від 3 до 5 робочих днів. Проєкти на стадії концепції починаються в Blueprint Studio. Робоча система, яка дає збої, не має документації або потребує інтеграції, починається з діагностики тривалістю від 1 до 2 тижнів. Blueprint Studio і діагностика мають фіксовану плату, зазначену в пропозиції.