API провайдера для користувачів і AS4 між Access Point — це різні інтерфейси. Протестуйте отримання, надсилання, дублікати й помилки; сам успіх HTTP не підтверджує доставлення.
Як програмне забезпечення підключається до Peppol через API?
Звичайна інтеграція поєднує вашу систему виставлення рахунків-фактур або ERP з інтерфейсом провайдера доставлення. Програма готує дані, передає документ і приймає результати чи отримані рахунки-фактури. Провайдер виконує свою роль у мережі доставлення.
Клієнтський API і передавання між Access Point — це різні рівні. Peppol AS4 описує комунікацію між провайдерами. Конкретні адреси API, спосіб автентифікації та формат відповідей для вашої програми визначають матеріали обраного провайдера.
Перш ніж почнеться програмування, підтвердьте обсяг: лише надсилання, лише отримання чи обидва напрямки. Зазначте також кілька компаній, коригувальні документи, вкладення та потрібне підключення до бухгалтерського обліку.
Які завдання розподілити між ERP і провайдером?
| Завдання | Про що домовитися |
|---|---|
| Створення рахунку-фактури | Де джерело даних і хто затверджує документ |
| Експорт UBL | Хто створює XML і який профіль чи випуск підтримується |
| Адресування | Звідки береться Peppol ID і як перевіряється отримувач |
| Валідація | Які рівні перевірки виконуються і як повертаються помилки |
| Доставлення | Яку ідентифікацію повідомлення та який результат отримає ERP |
| Отримання | Як отримати оригінальний XML, вкладення та час отримання |
| Повідомлення даних | Як відстежується результат передавання даних Фінансовому управлінню |
Провайдер може приймати готовий XML або пропонувати його створення з інших даних. В обох випадках перевірте, що комерційне значення полів зберігається. Відповідність полів пояснює зразок XML з коментарями.
Як спроєктувати надсилання та повернення результату?
Спочатку збережіть документ і технічно перевірте його. Під час передавання зафіксуйте власне посилання та ідентифікацію повідомлення від провайдера. Значення відповіді API має бути пояснене: прийняття запиту може передувати остаточному результату передавання.
У разі асинхронної обробки результат може надійти через webhook, або програма з'ясовує його повторними запитами відповідно до документації. Не вважайте ці можливості обов'язковою функцією кожного API. Домовтеся, як результат повертається до правильного документа і що побачить працівник у разі помилки.
Ілюстративний потік інтеграції:
ERP готує та зберігає рахунок-фактуру
→ перевіряє XML і присвоює власне посилання
→ передає документ провайдерові
→ зберігає ідентифікацію повідомлення
→ приймає результат передавання
→ показує статус або завдання на виправлення
Схема не є визначенням конкретного API. Назви статусів і доступні підтвердження беріть із документації служби. Відрізняйте технічне доставлення від комерційного затвердження покупцем.
Що відбувається в разі збою або повторного запиту?
Якщо після надсилання настає тайм-аут, результат може бути невідомим: провайдер міг прийняти документ. Повторне надсилання повинно мати узгоджений захист від дублювання. Перевірте, чи підтримує API ідемпотентний запит або пошук повідомлення за вашим посиланням.
У разі webhooks враховуйте повторні події та перевіряйте їхнє походження відповідно до документації. Під час отримання зберігайте ідентифікатор повідомлення та ідентичність рахунку-фактури; не покладайтеся в перевірці лише на назву файлу. Технічний дублікат передавання та два комерційно схожі документи — це різні ситуації.
Підготуйте також ручне вирішення випадку, що залишився без однозначного результату. Не позначайте результат автоматично як успішний лише тому, що перестав надходити код помилки.
Як налаштувати отримання та доступи кількох компаній?
Збережіть отриманий XML і порівняйте дані з імпортом до правильної компанії. Подальше затвердження, рознесення по рахунках і оплата належать до вашого робочого процесу. Офіційна структура UBL допоможе визначити, куди належать комерційні дані.
Тримайте тестові та продуктивні облікові записи окремо. Зберігайте ключі на сервері й надавайте доступ до них лише потрібним процесам. У разі кількох суб'єктів перевірте обсяг кожного уповноваження, щоб запит однієї компанії не міг обробити документи іншої.
Визначте також відновлення доступу та передавання даних у разі зміни служби. Експлуатаційний журнал має допомагати знайти проблему без зайвого копіювання всього вмісту рахунків-фактур до кожного логу.
Що має пройти перевірку перед запуском?
Протестуйте звичайне надсилання та отримання, недійсний документ, невідомого отримувача, виправлення та повторний імпорт. Додайте тайм-аут після передавання, повторну подію та тимчасову недоступність служби. Для кожного сценарію визначте очікуваний результат і порядок дій оператора.
Зафіксуйте використаний випуск правил і версію конектора. Під час оновлення порівняйте їх із чинними специфікаціями eDelivery. Перевірку документа пояснює валідація е-фактури.
Для роботи у Словаччині додайте також домовленість щодо повідомлення даних. Фінансове управління Словацької Республіки (Finančná správa SR) описує автоматичне передавання через Цифрового листоношу (Digitálny poštár); інтеграція має дати користувачеві змогу знайти його результат. Загальний потік описує доставлення рахунків-фактур.
Організацію роботи та випробування з постачальником програмного забезпечення доповнює інструкція з підключення бухгалтерської програми. Перетворення наявних документів пояснює порядок дій: від PDF до eFaktúra.
Перевірені джерела
Ми спираємося на офіційні матеріали. Першоджерела ви знайдете за посиланнями нижче. Коли правила змінюються, ми оновлюємо й цей путівник.
Зміст перевірено 01.10.2026. У конкретному податковому випадку вирішальними є чинна редакція закону та обставини постачання.