Un grupo es una unidad organizativa que te permite agrupar uno o más emisores (RFCs) dentro de tu cuenta de QRwey!.
Los grupos son útiles para:
- Separar emisores por razón social, sucursal o línea de negocio
- Organizar la estructura de facturación de tu empresa
POST /v1/qrs/groupsHost (DEV):
https://api-dev.qrwey.comHost (PROD):
https://api.qrwey.comAuthorization: Bearer {{access_token}}
Content-Type: application/json| Campo | Descripción |
|---|---|
name | Nombre del grupo (requerido) |
description | Descripción opcional del grupo |
| Campo | Descripción |
|---|---|
groupId | Identificador único del grupo |
name | Nombre del grupo |
description | Descripción del grupo |
status | Estado del grupo: ACTIVE o INACTIVE |
assignationsCount | Número de emisores asignados al grupo |
curl -X POST "https://api-dev.qrwey.com/v1/qrs/groups" \
-H "Authorization: Bearer {{access_token}}" \
-H "Content-Type: application/json" \
-d '{
"name": "Gasolineras Norte",
"description": "Grupo de estaciones de servicio en la zona norte"
}'{
"groupId": "grp_4aca0361cfcd41c097663db44008fbb9",
"name": "Gasolineras Norte",
"description": "Grupo de estaciones de servicio en la zona norte",
"status": "ACTIVE",
"assignationsCount": 3
}PUT /v1/qrs/groups/{groupId}Authorization: Bearer {{access_token}}
Content-Type: application/json| Campo | Descripción |
|---|---|
name | Nuevo nombre del grupo (requerido) |
description | Nueva descripción del grupo |
curl -X PUT "https://api-dev.qrwey.com/v1/qrs/groups/grp_4aca0361cfcd41c097663db44008fbb9" \
-H "Authorization: Bearer {{access_token}}" \
-H "Content-Type: application/json" \
-d '{
"name": "Gasolineras Norte Actualizado",
"description": "Grupo de estaciones actualizado"
}'GET /v1/qrs/groupsAuthorization: Bearer {{access_token}}| Parámetro | Descripción |
|---|---|
filter | Texto para filtrar grupos por nombre (default: vacío) |
page | Número de página (default: 0) |
size | Elementos por página (default: 20) |
curl -X GET "https://api-dev.qrwey.com/v1/qrs/groups?filter=norte&page=0&size=10" \
-H "Authorization: Bearer {{access_token}}"{
"content": [
{
"groupId": "grp_4aca0361cfcd41c097663db44008fbb9",
"name": "Gasolineras Norte",
"description": "Grupo de estaciones de servicio en la zona norte",
"status": "ACTIVE",
"assignationsCount": 3
}
],
"totalElements": 1,
"totalPages": 1,
"number": 0,
"size": 10
}GET /v1/qrs/groups/{groupId}Authorization: Bearer {{access_token}}curl -X GET "https://api-dev.qrwey.com/v1/qrs/groups/grp_4aca0361cfcd41c097663db44008fbb9" \
-H "Authorization: Bearer {{access_token}}"| Código | Motivo |
|---|---|
| 400 | El campo name es requerido o está vacío |
| 401 | Token inválido o expirado |
| 404 | Grupo no encontrado o no pertenece a tu cuenta |
Consulta: Manejo de errores
- Usa nombres descriptivos que identifiquen claramente la agrupación de emisores
- Cada grupo debe representar una unidad lógica de negocio
- Consulta los grupos existentes antes de crear uno nuevo para evitar duplicados
- Registra un emisor en tu grupo: Gestión de emisores
- Configura un comercio: Gestión de comercios
- Vuelve al índice: Gestión de Clientes