# Guías de QRwey!

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.

## ¿Qué aprenderás aquí?

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


## Empieza aquí

Si es tu primera vez integrando QRwey!, comienza por aquí:

- **[Guía Rápida](/guides/quickstart)**
Integra un flujo completo: generar un QR, resolverlo y completar la autofactura.


## Conceptos básicos

Antes de ir a producción, es importante entender cómo funciona QRwey! y sus reglas principales:

- **[Cómo funciona QRwey!](/guides/introduction)**
Visión general del flujo de autofactura basado en QR.
- **[Autenticación](/guides/authentication)**
Cómo usar tu API Key de forma segura.
- **[Ciclo de vida del QR](/guides/qr-lifecycle)**
Estados, expiración y validaciones de los códigos QR.


## Operación

Estas guías cubren las operaciones principales que usarás en tu integración:

- **[Generar códigos QR](/guides/generate-qr)**
Crear intenciones de autofactura y generar códigos QR seguros.
- **[Resolver códigos QR](/guides/resolve-qr)**
Obtener el detalle de una transacción a partir de un QR escaneado.


## Confiabilidad y seguridad

Para evitar errores, duplicados y comportamientos inesperados:

- **[Idempotencia & Reintentos](/guides/idempotency)**
Cómo prevenir operaciones duplicadas.
- **[Manejo de errores](/guides/error-handling)**
Interpretar códigos de error y actuar correctamente.
- **[Expiración & Reuso de tokens](/guides/expiration-and-reuse)**
Qué pasa cuando un QR expira o ya fue consumido.


## Buenas prácticas

Para operar QRwey! correctamente en producción:

- **[Uso responsable](/legal/responsible-use)**
Lineamientos y buenas prácticas de uso.
- **[Preguntas frecuentes](/tools/faq)**
Respuestas a dudas comunes de integración y operación.


## Siguiente paso

Cuando tengas dudas sobre parámetros específicos, esquemas o respuestas exactas,
consulta siempre la **[Referencia del API](/apis/qrwey)**, generada directamente a partir
del OpenAPI oficial.