Introducción
Fiscalapi es una API REST para emitir facturas CFDI 4.0 con validez ante el SAT. Envías los datos de la factura y Fiscalapi construye el XML, lo sella, lo timbra y genera su PDF. Los cambios que publica el SAT se aplican en la API sin costo adicional.
Primeros pasos
Activa una suscripción de prueba y obtén tus credenciales (API key y tenant) para hacer tus primeras peticiones a la API.
Cómo integrar Fiscalapi en tu sistema
Fiscalapi es una API web, así que funciona con cualquier sistema que haga peticiones HTTP: un backend, una aplicación de escritorio o móvil, o una tienda en línea. Puedes llamarla directamente desde cualquier lenguaje de programación o usar uno de los SDK oficiales.
Arquitectura de integración con Fiscalapi
Características soportadas
| Área | Qué incluye |
|---|---|
| Modos de operación | Facturación por valores y facturación por referencias. |
| Ambientes | Pruebas y producción. |
| SDK | .NET, Node.js, Python, PHP y Java. |
| Colección de Postman | Ejemplos de peticiones a la API, listos para importar en Postman y ejecutar. |
| Facturas | Ingreso, egreso (notas de crédito), pago, nómina, traslado y factura global. |
| Complementos | Pagos, nómina, Carta Porte, Comercio Exterior e impuestos locales. |
| Consultas al SAT | Estado de un CFDI y catálogos del SAT. |
| Descarga masiva | CFDI y metadatos emitidos y recibidos. |
| Validaciones CFDI | Siete criterios sobre un CFDI timbrado: estructura del XML, vigencia del certificado, sello del emisor, sello del SAT, estado en el SAT y listados 69-B y 69-B Bis del emisor. |
| Portal de autofactura (Beta) | Tus clientes facturan sus tickets de venta desde un portal, con el código QR del ticket. |
Otras características
Tu cuenta no tiene límite de emisores, receptores ni usuarios. Con una sola cuenta emites facturas de cualquier RFC a cualquier RFC y administras varias empresas o clientes independientes. Desde el dashboard controlas emisores, receptores, usuarios, API keys, productos, facturas, certificados, timbres y reportes.
Cada CFDI incluye su PDF sin costo adicional, con el logo y los colores que definas para cada emisor en sus reglas de reporte. Puedes enviar el XML y el PDF por correo sin costo y recuperar cualquier factura emitida, desde la API o el dashboard, porque Fiscalapi las almacena.
Recibes asistencia personalizada sin costo antes, durante y después de tu integración, y soporte técnico prioritario en horario comercial. Contratas y administras servicios y complementos desde el dashboard cuando los necesitas.
Complementos CFDI 4.0
Fiscalapi genera los complementos a partir de los datos de tu petición. Envías la información del pago, la nómina o el traslado en JSON y Fiscalapi construye el nodo del complemento, aplica las validaciones del SAT y lo integra al CFDI. No necesitas armar el XML del complemento ni mantener sus reglas cuando el SAT las cambia.
Esto es distinto de las soluciones que solo insertan en el CFDI un complemento que tú construyes. En ese esquema, el XML, la lógica de negocio y el cumplimiento del complemento quedan de tu lado.
Tutoriales
Inicio rápido
Integra Fiscalapi paso a paso, desde la creación de tu cuenta hasta la emisión de tu primera factura CFDI.
Credenciales de acceso
Obtén tu API key y tu tenant. Los dos son necesarios para autenticar tus peticiones a la API.
Autenticación
Autentica cada petición a la API con tu API key y tu tenant en los encabezados X-API-KEY y X-TENANT-KEY.
Datos de prueba
Tarjetas, personas y certificados de prueba para activar una suscripción, comprar timbres y timbrar facturas en el ambiente de pruebas.
Modos de operación de la API
Los dos modos de operación que ofrece la API para crear facturas: por referencias y por valores.
Validaciones SAT
Qué verifica cada uno de los siete criterios de validación del SAT, cómo se cobran en créditos y cómo interpretar el veredicto.
Recursos
Introducción a las validaciones SAT
Qué verifica cada uno de los siete criterios de validación, cómo se cobran en créditos y cómo interpretar el veredicto.
Validaciones SAT
Valida un CFDI ante el SAT: estructura, vigencia del certificado, sellos, estatus de cancelación y listas negras 69-B.
Reglas de reporte
Personaliza el aspecto de las facturas PDF con la identidad de tu negocio o la de tus clientes.