# Acerca de QRwey!

**QRwey!** es una plataforma tecnológica diseñada para habilitar intenciones de
**autofacturación y consulta de transacciones** mediante el uso
de **códigos QR efímeros, firmados y verificables**.

QRwey! está orientado a empresas y personas que operan en **México**, especialmente en sectores
donde es necesario vincular una transacción con procesos posteriores como
facturación electrónica o validación por parte del cliente.

## ¿Qué es QRwey!?

QRwey! permite que una transacción quede representada en una intención de autofactura mediante **QR seguro** que:

- No contiene información sensible
- Tiene una vigencia limitada
- Puede validarse de forma confiable vía API
- Es leído y procesado por la aplicación móvil de QRwey!


Este enfoque reduce fricción operativa y mejora la experiencia del cliente,
manteniendo controles de seguridad estrictos. El cliente YA no tiene que ir a portales de autofactura complicados, feos y con formas interminables para autofacturarse.

## El problema que resuelve

En muchos flujos comerciales existe una desconexión entre:

- El momento en que ocurre la venta
- El momento en que el cliente requiere facturar o consultar la operación
- El timbrado de la factura (XML y PDF)
- El poder compartir dicha factura con sus áreas contables (WhatsApp, eMail, etc.)
- La validación posterior de la transacción


QRwey! actúa como un **puente confiable** entre estos momentos, evitando errores,
reprocesos y el uso de datos sensibles en canales no seguros.

## Cómo funciona (visión general)

A alto nivel, el flujo es el siguiente:

1. El comercio/integrador registra una intención de autofactura mediante la API de QRwey!
2. QRwey! genera un token opaco y lo firma criptográficamente
3. El token se entrega dentro de un código QR
4. El cliente escanea el QR desde la app móvil de QRwey!
5. La aplicación resuelve el QR y muestra el detalle de la transacción
6. El cliente final timbra adecuadamente esa intención de autofactura y la convierte en
un documento válido ante el SAT (Timbre XML y representación impresa PDF)


Todo el proceso está protegido mediante validaciones en los servidores de QRwey!

## Principios de diseño

QRwey! fue diseñado con los siguientes principios:

- **Seguridad por defecto**
Tokens opacos, firmas HMAC y validación en cada resolución.
- **Expiración controlada**
Los códigos QR no son permanentes y no pueden reutilizarse indefinidamente.
- **Integración clara**
API REST documentada y orientada a integraciones con cualquier software, terminal de venta, sistemas SaaS y backends.
- **Enfoque local**
Considera el contexto fiscal, operativo y normativo de México.


## Quién desarrolla QRwey!

QRwey! es un producto desarrollado y operado por:

**Petroverse Software, SAPI de CV**

Empresa enfocada en soluciones tecnológicas para el sector energético,
comercial y de servicios en México.

## Recursos para desarrolladores

- [Guía Rápida](/guides/quickstart)
- [Guías de Integración](/guides)
- [Referencia del API](/apis/qrwey)
- [Uso Responsable](/legal/responsible-use)
- [Términos de Uso](/legal/terms)


## Contacto

Para información adicional sobre **QRwey!**, utiliza los canales oficiales de **Petroverse Software**

### Hecho en Querétaro, con amor para México 🇲🇽

**Petroverse Software, SAPI de CV**
Edificio Highpark
Lic. Manuel Gómez Morin 3960-6C
Centro Sur, Querétaro, 76090, MX

> **“La quinta esencia de lo complicado, radica en lo sencillo”**