API de faturação. O FIZ emite as faturas e comunica‑as à AT.
O seu sistema envia os dados da venda e recebe a fatura pronta, com o número e o PDF. O Claude e o ChatGPT ligam‑se ao FIZ sem código e preparam faturas a seu pedido.
Para independentes e empresas, em todos os planos pagos do FIZ. Um programador liga a API ao seu sistema uma vez.
14 dias grátis · Sem cartão de crédito · Sem fidelização
- Cliente
- Ana Costa
- Total
- 61,50 €
- Rascunho criado
POST /invoices - Número e ATCUD atribuídos
POST /invoices/{id}/issue - PDF pronto
GET /invoices/{id}/pdf
Emitida e comunicada à AT
Como o FIZ emite as faturas do seu sistema
O FIZ recebe os dados da venda
A sua loja online, o CRM ou outro sistema indica o cliente, os artigos e o tipo de documento. O FIZ guarda um rascunho; à AT só chega a fatura emitida.
O FIZ emite a fatura e comunica‑a à AT
A pedido do seu sistema, o FIZ numera a fatura na série, junta o ATCUD e o código QR e comunica‑a à AT. A resposta traz o número e o estado na AT.
O FIZ prepara o PDF
Em A4, com o modelo que escolher no FIZ, ou em papel de talão de 80 ou 58 mm. O seu sistema recebe o PDF e envia‑o ao cliente.
O que o seu sistema pode pedir ao FIZ
O seu sistema usa uma chave API, que o titular, um administrador ou um editor cria na página Integrações do FIZ. Cada chave vale para um perfil (independente ou empresa).
- Faturas, recibos e notas de crédito
- Fatura, fatura‑recibo, fatura simplificada e recibo, com descontos e retenção na fonte. Pagamentos parciais, cada um com o seu recibo, e notas de crédito do valor total.
- Clientes e artigos
- Cada artigo leva a taxa de IVA do Continente, da Madeira ou dos Açores, ou o motivo de isenção. O FIZ verifica se cada NIF português está bem escrito.
- Faturas agendadas
- O FIZ emite‑as com a frequência que definir, por exemplo todos os meses, comunica‑as à AT e pode enviá‑las ao cliente por email.
- Pedidos repetidos sem duplicados
- Se o seu sistema repetir um pedido com a mesma
Idempotency-Key, como no exemplo, o FIZ devolve a primeira resposta e não cria outro documento.
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" }}O Claude e o ChatGPT preparam as suas faturas
Com o conector do FIZ, o assistente encontra faturas, clientes e artigos e prepara rascunhos a seu pedido. Antes de emitir, mostra a pré‑visualização e espera pela sua confirmação.
A ligação faz‑se sem código, com um conector personalizado no Claude ou no ChatGPT. No FIZ, escolhe o perfil e as permissões que dá ao assistente, e pode desligá‑lo quando quiser.
O que pode fazer o assistente?
Consultar os clientes, os artigos, os documentos com o estado na AT, os movimentos dos bancos ligados ao FIZ e as despesas do e‑Fatura. Criar clientes, artigos, rascunhos e pró‑formas.
Emitir faturas, registar pagamentos com recibo, anular documentos e emitir notas de crédito do valor total, sempre depois da sua confirmação.
- Pedido ao assistente
- Fature 2 horas de consultoria à Norte Studio.
- Cliente
- Norte Studio, Lda
- Consultoria · 2 h
- 120,00 €
- IVA 23%
- 27,60 €
- Total
- 147,60 €
- A sua resposta
- Confirmo. Pode emitir.
Emitida e comunicada à AT
Aplicações parceiras: faturas em nome de cada cliente
A sua aplicação liga‑se ao FIZ pela API. Cada cliente tem um perfil, independente ou empresa, e o titular autoriza a ligação. A pedido da aplicação, o FIZ emite as faturas em nome do cliente.
Cada cliente paga o próprio plano do FIZ, ou a sua plataforma paga o acesso dos clientes, por acordo com o FIZ.
- Na sua aplicação
- Nome e domínioInterfaceCobrança do seu produto
- Fora da sua aplicação
- Conta do clienteLigação à ATGestão da ligação
Para testar, a aplicação liga‑se sem plano pago ao seu perfil e aos de até 20 pessoas que indicar. Os seus clientes ligam‑se a uma aplicação de produção aprovada pelo FIZ.
Escolha o plano para o seu negócio
Perguntas frequentes sobre a API do FIZ
Que planos incluem a API?
Todos os planos pagos do FIZ, também durante os 14 dias grátis: Auto, Prime, Auto Pro e Prime Pro, para independentes, e FIZ Pro e FIZ Max, para empresas. O conector para o Claude e o ChatGPT está nos mesmos planos.
Preciso de um programador?
Sim, para ligar a API ao seu sistema ou criar uma aplicação: o programador trabalha com o guia de início rápido e a documentação da API. Para o Claude e o ChatGPT, não: ligam‑se sem código, com um conector personalizado.
As faturas emitidas pela API são certificadas e comunicadas à AT?
Sim, como as que emite no FIZ. O FIZ é um programa certificado pela AT (n.º 3041) e comunica cada documento à AT no momento da emissão.
Para isso, o perfil no FIZ precisa da ligação à AT, da comunicação automática das faturas e de uma série de faturas deste ano. A API mostra o que falta antes da emissão.
Como sabe o meu sistema que a AT recebeu a fatura?
Pela resposta à emissão: traz o número, o ATCUD e o estado da comunicação à AT (em curso, comunicada ou com erro), com a mensagem da AT. Se ficar em curso, o seu sistema volta a consultar o documento e recebe o estado final.
Que documentos e dados posso gerir pela API?
Com uma chave API: faturas, faturas‑recibo, faturas simplificadas, recibos, notas de crédito do valor total, clientes, artigos e PDF, além de faturas agendadas, documentos de transporte, pró‑formas e, só para consulta, os movimentos dos bancos ligados.
Uma aplicação parceira trata faturas, clientes, artigos e PDF. As declarações e as despesas tratam‑se no próprio FIZ.
Como posso testar a integração?
Com rascunhos: o FIZ guarda‑os, o seu sistema pode alterá‑los, apagá‑los e gerar o PDF, e só os documentos emitidos chegam à AT. Cada emissão, também num teste, cria um documento fiscal real.
Num perfil de empresa, as faturas pedidas por uma aplicação parceira de teste só são emitidas nos 14 dias grátis ou com plano pago.
Posso faturar automaticamente quando uma encomenda é paga?
Sim. Quando a sua loja online ou o seu sistema regista o pagamento, chama a API: cria o rascunho de uma fatura‑recibo e pede a emissão. O FIZ comunica‑a à AT e prepara o PDF, que o seu sistema envia ao cliente.
A minha aplicação pode faturar em nome de cada um dos meus clientes?
Sim, com uma aplicação aprovada pelo FIZ. O titular de cada perfil autoriza a ligação e pode desligá‑la no FIZ quando quiser.
Como é que o Claude ou o ChatGPT emitem uma fatura?
Com a sua confirmação explícita, depois de lhe mostrar a pré‑visualização na conversa. Se o documento mudar entretanto, o FIZ recusa a emissão até que confirme a nova pré‑visualização.
Como ligo o Claude ou o ChatGPT ao FIZ?
Basta adicionar um conector personalizado no Claude ou no ChatGPT, com o endereço https://api.fiz.co/mcp, e entrar no FIZ quando o assistente o pedir. Na página Integrações do FIZ, em «Ligar um assistente», estão os passos para cada assistente.
Os conectores personalizados dependem do plano que tem no Claude ou no ChatGPT.
Como ficam protegidos os meus dados?
Uma chave API dá acesso a um só perfil. Um assistente ou uma aplicação acede só ao perfil autorizado, com as permissões que lhe deu. Na página Integrações, pode revogar as suas chaves e desligar os seus assistentes e as aplicações, com efeito imediato.
No Claude ou no ChatGPT, os dados que o assistente recebe do FIZ seguem as regras de privacidade desse assistente.
Onde está a documentação da API?
Em api.fiz.co, em português e em inglês: o guia de início rápido, a referência da API, o guia de integração e o guia para ligar o Claude e o ChatGPT.
No GitHub há também um exemplo de aplicação em Node.js e instruções do FIZ para assistentes de programação, ambos em código aberto.
O meu contabilista vê o que a API emite?
Sim. Os documentos emitidos pela API ficam no mesmo perfil do FIZ, com os outros, e entram no SAF‑T (PT) de faturação, que o FIZ envia todos os meses para o email do contabilista, se o titular ativar este envio. Se o contabilista tiver acesso ao perfil, também os vê no FIZ.