# NetSuite + Krokul CRM

Так. Krokul CRM інтегрується з Oracle NetSuite. Контрагенти стають записами клієнтів, виграні угоди стають замовленнями на продаж, а рахунки й оплати клієнтів, проведені в NetSuite, оновлюють угоду в Krokul. Зв’язок працює через застосунок Krokul у Zapier і Make або через REST web services NetSuite у парі з API і вебхуками Krokul.

**Статус:** Через API і вебхуки. **Платформи автоматизації:** Zapier, Make.

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

### Запис клієнта за зовнішнім ідентифікатором

Коли в Krokul створюють контрагента, конектор створює або оновлює запис customer у NetSuite за зовнішнім ідентифікатором, тож повторна синхронізація оновлює того самого клієнта. Внутрішній ідентифікатор NetSuite повертається в контрагента Krokul як його зовнішній ключ.

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

Виграна угода з рядками створює в NetSuite запис sales order з товарами, кількостями й цінами, погодженими в Krokul. Далі NetSuite веде відвантаження й виставлення рахунку за вашими правилами погодження.

### Рахунки й оплати читаються через SuiteQL

За розкладом конектор виконує запити SuiteQL до записів invoice і customer payment, змінених від минулого читання. Кожен рахунок прив’язується до своєї угоди в Krokul, а кожна оплата клієнта стає фактом оплати. Продажі бачать, що NetSuite виставив і що зібрав.

### Скрипт для майже миттєвих оновлень

Акаунти, яким потрібні швидші оновлення, розгортають скрипт Krokul типу User Event. Його точка входу afterSubmit спрацьовує, коли зберігають рахунок чи оплату, і через модуль N/https надсилає ідентифікатор запису на адресу вебхука Krokul. Конектор одразу читає цей запис.

### Товари синхронізовані

Конектор читає записи item з NetSuite в каталог Krokul за внутрішнім ідентифікатором, тож кожен рядок замовлення на продаж, який створює Krokul, вказує на товар, що вже є в NetSuite.

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

| NetSuite | Krokul | Напрям | Коли |
|---|---|---|---|
| Запис клієнта (customer) | Контрагент | Krokul → NetSuite | Контрагента створено чи змінено |
| Запис товару (item) | Товар | NetSuite → Krokul | Читання SuiteQL за розкладом |
| Замовлення на продаж (sales order) | Виграна угода з рядками | Krokul → NetSuite | Угоду виграно |
| Рахунок (invoice) | Статус рахунку на угоді | NetSuite → Krokul | Читання SuiteQL або скрипт User Event |
| Оплата клієнта (customer payment) | Факт оплати на угоді | NetSuite → Krokul | Читання SuiteQL або скрипт User Event |
| Внутрішній ідентифікатор | Зовнішній ключ запису Krokul | NetSuite → Krokul | Одразу після кожного створення |

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

### Застосунок Krokul у Zapier чи Make

1. Підключіть застосунок Krokul ключем API Krokul. У Zapier застосунку NetSuite потрібен Zapier Automation SuiteApp, а в Make застосунку NetSuite потрібен план Make Enterprise.
2. Від Krokul до NetSuite тригер Krokul Company Created запускає дію NetSuite Upsert (Create or Update) Record для клієнта, а Deal Won запускає Create Record для замовлення на продаж.
3. Від NetSuite до Krokul New Record (Saved Search) на рахунках чи оплатах клієнтів закінчується дією Krokul, наприклад Record Payment або Create Task.

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

1. Дайте своїй інтеграції ключ API Krokul зі scope на контрагентів, угоди й оплати, а в NetSuite увімкніть REST Web Services з OAuth 2.0.
2. Підпишіть вебхук Krokul на clientCompany.created і card.won і перевіряйте заголовок x-crm-signature кожної доставки, перш ніж писати в NetSuite.
3. Після кожного створення в NetSuite зберігайте внутрішній ідентифікатор на записі Krokul через externalRef/api-upsert.
4. Читайте змінені рахунки й оплати клієнтів через SuiteQL за розкладом і надсилайте кожну оплату в payment/api-create із cardUuid її угоди.

**Тригери:** New Record; New Record (Saved Search); New Or Updated Record.

**Дії:** Create Record; Update Record; Upsert (Create or Update) Record; Transform Record; Find Record; Run SuiteQL Query.

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

REST web services NetSuite охоплюють CRUD записів, перетворення записів, запити SuiteQL і метадані, а нові інтеграції Oracle радить будувати на REST з OAuth 2.0. На перевищення ліміту Krokul відповідає 429 з `Retry-After`, підписує свої вебхуки HMAC-SHA256, а `externalRef/api-upsert` дає скрипту NetSuite писати в Krokul за ідентифікатором NetSuite без попередньої перевірки.

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

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

### Чи інтегрується Krokul з Oracle NetSuite?

Так. Krokul інтегрується з Oracle NetSuite через застосунок Krokul у Zapier і Make, а також через своє API і вебхуки.

### Чи має NetSuite вебхуки?

REST web services NetSuite не пропонують загальної підписки на вебхуки. Krokul читає зміни через SuiteQL, а необов’язковий скрипт Krokul типу User Event надсилає в Krokul сповіщення, коли запис збережено.

### Хто має володіти рахунком, Krokul чи NetSuite?

Як правило, рахунками володіє NetSuite, бо проводить їх у головну книгу. Krokul веде угоду й отримує статус оплати, тож продажі бачать, що оплачено, без доступу до NetSuite.

### Що має зробити адміністратор NetSuite?

Увімкнути REST Web Services і OAuth 2.0, створити запис інтеграції й дати Krokul роль із доступом до типів записів, що синхронізуються. Для розгортання необов’язкового скрипта User Event потрібна роль із правами SuiteScript.

## Обмеження

NetSuite лишається обліковою системою для відвантаження, виставлення рахунків, виручки й головної книги. Загальної підписки на вебхуки NetSuite не має, тож зміни доходять до Krokul читанням SuiteQL за розкладом або через скрипт Krokul типу User Event, який ви розгортаєте у своєму акаунті.

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

- [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)
- [Avalara](https://krokul.com/uk/integrations/avalara/index.md)

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

Oracle і NetSuite є торговими марками Oracle та її афілійованих осіб. Krokul не афілійований з Oracle.

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

---

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