API B2B · México
Mandas los datos del ticket a la API. CFDIX averigua dónde y cómo factura ese comercio, hace la solicitud y te devuelve el XML y el PDF ya comprobados. Si algo se atora, lo ves en el panel con el motivo.
POST /api/v1/invoice-requests
Authorization: Bearer cfdix_••••••••
Idempotency-Key: tkt-A88431-2026-08-10
Content-Type: application/json
{
"ticket": {
"ticket_number": "A-88431",
"purchase_total": { "amount": "1234.50", "currency": "MXN" },
"purchased_at": "2026-08-10T18:24:00Z",
"merchant_rfc": "XAXX010101000"
},
"recipient": {
"rfc": "XAXX010101000",
"legal_name": "MI EMPRESA SA DE CV",
"fiscal_regime_code": "601",
"postal_code": "66350",
"cfdi_use_code": "G03"
}
}202 Accepted
Location: /api/v1/invoice-requests/01J5M4T7Y9K2QW3E4R5T6Y7U8I
X-Correlation-ID: 01J5M4T7Y9K2QW3E4R5T6Y7U8I
{
"data": {
"id": "01J5M4T7Y9K2QW3E4R5T6Y7U8I",
"status": "RECEIVED",
"ticket_number": "A-88431",
"created_at": "2026-08-10T18:24:03Z"
}
}CFDIX responde de inmediato y sigue trabajando en segundo plano. Que acepte la solicitud no quiere decir que ya esté facturada.
01 / QUÉ HACE
CFDIX es una plataforma B2B y API-first que automatiza solicitudes de facturación en México a partir de los datos de un ticket. Un mismo comercio puede tener varias sucursales y más de un portal de facturación, así que CFDIX los guarda por separado: cuando revisas una solicitud, ves exactamente por qué se fue por una ruta y no por otra.
02 / INTEGRACIÓN
Si repites la misma petición no se crea una solicitud duplicada. Y como facturar toma tiempo, CFDIX contesta de inmediato y te avisa después. El contrato completo está en OpenAPI 3.1.
AuthorizationIdempotency-KeyX-Correlation-ID202200409429{
"error": {
"code": "IDEMPOTENCY_CONFLICT",
"message": "…",
"retryable": false,
"correlation_id": "…"
}
}Todos los errores tienen la misma forma: un código fijo, si vale la pena reintentar y el id para rastrearlo.
De cada archivo recuperado sabes su tipo, su tamaño, su sha256 y si pasó la revisión.
Se descargan con una petición autenticada. No hay URLs públicas.
03 / ESTADOS
Son los únicos valores que puede devolver el campo status, sin importar el portal. Puedes programar sobre ellos sin adivinar. Cada cambio se guarda con su fecha y su motivo.
Entrada Proceso Éxito Cierre
04 / FLUJO
Si el portal pide algo que CFDIX no debe resolver solo, la solicitud pasa a una persona en vez de seguir adivinando.
Tu sistema manda los datos del ticket a la API.
CFDIX busca de qué comercio y sucursal es, y por dónde se factura.
Hace la solicitud por el portal autorizado y guarda con qué versión la hizo.
Comprueba el XML y el PDF antes de darla por buena.
05 / SEGURIDAD
No hace falta que nos creas: todas dejan rastro o se verifican desde tu lado.
Cada solicitud guarda por qué estados pasó, cuándo, y con qué versión de la automatización se ejecutó.
Solicitudes, archivos y credenciales quedan dentro de la empresa a la que pertenecen.
Si el portal pide un código, un inicio de sesión o contesta algo ambiguo, la solicitud se detiene y la retoma una persona.
Antes de dar una solicitud por exitosa, CFDIX comprueba que el archivo sea lo que dice ser.
Cada webhook lleva una firma HMAC-SHA256 y su hora, para que confirmes que salió de CFDIX.
QUÉ SÍ HACE
Recibe los datos del ticket, averigua por dónde se factura ese comercio, hace la solicitud, baja el XML y el PDF, y comprueba que sean válidos antes de darla por buena.
QUÉ NO HACE
No emite comprobantes. No rompe CAPTCHA, códigos de un solo uso ni inicios de sesión. Y que un archivo pase nuestra revisión técnica no significa que sea válido ante el SAT.
06 / PREGUNTAS
Lo que suelen preguntar antes de integrarse.
No. CFDIX pide la factura en el portal del comercio y revisa los archivos que llegan. Quien la emite y la timbra sigue siendo el comercio con su PAC.
No. Le mandas los datos ya leídos: folio, total, fecha y de qué comercio es. Si necesitas sacarlos de una foto, eso lo hace tu aplicación antes de llamarnos.
CFDIX no intenta saltárselos. La solicitud se detiene, queda marcada y la retoma una persona autorizada, con el registro de lo que se hizo.
No se duplica. Al crear mandas un encabezado Idempotency-Key con un valor que tú eliges; si repites la petición con esa clave y los mismos datos, te devolvemos la solicitud que ya existía. Si reutilizas la clave con datos distintos, te avisamos del conflicto en vez de crear otra.
Cada solicitud tiene un id propio y un id de rastreo que viaja con ella por todo el proceso. Puedes consultarla cuando quieras, o recibir un aviso por webhook. Los cambios de estado quedan guardados con su fecha y su motivo.
Los consultas como archivos de la solicitud. De cada uno sabes el tipo, el tamaño, su hash SHA-256 y si pasó la revisión. Se descargan con una petición autenticada; no quedan en URLs públicas.
EL PANEL