Question 1

¿Cuánto tiempo toma integrar la API en mi sistema?

Accepted Answer

Question 2

¿Tengo que implementar la lógica del SAT en mi sistema?

Accepted Answer

No. Tú envías datos de negocio en JSON; Factura.com aplica todas las reglas SAT antes del timbrado. Lo que NO tienes que construir tu propio PAC:
• Validación de RFC (estructura, dígito verificador, lista LCO).
• Validación de código postal vs régimen fiscal (la combinación más fallada en CFDI 4.0).
• Catálogos SAT actualizados (c_ClaveProdServ, c_ClaveUnidad, c_FormaPago, c_Moneda, c_UsoCFDI, c_RegimenFiscal, etc.).
• Firmado con CSD (la cadena original, sellado y timbrado fiscal digital).
• Estructura XML Anexo 20: tú no construyes ni un nodo XML.
• Validaciones de complementos (Carta Porte 3.1, Pagos 2.0, Nómina 1.2, etc).
 💡
 Lo que sí debes hacer en tu sistema: 
 Solo: capturar datos del cliente y de la operación, llamar al endpoint de emisión, manejar la respuesta (éxito/error) y almacenar el UUID + URLs del XML/PDF. Eso es todo.

Question 3

¿El entorno sandbox es 100% equivalente a producción?

Accepted Answer

(Evolución de FAQ actual #3)
Sí, en endpoints, payloads y comportamiento. Cambian tres cosas:
• Las API Keys son distintas (F-Api-Key y F-Secret-Key específicas de sandbox).
• El sandbox no envía al SAT, por lo que los CFDI no tienen validez fiscal — pero el UUID, XML, PDF y QR se generan idénticamente.
• El dominio Es distinto, para sandbox es sandbox.factura.com/api y para producción api.factura.com evitando que mezcles los ambientes por error
Lo que el sandbox incluye:
• CSDs de prueba del SAT descargables desde el panel (no requieres CSD real para integrar). y configurado por defecto al crear tu cuenta de sandbox
• RFCs de prueba para personas físicas y morales, distintos regímenes.
• Catálogos SAT idénticos a producción.
• Mismas validaciones, mismos códigos de error.

Question 4

¿Qué necesito para empezar? (Checklist técnico)

Accepted Answer

Para tu primer CFDI en sandbox:
• Crear cuenta para sandbox en factura.com/sandbox (sin contrato previo).
• Ingresar al tu cuenta de sandbox en sandbox.factura.com
• Tus API Keys (F-Api-Key y F-Secret-Key) desde Configuraciones → API → Datos de Acceso.
• Cliente HTTP (Postman, Insomnia, o cURL desde terminal).
Para migrar a producción agregas:
• Plan Anual activo o plan de folios por volumen.
• CSD real del contribuyente emisor (.cer y .key — NO la e.firma/FIEL).
• RFC dado de alta en tu cuenta de producción.
• Whitelist de IPs si tu infraestructura lo requiere.
 ⚠️
 Error común evitable: 
 No confundir CSD (Certificado de Sello Digital) con e.firma (FIEL). El CSD es exclusivo para timbrado y se tramita en el portal SAT. Si subes la FIEL, todos los timbrados fallarán con error de certificado inválido.

Question 5

¿Cómo automatizo la emisión de CFDI post-cobro?

Accepted Answer

El patrón típico para automatización post-cobro es:
• Cobro confirmado (Stripe, Mercado Pago, Conekta, OpenPay, transferencia, etc.) dispara un webhook a tu backend.
• Tu backend recibe el evento y construye el payload del CFDI con los datos fiscales del cliente.
• Llamas al endpoint de emisión (POST /v4/cfdi40/create).
• Recibes UUID, XML y PDF, los guardas en tu DB y los envías al cliente por email.
Ejemplo mínimo del payload (sandbox):
 curl -X POST https://sandbox.factura.com/api/v4/cfdi40/create -H "F-PLUGIN: 9d4095c8f7ed5785cb14c0e3b033eeb8252416ed" -H "F-Api-Key: " -H "F-Secret-Key: " -H "Content-Type: application/json" -d &#x27;{
 "Receptor": { "UID": "" },
 "TipoDocumento": "factura",
 "UsoCFDI": "G03",
 "FormaPago": "03",
 "MetodoPago": "PUE",
 "Conceptos": [ { "ClaveProdServ": "81111500", "Cantidad": 1, "Descripcion": "Servicio mensual SaaS", "ValorUnitario": 1000 } ]
 }&#x27;
 💡
 Best practice de automatización: 
 Implementa idempotencia con un id único de transacción (Stripe payment_intent, MP payment_id) para evitar duplicar CFDI ante reintentos del webhook. Maneja errores 5xx con exponential backoff y los 4xx con cola de revisión manual.

Question 6

¿Existen rate limits? ¿Cómo manejo picos de timbrado masivo?

Accepted Answer

La API está diseñada para escalar desde decenas hasta millones de CFDI mensuales. 
Recomendaciones técnicas para timbrado a gran escala:
• Procesamiento asíncrono: Usa colas (RabbitMQ, AWS SQS, Redis BullMQ, Sidekiq) en lugar de timbrar en el hilo de la petición HTTP del usuario.
• Reintentos exponenciales: Backoff de 1s, 2s, 4s, 8s para respuestas 5xx o timeouts. Los 4xx NO se reintentan automáticamente.
• Concurrencia controlada: Limita workers paralelos en cierres de mes / Black Friday / Hot Sale para no saturar tu propia infraestructura.
• Caché local de catálogos SAT: Almacena c_ClaveProdServ y c_ClaveUnidad con TTL semanal, no consultes catálogos en cada timbrado.
• Volúmenes empresariales: Para operaciones >100k CFDIs/mes está disponible un SLA dedicado con asesoría técnica de implementación.

Question 7

¿Existen librerías oficiales o SDKs por lenguaje?

Accepted Answer

Question 8

¿Cuáles son los errores más comunes al timbrar y cómo los manejo?

Accepted Answer

Top de errores más reportados y su resolución:
 Código | 
 Causa común | 
 Resolución | 
 | 
 CFDI40102 | 
 Código postal del emisor no coincide con su régimen fiscal | 
 Validar CP en constancia de situación fiscal del SAT | 
 CFDI40147 | 
 UsoCFDI no permitido para el régimen fiscal del receptor | 
 Consultar matriz UsoCFDI vs Régimen del receptor | 
 CFDI33199 | 
 Receptor con RFC no registrado ante SAT | 
 Validar el RFC con LCO del SAT antes de timbrar | 
 301 / 302 | 
 OkHttp, Apache HttpClient | 
 Spring Boot, sistemas enterprise, banca | 
 CFDI40109 | 
 CSD vencido o revocado | 
 Renovar CSD en el portal SAT y resubir a tu cuenta | 
 401 | 
 API Keys incorrectas o ambiente mezclado (sandbox vs prod) | 
 Verificar headers F-Api-Key y F-Secret-Key del ambiente correcto | 
 💡
 Patrón recomendado: 
 Implementa un catálogo de mapeo de códigos de error a mensajes de usuario amigables en tu propia capa. Los 4xx son responsabilidad del payload de entrada (no reintentar), los 5xx son transitorios (sí reintentar con backoff).

Question 9

¿Qué complementos del SAT puedo emitir vía API?

Accepted Answer

Todos los CFDI y complementos vigentes del SAT están disponibles vía API:
• Tipos de CFDI: Ingreso (I), Egreso (E), Traslado (T), Pago (P), Nómina (N).
• Complementos: Carta Porte 3.1, Pagos 2.0, Nómina 1.2, Comercio Exterior 2.0, INE, IEDU, Donatarias, Notarios, Vehículo Usado, Aerolíneas, Servicios Parciales de Construcción, entre otros.
• Operaciones adicionales: Cancelación con motivo, descarga de XML/PDF, consulta de estatus SAT, validación de RFC contra LCO, consulta de folios disponibles.

Question 10

¿Qué versión de la API uso? ¿Cómo manejan los cambios y deprecaciones?

Accepted Answer

Todos los CFDI y complementos vigentes del SAT están disponibles vía API:
• Versionado: La versión actual de la API es v4 (alineada a CFDI 4.0). El versionado se hace por URL: /api/v4/....
• Cambios obligatorios del SAT: Cuando el SAT actualiza catálogos o reglas, Factura.com los implementa sin que modifiques tu integración.
• Cambios mayores (breaking changes): Se anuncian con anticipación, se publican en el sandbox y conviven con la versión anterior durante el período de transición.
• Almacenamiento de tus CFDI: 5 años, cumpliendo el Art. 30 del CFF, accesibles vía API en cualquier momento.
• Soporte técnico vía teléfono, chat y correo, escalable a equipo de integración para casos complejos.

FACTURACIÓN ELECTRÓNICA

CASOS DE USO

INTEGRACIONES Y PLATAFORMAS

PLUGINS

Recursos

Desarrollo

Facturación electrónica vía API, lista para integrar

Empieza en minutos

Prueba en sandbox

Lleva la facturación a tu flujo

Activa producción

Menos desarrollo, producción más rápida y autofacturación incluida

Portal listo para tus clientes

Menos carga operativa

Factura global

Consulta por API

Elige el plan que acompaña tu integración

¿Tienes dudas sobre qué plan elegir?

Construida para desarrolladores

Integración rápida

Cumplimiento fiscal

Automatización

Empieza en sandbox

Explora nuestros plugins y conecta tu e-commerce hoy mismo

Documentación y herramientas
para comenzar

API

Revisa nuestra documentación

Modo sandbox

Algunas ventajas de Factura.com

Actualizaciones permanentes

Almacenamiento por 5 años

Soporte

Preguntas frecuentes

Aquí encontrarás respuesta a tus dudas

Empieza a integrar hoy

Uso de cookies: