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, чтобы выставить документ и отправить его клиенту на почту.
Встройте 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-кодом — готовый к отправке клиенту.
Синхронизация с AT
Каждый выставленный документ автоматически передаётся в AT (налоговый орган Португалии). Статус синхронизации видно на каждом вызове.
Ретраи без дублей
Используйте 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