La Gestión de Clientes de QRwey! permite a los Integradores gestionar de forma autónoma su configuración de facturación y timbrar CFDIs directamente a través del API.
Un Integrador es quien tiene la relación comercial con QRwey!: crea grupos, da de alta emisores (RFCs ante el SAT) y registra los comercios bajo cada emisor. A cada comercio le emite una
X-API-Keyque el comercio usa desde su backend para los endpoints de generación y resolución de QR.
A diferencia de los endpoints de operación de QR (consumidos por los Comercios con X-API-Key), los endpoints de la Gestión de Clientes utilizan autenticación mediante Bearer token (OAuth 2.0) y están dirigidos a los Integradores.
Con la Gestión de Clientes puedes:
- Crear y administrar grupos para organizar tus emisores
- Registrar y sincronizar emisores (RFCs) con el SAT
- Configurar comercios con sus llaves CSD para facturar
- Mantener el catálogo de productos de cada comercio
- Timbrar CFDIs 4.0 directamente: facturas de ingreso, notas de crédito y complementos de pago
- Consultar transacciones y reportes de consumo
- Administrar planes de facturación
Todos los endpoints de la Gestión de Clientes requieren un Bearer token válido:
Authorization: Bearer {{access_token}}
Content-Type: application/jsonEl token se obtiene mediante el flujo OAuth 2.0 de client credentials configurado en tu cuenta de QRwey!. Consulta el paso a paso en Obtener un token de acceso (Integradores).
⚠️ No uses API Keys para estos endpoints. Solo se acepta Bearer token.
Los recursos de la Gestión de Clientes siguen una jerarquía lógica:
Integrador (tu cuenta)
└── Grupo
└── Emisor (RFC)
└── Comercio
├── Llaves CSD (invoice-mode)
├── API Key (consumida por el Comercio en los endpoints de QR)
└── Transacciones- Un grupo agrupa uno o más emisores
- Un emisor representa un RFC registrado ante el SAT
- Un comercio es un punto de venta asociado a un emisor, con sus propias llaves CSD
| Recurso | Guia |
|---|---|
| Grupos | Gestión de grupos |
| Emisores | Gestión de emisores |
| Comercios | Gestión de comercios |
| Productos | Catálogo de productos del comercio |
| Transacciones | Gestión de transacciones |
| Reportes | Reportes del cliente |
| Operación | Guia |
|---|---|
| Factura de ingreso (tipo I) | Timbrar CFDI 4.0 |
| Nota de crédito (tipo E) | Notas de crédito |
| Complemento de pago (tipo P) | Complementos de pago |
| Consulta de facturas | Consulta de facturas |
| Detalle de CFDI | Detalle de CFDI |
| Cancelar CFDI | Cancelar CFDI 4.0 |
| Consultar estatus de CFDI | Consultar estatus |
| Recurso | Guia |
|---|---|
| Catálogos SAT | Catálogos SAT |
| Planes de facturación | Planes de facturación |
DEV:
https://api-dev.qrwey.comPROD:
https://api.qrwey.comLos endpoints que devuelven listas soportan paginación mediante query params:
| Parámetro | Descripción |
|---|---|
page | Número de página (inicia en 0) |
size | Elementos por página (default 20) |
sort | Campo y dirección de ordenamiento (ej. createdAt,desc) |
| Código | Motivo |
|---|---|
| 401 | Token inválido o expirado |
| 403 | No tienes permisos sobre el recurso solicitado |
| 404 | Recurso no encontrado o no pertenece a tu cuenta |
| 409 | Conflicto, el recurso ya existe |
| 422 | Error de reglas de negocio |
Consulta: Manejo de errores
- Organiza tus emisores: Gestión de grupos
- Registra un RFC: Gestión de emisores
- Configura un punto de venta: Gestión de comercios
- Timbra tu primer CFDI: Timbrar CFDI 4.0