API для рахунків. FIZ виставляє рахунки й передає їх до AT.
Ваша система надсилає дані продажу й отримує готовий рахунок із номером і PDF. Claude і ChatGPT підключаються до FIZ без коду й готують рахунки на ваше прохання.
Для самозайнятих і компаній, у всіх платних планах FIZ. Розробник підключає API до вашої системи один раз.
- Клієнт
- Ana Costa
- Разом
- 61,50 €
- Чернетку створено
POST /invoices - Номер і ATCUD присвоєно
POST /invoices/{id}/issue - PDF готовий
GET /invoices/{id}/pdf
Виставлено й передано до AT
Як FIZ виставляє рахунки з вашої системи
Якщо ви продаєте через інтернет-магазин, CRM або свій застосунок, API звільняє від ручного виставлення: FIZ виставляє рахунок на кожен продаж і передає його до AT.
FIZ отримує дані продажу
Ваш інтернет-магазин, CRM або інша система вказує клієнта, товари й тип документа. FIZ зберігає чернетку; до AT потрапляє лише виставлений рахунок.
FIZ виставляє рахунок і передає його до AT
На запит вашої системи FIZ присвоює рахунку номер у серії, ATCUD і QR‑код та передає рахунок до AT. У відповіді надходять номер і статус в AT.
FIZ готує PDF
На A4 за шаблоном, вибраним у FIZ, або на чековій стрічці 80 чи 58 мм. Ваша система отримує PDF і надсилає його клієнту.
Що ваша система може доручити FIZ
Ваша система працює з API‑ключем, який власник, адміністратор або редактор створює на сторінці «Інтеграції» у FIZ. Ключ діє для одного профілю (самозайнятого або компанії).
- Рахунки, квитанції та кредит‑ноти
- Рахунок, fatura‑recibo, спрощений рахунок і квитанція про оплату, зі знижками та утриманням податку (retenção na fonte). Часткові оплати, кожна зі своєю квитанцією, і кредит‑ноти на всю суму.
- Клієнти й товари
- Кожен товар має ставку IVA материка, Мадейри чи Азорських островів або причину звільнення. FIZ перевіряє, чи немає помилки в кожному португальському NIF.
- Рахунки за розкладом
- FIZ виставляє їх із заданою вами періодичністю, наприклад щомісяця, передає до AT і може надсилати клієнту на email.
- Повторні запити без дублікатів
- Якщо ваша система повторить запит із тим самим
Idempotency-Key, як у прикладі, FIZ поверне першу відповідь і не створить другий документ.
POST /invoicesx-api-key: fiz_api_••••••••Idempotency-Key: order-1042{ "type": "INVOICE_RECEIPT", "cae": "47711", "customerId": "66f2c1a9e4b0a1d2c3e4f5a6", "items": [ { "id": "66f2c1b7d3a1b2c3d4e5f6a7", "quantity": 2 } ], "payment": { "method": "mbWay", "date": "2026-10-09T10:15:00Z" }}Claude і ChatGPT готують ваші рахунки
З конектором FIZ асистент на ваше прохання знаходить рахунки, клієнтів і товари та готує чернетки. Перед виставленням він показує попередній перегляд і чекає на ваше підтвердження.
Підключення без коду, через користувацький конектор у Claude або ChatGPT. У FIZ ви вибираєте профіль і дозволи для асистента та можете відключити його будь‑коли.
Що може робити асистент?
Переглядати клієнтів, товари, документи з їхнім статусом в AT, транзакції банків, підключених до FIZ, і витрати з e‑Fatura. Створювати клієнтів, товари, чернетки та проформи.
Виставляти рахунки, позначати оплати з квитанцією, анулювати документи й виставляти кредит‑ноти на всю суму, завжди після вашого підтвердження.
- Запит асистенту
- Виставте рахунок Norte Studio за 2 години консультацій.
- Клієнт
- Norte Studio, Lda
- Консультації · 2 год
- 120,00 €
- IVA 23%
- 27,60 €
- Разом
- 147,60 €
- Ваша відповідь
- Підтверджую, виставляйте.
Виставлено й передано до AT
Партнерські застосунки: рахунки від імені кожного клієнта
Ваш застосунок підключається до FIZ через API. У кожного клієнта свій профіль, самозайнятого або компанії, і власник дозволяє підключення. На запит застосунку FIZ виставляє рахунки від імені клієнта.
Кожен клієнт оплачує власний план FIZ, або за домовленістю з FIZ доступ клієнтів оплачує ваша платформа.
- У вашому застосунку
- Назва й доменІнтерфейсПриймання оплати за ваш продукт
- Поза вашим застосунком
- Обліковий запис клієнтаПідключення до ATКерування підключенням
Для тесту застосунок підключається без платного плану до вашого профілю та профілів щонайбільше 20 людей, яких ви вкажете. Ваші клієнти підключаються до робочого застосунку (Production), схваленого FIZ.
Виберіть план для вашого бізнесу
Поширені запитання про API FIZ
У яких планах є API?
У всіх платних планах FIZ, зокрема в пробний період: Auto, Prime, Auto Pro і Prime Pro для самозайнятих, FIZ Pro і FIZ Max для компаній. Конектор для Claude і ChatGPT входить у ті самі плани.
Чи потрібен розробник?
Так, щоб підключити API до вашої системи або створити застосунок: розробник працює за коротким посібником і документацією API. Для Claude і ChatGPT ні: вони підключаються без коду, через користувацький конектор.
Рахунки, виставлені через API, сертифіковані й передаються до AT?
Так, як і рахунки, виставлені у FIZ. FIZ має сертифікат AT (№ 3041) і передає кожен документ до AT у момент виставлення.
Для цього в профілі FIZ потрібні підключення до AT, увімкнена автоматична передача рахунків і серія рахунків на цей рік. API показує, чого бракує, ще до виставлення.
Як моя система дізнається, що AT отримала рахунок?
З відповіді на запит виставлення: у ній номер, ATCUD і статус передачі до AT («передається», «передано» або «помилка») з повідомленням AT. Якщо передача ще триває, ваша система пізніше запитує документ і отримує остаточний статус.
Які документи й дані доступні через API?
З API‑ключем: рахунки, fatura‑recibo, спрощені рахунки, квитанції про оплату, кредит‑ноти на всю суму, клієнти, товари й PDF, а також рахунки за розкладом, транспортні документи, проформи та, лише для перегляду, транзакції підключених банків.
Партнерський застосунок працює з рахунками, клієнтами, товарами й PDF. Декларації та витрати клієнт веде безпосередньо у FIZ.
Як протестувати інтеграцію?
На чернетках: FIZ їх зберігає, ваша система може їх змінювати, видаляти й формувати PDF, а до AT потрапляють лише виставлені документи. Кожне виставлення, навіть у тесті, створює справжній фіскальний документ.
У профілі компанії рахунки на запит тестового партнерського застосунку виставляються лише у пробний період або з платним планом.
Чи можна виставляти рахунок автоматично, коли замовлення оплачено?
Так. Коли ваш інтернет-магазин або система фіксує оплату, вона звертається до API: створює чернетку fatura‑recibo й запитує виставлення. FIZ передає документ до AT і готує PDF, а ваша система надсилає його клієнту.
Чи може мій застосунок виставляти рахунки від імені кожного мого клієнта?
Так, через застосунок, схвалений FIZ. Власник кожного профілю дозволяє підключення і може відключити його у FIZ будь‑коли.
Як Claude або ChatGPT виставляють рахунок?
З вашого явного підтвердження, після попереднього перегляду в розмові. Якщо документ тим часом змінився, FIZ відхиляє виставлення, доки ви не підтвердите новий попередній перегляд.
Як підключити Claude або ChatGPT до FIZ?
Достатньо додати користувацький конектор у Claude або ChatGPT з адресою https://api.fiz.co/mcp і ввійти у FIZ, коли асистент попросить. На сторінці «Інтеграції» у FIZ, у блоці «Підключити асистента», є кроки для кожного асистента.
Можливість додати користувацький конектор залежить від вашого плану в Claude або ChatGPT.
Як захищені мої дані?
API‑ключ відкриває лише один профіль. Асистент або застосунок працює тільки з тим профілем, який ви підключили, і в межах наданих прав. На сторінці «Інтеграції» можна відкликати свої ключі й відключити своїх асистентів і застосунки: доступ закриється одразу.
У Claude або ChatGPT дані, які асистент отримує від FIZ, підпорядковуються правилам конфіденційності цього асистента.
Де документація API?
На api.fiz.co, португальською та англійською: короткий посібник, довідник API, посібник з інтеграції та посібник із підключення Claude і ChatGPT.
На GitHub також є приклад застосунку на Node.js та інструкції FIZ для ШІ‑помічників програміста, обидва з відкритим кодом.
Чи бачить мій бухгалтер рахунки, виставлені через API?
Так. Документи, виставлені через API, зберігаються в тому самому профілі FIZ разом з іншими й потрапляють до SAF‑T (PT) з виставленими рахунками, який FIZ щомісяця надсилає бухгалтеру на email, якщо власник увімкне надсилання. Якщо бухгалтер має доступ до профілю, він бачить їх і у FIZ.