API REST v1 disponible

Timbra facturas con
una linea de codigo

API REST para facturacion electronica CFDI 4.0, nomina, SUA e IDSE. Conecta tu sistema al SAT, IMSS e INFONAVIT en minutos, no semanas.

timbrar-factura.ts
import { FiscaFacil } from "fiscafacil"

const client = new FiscaFacil("ff_YOUR_KEY")

// Timbrar una factura CFDI 4.0
const factura = await client.facturas.crear({
  receptor: { rfc: "XAXX010101000" },
  conceptos: [{ 
    descripcion: "Servicio de consultoria",
    cantidad: 1, precioUnitario: 5000
  }]
})

console.log(factura.uuid)
// → "6128396c-5765-4f1b-b3a2-e4d1c7a6e9b3"

Integrado con

SATIMSSINFONAVITPAC Autorizado

Todo lo que necesitas para facturar en Mexico

Un API unificado para CFDI 4.0, nomina, SUA/IDSE y mas. Sin XML, sin criptografia — nosotros nos encargamos.

POST /v1/facturas

CFDI 4.0 Timbrado

Genera, sella y timbra facturas con una sola llamada. Soporte para Ingreso, Egreso, Traslado, Pagos y Nomina.

POST /v1/nomina/calcular

Nomina Gross-to-Net

Calculo programable de ISR Art. 96, subsidio al empleo, IMSS y neto a pagar. Ningun otro PAC expone esto via API.

POST /v1/facturas/cancelar

Cancelacion SAT

Cancela CFDIs con los 4 motivos del SAT. Devolucion automatica de timbres. Webhooks para aceptacion del receptor.

POST /v1/nomina/sua

Archivos SUA / IDSE

Genera archivos para el IMSS: altas, bajas, modificaciones salariales y determinacion de cuotas bimestrales.

Header: Idempotency-Key

Idempotencia

Cada peticion acepta un Idempotency-Key. Si la conexion falla, reintenta sin miedo a duplicar facturas.

POST tu-server/webhook

Webhooks

Recibe notificaciones push cuando una factura se timbra, cancela o requiere aceptacion. Sin polling.

POST /v1/facturas/status

Status SAT en tiempo real

Consulta si un CFDI esta vigente, cancelado o en proceso. Verifica el status directamente con el SAT.

POST /v1/facturas/pdf

PDF automatico

Genera la representacion impresa (PDF) de cualquier CFDI timbrado con una sola llamada.

GET /v1/facturas/pendientes

Cancelaciones inteligentes

Consulta pendientes, acepta o rechaza cancelaciones, y consulta relaciones entre CFDIs. Flujo completo.

SDKs para tu lenguaje favorito

Instala el paquete, pasa tu API key, y empieza a timbrar. Cero configuracion de certificados.

TypeScript / Node.js

npm install fiscafacil

Python

pip install fiscafacil

PHP

composer require fiscafacil/sdk

C# / .NET

dotnet add package FiscaFacil

Sandbox de pruebas

Ambiente aislado con CSDs de prueba del SAT. Simula timbrado, cancelaciones y errores sin costo y sin valor fiscal.

Probar en Sandbox

Referencia API interactiva

Documentacion OpenAPI con ejemplos en cada lenguaje. Prueba endpoints desde el navegador.

Explorar API

Errores descriptivos

Codigos de error especificos del negocio: RFC_INVALIDO, CSD_EXPIRADO, SALDO_INSUFICIENTE. Nunca un 500 generico.

Ver catalogo de errores

Errores que explican que paso

Cada respuesta incluye un codigo unico, un mensaje claro y sugerencia de solucion.

HTTP 400 Bad Request
{
  "success": false,
  "error": {
    "code": "CSD_EXPIRADO",
    "message": "El certificado CSD expiro el 2025-12-15.",
    "suggestion": "Renueva tu CSD en el portal del SAT y subelo via PUT /v1/empresas/{id}/certificados"
  }
}

Empieza a timbrar hoy

Crea tu cuenta, genera un API key, y timbra tu primera factura en menos de 5 minutos.