# Avalara + Krokul CRM

Так. Krokul CRM інтегрується з Avalara AvaTax. КП і рахунки отримують податок з продажу (sales tax) з AvaTax, виставлені рахунки фіксуються як транзакції AvaTax, скасовані рахунки там анулюються, а сертифікати звільнення від податку зберігаються з покупцем в AvaTax. Виклики йдуть через застосунок Krokul у Make або через API і вебхуки Krokul.

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

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

### Податок у КП до того, як клієнт погодився

Коли менеджер готує КП, Krokul надсилає її рядки й адресу доставки в CreateTransaction як SalesOrder, який AvaTax розраховує без запису. Податок за кожним рядком з’являється в КП, і клієнт одразу бачить повну суму.

### Виставлений рахунок зафіксовано в AvaTax

Виставлення рахунку надсилає транзакцію SalesInvoice з тим самим кодом документа, а коли рахунок остаточний, конектор фіксує її через CommitTransaction. Код транзакції AvaTax лишається на рахунку Krokul як його зовнішній ключ.

### Скасований чи змінений рахунок збігається з AvaTax

Скасування рахунку в Krokul викликає VoidTransaction для його транзакції AvaTax. Зміна після фіксації йде через AdjustTransaction, а повернення через RefundTransaction, тож запис AvaTax відповідає документу Krokul.

### Адресу перевірено один раз

Коли створено контрагента або змінено його адресу, конектор запускає ResolveAddress. Нормалізовану адресу Krokul пропонує менеджеру, а адреса, яку AvaTax не може розпізнати, стає задачею до першого рахунку.

### Сертифікати звільнення під рукою

Для покупця, звільненого від податку, конектор створює клієнта AvaTax через CreateCustomers і додає сертифікат звільнення через CreateCertificates. Наступні транзакції цього клієнта несуть збережений код клієнта, і AvaTax застосовує звільнення.

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

| Avalara AvaTax | Krokul | Напрям | Коли |
|---|---|---|---|
| Транзакція (SalesOrder) | КП (документ) з податком за рядками | Krokul → AvaTax → Krokul | КП збережено |
| Транзакція (SalesInvoice, CommitTransaction) | Рахунок (документ) | Krokul → AvaTax → Krokul | Рахунок виставлено |
| VoidTransaction, AdjustTransaction, RefundTransaction | Скасований, змінений чи повернений рахунок | Krokul → AvaTax | Рахунок змінено після фіксації |
| Адреса (ResolveAddress) | Адреса контрагента | Krokul → AvaTax → Krokul | Створено контрагента або змінено його адресу |
| Клієнт і сертифікат (CreateCustomers, CreateCertificates) | Контрагент, звільнений від податку | Krokul → AvaTax | Додано сертифікат звільнення |

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

### Застосунок Krokul у Make

1. Підключіть у Make застосунок Krokul ключем API Krokul, а застосунок Avalara AvaTax за account ID і license key компанії AvaTax.
2. Почніть сценарій із тригера Krokul Document Created і надішліть рядки в CreateTransaction через модуль Avalara Make an API Call.
3. Через Get a Transaction чи Search Transactions by Company перевіряйте, що AvaTax записав для рахунку.

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

1. Випустіть ключ API Krokul зі scope на документи й контрагентів і виберіть середовище AvaTax, sandbox чи production.
2. Підпишіть вебхук Krokul на document.created і перевіряйте його заголовок x-crm-signature своїм секретом. За x-crm-delivery відкидайте повторні доставки.
3. Викличте CreateTransaction для КП чи рахунку, потім запишіть податок за рядками назад через document/api-setItems.
4. Збережіть код транзакції AvaTax на рахунку через externalRef/api-upsert, щоб пізніше анулювання чи коригування знайшло його через externalRef/api-resolve.

**Дії:** Get a Transaction; Search Transactions by Company; Make an API Call.

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

AvaTax REST v2 має CreateTransaction, CommitTransaction, AdjustTransaction, VoidTransaction, RefundTransaction, ResolveAddress, CreateCustomers і CreateCertificates. Krokul додає публічний API, підписані вебхуки з `x-crm-delivery` для дедуплікації і зовнішні ключі, тож ваш код знаходить транзакцію AvaTax для будь-якого рахунку Krokul через `externalRef/api-resolve`.

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

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

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

Так. Krokul інтегрується з Avalara через застосунок Krokul у Make, а також через свій API і вебхуки. У Make застосунок Krokul працює поруч із застосунком Avalara AvaTax.

### Чи рахує Krokul податок з продажу сам?

Ні. Krokul питає AvaTax і зберігає результат у рядках документа. Якщо ви натомість нараховуєте ПДВ за фіксованою ставкою, Krokul бере ставку, задану в кожному рядку.

### Чи є тригер Avalara, щоб запустити потік?

Ні. AvaTax відповідає на запити, а застосунок Avalara AvaTax у Make має тільки дії й пошуки. Потоки стартують від подій Krokul або за розкладом.

### Що відбувається, коли рахунок Krokul скасовано?

Потік викликає VoidTransaction для транзакції AvaTax цього рахунку. Транзакцію він знаходить за зовнішнім ключем, який Krokul зберігає на рахунку.

## Обмеження

Податкові декларації, їх подання й сплата лишаються за Avalara. AvaTax відповідає на виклики й не надсилає подій назад, тому кожен результат приходить у Krokul відповіддю на запит конектора.

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

- [PEPPOL](https://krokul.com/uk/integrations/peppol/index.md)
- [QuickBooks Online](https://krokul.com/uk/integrations/quickbooks-online/index.md)
- [NetSuite](https://krokul.com/uk/integrations/netsuite/index.md)
- [Xero](https://krokul.com/uk/integrations/xero/index.md)
- [Stripe](https://krokul.com/uk/integrations/stripe/index.md)

[Податки й електронні рахунки](https://krokul.com/uk/integrations/category/tax-einvoicing/index.md)

Avalara і AvaTax є торговими марками Avalara, Inc. Krokul не афілійований з Avalara.

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

---

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