Guia de Inicio Rapido

De cero a tu primer CFDI timbrado en 4 pasos. Solo necesitas 2 minutos.

Paso 1 — Crea tu cuenta

Registra una cuenta con tu email y contrasena.

curl -X POST https://api.fiscafacil.mx/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Tu Nombre",
    "email": "tu@email.com",
    "password": "Pass1234!"
  }'

Paso 2 — Obtén tu API key

Con las mismas credenciales de registro, crea tu API key en una sola llamada. No necesitas sesion ni tokens previos.

curl -X POST https://api.fiscafacil.mx/api-keys \
  -H "Content-Type: application/json" \
  -d '{
    "email": "tu@email.com",
    "password": "Pass1234!",
    "name": "mi-aplicacion"
  }'

Paso 3 — Crea tu empresa

Registra la empresa emisora. El RFC, razon social, regimen fiscal y codigo postal son obligatorios. Si el RFC ya existe en tu cuenta, se devuelve la empresa existente (seguro para reintentos).

curl -X POST https://api.fiscafacil.mx/empresas \
  -H "Authorization: Bearer ff_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "rfc": "EKU9003173C9",
    "razonSocial": "ESCUELA KEMPER URGATE",
    "regimenFiscal": "601",
    "codigoPostal": "26015"
  }'

Paso 4 — Timbra tu primera factura

En modo sandbox no necesitas CSD. Envia directamente a timbrar y obtienes un UUID de prueba.

curl -X POST https://api.fiscafacil.mx/cfdi/timbrar \
  -H "Authorization: Bearer ff_YOUR_KEY" \
  -H "x-empresa-id: YOUR_EMPRESA_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "tipoComprobante": "I",
    "metodoPago": "PUE",
    "formaPago": "03",
    "moneda": "MXN",
    "conceptos": [{
      "claveProdServ": "84111506",
      "claveUnidad": "E48",
      "descripcion": "Servicio de consultoria",
      "cantidad": 1,
      "precioUnitario": 1000,
      "objetoImpuesto": "02"
    }]
  }'

{
  "success": true,
  "data": {
    "uuid": "7F3A2B1C-...",
    "folio": "1",
    "total": 1160.00,
    "sandbox": true
  }
}

CSD — Cuando estes listo para produccion

El CSD (Certificado de Sello Digital) solo es necesario para timbrar en produccion. Sube tus archivos .cer y .key codificados en base64:

# Codifica tus archivos
CER_B64=$(base64 -w 0 tu_certificado.cer)   # Linux
KEY_B64=$(base64 -w 0 tu_llave.key)          # macOS: base64 -i

# Sube el CSD
curl -X POST https://api.fiscafacil.mx/empresas/YOUR_EMPRESA_ID/certificados \
  -H "Authorization: Bearer ff_YOUR_KEY" \
  -H "x-empresa-id: YOUR_EMPRESA_ID" \
  -H "Content-Type: application/json" \
  -d "{
    \"cerBase64\": \"$CER_B64\",
    \"keyBase64\": \"$KEY_B64\",
    \"password\": \"tu_password_csd\"
  }"

RFCs de prueba (Sandbox)

FIEL — Para consultar facturas recibidas

Si quieres ver las facturas que recibes de tus proveedores (insumos, productos, montos), sube tu FIEL (e.firma). Conectamos directamente al portal del SAT — resultados instantaneos, sin esperas.

1. Sube tu FIEL con POST /api/empresas/:id/fiel (mismo formato que CSD — envia cer/key en base64 + password).

2. Sincroniza un mes completo con POST /api/cfdi/sync-recibidos — descarga todas las facturas de ese mes en ~30 segundos.

3. O descarga una factura especifica con POST /api/cfdi/descargar-por-uuid — respuesta sincrona en 5-10 segundos con el CFDI completo y sus conceptos.

4. Consulta tus facturas con GET /api/cfdi — filtra por fecha, busca por UUID, pagina los resultados.

Detalles completos, ejemplos de codigo y respuestas en Referencia API → Facturas Recibidas.

Siguientes pasos