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), и FIZ передаёт каждый документ в 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.