# Електронні рахунки PEPPOL + Krokul CRM

Так. Krokul CRM інтегрується з PEPPOL і надсилає рахунки мережею через вашого провайдера Peppol Access Point. Рахунок формується як документ Peppol BIS Billing 3.0 у синтаксисі UBL 2.1, провайдер доставляє його до Access Point покупця, а статус доставки повертається на рахунок. Krokul працює як система-джерело, а роль Access Point лишається за провайдером. Зв’язка йде через API провайдера разом з API і вебхуками Krokul.

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

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

### Виставлений рахунок доставляється через Peppol

Коли рахунок виставлено покупцю, який приймає документи через Peppol, Krokul формує рахунок BIS Billing 3.0 в UBL 2.1 зі сторонами продавця й покупця, рядками, розкладом ПДВ і умовами оплати та передає його в API провайдера. Провайдер знаходить отримувача через SMP і доставляє документ.

### Ідентифікатор учасника покупця на компанії-клієнті

Кожен отримувач у мережі має ідентифікатор учасника. Krokul зберігає його на компанії-клієнті й перед надсиланням перевіряє через провайдера, чи покупець зареєстрований. Менеджер заздалегідь знає, чи піде рахунок через Peppol.

### Перевірка до відправлення рахунку

Peppol BIS Billing 3.0 є базовою специфікацією використання рахунку за EN 16931, тож коректний документ відповідає європейському стандарту й правилам Peppol поверх нього. Krokul спершу перевіряє рахунок за цими правилами, і відсутній номер платника ПДВ чи поштовий індекс видно на рахунку ще до надсилання.

### Статус доставки на рахунку

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

### B2B-рахунки в Бельгії з 2026 року

OpenPeppol зазначає, що з 1 січня 2026 року Бельгія вимагає структурованих електронних рахунків майже для всіх операцій між бельгійськими платниками ПДВ, а рекомендованою мережею називає Peppol. Бельгійська компанія, що виставляє рахунки в Krokul, надсилає їх через свого провайдера Access Point тим самим з’єднанням.

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

| Провайдер Peppol (Access Point) | Krokul | Напрям | Коли |
|---|---|---|---|
| Рахунок BIS Billing 3.0 (UBL 2.1) | Рахунок (документ) з рядками | Krokul → провайдер | Рахунок виставлено |
| Сторона покупця: юридична назва, номер платника ПДВ, адреса | Компанія-клієнт | Krokul → провайдер | Входить у кожен рахунок |
| Ідентифікатор учасника (пошук у SMP) | Peppol ID компанії-клієнта | Krokul ↔ провайдер | Перевіряється перед надсиланням |
| ID документа в провайдера | Зовнішній ключ рахунку | Провайдер → Krokul | Одразу після надсилання |
| Статус доставки чи відхилення | Статус рахунку й запис у стрічці угоди | Провайдер → Krokul | Колбек провайдера або перевірка за розкладом |

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

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

1. Укладіть договір із провайдером Peppol Access Point, зареєструйте в нього свою компанію як відправника й створіть у Krokul ключ API, що читає документи й компанії-клієнтів і записує активності.
2. Підпишіть вебхук Krokul (`webhook/api-upsert`) на `document.created`, перевірте заголовок `x-crm-signature`, потім прочитайте рахунок через `document/api-read`, а покупця через `clientCompany/api-read`.
3. Надішліть документ в API свого провайдера, спершу в його тестове середовище, і збережіть ID документа в провайдера через `externalRef/api-set`.
4. Кожну доставку чи відхилення, про які повідомив провайдер, записуйте в угоду через `activity/api-create`.

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

У чотирикутній моделі Peppol відправник і отримувач підключаються кожен через свій Access Point, SMP публікує, що приймає отримувач, а SML підказує Access Point, у якого SMP питати. Krokul стоїть перед першим кутом як система-джерело. Вебхуки Krokul підписані HMAC-SHA256, невдалі доставки можна повторити через `webhook/api-redeliver`, а `x-crm-delivery` дає вашому сервісу передати кожен рахунок провайдеру лише раз.

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

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

### Чи є Krokul точкою доступу Peppol (Access Point)?

Ні. Krokul сам до мережі Peppol не підключається й сертифікації Peppol не має. Рахунок надсилає ваш сертифікований провайдер Access Point, а Krokul його готує й стежить за статусом.

### Який формат Peppol формує Krokul?

Krokul формує рахунки Peppol BIS Billing 3.0 у синтаксисі UBL 2.1. Далі провайдер доставляє їх до Access Point покупця.

### Чи може Krokul приймати рахунки постачальників із Peppol?

Ні. Krokul веде угоди, комерційні пропозиції й рахунки, які виставляєте ви. Вхідні рахунки постачальників лишаються у вашій обліковій системі чи в провайдера Access Point.

### Чи є готовий модуль Peppol на платформах автоматизації?

Ні. Peppol є мережею провайдерів, тому потік працює з API обраного вами провайдера, а API і вебхуки Krokul дають рахунки й приймають назад статус.

## Обмеження

Krokul не має сертифікації Peppol, а підключення до мережі належить вашому провайдеру Access Point. Вхідні рахунки постачальників лишаються у вашій обліковій системі чи в провайдера, бо Krokul покриває бік продажів.

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

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

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

Peppol є торговельною маркою OpenPeppol AISBL. Krokul не пов’язаний з OpenPeppol і не є провайдером послуг Peppol.

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

---

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