# SAP Business One + Krokul CRM

Так. Krokul CRM інтегрується з SAP Business One. Контрагенти стають бізнес-партнерами, виграні угоди стають замовленнями покупця з позиціями, а рахунки покупцям і вхідні платежі, проведені в SAP Business One, повертаються на угоду в Krokul. Звʼязка працює через SAP Business One Service Layer, а власні потоки будуються на API і вебхуках Krokul.

**Статус:** Через API і вебхуки.

## Що отримує команда

### Контрагент стає бізнес-партнером

Новий контрагент у Krokul створює клієнта в BusinessPartners з назвою, податковим номером і адресами. SAP Business One повертає CardCode, і Krokul зберігає його як зовнішній ключ компанії. Подальші правки в Krokul оновлюють того самого бізнес-партнера, другий запис не зʼявляється.

### Виграна угода стає замовленням

Коли угоду виграно, Krokul створює документ в Orders із CardCode покупця і рядком у DocumentLines на кожен товар угоди з ItemCode, кількістю й ціною. Склад комплектує й відвантажує за цим замовленням у SAP Business One. Номер замовлення лягає на угоду, і менеджер називає його клієнтові.

### Рахунки й вхідні платежі повертаються

За розкладом Krokul читає Invoices і IncomingPayments, змінені після попереднього проходу. Рахунок покупцеві ставить статус рахунку на угоді. Кожен вхідний платіж стає фактом оплати. Відділ продажів бачить, що фінанси виставили й отримали, без ліцензії SAP для менеджерів.

### Довідник товарів SAP у каталозі Krokul

Сутність Items наповнює перелік товарів Krokul за ItemCode. Менеджери складають пропозиції з тих самих позицій, що лежать на складі. Тому кожен рядок замовлення вказує на товар, який SAP Business One уже знає.

### Швидші оновлення через Integration Framework

Партнери, які використовують Integration Framework для SAP Business One, розгортають сценарій Krokul. Event Sender забирає зміни бізнес-партнерів, рахунків і вхідних платежів, а сценарій надсилає ключ обʼєкта на адресу вебхука Krokul. Krokul одразу читає цей запис.

## Що передається між системами

| SAP Business One | Krokul | Напрям | Коли |
|---|---|---|---|
| BusinessPartners (клієнт, CardCode) | Контрагент | Krokul → SAP Business One | Контрагента створено чи змінено |
| Items (ItemCode) | Товар | SAP Business One → Krokul | Читання за розкладом |
| Orders із DocumentLines | Виграна угода з товарами | Krokul → SAP Business One | Угоду виграно |
| Invoices (рахунок покупцеві) | Статус рахунку на угоді | SAP Business One → Krokul | Читання за розкладом чи подія фреймворку |
| IncomingPayments | Факт оплати на угоді | SAP Business One → Krokul | Читання за розкладом чи подія фреймворку |
| CardCode, DocEntry | Зовнішній ключ запису Krokul | SAP Business One → Krokul | Одразу після кожного створення |

## Як підключити сьогодні

### Власний потік через API і вебхуки Krokul

1. Створіть ключ API Krokul зі scope для контрагентів, угод, товарів і оплат. На боці SAP відкрийте Service Layer через HTTPS і заведіть окремого користувача для інтеграції.
2. Увійдіть запитом POST /Login (CompanyDB, UserName, Password) і передавайте кукі B1SESSION у кожному наступному виклику.
3. Підпишіть вебхук Krokul на clientCompany.created і card.won, перевіряйте x-crm-signature кожної доставки, потім створюйте запис у BusinessPartners чи Orders і зберігайте CardCode чи DocEntry через externalRef/api-upsert.
4. Читайте Invoices і IncomingPayments з $filter за датою зміни, знаходьте угоду через externalRef/api-resolve і записуйте кожну оплату через payment/api-create з її cardUuid.

### Для інтеграторів

Service Layer є сервісом OData, і SAP називає OData версії 4 його основним протоколом. Колекції приймають $select, $filter, $orderby, $top і $skip, а /$metadata описує поля. На боці Krokul externalRef/api-upsert пише за ключем SAP без попереднього пошуку, ліміт запитів відповідає 429 з Retry-After, а кожна доставка вебхука несе підпис HMAC-SHA256 і ID доставки для дедуплікації.

[Документація API](https://app.krokul.com/api/v1/docs)

## Питання й відповіді

### Чи інтегрується Krokul з SAP Business One?

Так. Krokul обмінюється з SAP Business One бізнес-партнерами, товарами, замовленнями покупців, рахунками й вхідними платежами через Service Layer, а власні потоки працюють на API і вебхуках Krokul.

### Чи замінює Krokul SAP Business One?

Ні. SAP Business One веде склад, закупівлі, рахунки й бухгалтерію. Krokul веде воронку продажів, пропозиції й роботу з клієнтами і передає виграні угоди в SAP Business One як замовлення.

### Чи працює це з SAP Business One у власній мережі?

Так, якщо Service Layer відповідає через HTTPS ззовні вашої мережі. Партнери зазвичай публікують його через зворотний проксі або тунель.

### Як швидко оплати потрапляють у Krokul?

Читання за розкладом забирає їх на наступному проході. Зі сценарієм Krokul в Integration Framework Event Sender повідомляє про кожну зміну одразу.

## Обмеження

SAP Business One лишається обліковою ERP для складу, закупівель, виробництва, рахунків і головної книги. Krokul веде продажі. Service Layer, встановлений у вашій мережі, має бути доступним ззовні через HTTPS. Для цього партнер SAP відкриває публічну адресу або налаштовує тунель.

## Пов’язані сервіси

- [NetSuite](https://krokul.com/uk/integrations/netsuite/index.md)
- [Business Central](https://krokul.com/uk/integrations/dynamics-365-business-central/index.md)
- [QuickBooks Online](https://krokul.com/uk/integrations/quickbooks-online/index.md)
- [Xero](https://krokul.com/uk/integrations/xero/index.md)
- [Sage Accounting](https://krokul.com/uk/integrations/sage-accounting/index.md)

[Облік і бухгалтерія](https://krokul.com/uk/integrations/category/accounting/index.md)

SAP і SAP Business One є торговими марками або зареєстрованими торговими марками SAP SE. Krokul не афілійований із SAP.

Оновлено: 2026-10-15

---

Застосунок: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs