Інтеграція з банком
Інтеграція з сайтом — це автоматичний обмін даними між сайтом, інтернет-магазином, порталом клієнта або корпоративним вебресурсом і внутрішньою системою компанії: 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
- Українське програмне забезпечення