Інтеграція з банком
Інтеграція з сайтом — це автоматичний обмін даними між сайтом, інтернет-магазином, порталом клієнта або корпоративним вебресурсом і внутрішньою системою компанії: ERP, CRM, WMS, HRM, фінансовою системою, складом, сервісом або K2 ERP.
Простіше кажучи, інтеграція з сайтом потрібна, щоб товари, ціни, залишки, замовлення, клієнти, оплати, статуси доставки, документи й заявки не переносилися вручну з сайту в ERP і назад. Бо ручне копіювання замовлень — це не цифровізація, а Excel-фітнес для терплячих людей.
Головне. Інтеграція з сайтом дозволяє сайту продавати, приймати заявки або показувати дані клієнту, а ERP — бути джерелом правди для товарів, цін, залишків, замовлень, оплат, клієнтів і документів.
Проста аналогія. Сайт — це вітрина магазину. ERP — це склад, каса, бухгалтерія, закупівлі, ціни, клієнти й документи. Інтеграція — це двері між вітриною і реальним бізнесом. Якщо дверей немає, хтось бігає туди-сюди з блокнотом і героїчно помиляється.
Що таке інтеграція з сайтом
Інтеграція з сайтом — це налаштований обмін даними між сайтом і внутрішніми системами компанії.
Інтеграція відповідає на питання:
Звідки сайт бере товари?
Звідки сайт бере ціни?
Звідки сайт бере залишки?
Куди потрапляють замовлення з сайту?
Як передаються клієнти?
Як передаються оплати?
Як оновлюються статуси замовлень?
Як сайт отримує документи?
Як ERP дізнається про заявки з сайту?
Хто є джерелом правди для даних?Інтеграція може бути односторонньою або двосторонньою.
Приклад односторонньої інтеграції:
ERP → Сайт
Товари, ціни, залишкиПриклад двосторонньої інтеграції:
ERP → Сайт: товари, ціни, залишки, статуси
Сайт → ERP: замовлення, клієнти, оплати, заявкиДля чого потрібна інтеграція з сайтом
Інтеграція з сайтом потрібна для:
- автоматичного оновлення каталогу товарів;
- показу актуальних цін;
- показу актуальних залишків;
- приймання замовлень із сайту в ERP;
- створення клієнтів і контактів;
- передачі оплат;
- передачі статусів замовлення;
- синхронізації доставки;
- формування рахунків;
- роботи з особистим кабінетом клієнта;
- обміну документами;
- контролю повернень;
- контролю рекламацій;
- автоматизації B2B-порталу;
- зменшення ручних помилок;
- пришвидшення обробки замовлень;
- підключення аналітики в Power BI.
Без інтеграції менеджер часто робить так:
1. Відкрив сайт.
2. Скопіював замовлення.
3. Вставив у ERP.
4. Перевірив товар.
5. Перевірив ціну.
6. Перевірив залишок.
7. Помилився в одному символі.
8. Отримав маленький бізнес-квест.Що можна інтегрувати з сайтом
| Дані | Напрям | Приклад |
|---|---|---|
| Товари | ERP → Сайт | Назва, артикул, опис, характеристики |
| Категорії | ERP → Сайт | Групи товарів, структура каталогу |
| Ціни | ERP → Сайт | Роздрібна, оптова, акційна, персональна |
| Залишки | ERP → Сайт | Доступна кількість по складах |
| Замовлення | Сайт → ERP | Замовлення покупця |
| Клієнти | Сайт → ERP / ERP → Сайт | Профіль клієнта, контакти, реквізити |
| Оплати | Сайт → ERP | Онлайн-оплата, статус платежу |
| Статуси | ERP → Сайт | Прийнято, зібрано, відправлено, доставлено |
| Доставка | ERP ↔ Сайт | Перевізник, ТТН, адреса, вартість |
| Документи | ERP → Сайт | Рахунок, акт, накладна, акт звірки |
| Рекламації | Сайт → ERP | Звернення клієнта щодо якості |
| Заявки | Сайт → ERP | Форма зворотного зв’язку, сервісна заявка |
Основні сценарії інтеграції
Найпоширеніші сценарії:
- ERP передає товари на сайт;
- ERP передає ціни на сайт;
- ERP передає залишки;
- сайт передає замовлення в ERP;
- сайт передає оплату;
- ERP передає статус замовлення;
- ERP передає номер ТТН;
- сайт передає нових клієнтів;
- клієнт у кабінеті бачить документи;
- клієнт у кабінеті бачить борг або баланс;
- сайт передає рекламацію;
- ERP передає персональні ціни для B2B-клієнтів;
- сайт показує доступність товару по складах;
- ERP блокує продаж товару, якого немає в наявності.
Інтеграція каталогу товарів
Каталог товарів часто ведеться в ERP, а сайт отримує актуальні дані.
Передаються:
- артикул;
- назва;
- опис;
- категорія;
- бренд;
- характеристики;
- одиниця виміру;
- фото;
- штрихкод;
- вага;
- габарити;
- статус активності;
- SEO-поля;
- аналоги;
- супутні товари;
- серії;
- модифікації.
Приклад:
{
"sku": "ITEM-001",
"name": "Насос промисловий NP-100",
"category": "Промислове обладнання",
"brand": "ExampleBrand",
"unit": "шт",
"barcode": "4820000000012",
"active": true
}Інтеграція цін
Ціни можуть змінюватися в ERP і автоматично передаватися на сайт.
Типи цін:
- роздрібна;
- оптова;
- дилерська;
- акційна;
- персональна;
- за договором;
- за сегментом клієнта;
- за валютою;
- за регіоном;
- за кількістю.
Приклад:
{
"sku": "ITEM-001",
"prices": [
{
"type": "retail",
"currency": "UAH",
"price": 1200.00
},
{
"type": "wholesale",
"currency": "UAH",
"price": 1050.00
}
]
}Ціни мають мати джерело правди. Якщо менеджер змінює ціну в ERP, а маркетолог — на сайті, через тиждень вони обидва впевнені, що праві. Клієнт, звісно, вибирає нижчу ціну. Він не дурний.
Інтеграція залишків
Залишки потрібні, щоб сайт показував реальну доступність товару.
Можна передавати:
- загальний залишок;
- залишок по складах;
- доступний залишок;
- зарезервований залишок;
- очікуване надходження;
- дату поставки;
- мінімальну кількість для продажу;
- статус “під замовлення”;
- статус “немає в наявності”.
Приклад:
{
"sku": "ITEM-001",
"stock": [
{
"warehouse": "MAIN",
"available": 15,
"reserved": 3
},
{
"warehouse": "KYIV",
"available": 7,
"reserved": 1
}
]
}Важливо передавати саме доступний залишок, а не просто фізичний. Бо товар, який уже зарезервований під іншого клієнта, — це не товар “можна купити”, а майбутній конфлікт.
Інтеграція замовлень
Замовлення з сайту має автоматично потрапляти в ERP.
Передаються:
- номер замовлення на сайті;
- дата;
- клієнт;
- контактні дані;
- товари;
- кількість;
- ціни;
- знижки;
- доставка;
- спосіб оплати;
- статус оплати;
- коментар клієнта;
- промокод;
- адреса доставки;
- перевізник;
- джерело замовлення.
Приклад:
{
"site_order_id": "WEB-2026-000125",
"created_at": "2026-05-16T11:25:00",
"customer": {
"name": "ТОВ Клієнт",
"phone": "+380000000000",
"email": "client@example.com"
},
"items": [
{
"sku": "ITEM-001",
"quantity": 2,
"price": 1200.00
}
],
"payment_status": "paid",
"delivery_method": "nova_poshta"
}Обробка замовлення з сайту в ERP
Типовий процес:
Клієнт оформлює замовлення на сайті
↓
Сайт передає замовлення в ERP
↓
ERP створює замовлення покупця
↓
ERP перевіряє клієнта, ціни, залишки
↓
Товар резервується
↓
Склад отримує задачу на відбір
↓
Формується доставка
↓
Статус повертається на сайт
↓
Клієнт бачить оновлення в кабінетіІнтеграція клієнтів
Клієнти можуть створюватися на сайті й передаватися в ERP.
Передаються:
- ПІБ або назва компанії;
- телефон;
- email;
- ЄДРПОУ або ІПН;
- адреса;
- контактна особа;
- тип клієнта;
- сегмент;
- джерело;
- згода на обробку даних;
- особистий кабінет;
- реквізити;
- договори.
Приклад:
{
"customer_id": "WEB-CUST-00125",
"type": "company",
"name": "ТОВ Клієнт",
"edrpou": "12345678",
"email": "client@example.com",
"phone": "+380000000000"
}Дублі клієнтів
Одна з типових проблем інтеграції — дублювання клієнтів.
Причини:
- різні написання назви;
- різні телефони;
- різні email;
- клієнт оформив замовлення кілька разів;
- компанія вже є в ERP;
- сайт не передає ЄДРПОУ;
- немає правил пошуку дубля.
Приклад:
ТОВ “Ромашка”
ТОВ Ромашка
Ромашка ТОВ
ТОВ "Ромашка"Для людини це одне й те саме. Для системи без правил — чотири різні клієнти і майбутнє свято в актах звірки.
Інтеграція оплат
Якщо сайт приймає онлайн-оплати, статус платежу потрібно передавати в ERP.
Передаються:
- номер платежу;
- платіжна система;
- сума;
- валюта;
- статус;
- дата;
- комісія;
- замовлення;
- клієнт;
- transaction id;
- підтвердження платежу.
Приклад:
{
"payment_id": "PAY-WEB-00125",
"site_order_id": "WEB-2026-000125",
"amount": 2400.00,
"currency": "UAH",
"status": "paid",
"provider": "payment_gateway",
"transaction_id": "TX123456789"
}Статуси оплати:
- очікує оплати;
- оплачено;
- частково оплачено;
- помилка оплати;
- повернення коштів;
- скасовано;
- chargeback;
- потребує перевірки.
Інтеграція доставки
Сайт і ERP можуть обмінюватися даними доставки.
Передаються:
- спосіб доставки;
- перевізник;
- адреса;
- склад відвантаження;
- номер ТТН;
- статус доставки;
- вартість доставки;
- дата відправлення;
- дата доставки;
- контакт отримувача;
- коментар.
Приклад:
{
"site_order_id": "WEB-2026-000125",
"carrier": "nova_poshta",
"tracking_number": "20450000000000",
"delivery_status": "shipped",
"shipped_at": "2026-05-16T16:45:00"
}Інтеграція статусів замовлення
Статуси дозволяють клієнту бачити, що відбувається із замовленням.
Приклад статусів:
| Статус на сайті | Статус в ERP | Значення |
|---|---|---|
| Прийнято | Нове замовлення | Замовлення отримано |
| Підтверджено | Погоджено | Менеджер перевірив замовлення |
| Комплектується | На відборі | Склад збирає товар |
| Відправлено | Відвантажено | Товар передано перевізнику |
| Доставлено | Закрито | Замовлення виконано |
| Скасовано | Скасовано | Замовлення не виконується |
Проблема виникає, коли сайт показує “в наявності”, менеджер каже “немає”, а ERP мовчить, бо її ніхто не питав. Інтеграція саме для того, щоб таких сцен було менше.
Особистий кабінет клієнта
Інтеграція з сайтом часто потрібна для особистого кабінету клієнта.
Клієнт може бачити:
- свої замовлення;
- статуси;
- рахунки;
- акти;
- накладні;
- акти звірки;
- баланс;
- дебіторську заборгованість;
- історію оплат;
- персональні ціни;
- договори;
- рекламації;
- сервісні заявки;
- бонуси;
- ліміти;
- документи для завантаження.
Приклад:
Клієнт заходить у кабінет:
- бачить замовлення;
- бачить статус доставки;
- завантажує рахунок;
- бачить акт звірки;
- створює рекламацію.B2B-портал
B2B-портал — це сайт або особистий кабінет для корпоративних клієнтів.
Особливості:
- персональні ціни;
- договори;
- кредитні ліміти;
- відстрочка платежу;
- замовлення за шаблонами;
- повторення попереднього замовлення;
- погодження замовлення всередині клієнта;
- залишки по складах;
- акти звірки;
- документи;
- обмеження асортименту;
- історія закупівель.
B2B-портал без інтеграції з ERP — це дуже красива форма ручного введення даних. Виглядає сучасно, а працює як факс у новому корпусі.
Інтеграція форм із сайту
Сайт може передавати в ERP не тільки замовлення, а й форми.
Приклади форм:
- заявка на консультацію;
- запит ціни;
- заявка на сервіс;
- заявка на ремонт;
- рекламація;
- запит на демо;
- підписка;
- анкета клієнта;
- запит документів;
- заявка на партнерство;
- форма зворотного зв’язку.
Приклад:
{
"form_id": "FORM-2026-00045",
"type": "demo_request",
"name": "Іван",
"phone": "+380000000000",
"email": "ivan@example.com",
"comment": "Хочу демо K2 ERP для виробництва"
}У ERP така форма може створити ліда, задачу менеджеру, сервісну заявку або звернення підтримки.
Інтеграція рекламацій із сайту
Клієнт може створити рекламацію через сайт.
Передаються:
- клієнт;
- замовлення;
- товар;
- партія або серійний номер;
- причина;
- опис проблеми;
- фото;
- відео;
- бажане рішення;
- контакт;
- дата.
Приклад:
{
"claim_id": "WEB-CLAIM-00125",
"site_order_id": "WEB-2026-000125",
"sku": "ITEM-001",
"reason": "damaged_goods",
"description": "Пошкоджено корпус товару",
"attachments": ["photo1.jpg", "photo2.jpg"]
}ERP створює рекламацію, призначає відповідального, контролює SLA і запускає процес розгляду.
Способи інтеграції з сайтом
| Спосіб | Що означає | Де використовується |
|---|---|---|
| API | Сайт і ERP обмінюються запитами | Замовлення, товари, клієнти, статуси |
| Webhook | Сайт або ERP надсилає подію при зміні | Нове замовлення, оплата, зміна статусу |
| Файловий обмін | Дані передаються файлами | CSV, XML, JSON |
| Пряма інтеграція з базою | Системи читають або пишуть у базу | Рідко, з великими ризиками |
| Middleware | Проміжний сервіс обміну | Складні інтеграції між багатьма системами |
| Плагін CMS | Модуль для конкретної CMS | WooCommerce, OpenCart, Shopify, інші CMS |
API інтеграція
API — це інтерфейс, через який сайт і ERP обмінюються даними.
API може дозволяти:
- отримати список товарів;
- отримати ціни;
- отримати залишки;
- створити замовлення;
- створити клієнта;
- оновити статус;
- передати оплату;
- створити рекламацію;
- отримати документи;
- перевірити доступність доставки.
Приклад API-запиту:
POST /api/orders
Content-Type: application/json
Authorization: Bearer tokenПриклад відповіді:
{
"success": true,
"erp_order_id": "SO-2026-00125",
"status": "created"
}Webhooks
Webhook — це повідомлення про подію.
Приклади подій:
- створено замовлення;
- оплачено замовлення;
- скасовано замовлення;
- змінено статус;
- створено рекламацію;
- товар став доступним;
- змінено ціну;
- створено клієнта.
Приклад:
{
"event": "order.paid",
"site_order_id": "WEB-2026-000125",
"paid_at": "2026-05-16T12:05:00",
"amount": 2400.00
}Webhook зручний тим, що система не питає кожні 5 хвилин “ну що там?”, а надсилає повідомлення, коли щось справді сталося.
Файловий обмін
Файловий обмін використовується, коли API немає або інтеграція проста.
Формати:
- CSV;
- XML;
- JSON;
- XLSX;
- TXT.
Приклад CSV:
sku,name,price,stock
ITEM-001,Насос NP-100,1200,15
ITEM-002,Фільтр F-20,350,40Файловий обмін простий, але має ризики:
- затримки;
- дублікати;
- помилки формату;
- неповні дані;
- складна обробка помилок;
- проблеми з версіями файлів.
JSON в інтеграції з сайтом
JSON часто використовується для API.
Переваги:
- зрозумілий формат;
- зручний для вебсервісів;
- підтримується більшістю мов програмування;
- добре підходить для структурованих даних;
- легко передавати вкладені об’єкти.
Приклад товару:
{
"sku": "ITEM-001",
"name": "Товар А",
"category": "Категорія 1",
"price": 1200.00,
"stock": 15,
"currency": "UAH"
}XML в інтеграції з сайтом
XML теж використовується, особливо в старіших або формалізованих інтеграціях.
Приклад:
<product>
<sku>ITEM-001</sku>
<name>Товар А</name>
<price currency="UAH">1200.00</price>
<stock>15</stock>
</product>XML зручний для суворих схем, але зазвичай більш громіздкий, ніж JSON.
Джерело правди
Джерело правди — це система, яка вважається головною для конкретного типу даних.
Приклад:
| Дані | Джерело правди |
|---|---|
| Товари | ERP |
| Ціни | ERP |
| Залишки | ERP / WMS |
| Замовлення | Сайт створює, ERP обробляє |
| Оплати | Платіжна система + ERP |
| Клієнти | CRM / ERP |
| Статуси доставки | ERP / служба доставки |
Якщо джерело правди не визначене, дані швидко починають сперечатися між собою. І зазвичай голосніше за всіх сперечається клієнт.
Синхронізація даних
Синхронізація може бути:
- в реальному часі;
- кожні кілька хвилин;
- раз на годину;
- раз на день;
- за подією;
- вручну за кнопкою;
- пакетно вночі.
Приклад:
| Дані | Частота | Коментар |
|---|---|---|
| Залишки | Кожні 5 хвилин або частіше | Важливо для продажів |
| Ціни | Після зміни або щогодини | Залежить від політики цін |
| Каталог | Раз на день або після зміни | Не завжди критично щосекунди |
| Замовлення | Одразу | Має швидко потрапляти в ERP |
| Статуси | За зміною статусу | Для кабінету клієнта |
Конфлікти даних
Конфлікт виникає, коли сайт і ERP мають різні дані.
Приклади:
- різна ціна;
- різний залишок;
- різний статус;
- різний клієнт;
- дубль замовлення;
- замовлення скасоване на сайті, але активне в ERP;
- товар видалений на сайті, але активний в ERP;
- оплата є на сайті, але немає в ERP.
Потрібні правила:
- хто головний;
- як вирішувати конфлікт;
- як логувати помилку;
- кого повідомляти;
- чи можна автоматично виправити;
- коли потрібна ручна перевірка.
Безпека інтеграції
Інтеграція з сайтом має бути захищена.
Потрібно контролювати:
- HTTPS;
- токени доступу;
- API-ключі;
- термін дії токенів;
- IP whitelist;
- ролі доступу;
- обмеження методів API;
- логування запитів;
- rate limiting;
- захист персональних даних;
- підпис webhooks;
- шифрування;
- резервні сценарії;
- моніторинг помилок.
Погано:
API без авторизації, бо “там же тільки залишки”.Сьогодні “тільки залишки”, завтра хтось створює фальшиве замовлення, післязавтра фінансовий відділ вивчає нові слова.
Логування інтеграції
Усі обміни потрібно логувати.
Лог має містити:
- дату і час;
- напрям обміну;
- endpoint;
- тип об’єкта;
- ID на сайті;
- ID в ERP;
- статус;
- помилку;
- payload або його безпечну частину;
- повторну спробу;
- користувача або сервіс;
- час відповіді.
Приклад:
| Час | Подія | Статус | Коментар |
|---|---|---|---|
| 16.05.2026 11:25 | Створення замовлення WEB-125 | OK | Створено SO-2026-00125 |
| 16.05.2026 11:26 | Передача оплати | Error | Невідома валюта |
Лог інтеграції — це чорний ящик. Коли щось падає, без нього всі просто дивляться одне на одного й кажуть: “У нас усе відправилось”.
Обробка помилок
Помилки інтеграції неминучі.
Типові помилки:
- товар не знайдено;
- клієнт уже існує;
- неправильний формат JSON;
- відсутнє обов’язкове поле;
- неправильна валюта;
- немає залишку;
- ціна неактуальна;
- API недоступний;
- timeout;
- дубль замовлення;
- неправильний токен;
- помилка доставки;
- помилка платіжної системи.
ERP має:
- фіксувати помилку;
- не втрачати дані;
- повідомляти відповідального;
- дозволяти повторити обмін;
- показувати зрозумілу причину;
- не створювати дублікати при повторі.
Повторна відправка
Якщо обмін не пройшов, потрібен механізм повторної відправки.
Приклад:
Замовлення з сайту не створилося в ERP через timeout.
Система не створює дубль.
Через 5 хвилин повторює запит.
Якщо ERP бачить site_order_id, вона не створює друге замовлення.Для цього потрібні унікальні ідентифікатори.
Унікальні ідентифікатори
Для інтеграції важливо мати ID об’єктів.
Приклади:
- site_order_id;
- erp_order_id;
- sku;
- customer_id;
- payment_id;
- transaction_id;
- claim_id;
- delivery_id;
- product_guid;
- external_id.
Приклад:
{
"site_order_id": "WEB-2026-000125",
"erp_order_id": "SO-2026-00125"
}Без external_id інтеграція швидко перетворюється на гру “це те саме замовлення чи дуже схоже?”.
Інтеграція з CMS
Сайт може бути побудований на CMS або e-commerce платформі.
Приклади типів систем:
- інтернет-магазин;
- корпоративний сайт;
- B2B-портал;
- маркетплейс;
- клієнтський кабінет;
- сервісний портал;
- навчальний портал;
- портал партнерів.
CMS може мати:
- REST API;
- GraphQL API;
- webhooks;
- плагіни;
- модулі обміну;
- експорт-імпорт файлів;
- власну базу даних;
- обмеження інтеграції.
Інтеграція з маркетплейсами через сайт
Іноді сайт працює разом із маркетплейсами.
Сценарій:
ERP → Сайт → Маркетплейс
Маркетплейс → Сайт → ERPПередаються:
- товари;
- ціни;
- залишки;
- замовлення;
- статуси;
- доставки;
- повернення;
- рекламації;
- комісії.
Важливо не заплутатись, де джерело правди. Бо якщо ERP, сайт і маркетплейс одночасно вирішують, яка ціна правильна, клієнт купить там, де помилка найвигідніша.
Інтеграція з сайтом у K2 ERP
У K2 ERP інтеграція з сайтом може забезпечувати обмін між ERP і вебресурсом компанії.
Можливості:
- передача товарів;
- передача категорій;
- передача характеристик;
- передача фото;
- передача цін;
- передача залишків;
- приймання замовлень;
- створення клієнтів;
- обробка оплат;
- передача статусів;
- передача ТТН;
- особистий кабінет клієнта;
- B2B-портал;
- заявки з сайту;
- рекламації;
- сервісні звернення;
- API;
- webhooks;
- логування обміну;
- audit log;
- права доступу;
- Power BI-аналітика.
Приклад процесу:
K2 ERP передає товари, ціни й залишки на сайт
↓
Клієнт оформлює замовлення
↓
Сайт передає замовлення в K2 ERP
↓
K2 ERP створює замовлення покупця і резервує товар
↓
Склад збирає замовлення
↓
K2 ERP передає статус і ТТН на сайт
↓
Клієнт бачить статус у кабінетіPower BI для інтеграції з сайтом
Power BI може аналізувати дані сайту й ERP.
Корисні дашборди:
- кількість замовлень із сайту;
- конверсія замовлень;
- сума продажів;
- середній чек;
- популярні товари;
- товари без залишку;
- замовлення з помилками інтеграції;
- дублікати клієнтів;
- час обробки замовлення;
- частка оплат онлайн;
- рекламації з сайту;
- повернення;
- SLA обробки замовлень;
- джерела трафіку;
- ефективність акцій;
- маржа по онлайн-продажах.
Приклад:
| Показник | Значення |
|---|---|
| Замовлень із сайту за місяць | 2 450 |
| Успішно передано в ERP | 98,7% |
| Помилок інтеграції | 32 |
| Середній час створення замовлення в ERP | 12 секунд |
| Онлайн-оплат | 64% |
| Рекламацій із сайту | 18 |
Права доступу
Інтеграція з сайтом має мати обмежені права.
Приклад:
| Сервіс | Доступ |
|---|---|
| Сайт | Створення замовлень, читання товарів, цін і залишків |
| Особистий кабінет | Читання документів тільки свого клієнта |
| Платіжний модуль | Передача статусів оплат |
| Сервіс рекламацій | Створення рекламацій і вкладень |
| Адміністратор інтеграції | Перегляд логів і повтор обміну |
Сайт не повинен мати повний доступ до ERP. Якщо сайт може “все”, то перша ж помилка або атака може зробити “все” дуже буквально.
Audit log інтеграції
Audit log має фіксувати:
- хто змінив налаштування інтеграції;
- хто змінив API-ключ;
- хто повторив обмін;
- хто змінив мапінг полів;
- хто змінив правила цін;
- хто змінив склад для залишків;
- хто змінив доступи сайту;
- хто скасував замовлення;
- хто змінив статус;
- хто видалив лог або запис.
Audit log потрібен, щоб інтеграція не була “чорним ящиком із кнопкою, яку ніхто не натискав, але все зламалось”.
Типові помилки інтеграції з сайтом
| Помилка | Причина | Наслідок |
|---|---|---|
| Немає джерела правди | Дані редагують і в ERP, і на сайті | Різні ціни, залишки, описи |
| Не передають доступний залишок | Передають фізичний залишок | Продаж зарезервованого товару |
| Немає унікального ID | Поганий мапінг | Дублі замовлень і клієнтів |
| Немає логів | Обмін не контролюється | Неможливо знайти причину помилки |
| Немає повторної відправки | Помилка губить дані | Замовлення не потрапляє в ERP |
| API має надмірні права | Слабка безпека | Ризик зміни або витоку даних |
| Не обробляють помилки | Сайт показує “успіх”, ERP не створила замовлення | Клієнт чекає, а бізнес не бачить замовлення |
| Немає тестового середовища | Перевіряють на бойових даних | Поломки в реальному продажі |
Помилка: сайт продає те, чого немає
Поганий сценарій:
ERP: товар зарезервований під іншого клієнта.
Сайт: показує “в наявності”.
Клієнт: оплачує.
Менеджер: вибачається.
Клієнт: не дуже щасливий.Краще:
ERP передає на сайт доступний залишок:
Фізичний залишок - резерв = доступно для продажу.Помилка: замовлення дублюються
Причина:
- сайт повторно відправив замовлення;
- ERP не перевірила site_order_id;
- timeout сприйняли як помилку і створили друге замовлення.
Краще:
ERP перевіряє site_order_id.
Якщо замовлення вже створено — повертає існуючий erp_order_id.Помилка: ціни змінюються вручну на сайті
Погано:
ERP має одну ціну.
Сайт має іншу.
Менеджер має третю в Excel.
Клієнт має скріншот найнижчої.Краще:
Ціни ведуться в ERP.
Сайт отримує ціни автоматично.
Ручне редагування цін на сайті обмежене або заборонене.Помилка: немає моніторингу інтеграції
Інтеграція може впасти непомітно.
Погано:
Замовлення не передаються 6 годин.
Дізналися від клієнта.Краще:
Якщо обмін не проходить 10 хвилин або є 5 помилок підряд — система надсилає повідомлення відповідальному.Інтеграція без моніторингу — це як холодильник без лампочки й термометра. Може все добре. А може вже пахне.
Тестування інтеграції
Перед запуском потрібно протестувати:
- створення товару;
- оновлення ціни;
- оновлення залишку;
- створення замовлення;
- оплату;
- скасування;
- часткову оплату;
- доставку;
- повернення;
- рекламацію;
- дубль замовлення;
- помилковий JSON;
- timeout;
- недоступність API;
- неправильний токен;
- відсутнє поле;
- великі обсяги даних.
Приклад тест-кейсу:
Сценарій: створення замовлення з оплатою.
1. Створити замовлення на сайті.
2. Провести онлайн-оплату.
3. Перевірити створення замовлення в ERP.
4. Перевірити статус оплати.
5. Перевірити резерв товару.
6. Перевірити відповідь сайту клієнту.Впровадження інтеграції з сайтом
Етапи:
- Описати бізнес-процеси.
- Визначити джерело правди для даних.
- Описати, які дані передаються.
- Описати напрям обміну.
- Визначити частоту синхронізації.
- Підготувати API або файловий формат.
- Описати мапінг полів.
- Налаштувати безпеку.
- Налаштувати логування.
- Налаштувати обробку помилок.
- Налаштувати повторну відправку.
- Провести тестування.
- Запустити пілот.
- Налаштувати моніторинг.
- Навчити відповідальних.
- Запустити в промислову експлуатацію.
Приклад мапінгу полів
| Поле сайту | Поле ERP | Коментар |
|---|---|---|
| product.sku | Номенклатура.Артикул | Унікальний артикул товару |
| product.name | Номенклатура.Назва | Назва товару |
| order.id | ЗамовленняПокупця.ExternalID | ID замовлення на сайті |
| customer.email | Контрагент.Email | Для пошуку клієнта |
| payment.status | Оплата.Статус | paid, pending, failed |
Чек-лист інтеграції з сайтом
- Визначено джерело правди.
- Описано всі сценарії обміну.
- Описано товари, ціни, залишки.
- Описано замовлення.
- Описано клієнтів.
- Описано оплати.
- Описано статуси.
- Описано доставку.
- Є унікальні ідентифікатори.
- Є мапінг полів.
- Є API або формат файлів.
- Є авторизація.
- Є HTTPS.
- Є логування.
- Є обробка помилок.
- Є повторна відправка.
- Є захист від дублів.
- Є тестове середовище.
- Є моніторинг.
- Є відповідальні.
- Є Power BI або інша аналітика.
Типові питання
Що таке інтеграція з сайтом?
Інтеграція з сайтом — це автоматичний обмін даними між сайтом або інтернет-магазином і внутрішньою системою компанії: ERP, CRM, складом, фінансами або сервісом.
Які дані найчастіше інтегрують із сайтом?
Найчастіше інтегрують товари, ціни, залишки, замовлення, клієнтів, оплати, статуси доставки, документи, заявки й рекламації.
Що має бути джерелом правди для цін і залишків?
Зазвичай ERP або WMS. Сайт має отримувати ціни й доступні залишки з внутрішньої системи, а не жити окремим життям.
Чому важливо передавати доступний залишок, а не фізичний?
Бо частина товару може бути зарезервована під інші замовлення. Якщо сайт продає фізичний залишок без урахування резервів, клієнт може купити товар, якого фактично вже немає для продажу.
Що краще: API чи файловий обмін?
API краще для оперативного обміну, замовлень, статусів, оплат і кабінету клієнта. Файловий обмін простіший, але часто повільніший і менш зручний для обробки помилок.
Навіщо потрібні логи інтеграції?
Щоб бачити, які дані передавались, коли, з яким результатом і з якою помилкою. Без логів дуже важко зрозуміти, де саме зламався обмін.
Коротко
| Питання | Відповідь |
|---|---|
| Що це? | Автоматичний обмін даними між сайтом і ERP/CRM/WMS/іншими системами. |
| Основні дані | Товари, ціни, залишки, замовлення, клієнти, оплати, статуси, доставка, документи. |
| Головний принцип | Визначити джерело правди для кожного типу даних. |
| Основні технології | API, JSON, XML, webhooks, файловий обмін, middleware. |
| Основний ризик | Різні дані на сайті й в ERP: ціни, залишки, клієнти, статуси. |
| Найкраща практика | API, унікальні ID, логування, обробка помилок, моніторинг, безпека і Power BI-аналітика. |
Висновок
Інтеграція з сайтом — це ключовий елемент сучасної автоматизації продажів, сервісу, B2B-порталів, інтернет-магазинів і клієнтських кабінетів. Вона дозволяє автоматично передавати товари, ціни, залишки, замовлення, клієнтів, оплати, статуси доставки, документи, заявки й рекламації між сайтом і ERP.
Якісна інтеграція з сайтом зменшує ручну роботу, прискорює обробку замовлень, знижує кількість помилок, покращує клієнтський досвід і дає керівництву прозору аналітику.
Хороша інтеграція з сайтом — це коли клієнт бачить актуальну ціну, купує доступний товар, замовлення автоматично потрапляє в ERP, склад швидко збирає відвантаження, а менеджер не копіює дані вручну як герой минулого століття.
У сучасній ERP, зокрема в K2 ERP, інтеграція з сайтом має бути пов’язана з товарами, цінами, залишками, замовленнями, клієнтами, оплатами, доставкою, рекламаціями, документами, API, webhooks, audit log, правами доступу і Power BI. Тоді сайт стає не окремою вітриною, а повноцінною частиною керованого бізнес-процесу.
Див. також
- API
- Інтеграція через JSON
- HTTP-сервіси
- Webhooks
- CRM
- ERP
- K2 ERP
- K2 Cloud ERP
- Складський облік
- Штрихкодування
- Адресне зберігання
- Замовлення покупця
- Контрагент
- Договір
- Типи цін
- Партії
- Управління доставкою
- ТТН
- Рекламації
- Повернення товарів
- Архів документів
- База знань
- Power BI
- BI система
- Audit log
- Права доступу в ERP
- Українське програмне забезпечення
Зовнішні посилання
- Сторінки, де ігноруються відображувані назви
- Сторінки, які містять помилки підсвічення синтаксису
- Інтеграція з сайтом
- Інтеграція
- API
- JSON
- XML
- Webhooks
- HTTP-сервіси
- Інтернет-магазин
- B2B-портал
- Особистий кабінет
- CRM
- ERP
- K2 ERP
- K2 Cloud ERP
- Сайт
- Каталог товарів
- Товари
- Ціни
- Типи цін
- Залишки
- Замовлення
- Замовлення покупця
- Контрагенти
- Оплати
- Доставка
- ТТН
- Рекламації
- Повернення товарів
- Складський облік
- Power BI
- BI
- Audit log
- Права доступу в ERP
- Українське програмне забезпечення