Comercios
Usuarios de Comercio
Gestionar usuarios, roles y contactos de un comercio.
POST /api/commerces/:cId/users
Crea un usuario para un comercio.
Auth: Requerida — permiso MANAGE_COMMERCES
Cuerpo de la Solicitud
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
firstName | string | Sí | Nombre |
lastName | string | Sí | Apellido |
Respuesta 201 Created
PATCH /api/commerces/:cId/users/:uId
Actualiza un usuario de comercio.
POST /api/commerces/:cId/users/:uId/roles
Agrega un rol a un usuario de comercio.
Cuerpo de la Solicitud
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
role | string | Sí | Uno de: OWNER, ORDERS, FINANCE, ATTENTION, ADMIN, COMMERCE_REP, OTHER |
Respuesta 201 Created
DELETE /api/commerces/:cId/users/:uId/roles/:role
Elimina un rol de un usuario de comercio.
Respuesta 204 No Content
POST /api/commerces/:cId/users/:uId/contacts
Agrega un contacto a un usuario de comercio.
Cuerpo de la Solicitud
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
type | string | Sí | EMAIL, PHONE o WHATSAPP |
value | string | Sí | Valor del contacto (validado según el tipo) |
isPrimary | boolean | No | Establecer como contacto principal para este tipo |
Validación
| Tipo | Formato |
|---|---|
EMAIL | Expresión regular de correo electrónico válido |
PHONE | Formato E.164 (ej., +56912345678) |
WHATSAPP | Formato E.164 |
Respuesta 201 Created
PATCH /api/commerces/:cId/users/:uId/contacts/:contactId
Actualiza un contacto.
POST /api/commerces/:cId/users/:uId/contacts/:contactId/set-primary
Establece un contacto como principal para su tipo.
Notas
- Solo puede haber un contacto principal por tipo por usuario de comercio (entre los contactos activos)
- Establecer un nuevo contacto principal desestablece automáticamente el anterior para ese tipo