Перейти до вмісту

Інтеграція з банком

Матеріал з K2 ERP Wiki

Синхронізація має змогу бути:

Клієнти можуть створюватися на сайті й передаватися в ERP.; Приклади типів систем: замовник має змогу бачити:

API інтеграційні функціональні можливості

Сайт → ERP: замовлення, клієнти, оплати, заявки

Які інформаційні дані найчастіше інтегрують із сайтом?

} Сайт має змогу бути побудований на CMS або e-commerce платформі.; інтеграційні функціональні можливості з сайтом часто потрібна для особистого кабінету клієнта.; * очікує оплати;

  • оплачено;
  • частково оплачено;
  • помилка оплати;
  • повернення коштів;
  • скасовано;
  • chargeback;
  • потребує перевірки.; Для системи без правил — чотири різні клієнти і майбутнє свято в актах звірки.; |-

| 16.05.2026 11:25 | Створення замовлення WEB-125 | OK | Створено SO-2026-00125 |- | 16.05.2026 11:26 | Передача оплати | Error | Невідома валюта |}

Приклад процесу:

[[Категорія:Рекламації]]

{| class="wikitable" style="width:100%;"

* товар не знайдено;
* замовник уже існує;
* неправильний формат JSON;
* відсутнє обов’язкове поле;
* неправильна валюта;
* немає залишку;
* ціна неактуальна;
* API недоступний;
* timeout;
* дубль замовлення;
* неправильний токен;
* помилка доставки;
* помилка платіжної системи.; Приклад товару:
}
[[Категорія:Ціни]]
Приклад:
 ↓
 "email": "ivan@example.com",
Приклади форм:

== Типові помилки інтеграції з сайтом ==

 ↓

ERP → Сайт: товари, ціни, залишки, статуси

!;== Чек-лист інтеграції з сайтом ==
== Webhooks ==
 "currency": "UAH"

</syntaxhighlight>

Audit log має фіксувати:

API — це інтерфейс, через який сайт і ERP обмінюються даними.; # є собою HTTPS.; Перевірив товар.; Приклад:

{

!; Якщо менеджер змінює ціну в ERP, а маркетолог — на сайті, через тиждень вони обидва впевнені, що праві.; # є собою Power BI або інша аналітичні інструменти.;

{

JSON в інтеграції з сайтом

У сучасній ERP, зокрема в [[K2 ERP]], інтеграційні функціональні можливості з сайтом має бути пов’язана з товарами, цінами, залишками, замовленнями, клієнтами, оплатами, доставкою, рекламаціями, документами, API, webhooks, audit log, правами доступу і Power BI.; !; "price": 1200.00
 }
Менеджер: вибачається.; Приклад
=== Навіщо потрібні логи інтеграції? ===
Куди потрапляють замовлення з сайту?; Маркетплейс → Сайт → ERP

'''інтеграційні функціональні можливості з сайтом''' — це налаштований обмін даними між сайтом і внутрішніми системами компанії.; Наслідок

замовник має скріншот найнижчої.; # є собою обробка помилок.;<syntaxhighlight lang="json">

<syntaxhighlight lang="text">

* товари;
* ціни;
* залишки;
* замовлення;
* статуси;
* доставки;
* повернення;
* рекламації;
* комісії.; # Описано замовлення.; }

}

Передаються:

Найпоширеніші сценарії:
{
B2B-портал — це сайт або особистий кабінет для корпоративних клієнтів.; # Описано всі сценарії обміну.; # Описано товари, ціни, залишки.; Файловий обмін простіший, але часто повільніший і менш зручний для обробки помилок.; Звідки сайт бере залишки?;<syntaxhighlight lang="text">

замовник: оплачує.; Одна з типових проблем інтеграції — дублювання клієнтів.; * ПІБ або назва компанії;
* телефон;
* email;
* ЄДРПОУ або ІПН;
* адреса;
* контактна особа;
* тип клієнта;
* сегмент;
* джерело;
* згода на обробку даних;
* особистий кабінет;
* реквізити;
* договори.; Перевірити статус оплати.; "price": 1200.00
Сайт має іншу.; замовник оформлює замовлення

 "carrier": "nova_poshta",
;

Для цього потрібні унікальні ідентифікатори.; {

"type": "wholesale",

Як сайт отримує документи?; Без external_id інтеграційні функціональні можливості оперативно перетворюється на гру “це те саме замовлення чи дуже схоже?”.; !; Сайт має отримувати ціни й доступні залишки з внутрішньої системи, а не жити окремим життям.; "phone": "+380000000000" Приклад:

7.;
 "brand": "ExampleBrand",
Іноді сайт функціонує разом із маркетплейсами.; {

Без інтеграції менеджер часто робить так:
функціональні можливості:
 ↓
=== Що має бути джерелом правди для цін і залишків? ===
== Права доступу ==
== Висновок ==

замовник бачить статус у кабінеті

2.; Поле сайту

Приклад:

== Помилка: немає моніторингу інтеграції ==
== Способи інтеграції з сайтом ==
{| class="wikitable" style="width:100%;"
|-
| Сайт
| Створення замовлень, читання товарів, цін і залишків
|-
| Особистий кабінет
| Читання документів тільки свого клієнта
|-
| Платіжний компонент
| Передача статусів оплат
|-
| Сервіс рекламацій
| Створення рекламацій і вкладень
|-
| Адміністратор інтеграції
| Перегляд логів і повтор обміну
|}

<syntaxhighlight lang="http">

<syntaxhighlight lang="text">

 "warehouse": "MAIN",

* хто змінив конфігурація інтеграції;
* хто змінив API-ключ;
* хто повторив обмін;
* хто змінив мапінг полів;
* хто змінив правила цін;
* хто змінив складський облік для залишків;
* хто змінив доступи сайту;
* хто скасував замовлення;
* хто змінив статус;
* хто видалив лог або запис.;[[Категорія:Оплати]]
|-
| Що це?; |-
| Прийнято
| Нове замовлення
| Замовлення отримано
|-
| Підтверджено
| Погоджено
| Менеджер перевірив замовлення
|-
| Комплектується
| На відборі
| складський облік збирає товар
|-
| Відправлено
| Відвантажено
| Товар передано перевізнику
|-
| Доставлено
| Закрито
| Замовлення виконано
|-
| Скасовано
| Скасовано
| Замовлення не виконується
|}

[[Категорія:Складський облік]]

 "type": "company",

 "name": "Іван",

Як оновлюються статуси замовлень?; Файловий обмін застосовується, коли API немає або інтеграційні функціональні можливості проста.; # Описати напрям обміну.; Виглядає сучасно, а функціонує як факс у новому корпусі.; інтеграційні функціональні можливості — це двері між вітриною і реальним бізнесом.;<syntaxhighlight lang="text">
[[Категорія:Power BI]]
замовник бачить актуалізація в кабінеті

 ↓

 "attachments": ["photo1.jpg", "photo2.jpg"]

Як передаються оплати?;== Тестування інтеграції ==

== Для чого потрібна інтеграційні функціональні можливості з сайтом ==
}
}
__TOC__
{{DISPLAYTITLE:Інтеграція з сайтом}}
інтеграційні функціональні можливості з сайтом потрібна для:

!;== Обробка замовлення з сайту в ERP ==
Приклад:

{

 "status": "paid",

Webhook зручний тим, що платформа не питає кожні 5 хвилин “ну що там?”, а надсилає повідомлення, коли щось справді сталося.;=== Що краще: API чи файловий обмін? ===

* різна ціна;
* різний залишок;
* різний статус;
* різний замовник;
* дубль замовлення;
* замовлення скасоване на сайті, але активне в ERP;
* товар видалений на сайті, але активний в ERP;
* оплата є собою на сайті, але немає в ERP.; "erp_order_id": "SO-2026-00125"

[[Категорія:Каталог товарів]]
== Джерело правди ==
Приклади:
"customer_id": "WEB-CUST-00125",

Content-Type: application/json Статуси дозволяють клієнту бачити, що відбувається із замовленням.; інтеграційні функціональні можливості з сайтом — це автоматичний обмін даними між сайтом або інтернет-магазином і внутрішньою системою компанії: ERP, CRM, складом, фінансами або сервісом.; - бачить статус доставки;

2.; Перевірити створення замовлення в ERP.;

ERP створює замовлення покупця

 <price currency="UAH">1200.00</price>
}
</div>

== Помилка: ціни змінюються вручну на сайті ==

Приклад:

* автоматичного актуалізація каталогу товарів;
* показу актуальних цін;
* показу актуальних залишків;
* приймання замовлень із сайту в ERP;
* створення клієнтів і контактів;
* передачі оплат;
* передачі статусів замовлення;
* синхронізації доставки;
* формування рахунків;
* роботи з особистим кабінетом клієнта;
* обміну документами;
* контролю повернень;
* контролю рекламацій;
* автоматизації B2B-порталу;
* зменшення ручних помилок;
* пришвидшення обробки замовлень;
* підключення аналітики в [[Power BI]].; Час
[[Категорія:Audit log]]
== Логування інтеграції ==
'''Проста аналогія.''' Сайт — це вітрина магазину.; !; Якщо сайт продає фізичний залишок без урахування резервів, замовник має змогу купити товар, якого фактично вже немає для продажу.; Перевірив ціну.; ERP → Сайт → Маркетплейс

Етапи:

<syntaxhighlight lang="json">

{| class="wikitable" style="width:100%;"

* передача товарів;
* передача категорій;
* передача характеристик;
* передача фото;
* передача цін;
* передача залишків;
* приймання замовлень;
* створення клієнтів;
* обробка оплат;
* передача статусів;
* передача ТТН;
* особистий кабінет клієнта;
* B2B-портал;
* заявки з сайту;
* рекламації;
* сервісні звернення;
* API;
* webhooks;
* логування обміну;
* audit log;
* права доступу;
* Power BI-аналітика.;{{SEO
|title=Інтеграція з сайтом — ERP, інтернет-магазин, API, товари, ціни, залишки, замовлення і K2 ERP
|description=Інтеграція з сайтом: що це таке, як обмінювати товари, ціни, залишки, замовлення, клієнтів, оплату і статуси між ERP та сайтом. API, JSON, webhooks, безпека, ERP, K2 ERP, Power BI, типові помилки і приклади.
|keywords=інтеграція з сайтом, інтеграція ERP з сайтом, інтернет-магазин, API, JSON, webhooks, товари, ціни, залишки, замовлення, клієнти, K2 ERP, CRM, CMS
}}

* номер замовлення на сайті;
* дата;
* замовник;
* контактні інформаційні дані;
* товари;
* кількість;
* ціни;
* знижки;
* доставка;
* спосіб оплати;
* статус оплати;
* коментар клієнта;
* промокод;
* адреса доставки;
* перевізник;
* джерело замовлення.; Формати:
!; Помилка

== Файловий обмін ==
Менеджер має третю в Excel.; "reserved": 1
↓ </product>

інтеграційні функціональні можливості статусів замовлення

"name": "Товар А",

Краще:

"type": "demo_request",
; * заявка на консультацію;
  • запит ціни;
  • заявка на сервіс;
  • заявка на ремонт;
  • рекламація;
  • запит на демо;
  • підписка;
  • анкета клієнта;
  • запит документів;
  • заявка на партнерство;
  • форма зворотного зв’язку.; * кількість замовлень із сайту;
  • конверсія замовлень;
  • сума продажів;
  • середній чек;
  • популярні товари;
  • товари без залишку;
  • замовлення з помилками інтеграції;
  • дублікати клієнтів;
  • час обробки замовлення;
  • частка оплат онлайн;
  • рекламації з сайту;
  • повернення;
  • SLA обробки замовлень;
  • джерела трафіку;
  • ефективність акцій;
  • маржа по онлайн-продажах.; А має змогу вже пахне.; Статуси оплати:

sku,name,price,stock <product> API має змогу дозволяти:

"erp_order_id": "SO-2026-00125",

Див.; додатково

Приклади:

K2 ERP передає статус і ТТН на сайт

  • загальний залишок;
  • залишок по складах;
  • доступний залишок;
  • зарезервований залишок;
  • очікуване надходження;
  • дату поставки;
  • мінімальну кількість для продажу;
  • статус “під замовлення”;
  • статус “немає в наявності”.; # є собою авторизація.;
     },
    
    == Безпека інтеграції ==
    [[Категорія:ERP]]
    == інтеграційні функціональні можливості замовлень ==
    
Немає джерела правди інформаційні дані редагують і в ERP, і на сайті Різні ціни, залишки, описи
Не передають доступний залишок Передають фізичний залишок Продаж зарезервованого товару
Немає унікального ID Поганий мапінг Дублі замовлень і клієнтів
Немає логів Обмін не контролюється Неможливо знайти причину помилки
Немає повторної відправки Помилка губить інформаційні дані Замовлення не потрапляє в ERP
API має надмірні права Слабка безпека Ризик зміни або витоку даних
Не обробляють помилки Сайт показує “успіх”, ERP не створила замовлення замовник чекає, а бізнес-середовище не бачить замовлення
Немає тестового середовища Перевіряють на бойових даних Поломки в реальному продажі та реалізація

</syntaxhighlight>

 "sku": "ITEM-001",
Приклад CSV:

ERP перевіряє site_order_id.; }

"phone": "+380000000000",

Лог має містити:

{| class="wikitable" style="width:100%;"
[[Категорія:K2 ERP]]
Приклади подій:
<syntaxhighlight lang="xml">

Приклад:

інтеграційні функціональні можливості з маркетплейсами через сайт

Конфлікти даних

Товари ERP → Сайт Назва, артикул, характеристика, характеристики
Категорії ERP → Сайт Групи товарів, структура каталогу
Ціни ERP → Сайт Роздрібна, оптова, акційна, персональна
Залишки ERP → Сайт Доступна кількість по складах
Замовлення Сайт → ERP Замовлення покупця
Клієнти Сайт → ERP / ERP → Сайт Профіль клієнта, контакти, реквізити
Оплати Сайт → ERP Онлайн-оплата, статус платежу
Статуси ERP → Сайт Прийнято, зібрано, відправлено, доставлено
Доставка ERP ↔ Сайт Перевізник, ТТН, адреса, вартість
Документи ERP → Сайт Рахунок, акт, накладна, акт звірки
Рекламації Сайт → ERP Звернення клієнта щодо якості
Заявки Сайт → ERP Форма зворотного зв’язку, сервісна заявка

ITEM-002,Фільтр F-20,350,40

</syntaxhighlight>

  • ERP передає товари на сайт;
  • ERP передає ціни на сайт;
  • ERP передає залишки;
  • сайт передає замовлення в ERP;
  • сайт передає оплату;
  • ERP передає статус замовлення;
  • ERP передає номер ТТН;
  • сайт передає нових клієнтів;
  • замовник у кабінеті бачить документи;
  • замовник у кабінеті бачить борг або баланс;
  • сайт передає рекламацію;
  • ERP передає персональні ціни для B2B-клієнтів;
  • сайт показує доступність товару по складах;
  • ERP блокує продаж товару, якого немає в наявності.; # Описано оплати.; інтеграційні функціональні можливості з сайтом має мати обмежені права.; Коментар

ERP створює рекламацію, призначає відповідального, контролює SLA і запускає бізнес-процес розгляду.; Передаються:

ERP → Сайт

"warehouse": "KYIV",

Зазвичай ERP або WMS.; Статус на сайті

"items": [
"amount": 2400.00,

Для інтеграції істотно мати ID об’єктів.; # Запустити пілот.; Передаються:

"success": true,

Краще: Корисні дашборди:

інтеграційні функціональні можливості рекламацій із сайту

"shipped_at": "2026-05-16T16:45:00"

Бо частина товару має змогу бути зарезервована під інші замовлення.; Частота Джерело правди — це платформа, яка вважається головною для конкретного типу даних.;</syntaxhighlight>

Поганий сценарій:

  • номер платежу;
  • платіжна платформа;
  • сума;
  • валюта;
  • статус;
  • дата;
  • комісія;
  • замовлення;
  • замовник;
  • transaction id;
  • підтвердження платежу.; Коли щось падає, без нього всі без ускладнень дивляться одне на одного й кажуть: “У нас усе відправилось”.;
    Фізичний залишок - резерв = доступно для продажу.; замовник, звісно, вибирає нижчу ціну.; Джерело правди
    
    Статус повертається на сайт
    
     "name": "Насос промисловий NP-100",
    Сайт: показує “в наявності”.; "comment": "Хочу демо K2 ERP для виробництва"
     "tracking_number": "20450000000000",
     "payment_id": "PAY-WEB-00125",
     "reason": "damaged_goods",
    інтеграційні функціональні можливості з сайтом має бути захищена.;[[Категорія:Особистий кабінет]]
    
    !;[[Категорія:Інтернет-магазин]]
    
    інтеграційні функціональні можливості відповідає на питання:
    [[Категорія:Інтеграція]]
     
    |-
    | Замовлень із сайту за місяць
    | 2 450
    |-
    | Успішно передано в ERP
    | 98,7%
    |-
    | Помилок інтеграції
    | 32
    |-
    | Середній час створення замовлення в ERP
    | 12 секунд
    |-
    | Онлайн-оплат
    | 64%
    |-
    | Рекламацій із сайту
    | 18
    |}
    
    платформа не створює дубль.; Причина
    
істотно не заплутатись, де джерело правди.;== Основні сценарії інтеграції ==

інтеграційні функціональні можливості оплат

Сценарій:

{

{

"site_order_id": "WEB-2026-000125",

{

Приклад тест-кейсу:

  • замовник;
  • замовлення;
  • товар;
  • партія або серійний номер;
  • причина;
  • характеристика проблеми;
  • фото;
  • відео;
  • бажане рішення для бізнесу;
  • контакт;
  • дата.; Помилився в одному символі.; Погано:

Приклад:

; # Описано доставку.; Він не дурний.; "amount": 2400.00
<stock>15</stock>

Погано:

  • HTTPS;
  • токени доступу;
  • API-ключі;
  • термін дії токенів;
  • IP whitelist;
  • ролі доступу;
  • обмеження методів API;
  • логування запитів;
  • rate limiting;
  • захист персональних даних;
  • підпис webhooks;
  • шифрування;
  • резервні сценарії;
  • моніторинг помилок.; # Налаштувати логування.; ↓

Потрібні правила:

інтеграційні функціональні можливості має змогу бути односторонньою або двосторонньою.; "phone": "+380000000000",

"barcode": "4820000000012",
"event": "order.paid",
;</syntaxhighlight>
Залишки Кожні 5 хвилин або частіше істотно для продажів
Ціни Після зміни або щогодини Залежить від політики цін
Каталог Раз на день або після зміни Не завжди критично щосекунди
Замовлення Одразу Має оперативно потрапляти в ERP
Статуси За зміною статусу Для кабінету клієнта
; інформаційні дані
  • в реальному часі;
  • кожні кілька хвилин;
  • раз на годину;
  • раз на день;
  • за подією;
  • вручну за кнопкою;
  • пакетно вночі.; Причини:
↓
{
"currency": "UAH",
↓

Приклад двосторонньої інтеграції:

Приклад:
 ],
!; # Підготувати API або файловий формат.;== Коротко ==
Приклад:

Приклад:

"edrpou": "12345678",

складський облік збирає замовлення замовник має змогу створити рекламацію через сайт.; Статус в ERP </syntaxhighlight> складський облік отримує задачу на відбір істотно передавати саме доступний залишок, а не без ускладнень фізичний.; ERP має:

"price": 1050.00 Приклад:
  • персональні ціни;
  • договори;
  • кредитні ліміти;
  • відстрочка платежу;
  • замовлення за шаблонами;
  • повторення попереднього замовлення;
  • погодження замовлення всередині клієнта;
  • залишки по складах;
  • акти звірки;
  • документи;
  • обмеження асортименту;
  • історичний розвиток закупівель.; # Описати, які інформаційні дані передаються.; Якщо сайт приймає онлайн-оплати, статус платежу потрібно передавати в ERP.; Звідки сайт бере товари?;</syntaxhighlight>
Якщо обмін не пройшов, потрібен механізм повторної відправки.; 6.; ERP має одну ціну.; Помилки інтеграції неминучі.;== Audit log інтеграції ==
API Сайт і ERP обмінюються запитами Замовлення, товари, клієнти, статуси
Webhook Сайт або ERP надсилає подію при зміні Нове замовлення, оплата, зміна статусу
Файловий обмін інформаційні дані передаються файлами CSV, XML, JSON
Пряма інтеграційні функціональні можливості з базою Системи читають або пишуть у базу Рідко, з великими ризиками
Middleware Проміжний сервіс обміну Складні інтеграції між багатьма системами
Плагін CMS компонент для конкретної CMS WooCommerce, OpenCart, Shopify, інші CMS

</syntaxhighlight>

Конфлікт виникає, коли сайт і ERP мають різні інформаційні дані.; # є собою логування.;== Особистий кабінет клієнта == 3.; "site_order_id": "WEB-2026-000125",

"status": "created"
  • артикул;
  • назва;
  • характеристика;
  • категорія;
  • бренд;
  • характеристики;
  • одиниця виміру;
  • фото;
  • штрихкод;
  • вага;
  • габарити;
  • статус активності;
  • SEO-поля;
  • аналоги;
  • супутні товари;
  • серії;
  • модифікації.; # є собою повторна відправка.; Вставив у ERP.; "unit": "шт",
"claim_id": "WEB-CLAIM-00125",

Чому істотно передавати доступний залишок, а не фізичний?

"sku": "ITEM-001",
  • дату і час;
  • напрям обміну;
  • endpoint;
  • тип об’єкта;
  • ID на сайті;
  • ID в ERP;
  • статус;
  • помилку;
  • payload або його безпечну частину;
  • повторну спробу;
  • користувача або сервіс;
  • час відповіді.; # Визначити частоту синхронізації.; інтеграційні функціональні можливості саме для того, щоб таких сцен було менше.; Коментар

Лог інтеграції — це чорний ящик.; Поле ERP

"sku": "ITEM-001",

</syntaxhighlight>

 "prices": [
=== Що таке інтеграційні функціональні можливості з сайтом? ===
<syntaxhighlight lang="json">

Ціни ведуться в ERP.; Створити замовлення на сайті.; Приклад односторонньої інтеграції:

Приклад:

"sku": "ITEM-001",

ITEM-001,Насос NP-100,1200,15

;</syntaxhighlight>

</syntaxhighlight> Для людини це одне й те саме.; # є собою захист від дублів.;== інтеграційні функціональні можливості клієнтів ==

  • site_order_id;
  • erp_order_id;
  • sku;
  • customer_id;
  • payment_id;
  • transaction_id;
  • claim_id;
  • delivery_id;
  • product_guid;
  • external_id.; # є собою API або формат файлів.; "paid_at": "2026-05-16T12:05:00",
"created_at": "2026-05-16T11:25:00",

Хто є собою джерелом правди для даних?; * CSV;

  • XML;
  • JSON;
  • XLSX;
  • TXT.; Скопіював замовлення.; "delivery_method": "nova_poshta"
"email": "client@example.com"

}

Хороша інтеграційні функціональні можливості з сайтом — це коли замовник бачить актуальну ціну, купує доступний товар, замовлення автономно потрапляє в ERP, складський облік оперативно збирає відвантаження, а менеджер не копіює інформаційні дані вручну як герой минулого століття.

"payment_status": "paid",

інтеграційні функціональні можливості має змогу впасти непомітно.; Вона надає можливість автономно передавати товари, ціни, залишки, замовлення, клієнтів, оплати, статуси доставки, документи, заявки й рекламації між сайтом і ERP.;== Що можна інтегрувати з сайтом ==

; Бо якщо ERP, сайт і маркетплейс одночасно вирішують, яка ціна правильна, замовник купить там, де помилка найвигідніша.; Передаються:

Приклад: Сайт отримує ціни автономно.; Приклад відповіді:

product.sku Номенклатура.Артикул Унікальний артикул товару
product.name Номенклатура.Назва Назва товару
order.id ЗамовленняПокупця.ExternalID ID замовлення на сайті
customer.email Контрагент.Email Для пошуку клієнта
payment.status Оплата.Статус paid, pending, failed
"site_order_id": "WEB-2026-000125",
  1. Визначено джерело правди.; Відкрив сайт.;</syntaxhighlight>

Якісна інтеграційні функціональні можливості з сайтом зменшує ручну роботу, прискорює обробку замовлень, знижує кількість помилок, покращує клієнтський досвід і дає керівництву прозору аналітику.; Краще:

Приклад:

"stock": [

Дізналися від клієнта.; Якщо замовлення вже створено — повертає існуючий erp_order_id.; Можна передавати:

Товари, ціни, залишки Приклад:

"name": "ТОВ замовник",

Замовлення з сайту не створилося в ERP через timeout.; # Описано статуси.; * отримати список товарів;

  • отримати ціни;
  • отримати залишки;
  • створити замовлення;
  • створити клієнта;
  • оновити статус;
  • передати оплату;
  • створити рекламацію;
  • отримати документи;
  • перевірити доступність доставки.; # є собою мапінг полів.; * фіксувати помилку;
  • не втрачати інформаційні дані;
  • повідомляти відповідального;
  • дозволяти повторити обмін;
  • показувати зрозумілу причину;
  • не створювати дублікати при повторі.; * свої замовлення;
  • статуси;
  • рахунки;
  • акти;
  • накладні;
  • акти звірки;
  • баланс;
  • дебіторську заборгованість;
  • історію оплат;
  • персональні ціни;
  • договори;
  • рекламації;
  • сервісні заявки;
  • бонуси;
  • ліміти;
  • документи для завантаження.; І зазвичай голосніше за всіх сперечається замовник.; Подія

POST /api/orders Через 5 хвилин повторює запит.; інформаційні дані Ціни можуть змінюватися в ERP і автономно передаватися на сайт.; Типові помилки:

"currency": "UAH",
Якщо ERP бачить site_order_id, вона не створює друге замовлення.; XML теж застосовується, особливо в старіших або формалізованих інтеграціях.;

Що таке інтеграційні функціональні можливості з сайтом

- завантажує рахунок;

<syntaxhighlight lang="text">
{

Перед запуском потрібно протестувати:

== Синхронізація даних ==

* сайт повторно відправив замовлення;
* ERP не перевірила site_order_id;
* timeout сприйняли як помилку і створили друге замовлення.; !; # Описано клієнтів.; має змогу все добре.; Сайт передає замовлення в ERP

інтеграційні функціональні можливості без моніторингу  це як холодильник без лампочки й термометра.; !; {| class="wikitable" style="width:100%;"

* REST API;
* GraphQL API;
* webhooks;
* плагіни;
* модулі обміну;
* експорт-імпорт файлів;
* власну базу даних;
* обмеження інтеграції.; Без логів дуже важко зрозуміти, де саме зламався обмін.; Де застосовується

<syntaxhighlight lang="json">

}

[[Категорія:JSON]]

товарів забезпечується через '''Головне.''' інтеграційні функціональні можливості з сайтом надає можливість сайту продавати, приймати заявки або показувати інформаційні дані клієнту, а ERP  бути джерелом правди; додатково реалізовано цін, залишків, замовлень, оплат, клієнтів і документів.;<syntaxhighlight lang="json">

* хто центральний;
* як вирішувати конфлікт;
* як логувати помилку;
* кого повідомляти;
* чи можна автономно виправити;
* коли потрібна ручна перевірка.; Якщо дверей немає, хтось бігає туди-сюди з блокнотом і героїчно помиляється.; Перевірити резерв товару.; Передаються:

Audit log потрібен, щоб інтеграційні функціональні можливості не була “чорним ящиком із кнопкою, яку ніхто не натискав, але все зламалось”.; У ERP така форма має змогу створити ліда, задачу менеджеру, сервісну заявку або звернення підтримки.; Перевірити відповідь сайту клієнту.; Сайт передає замовлення в K2 ERP

* створено замовлення;
* оплачено замовлення;
* скасовано замовлення;
* змінено статус;
* створено рекламацію;
* товар став доступним;
* змінено ціну;
* створено клієнта.; |-
| Основні інформаційні дані
| Товари, ціни, залишки, замовлення, клієнти, оплати, статуси, доставка, документи.; # Налаштувати повторну відправку.; XML зручний для суворих схем, але зазвичай більш громіздкий, ніж JSON.; # є собою тестове середовище.; Отримав маленький бізнес-квест.; У [[K2 ERP]] інтеграційні функціональні можливості з сайтом має змогу забезпечувати обмін між ERP і вебресурсом компанії.; Погано:

 "sku": "ITEM-001",
переважні аспекти:
 "name": "ТОВ замовник",
4.; }
[[Категорія:HTTP-сервіси]]
 "site_order_id": "WEB-2026-000125",
 
Найчастіше інтегрують товари, ціни, залишки, замовлення, клієнтів, оплати, статуси доставки, документи, заявки й рекламації.;== Унікальні ідентифікатори ==
!; 

B2B-портал без інтеграції з ERP  це дуже красива форма ручного введення даних.; }

== Дублі клієнтів ==
"site_order_id": "WEB-2026-000125",

інтеграційні функціональні можливості з сайтом у K2 ERP

5.; # Навчити відповідальних.; Що означає }

Товари ERP Ціни ERP Залишки ERP / WMS Замовлення Сайт створює, ERP обробляє Оплати Платіжна платформа + ERP Клієнти CRM / ERP Статуси доставки ERP / служба доставки !; Провести онлайн-оплату.; # Налаштувати обробку помилок.; Тоді сайт стає не окремою вітриною, а повноцінною частиною керованого бізнес-процесу.;

3.; |-
| Найкраща практика
| API, унікальні ID, логування, обробка помилок, моніторинг, безпека і Power BI-аналітика.; Значення
 <name>Товар А</name>
 "provider": "payment_gateway",
4.; Спосіб
 "reserved": 3
 "email": "client@example.com",

{

== Приклад мапінгу полів ==

* [[API]]
* [[Інтеграція через JSON]]
* [[HTTP-сервіси]]
* [[Webhooks]]
* [[CRM]]
* [[ERP]]
* [[K2 ERP]]
* [[K2 Cloud ERP]]
* [[Складський облік]]
* [[Штрихкодування]]
* [[Адресне зберігання]]
* [[Замовлення покупця]]
* [[Контрагент]]
* [[Договір]]
* [[Типи цін]]
* [[Партії]]
* [[Управління доставкою]]
* [[ТТН]]
* [[Рекламації]]
* [[Повернення товарів]]
* [[Архів документів]]
* [[База знань]]
* [[Power BI]]
* [[BI система]]
* [[Audit log]]
* [[Права доступу в ERP]]
* [[Українське програмне забезпечення]]

[[Категорія:Типи цін]]

* [https://erp.kyiv.ua Сайт K2 ERP]
* [https://wiki.erp.kyiv.ua Wiki K2 ERP]
* [https://cloud.corp2.eu K2 Cloud ERP]

[[Категорія:Товари]]
<syntaxhighlight lang="text">
API краще для оперативного обміну, замовлень, статусів, оплат і кабінету клієнта.; "active": true

* спосіб доставки;
* перевізник;
* адреса;
* складський облік відвантаження;
* номер ТТН;
* статус доставки;
* вартість доставки;
* дата відправлення;
* дата доставки;
* контакт отримувача;
* коментар.; # Описати бізнес-процеси.; Коментар

{
== Обробка помилок ==

{ API без авторизації, бо “там же тільки залишки”.; інформаційні дані

{

</syntaxhighlight>

Типовий бізнес-процес:
Щоб бачити, які інформаційні дані передавались, коли, з яким результатом і з якою помилкою.;== інтеграційні функціональні можливості каталогу товарів ==
[[Power BI]] має змогу аналізувати інформаційні дані сайту й ERP.; Сервіс

* зрозумілий формат;
* зручний для вебсервісів;
* підтримується більшістю мов програмування;
* добре підходить для структурованих даних;
* без зайвих зусиль передавати вкладені об’єкти.; "sku": "ITEM-001",
 ]
Як ERP дізнається про заявки з сайту?; |-
| центральний принцип
| Визначити джерело правди для кожного типу даних.; |-
| ключовий ризик
| Різні інформаційні дані на сайті й в ERP: ціни, залишки, клієнти, статуси.; Бо ручне копіювання замовлень — це не цифровізація, а Excel-фітнес для терплячих людей.; {

Приклад API-запиту:

- бачить акт звірки;

Проблема виникає, коли сайт показує “в наявності”, менеджер каже “немає”, а ERP мовчить, бо її ніхто не питав.; 1.; Звідки сайт бере ціни?; !; |}

== Power BI для інтеграції з сайтом ==

== B2B-портал ==

- створює рекламацію.; Якщо обмін не проходить 10 хвилин або є собою 5 помилок підряд — платформа надсилає повідомлення відповідальному.; # Запустити в промислову експлуатацію.;
"customer": {
"site_order_id": "WEB-2026-000125",

ТОВ “Ромашка” ERP передає на сайт доступний залишок: JSON часто застосовують, коли потрібно для API.; },

<sku>ITEM-001</sku>

XML в інтеграції з сайтом

"currency": "UAH",

CMS має змогу мати: Ромашка ТОВ інтеграційні функціональні можливості з сайтом — це ключовий елемент сучасної автоматизації продажів, сервісу, B2B-порталів, інтернет-магазинів і клієнтських кабінетів.; ↓

Ціни мають мати джерело правди.;== Зовнішні посилання ==

"category": "Категорія 1",
}

6.; !; !; Напрям

},

!; }

K2 ERP створює замовлення покупця і резервує товар
8.;[[Категорія:Замовлення]]

Authorization: Bearer token

!; # є собою відповідальні.; "stock": 15,

 "description": "Пошкоджено корпус товару",

Каталог товарів часто ведеться в ERP, а сайт отримує актуальні інформаційні дані.;== інтеграційні функціональні можливості доставки ==

ТОВ "Ромашка" Причина: !; Доступ Приклад: Замовлення з сайту має автономно потрапляти в ERP.; * створення товару;

  • актуалізація ціни;
  • актуалізація залишку;
  • створення замовлення;
  • оплату;
  • скасування;
  • часткову оплату;
  • доставку;
  • повернення;
  • рекламацію;
  • дубль замовлення;
  • помилковий JSON;
  • timeout;
  • недоступність API;
  • неправильний токен;
  • відсутнє поле;
  • великі обсяги даних.; # Визначити джерело правди для даних.;
    == Помилка: замовлення дублюються ==
    
    Передаються:
    
    * інтернет-магазин;
    * корпоративний сайт;
    * B2B-портал;
    * маркетплейс;
    * клієнтський кабінет;
    * сервісний портал;
    * навчальний портал;
    * портал партнерів.; Відповідь
    
    замовник оформлює замовлення на сайті
    Замовлення не передаються 6 годин.; # Провести тестування.; Формується доставка
    Приклад:
    
    Якщо джерело правди не визначене, інформаційні дані оперативно починають сперечатися між собою.; Приклад:
    !; * роздрібна;
    * оптова;
    * дилерська;
    * акційна;
    * персональна;
    * за договором;
    * за сегментом клієнта;
    * за валютою;
    * за регіоном;
    * за кількістю.;<syntaxhighlight lang="text">
    
    !; Бо товар, який уже зарезервований під іншого клієнта, — це не товар “можна купити”, а майбутній конфлікт.; ERP — це складський облік, каса, бухгалтерський обліковий облік, закупівельна діяльність, ціни, клієнти й документи.; Перевірив залишок.; # Описати мапінг полів.; Якщо сайт має змогу “все”, то перша ж помилка або атака має змогу зробити “все” дуже буквально.; | Автоматичний обмін даними між сайтом і ERP/CRM/WMS/іншими системами.; # Налаштувати моніторинг.;== Впровадження інтеграції з сайтом ==
     "price": 1200.00,
    Потрібно контролювати:
     "delivery_status": "shipped",
    [[Категорія:CRM]]
    5.; # Налаштувати безпеку.;

Сайт має змогу передавати в ERP не тільки замовлення, а й форми.; # є собою моніторинг.; Як передаються клієнти?; # є собою унікальні ідентифікатори.; K2 ERP передає товари, ціни й залишки на сайт

]

це автоматичний обмін даними між сайтом, інтернет-магазином, порталом клієнта або корпоративним вебресурсом і внутрішньою системою компанії: ERP, CRM, WMS, HRM, фінансовою системою, складом, сервісом або K2 ERP виступає ключовою рисою інтеграційні функціональні можливості з сайтом.; { Простіше кажучи, інтеграційні функціональні можливості з сайтом потрібна, щоб товари, ціни, залишки, замовлення, клієнти, оплати, статуси доставки, документи й заявки не переносилися вручну з сайту в ERP і назад.; Сайт не повинен мати повний доступ до ERP.; |- | Основні технології | API, JSON, XML, webhooks, файловий обмін, middleware.; "category": "Промислове обладнання",

інтеграційні функціональні можливості цін

!; "available": 15, Усі обміни потрібно логувати.; Передаються:

Краще:

  • різні написання назви;
  • різні телефони;
  • різні email;
  • замовник оформив замовлення кілька разів;
  • організація вже є собою в ERP;
  • сайт не передає ЄДРПОУ;
  • немає правил пошуку дубля.; Питання

Сценарій: створення замовлення з оплатою.; Ручне редагування цін на сайті обмежене або заборонене.;== Типові питання ==

ERP перевіряє клієнта, ціни, залишки

Webhook — це повідомлення про подію.; "form_id": "FORM-2026-00045",

"quantity": 2,

Особливості: { </syntaxhighlight>

інтеграційні функціональні можливості залишків

"type": "retail",
Залишки потрібні, щоб сайт показував реальну доступність товару.; Значення
 "transaction_id": "TX123456789"
<syntaxhighlight lang="json">

Файловий обмін простий, але має ризики:

  • затримки;
  • дублікати;
  • помилки формату;
  • неповні інформаційні дані;
  • складна обробка помилок;
  • проблеми з версіями файлів.; замовник заходить у кабінет:

інтеграційні функціональні можливості з CMS

- бачить замовлення;

Сьогодні “тільки залишки”, завтра хтось створює фальшиве замовлення, післязавтра фінансовий відділ вивчає нові слова.; Показник 1.; Статус

</syntaxhighlight>

!;</syntaxhighlight>

Повторна відправка

Приклад статусів:

Помилка: сайт продає те, чого немає

інтеграційні функціональні можливості форм із сайту

"available": 7,
замовник: не дуже щасливий.; Товар резервується

Приклад:

ERP: товар зарезервований під іншого клієнта.; Сайт і ERP можуть обмінюватися даними доставки.; Типи цін: ТОВ Ромашка

<syntaxhighlight lang="text">