FISCALISTO / API
n8n, Zapier y Make: facturar sin programar
Timbre facturas, registre tickets para autofactura y reciba los eventos de Fiscalisto en sus flujos de n8n, Zapier o Make, con su llave de la API y sin escribir código.
Fiscalisto tiene conectores para las tres herramientas de automatización más usadas. Cada uno usa su llave de la API (fk_test_… para probar, fk_live_… para facturar de verdad) y hace lo mismo que la API: lo que timbre desde un flujo aparece en Desarrolladores › Facturas como cualquier otra factura, con su mismo costo por timbre.
| Herramienta | Cómo se agrega | Acciones | Disparadores |
|---|---|---|---|
| n8n | Nodo de la comunidad n8n-nodes-fiscalisto | Facturas, clientes, tickets, listas del SAT y RFC | «Fiscalisto Trigger», con los eventos que elija |
| Zapier (en inglés) | App «Fiscalisto», en revisión para el directorio de Zapier | «Create Invoice», «Create Customer», «Create Self-Invoicing Ticket», «Request Customer Tax Data», «Send Invoice by Email», «Find Customer», «Check RFC in SAT Lists» | «Invoice Stamped», «Invoice Rejected», «Invoice Canceled», «Ticket Invoiced», «Customer Tax Data Received» y «Low Stamp Balance» |
| Make | App «Fiscalisto», en revisión para el directorio de Make | «Timbrar una factura», «Ver una factura», «Buscar facturas», «Crear un cliente», «Registrar un ticket de autofactura», «Pedirle sus datos fiscales a un cliente», «Revisar un RFC en las listas del SAT» y «Hacer una llamada a la API» (cualquier ruta) | «Eventos de Fiscalisto», con los eventos que elija |
Conectar su cuenta
- En Desarrolladores › Llaves pulse Crear llave. Para un flujo que solo consulta, elija Solo lectura en Permisos.
- En su herramienta, al agregar la primera acción de Fiscalisto, pegue la llave donde dice «Llave de la API» (en Zapier, «API Key»).
- La herramienta la prueba con
GET /v1/accounty le muestra el nombre de su cuenta.
Empiece con la llave de pruebas: las facturas se timbran con un PAC de pruebas, no cuestan timbres y no valen ante el SAT. Cuando el flujo haga lo que quiere, cambie la llave por la de producción.
Eventos
Los disparadores crean un webhook en su cuenta al activar el flujo y lo borran al apagarlo; lo verá en Desarrolladores › Webhooks con una descripción que empieza con «n8n», «Zapier» o «Make». n8n revisa la firma de cada entrega y Zapier vuelve a leer el evento de la API con su llave antes de correr el flujo, así que nadie más puede hacerse pasar por Fiscalisto; en Make, la dirección del webhook es secreta y solo la conoce su escenario. Los eventos que existen están en Webhooks.
Ejemplos
- Tienda en línea → factura. Cuando entra un pedido pagado (Shopify, WooCommerce, Stripe), cree un ticket con
POST /v1/ticketsy mándele al comprador la ligaurldel ticket; él pone sus datos y la factura se timbra sola. Lo que nadie facture entra en la factura global. Ver Autofactura. - CRM → factura. Al ganar una venta en su CRM, busque el cliente por RFC (o créelo) y timbre la factura con sus conceptos.
- Pedir los datos fiscales. Si no tiene el RFC del cliente, «Pedirle sus datos fiscales a un cliente» le manda una liga; cuando el cliente la llena llega
customer_data_request.completedy el flujo sigue. Ver Datos del cliente. - Avisar al equipo. Con
invoice.failedobalance.low, mande un correo o un mensaje a su equipo. - Revisar proveedores. Antes de pagarle a un proveedor, revise su RFC en las listas 69-B y 69 del SAT. Ver Listas del SAT.
Otra herramienta
Cualquier herramienta que haga solicitudes HTTP sirve: use https://api.fiscalisto.com con el encabezado Authorization: Bearer fk_test_… y un cuerpo JSON como en la referencia. Para timbrar sin repetir facturas cuando la herramienta reintenta, mande también Idempotency-Key con un valor que no cambie entre reintentos, como el número de pedido. Ver Idempotencia.
Fiscalisto para agentes de IA
Pídale a su agente de código «agrega facturación con Fiscalisto a mi app»: conecte la documentación como servidor MCP, dele la guía en una página y deje que pruebe en modo de pruebas antes de escribir el código.
Cambios
Lo nuevo en la API, los SDKs y el CLI de Fiscalisto, del más reciente al más antiguo. Nada de lo que ya funciona deja de funcionar sin aviso.