API de Validación CFDI

Integra la validación de CFDI directamente en tus sistemas. REST API con respuestas en JSON bilingüe.

Anónimo

10 req / día

Sin registro

Con API Key

100 req / día

Gratis, solicita abajo

Pro

Ilimitado

Próximamente

Endpoint

Con API Key (recomendado):

bash

curl -X POST https://fiscal.alce-soft.com/api/v1/validate \
  -H "Authorization: Bearer af_tu_api_key" \
  -H "Content-Type: application/xml" \
  --data-binary @factura.xml

Sin API Key (10 req/día por IP):

bash

curl -X POST https://fiscal.alce-soft.com/api/v1/validate \
  -H "Content-Type: application/xml" \
  --data-binary @factura.xml

También puedes enviar JSON:

bash

curl -X POST https://fiscal.alce-soft.com/api/v1/validate \
  -H "Authorization: Bearer af_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"xml": "<cfdi:Comprobante>...</cfdi:Comprobante>"}'

Respuesta

json

{
  "valid": false,
  "cfdiInfo": {
    "version": "4.0",
    "tipoDeComprobante": "P",
    "emisor": { "rfc": "XYZ010101ABC", "nombre": "Mi Empresa SA de CV" },
    "receptor": { "rfc": "ABC010101XYZ", "nombre": "Cliente SA de CV" },
    "total": "0.00",
    "fecha": "2025-03-01T10:00:00"
  },
  "summary": { "errors": 2, "warnings": 0, "info": 1 },
  "issues": [
    {
      "severity": "error",
      "code": "EQUIV_DR_INCORRECT",
      "field": "Pago[1]/DoctoRelacionado[1]@EquivalenciaDR",
      "found": "0.05818",
      "suggestedValue": "0.05817",
      "message": {
        "es": "EquivalenciaDR incorrecto — el valor correcto calculado es 0.05817",
        "en": "Incorrect EquivalenciaDR — the correct calculated value is 0.05817"
      },
      "howToFix": {
        "es": "Cambie EquivalenciaDR de 0.05818 a 0.05817",
        "en": "Change EquivalenciaDR from 0.05818 to 0.05817"
      },
      "autoFixable": true,
      "isRootCause": true
    }
  ],
  "meta": { "tier": "free", "remainingRequests": 99 }
}

valid

boolean — true si no hay errores

cfdiInfo

Datos del emisor, receptor, total, fecha

summary

Conteo de errors / warnings / info

issues[].severity

"error" | "warning" | "info"

issues[].code

Código SAT (ej: CRP20265) o propio (ej: EQUIV_DR_INCORRECT)

issues[].message

Explicación bilingüe en lenguaje natural (no técnico)

issues[].howToFix

Pasos concretos de corrección

issues[].autoFixable

true si el sistema puede corregirlo automáticamente

issues[].suggestedValue

Valor correcto sugerido (cuando aplica)

issues[].isRootCause

true si es la causa raíz de otros errores

Headers de respuesta

http

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 99
X-RateLimit-Reset: 2025-03-24T23:59:59Z
X-Tier: free

Solicitar API Key

Gratis. Recibirás tu key en menos de 24 horas.