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.
QRwey! expone dos APIs según el tipo de integración, cada una con su propio esquema de autenticación:
- Comercios (puntos de venta que emiten intenciones de autofactura): consumen los endpoints de generación y resolución de QR, autenticados con
X-API-Key. Empieza por Autenticación y Generar código QR. - Integradores (quienes tienen la relación comercial con QRwey! y administran grupos, emisores de RFC y comercios): consumen la Gestión de Clientes, autenticado con
Authorization: Bearer {access_token}. Empieza por Gestión de Clientes.
En la práctica, los Integradores dan de alta a los Comercios en el Portal y les emiten la X-API-Key que el Comercio usa desde su backend. Los dos esquemas no son independientes: están encadenados.
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
- Obtener el detalle completo de una transacción QR
- 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.Obtener detalle de QR Obtener el detalle completo de una transacción QR por su identificador.
La Gestión de Clientes permite gestionar tu configuración de facturación y timbrar CFDIs directamente:
Gestión de Clientes Visión general del API de la Gestión de Clientes.
Gestión de grupos Crear y administrar grupos para organizar emisores.
Gestión de emisores Registrar y sincronizar emisores (RFCs) con el SAT.
Gestión de comercios Configurar comercios, llaves CSD y API keys.
Catálogo de productos del comercio Crear, listar, consultar y actualizar los productos de un comercio.
Gestión de transacciones Consultar y cancelar transacciones de un comercio.
Reportes del cliente Consultar reportes de consumo, RFCs frecuentes y tarifa óptima.
Catálogos SAT Consultar formas de pago, claves de unidad y productos/servicios del SAT.
Planes de facturación Consultar planes disponibles y configuración del simulador de costos.
Estos endpoints permiten timbrar CFDIs 4.0 directamente desde el API:
Timbrar CFDI 4.0 Generar y timbrar facturas de ingreso (tipo I).
Notas de crédito Generar notas de crédito (tipo E) vinculadas a una factura existente.
Complementos de pago Generar complementos de pago (tipo P) para facturas con método PPD.
Consulta de facturas Listar facturas emitidas por integrador, emisor o comercio.
Detalle de CFDI Obtener el detalle completo de un CFDI timbrado por su UUID fiscal.
Cancelar CFDI 4.0 Cancelar un CFDI 4.0 previamente timbrado.
Consultar estatus de CFDI Consultar el estatus actual de un CFDI ante el SAT.
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.