API FIZ · вже доступне
Так, у FIZ є API.
REST API, щоб виставляти сертифіковані рахунки, створювати клієнтів і позиції та синхронізувати все з податковим органом Португалії (AT) — просто зі свого софту, магазину чи платформи. А ще MCP-конектор, щоб під'єднати Claude чи ChatGPT до ваших рахунків узагалі без коду. Для підключення компаній ваших клієнтів створіть OAuth-застосунок.
Створіть чернетку рахунку кількома рядками
Для своєї компанії використовуйте API-ключ у заголовку x-api-key. Запит створює чернетку: замініть CAE та ідентифікатори на значення своєї компанії. Випуск документа — окрема дія, описана в довіднику API.
# Створити чернетку без випуску документа
curl -X POST https://api.fiz.co/invoices \
-H "x-api-key: $FIZ_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-1042-draft" \
-d '{
"type": "INVOICE",
"cae": "62010",
"customerId": "aaaaaaaaaaaaaaaaaaaaaaaa",
"items": [{ "id": "bbbbbbbbbbbbbbbbbbbbbbbb", "quantity": 1 }]
}'Платформи та інтегратори
Підключіть своїх клієнтів до FIZ
Додайте виставлення рахунків у Португалії до свого продукту. Клієнт обирає компанію та дозволяє доступ у FIZ; ваш сервер отримує OAuth-токени для цього підключення.
Схеми співпраці та white-label →
1. Створіть застосунок
У Налаштуваннях → Інтеграції вкажіть назву, адреси та дозволи. FIZ створить client ID і секрет для вашого сервера. Секрет показується лише один раз.
2. Підключіть клієнта
Користувачі FIZ обирають компанію та дозволи. Нові клієнти створюють акаунт і можуть підключити AT перед поверненням до вашого застосунку.
3. Створіть першу чернетку
Запустіть приклад на Node.js із назвою та даними доступу вашого застосунку. Він зберігає справжню чернетку рахунку в підключеній компанії без випуску документа. Відкритий код, ліцензія MIT.
Спочатку тестування, потім перевірка FIZ
Застосунки Development працюють в основній FIZ для вас і до 20 тестувальників зі списку email. Адресу можна додати до створення акаунта. Дані компаній справжні: це не фіскальна пісочниця.
Для підключення інших клієнтів створіть окремий застосунок Production і надішліть його на перевірку FIZ. Компанії потрібен тариф із доступом до API.
Нове · MCP-конектор
Під'єднайте Claude чи ChatGPT до свого виставляння рахунків
FIZ — це MCP-сервер (Model Context Protocol). Під'єднайте його один раз, і асистент зможе дивитися ваші документи, клієнтів і банківські рухи, готувати чернетки рахунків і — лише після вашого підтвердження кожного — виставляти їх. Без ключів API: це OAuth-з'єднання, яке ви відкликаєте будь-коли.
https://api.fiz.co/mcp Claude
Налаштування → Конектори → Додати власний конектор. Вставте URL, увійдіть у FIZ і оберіть компанію та дозволи.
ChatGPT
Налаштування → Застосунки та конектори → Створити. Вставте URL, оберіть автентифікацію OAuth і увійдіть у FIZ, коли попросить.
Claude Code
Виконайте claude mcp add --transport http fiz https://api.fiz.co/mcp, а потім у сесії /mcp → fiz → Authenticate.
Виставлення завжди потребує вашого підтвердження
Виставлення, реєстрація оплат, анулювання та кредит-ноти — це юридично значущі дії, що подаються до AT. Асистент завжди показує попередній перегляд і діє лише після вашого підтвердження — а якщо документ за цей час змінився, операцію буде відхилено. На екрані авторизації ви обираєте одну компанію і знімаєте позначки з дозволів, які давати не хочете.
Що на цьому будують команди
Найпоширеніші сценарії від команд, які вже інтегрують FIZ.
Онлайн-магазин → рахунок автоматично
Підключіть свій магазин (Shopify, WooCommerce тощо) і виставляйте сертифікований рахунок тієї ж миті, коли проходить продаж — без жодної ручної роботи.
Рахунок щойно клієнт оплатив
Щойно ваш платіжний шлюз (Stripe, ifthenpay, easypay…) підтвердить оплату, викличте FIZ, щоб виставити документ і надіслати його клієнту на email.
Вбудуйте FIZ у свій SaaS
Маєте платформу, маркетплейс чи систему обліку? Дайте своїм клієнтам виставляти рахунки просто з вашого продукту, а податковий комплаєнс бере на себе FIZ.
Перехід з іншого сервісу для рахунків
Сидите на Moloni, InvoiceXpress, Sage чи Vendus тільки заради API? Усе потрібне ви отримаєте у FIZ — із вже вбудованою синхронізацією з AT.
Що ви можете робити
Рахунки, клієнти, товари й PDF через документовані методи REST API.
Рахунки та квитанції
Створюйте чернетки й виставляйте Fatura, Fatura-recibo, Fatura simplificada, Nota de débito та Nota de crédito — зі знижками, методами оплати й податком, утриманим у джерела.
Клієнти та позиції
Створюйте, оновлюйте і шукайте клієнтів із перевіреним NIF, а також керуйте каталогом товарів і послуг зі ставками ПДВ та звільненнями за територіями.
PDF, ATCUD і QR-код
Завантажуйте PDF кожного документа зі своїми шаблонами, ATCUD і QR-кодом — готовий до надсилання клієнту.
Синхронізація з податковим органом
Кожен виставлений документ автоматично подається до податкового органу Португалії. А статус синхронізації ви бачите на кожному виклику.
Ретраї без дублікатів
Використовуйте Idempotency-Key під час запису. Завершені запити повертають збережену відповідь. Якщо результат невідомий, перевірте документ перед новою операцією.
Агенти з доступом до shell
Хочете skill замість конектора?
Для кодових агентів, які й так виконують команди — Claude Code, Cursor і подібні — ми маємо open-source skill, що працює напряму з цим REST API, із вбудованим знанням португальських податків: ставки ПДВ, коди звільнень, валідація NIF і обов'язкове підтвердження перед незворотним виставленням. Для звичайних Claude і ChatGPT простіше взяти MCP-конектор вище.
Готові інтегруватися?
Використовуйте API-ключ для своєї компанії або створіть OAuth-застосунок для підключення клієнтів. У посібнику є готовий до запуску приклад.
Отримати ключ API Посібник з інтеграції (EN) →
Сертифікат AT № 3041
NIPC 517696835
1200-082, Лісабон, Cais do Tojo 24