Las Guías de QRwey! están diseñadas para ayudarte a integrar un flujo completo de autofactura CFDI basado en códigos QR, desde el primer request hasta la generación de un XML timbrado y su representación impresa.
Aquí aprenderás a integrar QRwey! de forma correcta, segura y lista para producción.
A lo largo de estas guías aprenderás a:
- Autenticarte correctamente contra la API de QRwey!
- Generar intenciones de autofactura mediante códigos QR
- Resolver códigos QR para obtener el detalle de una transacción
- Convertir una intención validada en un CFDI timbrado (XML)
- Generar la representación impresa (PDF) del CFDI
- Manejar expiración, idempotencia y errores
- Construir una integración confiable para entornos productivos
Si es tu primera vez integrando QRwey!, comienza por aquí:
- Guía Rápida
Integra un flujo completo: generar un QR, resolverlo y completar la autofactura.
Antes de ir a producción, es importante entender cómo funciona QRwey! y sus reglas principales:
Cómo funciona QRwey!
Visión general del flujo de autofactura basado en QR.Autenticación
Cómo usar tu API Key de forma segura.Ciclo de vida del QR
Estados, expiración y validaciones de los códigos QR.
Estas guías cubren las operaciones principales que usarás en tu integración:
Generar códigos QR
Crear intenciones de autofactura y generar códigos QR seguros.Resolver códigos QR
Obtener el detalle de una transacción a partir de un QR escaneado.
Para evitar errores, duplicados y comportamientos inesperados:
Idempotencia & Reintentos
Cómo prevenir operaciones duplicadas.Manejo de errores
Interpretar códigos de error y actuar correctamente.Expiración & Reuso de tokens
Qué pasa cuando un QR expira o ya fue consumido.
Para operar QRwey! correctamente en producción:
Uso responsable
Lineamientos y buenas prácticas de uso.Preguntas frecuentes
Respuestas a dudas comunes de integración y operación.
Cuando tengas dudas sobre parámetros específicos, esquemas o respuestas exactas, consulta siempre la Referencia del API, generada directamente a partir del OpenAPI oficial.