FIZ API · ya disponible
Sí, FIZ tiene API.
Una API REST para emitir facturas certificadas, crear clientes y artículos, y sincronizar con la autoridad tributaria portuguesa (AT) — desde su propio software, tienda o plataforma. Y un conector MCP para enchufar Claude o ChatGPT directamente a su facturación, sin escribir código. Para conectar las empresas de sus clientes, cree una aplicación OAuth.
Cree un borrador de factura en pocas líneas
Para su propia empresa, use una clave de API en la cabecera x-api-key. Este pedido crea un borrador: sustituya el CAE y los ID por los de su empresa. La emisión es una acción aparte, descrita en la referencia de la API.
# Crear un borrador sin emitirlo
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
Conecte a sus clientes con FIZ
Añada facturación portuguesa a su producto. Su cliente elige una empresa y autoriza los permisos en FIZ; su servidor recibe tokens OAuth para esa conexión.
Modelos de colaboración y white-label →
1. Registre su aplicación
En Ajustes → Integraciones, indique el nombre, las URL y los permisos. FIZ genera un client ID y un secreto, que se muestra una sola vez, para guardarlo en su servidor.
2. Conecte a un cliente
Los usuarios de FIZ eligen su empresa y los permisos. Los nuevos clientes crean una cuenta y pueden conectar la AT antes de volver a su aplicación.
3. Cree el primer borrador
Ejecute el ejemplo Node.js con el nombre y las credenciales de su aplicación. Guarda un borrador real de factura en la empresa conectada, sin emitir el documento. Código abierto, licencia MIT.
Primero pruebe, después solicite la revisión
Las aplicaciones Development funcionan en FIZ real para usted y hasta 20 probadores indicados por email. Puede añadir un email antes de crear su cuenta. Los datos de las empresas son reales: no es un entorno fiscal simulado.
Para conectar a otros clientes, cree una aplicación Production independiente y envíela a revisión de FIZ. Las conexiones Production requieren un plan de empresa con acceso a la API.
Nuevo · conector MCP
Conecte Claude o ChatGPT a su facturación
FIZ es un servidor MCP (Model Context Protocol). Conéctelo una vez y su asistente podrá consultar sus documentos, clientes y movimientos bancarios, preparar borradores de facturas y — solo después de que usted confirme cada una — emitirlas. Sin claves de API: es una conexión OAuth que puede revocar cuando quiera.
https://api.fiz.co/mcp Claude
Ajustes → Conectores → Añadir conector personalizado. Pegue el URL, inicie sesión en FIZ y elija la empresa y los permisos.
ChatGPT
Ajustes → Apps y conectores → Crear. Pegue el URL, elija autenticación OAuth e inicie sesión en FIZ cuando se lo pida.
Claude Code
Ejecute claude mcp add --transport http fiz https://api.fiz.co/mcp y luego, en la sesión, /mcp → fiz → Authenticate.
Emitir siempre requiere su confirmación
Emitir, registrar pagos, anular y emitir notas de crédito son actos con valor legal que se comunican a la AT. El asistente siempre le muestra una vista previa y solo actúa cuando usted confirma — y si el documento ha cambiado entretanto, la operación se rechaza. En la pantalla de autorización elige una empresa y desmarca los permisos que prefiera no conceder.
Lo que construyen los equipos con ella
Las integraciones más habituales entre los equipos que ya usan FIZ.
Tienda online → factura automática
Conecte su tienda (Shopify, WooCommerce y similares) y emita la factura certificada en el momento en que se cierra la venta — sin trabajo manual.
Factura en cuanto el cliente paga
Cuando su pasarela (Stripe, ifthenpay, easypay…) confirma el pago, llame a FIZ para emitir el documento y enviárselo al cliente por email.
Integre FIZ en su SaaS
¿Tiene una plataforma, un marketplace o un software de gestión? Deje que sus propios clientes facturen directamente desde su producto, con FIZ encargándose del cumplimiento fiscal.
Migre desde otra herramienta de facturación
¿Está en Moloni, InvoiceXpress, Sage o Vendus solo por la API? En FIZ tiene lo que necesita — con la sincronización con la AT ya incluida.
Lo que puede hacer
Facturas, clientes, artículos y PDF a través de los endpoints REST documentados.
Facturas y recibos
Cree borradores y emita Factura, Factura-recibo, Factura simplificada, Nota de débito y Nota de crédito — con descuentos, métodos de pago y retención en la fuente.
Clientes y artículos
Cree, actualice y busque clientes con el NIF validado, y gestione su catálogo de productos y servicios con tipos de IVA y exenciones por territorio.
PDF, ATCUD y código QR
Descargue el PDF de cada documento con sus propias plantillas, ATCUD y código QR — listo para enviárselo al cliente.
Sincronización con la AT
Cada documento emitido se comunica automáticamente a la autoridad tributaria portuguesa. Consulte el estado de la sincronización en cada llamada.
Reintentos sin duplicados
Use Idempotency-Key en las escrituras. Los pedidos completados devuelven la respuesta guardada. Si el resultado es desconocido, compruebe el documento antes de iniciar otra operación.
Agentes con acceso a la shell
¿Prefiere un skill en vez del conector?
Para agentes de programación que ya ejecutan comandos — Claude Code, Cursor y similares — publicamos un skill de código abierto que usa directamente esta API REST, con el conocimiento fiscal portugués ya integrado: tipos de IVA, códigos de exención, validación de NIF y una confirmación obligatoria antes del paso irreversible de la emisión. Para el Claude y el ChatGPT del día a día, el conector MCP de arriba es el camino más sencillo.
¿Listo para integrar?
Use una clave de API para su empresa o cree una aplicación OAuth para conectar a sus clientes. La guía incluye un ejemplo listo para ejecutar.
Consiga una clave de API Guía de integración (EN) →
Certificado AT N.º 3041
NIPC 517696835
1200-082, Lisboa, Cais do Tojo 24