API REST en produccion โ€” CFDI 4.0 + Nomina + SAT

Timbra facturas con
una llamada al API

API REST para facturacion electronica CFDI 4.0, nomina, descarga de XMLs del SAT, SUA e IDSE. Conecta tu POS, ERP o app al SAT en minutos.

timbrar-factura.js
const res = await fetch("https://api.fiscafacil.mx/cfdi/timbrar", {
  method: "POST",
  headers: {
    "Authorization": "Bearer ff_YOUR_API_KEY",
    "x-empresa-id": "YOUR_EMPRESA_ID",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    conceptos: [{
      claveProdServ: "84111506",
      claveUnidad: "E48",
      descripcion: "Servicio de consultoria",
      cantidad: 1, valorUnitario: 5000
    }],
    formaPago: "03", metodoPago: "PUE"
  })
})

const { data } = await res.json()
console.log(data.uuid) // โ†’ "6128396c-5765-4f1b-b3a2-e4d1c7a6e9b3"

CFDI 4.0

Timbrado certificado

PAC

Autorizado por el SAT

5s

Descarga XML del SAT

99.9%

Uptime del API

๐Ÿค–AI-Ready API

Tu agente AI puede integrar FiscaFacil solo

Copia este prompt y pegalo en Claude, ChatGPT, Cursor o cualquier AI coding agent. Tu agente leera la documentacion completa y generara codigo funcional.

PROMPT PARA TU AI AGENT:

Lee la documentacion completa del API de FiscaFacil en https://docs.fiscafacil.mx/llms-full.txt y ayudame a integrar facturacion electronica CFDI 4.0 en mi aplicacion. Mi API key es ff_... y mi empresa ID es ...

Compatible con Claude Code ยท Cursor ยท ChatGPT ยท GitHub Copilot ยท Windsurf

Todo lo que necesitas para facturar en Mexico

Un API para CFDI 4.0, nomina, SUA/IDSE y descarga del SAT. Sin XML, sin criptografia โ€” nosotros nos encargamos.

POST /cfdi/timbrar

CFDI 4.0 Timbrado

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

POST /nomina/calcular

Nomina Gross-to-Net

Calculo programable de ISR Art. 96 (2026), subsidio al empleo, IMSS y neto a pagar. API publica sin auth.

POST /cfdi/descargar-por-uuid

Descarga XML del SAT

Descarga facturas recibidas por UUID en 5 segundos. Portal scraping instantaneo con FIEL. Sin espera de 72h.

POST /cfdi/cancelar

Cancelacion SAT

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

POST /nomina/sua

SUA / IDSE

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

cfdi.timbrado ยท cfdi.xml_disponible

Webhooks en tiempo real

Recibe notificaciones cuando una factura se timbra, cancela, o cuando un XML del SAT esta listo.

Header: Idempotency-Key

Idempotencia

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

X-FiscaFacil-Mode: sandbox

Sandbox + Live Mode

Toda respuesta indica el modo (sandbox/live). Misma API key, la empresa decide el ambiente.

allowedActions ยท ipWhitelist

API Key Scoping

Restringe keys por empresa, acciones, rate limit e IP. Cada integracion POS tiene su scope aislado.

Integra en cualquier lenguaje

API REST estandar. Sin SDK obligatorio โ€” una llamada HTTP con tu API key y listo.

cURL

curl -X POST https://api.fiscafacil.mx/cfdi/timbrar \
  -H "Authorization: Bearer ff_..." \
  -H "x-empresa-id: emp_..." \
  -H "Content-Type: application/json" \
  -d '{"conceptos":[...]}'

JavaScript / Node.js

const res = await fetch(
  "https://api.fiscafacil.mx/cfdi/timbrar",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer ff_...",
      "x-empresa-id": "emp_..."
    },
    body: JSON.stringify({ conceptos: [...] })
  }
)

Python

import requests

res = requests.post(
    "https://api.fiscafacil.mx/cfdi/timbrar",
    headers={
        "Authorization": "Bearer ff_...",
        "x-empresa-id": "emp_..."
    },
    json={"conceptos": [...]}
)

Sandbox gratuito

Ambiente aislado. Timbra, cancela y prueba sin costo. Sin valor fiscal. Cambia a produccion cuando estes listo.

Probar Sandbox โ†’

Documentacion AI-ready

Docs interactivas con ejemplos en 3 lenguajes. Archivo llms-full.txt para que tu AI agent lea toda la API.

Explorar API โ†’

Errores descriptivos

Codigos especificos: CSD_003, FIEL_004, RECEPTOR_MISMATCH. Cada error explica que paso y como solucionarlo.

Ver errores โ†’

Errores que explican que paso

Cada respuesta incluye modo (sandbox/live), codigo unico y mensaje claro.

HTTP 400 Bad Request
{
  "mode": "sandbox",
  "success": false,
  "error": {
    "code": "CSD_003",
    "message": "Tu certificado expiro el 15/12/2025. Renuevalo en sat.gob.mx"
  }
}

Precios simples, sin sorpresas

Empieza gratis en sandbox. Paga solo cuando timbres en produccion.

Para desarrollo

Sandbox

Gratis
TimbresIlimitados (mock)
Empresas3
  • โœ“API completa
  • โœ“Sandbox ilimitado
  • โœ“Sin tarjeta
Empezar gratis

Startup

$199/mes
Timbres25
Extra$2.00/extra
Empresas1
  • โœ“CFDI 4.0
  • โœ“Webhooks
  • โœ“API Key Scoping
Comenzar
Popular

PyME

$499/mes
Timbres150
Extra$1.50/extra
Empresas3
  • โœ“Todo Startup +
  • โœ“Nomina completa
  • โœ“Descarga SAT
Comenzar

Despacho

$999/mes
Timbres500
Extra$1.00/extra
Empresas10
  • โœ“Todo PyME +
  • โœ“SUA / IDSE
  • โœ“Soporte prioritario
Comenzar

Enterprise

$1,999/mes
Timbres2,000
Extra$0.50/extra
EmpresasIlimitadas
  • โœ“Todo Despacho +
  • โœ“Empresas ilimitadas
  • โœ“SLA 99.9%
Comenzar

Precios en MXN + IVA ยท Todos los planes incluyen sandbox gratuito ยท Cancela cuando quieras

Empieza a timbrar hoy

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