API de facturación CFDI para empresas
Integra la facturación automática de tickets de compra en tu sistema, ERP o aplicación. API REST con autenticación por API key, webhooks en tiempo real y 60 req/min por clave.
Endpoints
POST /v1/oxxo/facturasFactura un ticket de OXXO. Body: fiscal_profile_id, fecha (DD/MM/YYYY), folio, id (id_venta), total. Respuesta 202 con job_id para polling.
POST /v1/grupo-walmart/facturasFactura un ticket de Grupo Walmart. Body incluye forma_pago (04/05/28) y brand (walmart/sams/aurrera/superama).
POST /v1/alsea/facturasFactura ticket de Alsea (8 marcas). Body incluye brand (Dominos/Starbucks/BK/Chilis/Vips/Italiannis/PFChangs/ElPorton).
POST /v1/{comercio}/facturas/syncVariante síncrona. Espera hasta 120s la finalización del job. Timeout 504 si no termina en ese lapso.
GET /v1/facturas/{id}Consulta el estado de un job (pending/running/done/failed) y metadata del CFDI.
GET /v1/facturas/{id}/pdfDescarga el PDF de la factura. Redirect 307 a S3 presigned URL.
POST /v1/facturas/batchHasta 50 tickets en una sola llamada. Mismo perfil fiscal y conector para todo el batch.
Características técnicas
- Autenticación: Bearer token (API keys con prefijo fact_live_)
- Rate limit: 60 req/min por API key
- Idempotencia: header Idempotency-Key para evitar jobs duplicados
- Webhooks: notificaciones job.done y job.failed con firma HMAC-SHA256
- Formato fechas: DD/MM/YYYY
- Receptor snapshot: perfil fiscal congelado al momento de encolar
Plan Business — $299/mes
Incluye API pública con acceso completo a todos los comercios, webhooks, 5 perfiles fiscales y tickets ilimitados. Ideal para ERPs, apps de gastos, plataformas contables y equipos.
Empieza con BusinessMás información: Facturación electrónica · Qué es CFDI 4.0 · Comparativa plataformas