FiscaFacil API
API REST para facturacion electronica CFDI 4.0 en Mexico. Timbra, cancela y administra facturas de forma programatica.
Base URL
https://api.fiscafacil.mxTodas las rutas usan el prefijo /api
¿Que tipo de integracion necesitas?
Empresa individual
Facturas para una sola empresa. Registrate, crea tu empresa y empieza a timbrar en minutos.
Guia de inicio rapido →
Plataforma / SaaS / POS
Tus clientes son los que facturan. Un API key, multiples empresas, gestion 100% programatica.
Guia de plataformas →
Autenticacion
Todas las peticiones requieren un API key en el header Authorization. Las rutas que operan sobre datos de una empresa requieren ademas el header x-empresa-id.
# 1. Registrate
curl -X POST https://api.fiscafacil.mx/auth/register \
-H "Content-Type: application/json" \
-d '{"email": "tu@email.com", "password": "...", "name": "Tu Nombre"}'
# 2. Obtén tu API key (con email+password, sin sesion previa)
curl -X POST https://api.fiscafacil.mx/api-keys \
-H "Content-Type: application/json" \
-d '{"email": "tu@email.com", "password": "...", "name": "mi-app"}'
# → { "key": "ff_xxx..." } ← guarda este valor
# 3. Usa el API key en todas las peticiones
curl https://api.fiscafacil.mx/cfdi/timbrar \
-H "Authorization: Bearer ff_xxx..." \
-H "x-empresa-id: YOUR_EMPRESA_ID" \
-H "Content-Type: application/json"Headers
| Header | Requerido | Descripcion |
|---|---|---|
Authorization: Bearer ff_xxx | Si | API key (empieza con ff_) |
x-empresa-id: xxx | Condicional | ID de la empresa (rutas de CFDI, clientes, productos) |
Content-Type: application/json | Si | Todas las peticiones con body |
Idempotency-Key: uuid | Opcional | Previene duplicados en timbrar y cancelar |
Que puedes hacer
Timbrar Facturas
CFDI 4.0: Ingreso, Egreso, Traslado, Pagos. Timbrado y cancelacion via API.
Descargar CFDIs del SAT
Descarga por UUID facturas recibidas de tus proveedores usando tu FIEL. Incluye conceptos e impuestos.
Administrar Empresas
Multi-RFC: crear empresas, subir CSD y FIEL, verificar salud del certificado.
Clientes y Productos
Catalogo de receptores y productos/servicios con claves SAT.
Webhooks
Recibe notificaciones en tiempo real cuando cambie el status de un CFDI.
Formato de respuesta
Todas las respuestas siguen el mismo formato JSON:
Exitosa
{
"success": true,
"data": {
"id": "clx...",
"uuid": "612839AB-..."
}
}Error
{
"success": false,
"error": {
"code": "CSD_003",
"message": "El certificado ha expirado"
}
}