API de facturación. FIZ emite las facturas y las comunica a la AT.
Su sistema envía los datos de la venta y recibe la factura lista, con el número y el PDF. Claude y ChatGPT se conectan a FIZ sin código y preparan facturas a petición suya.
Para autónomos y empresas, en todos los planes de pago de FIZ. Un programador conecta la API a su sistema una sola vez.
- Cliente
- Ana Costa
- Total
- 61,50 €
- Borrador creado
POST /invoices - Número y ATCUD asignados
POST /invoices/{id}/issue - PDF listo
GET /invoices/{id}/pdf
Emitida y comunicada a la AT
Cómo emite FIZ las facturas de su sistema
Si vende a través de una tienda online, un CRM o su propia aplicación, la API elimina la facturación manual: FIZ emite una factura por cada venta y la comunica a la AT.
FIZ recibe los datos de la venta
Su tienda online, su CRM u otro sistema indica el cliente, los artículos y el tipo de documento. FIZ guarda un borrador; a la AT solo llega la factura emitida.
FIZ emite la factura y la comunica a la AT
A petición de su sistema, FIZ numera la factura en la serie, añade el ATCUD y el código QR y comunica la factura a la AT. La respuesta trae el número y el estado en la AT.
FIZ prepara el PDF
En A4 con la plantilla que elija en FIZ, o en papel de ticket de 80 o 58 mm. Su sistema recibe el PDF y lo envía al cliente.
Qué puede pedir su sistema a FIZ
Su sistema usa una clave API, que el titular, un administrador o un editor crea en la página Integraciones de FIZ. Cada clave sirve para un perfil (autónomo o empresa).
- Facturas, recibos y notas de crédito
- Factura, fatura‑recibo, factura simplificada y recibo, con descuentos y retención en la fuente. Pagos parciales, cada uno con su recibo, y notas de crédito por el importe total.
- Clientes y artículos
- Cada artículo lleva el tipo de IVA del Continente, de Madeira o de las Azores, o el motivo de exención. FIZ comprueba que cada NIF portugués esté bien escrito.
- Facturas programadas
- FIZ las emite con la frecuencia que defina, por ejemplo cada mes, las comunica a la AT y puede enviarlas al cliente por email.
- Peticiones repetidas sin duplicados
- Si su sistema repite una petición con la misma
Idempotency-Key, como en el ejemplo, FIZ devuelve la primera respuesta y no crea otro 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" }}Claude y ChatGPT preparan sus facturas
Con el conector de FIZ, el asistente encuentra facturas, clientes y artículos y prepara borradores a petición suya. Antes de emitir, muestra la vista previa y espera su confirmación.
La conexión se hace sin código, con un conector personalizado en Claude o en ChatGPT. En FIZ, usted elige el perfil y los permisos que da al asistente, y puede desconectarlo cuando quiera.
¿Qué puede hacer el asistente?
Consultar los clientes, los artículos, los documentos con su estado en la AT, los movimientos de los bancos conectados a FIZ y los gastos de e‑Fatura. Crear clientes, artículos, borradores y proformas.
Emitir facturas, registrar pagos con recibo, anular documentos y emitir notas de crédito por el importe total, siempre después de su confirmación.
- Petición al asistente
- Facture 2 horas de consultoría a Norte Studio.
- Cliente
- Norte Studio, Lda
- Consultoría · 2 h
- 120,00 €
- IVA 23%
- 27,60 €
- Total
- 147,60 €
- Su respuesta
- Confirmo. Puede emitirla.
Emitida y comunicada a la AT
Aplicaciones de socios: facturas en nombre de cada cliente
Su aplicación se conecta a FIZ a través de la API. Cada cliente tiene un perfil, de autónomo o de empresa, y el titular autoriza la conexión. A petición de la aplicación, FIZ emite las facturas en nombre del cliente.
Cada cliente paga su propio plan de FIZ, o su plataforma paga el acceso de los clientes, por acuerdo con FIZ.
- En su aplicación
- Nombre y dominioInterfazCobro de su producto
- Fuera de su aplicación
- Cuenta del clienteConexión con la ATGestión de la conexión
Para probar, la aplicación se conecta sin plan de pago a su perfil y a los de hasta 20 personas que indique. Sus clientes se conectan a una aplicación de producción aprobada por FIZ.
Elija el plan para su negocio
Preguntas frecuentes sobre la API de FIZ
¿Qué planes incluyen la API?
Todos los planes de pago de FIZ, también durante la prueba gratuita: Auto, Prime, Auto Pro y Prime Pro para autónomos, y FIZ Pro y FIZ Max para empresas. El conector para Claude y ChatGPT está en los mismos planes.
¿Necesito un programador?
Sí, para conectar la API a su sistema o crear una aplicación: el programador trabaja con la guía de inicio rápido y la documentación de la API. Para Claude y ChatGPT, no: se conectan sin código, con un conector personalizado.
¿Las facturas emitidas por la API están certificadas y se comunican a la AT?
Sí, como las que emite en FIZ. FIZ es un programa certificado por la AT (n.º 3041) y comunica cada documento a la AT en el momento de la emisión.
Para ello, el perfil en FIZ necesita la conexión con la AT, la comunicación automática de facturas activada y una serie de facturas de este año. La API muestra lo que falta antes de la emisión.
¿Cómo sabe mi sistema que la AT ha recibido la factura?
Por la respuesta a la emisión: trae el número, el ATCUD y el estado de la comunicación a la AT (en curso, comunicada o con error), con el mensaje de la AT. Si queda en curso, su sistema vuelve a consultar el documento y recibe el estado final.
¿Qué documentos y datos puedo gestionar con la API?
Con una clave API: facturas, faturas‑recibo, facturas simplificadas, recibos, notas de crédito por el importe total, clientes, artículos y PDF, además de facturas programadas, documentos de transporte, proformas y, solo para consulta, los movimientos de los bancos conectados.
Una aplicación de socio gestiona facturas, clientes, artículos y PDF. Las declaraciones y los gastos se gestionan en el propio FIZ.
¿Cómo puedo probar la integración?
Con borradores: FIZ los guarda, su sistema puede modificarlos, borrarlos y generar el PDF, y solo los documentos emitidos llegan a la AT. Cada emisión, incluso en una prueba, crea un documento fiscal real.
En un perfil de empresa, las facturas que pide una aplicación de socio en pruebas solo se emiten durante la prueba gratuita o con un plan de pago.
¿Puedo facturar automáticamente cuando se paga un pedido?
Sí. Cuando su tienda online o su sistema registra el pago, llama a la API: crea el borrador de una fatura‑recibo y pide la emisión. FIZ la comunica a la AT y prepara el PDF, que su sistema envía al cliente.
¿Mi aplicación puede facturar en nombre de cada uno de mis clientes?
Sí, con una aplicación aprobada por FIZ. El titular de cada perfil autoriza la conexión y puede desconectarla en FIZ cuando quiera.
¿Cómo emiten una factura Claude o ChatGPT?
Con su confirmación explícita, después de mostrarle la vista previa en la conversación. Si el documento cambia entretanto, FIZ rechaza la emisión hasta que confirme la nueva vista previa.
¿Cómo conecto Claude o ChatGPT a FIZ?
Basta con añadir un conector personalizado en Claude o en ChatGPT, con la dirección https://api.fiz.co/mcp, e iniciar sesión en FIZ cuando el asistente lo pida. En la página Integraciones de FIZ, en «Conectar un asistente», están los pasos para cada asistente.
Los conectores personalizados dependen del plan que tenga en Claude o en ChatGPT.
¿Cómo se protegen mis datos?
Una clave API da acceso a un solo perfil. Un asistente o una aplicación accede solo al perfil autorizado, con los permisos que usted le dio. En la página Integraciones, puede revocar sus claves y desconectar sus asistentes y las aplicaciones, con efecto inmediato.
En Claude o ChatGPT, los datos que el asistente recibe de FIZ siguen las normas de privacidad de ese asistente.
¿Dónde está la documentación de la API?
En api.fiz.co, en portugués y en inglés: la guía de inicio rápido, la referencia de la API, la guía de integración y la guía para conectar Claude y ChatGPT.
En GitHub hay también un ejemplo de aplicación en Node.js e instrucciones de FIZ para asistentes de programación, ambos de código abierto.
¿Mi contable ve lo que emite la API?
Sí. Los documentos emitidos por la API quedan en el mismo perfil de FIZ, con los demás, y entran en el SAF‑T (PT) de facturación, que FIZ envía cada mes al email del contable si el titular activa este envío. Si el contable tiene acceso al perfil, también los ve en FIZ.