API FIZ · disponível agora
Sim, a FIZ tem API.
Uma API REST para emitir faturas certificadas, criar clientes e artigos e sincronizar com a AT — a partir do teu software, da tua loja ou da tua plataforma. E um conector MCP para ligares o Claude ou o ChatGPT à tua faturação, sem escrever código. Para ligares as empresas dos teus clientes, cria uma aplicação OAuth.
Cria um rascunho em poucas linhas
Para a tua própria empresa, usa uma chave de API no cabeçalho x-api-key. Este pedido cria um rascunho: substitui o CAE e os IDs pelos da tua empresa. A emissão é uma ação separada, descrita na referência da API.
# Criar um rascunho, sem emitir
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 }]
}'Plataformas e integradores
Liga os teus clientes à FIZ
Adiciona faturação portuguesa ao teu produto. O cliente escolhe a empresa e autoriza as permissões na FIZ; o teu servidor recebe tokens OAuth para essa ligação.
Modelos de parceria e white-label →
1. Cria a tua aplicação
Em Definições → Integrações, indica o nome, os URLs e as permissões. A FIZ gera um client ID e um segredo, mostrado uma única vez, para guardares no teu servidor.
2. Liga um cliente
Quem já usa a FIZ escolhe a empresa e as permissões. Novos clientes criam uma conta e podem ligar a AT antes de regressarem à tua aplicação.
3. Cria o primeiro rascunho
Executa o exemplo Node.js com o nome e as credenciais da tua aplicação. Guarda um rascunho real de fatura na empresa ligada, sem emitir o documento. Código aberto, licença MIT.
Testa primeiro, lança após revisão
As aplicações Development funcionam na FIZ real, para ti e até 20 testadores indicados por email. Podes adicionar um email antes de a conta existir. Os dados das empresas são reais: não é um ambiente fiscal simulado.
Para ligar outros clientes, cria uma aplicação Production separada e submete-a à revisão da FIZ. As ligações Production exigem um plano da empresa com acesso à API.
Novo · conector MCP
Liga o Claude ou o ChatGPT à tua faturação
A FIZ é um servidor MCP (Model Context Protocol). Liga-o uma vez e o teu assistente passa a consultar os teus documentos, clientes e movimentos bancários, a preparar faturas em rascunho e — só depois de confirmares cada uma — a emiti-las. Sem chaves de API: é uma ligação OAuth que revogas quando quiseres.
https://api.fiz.co/mcp Claude
Definições → Conectores → Adicionar conector personalizado. Cola o URL, entra na FIZ e escolhe a empresa e as permissões.
ChatGPT
Definições → Apps e conectores → Criar. Cola o URL, escolhe autenticação OAuth e entra na FIZ quando for pedido.
Claude Code
Corre claude mcp add --transport http fiz https://api.fiz.co/mcp e depois, na sessão, /mcp → fiz → Authenticate.
Emitir exige sempre a tua confirmação
Emitir, registar pagamentos, anular e passar notas de crédito são atos com valor legal comunicados à AT. O assistente mostra-te sempre uma pré-visualização e só executa depois de confirmares — e se o documento mudar entretanto, a operação é recusada. Na autorização escolhes uma empresa e desmarcas as permissões que não queres dar.
Para o que as equipas usam a API
Os pedidos mais comuns de quem já integra a FIZ.
Loja online → fatura automática
Liga a tua loja (Shopify, WooCommerce e afins) e emite a fatura certificada no momento em que a venda é concluída — sem trabalho manual.
Faturar quando o cliente paga
Depois de o teu gateway (Stripe, ifthenpay, easypay…) confirmar o pagamento, chama a FIZ para emitir o documento e enviá-lo por email ao cliente.
Incorpora a FIZ no teu SaaS
És uma plataforma, marketplace ou software de gestão? Deixa que os teus clientes faturem diretamente a partir do teu produto, com a FIZ a tratar da conformidade fiscal.
Migrar de outro faturador
A usar o Moloni, InvoiceXpress, Sage ou Vendus só pela API? Tens o mesmo que precisas na FIZ — com a sincronização com a AT já incluída.
O que podes fazer
Faturas, clientes, artigos e PDFs através dos endpoints REST documentados.
Faturas e recibos
Cria rascunhos e emite Fatura, Fatura-Recibo, Fatura Simplificada, Nota de Débito e Nota de Crédito — com descontos, métodos de pagamento e retenção na fonte.
Clientes e artigos
Cria, atualiza e pesquisa clientes com NIF validado e gere o teu catálogo de produtos e serviços com taxas de IVA e isenções por território.
PDF, ATCUD e QR code
Descarrega o PDF de cada documento com os teus modelos, ATCUD e QR code — pronto a enviar ao cliente.
Sincronização com a AT
Cada documento emitido é comunicado automaticamente à Autoridade Tributária. Acompanha o estado da sincronização em cada chamada.
Retries sem duplicados
Usa Idempotency-Key nas escritas. Pedidos concluídos devolvem a resposta guardada. Se o resultado for desconhecido, verifica o documento antes de iniciar uma nova operação.
Agentes com acesso à shell
Preferes um skill em vez do conector?
Para agentes de programação que já correm comandos — Claude Code, Cursor e afins — publicámos um skill open-source que usa diretamente esta API REST, com o conhecimento fiscal português já incorporado: taxas de IVA, códigos de isenção, validação de NIF e a confirmação obrigatória antes do passo irreversível de emissão. Para o Claude e o ChatGPT do dia-a-dia, o conector MCP acima é o caminho mais simples.
Pronto para integrar?
Usa uma chave de API para a tua empresa ou cria uma aplicação OAuth para ligar os teus clientes. O guia inclui um exemplo pronto a executar.
Obter chave de API Guia de integração →
Certificado AT Nº 3041
NIPC 517696835
1200-082, Lisboa, Cais do Tojo 24