Roles

Cuando contrata a su primer cajero, cuando un empleado renuncia y llega su reemplazo, o cuando abre una sucursal nueva con más vendedores, los roles le ahorran configurar permisos persona por persona. Los roles en Zauru se crean para asignarles ciertos permisos y asignárselos a uno o varios usuarios cuando se suscriben, lo que facilita el proceso de reemplazo de usuarios (en caso de renuncia o despido de empleados) o el crecimiento de los negocios donde aumentan sucursales, vendedores o personal operativo.

Los pasos para crear un nuevo rol son los siguientes:

1. Ir a “Control de Acceso”.
2. Seleccionar “Roles”.
3. Seleccionar el botón de “Nuevo Rol”.

https://app.zauru.com/access_control/roles

Le aparecerán las opciones para crear el nuevo rol, en el ejemplo se crea un rol de contabilidad, para después asignarle permisos de contabilidad y suscribir a un empleado con este rol, las opciones son las siguientes:

1. Coloque el nombre del rol
2. Coloque una breve descripción de para que sirve este rol.
3. Seleccione “Crear rol” para aplicar los cambios.

https://app.zauru.com/access_control/roles/new

Le aparecerá un mensaje de éxito en la pantalla notificándole que el rol fue creado exitosamente.

https://app.zauru.com/access_control/roles

El siguiente paso es asignarle permisos a este rol creado para después suscribir a un usuario con este rol.

API (llamadas desde sistemas externos)

Obtener listado de roles

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/access_control/roles.json

Esto devolverá un JSON similar a este:

[
  {
    "id": "2576",
    "name": "admin",
    "description": null,
    "entity_id": "1303",
    "created_at": "2026-02-06 18:09:56.966671",
    "updated_at": "2026-02-06 18:09:56.966671",
    "crm_user": false,
    "crm_admin": false,
    "crm_supervisor": false
  }
]

Obtener detalle de un rol

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/access_control/roles/1.json

Esto devolverá un JSON similar a este:

{
  "id": "2576",
  "name": "admin",
  "description": null,
  "entity_id": "1303",
  "created_at": "2026-02-06 18:09:56.966671",
  "updated_at": "2026-02-06 18:09:56.966671",
  "crm_user": false,
  "crm_admin": false,
  "crm_supervisor": false
}

Crear rol

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X POST \
  -d '{
    "role": {
      "name": "Contabilidad",
      "description": "Rol para el departamento de contabilidad"
    }
  }' \
  https://app.zauru.com/access_control/roles.json

Esto devolverá un JSON similar a este:

{
  "id": "2576",
  "name": "admin",
  "description": null,
  "entity_id": "1303",
  "created_at": "2026-02-06 18:09:56.966671",
  "updated_at": "2026-02-06 18:09:56.966671",
  "crm_user": false,
  "crm_admin": false,
  "crm_supervisor": false
}

Actualizar rol

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X PATCH \
  -d '{
    "role": {
      "name": "Contabilidad Senior",
      "description": "Rol actualizado"
    }
  }' \
  https://app.zauru.com/access_control/roles/1.json

Esto devolverá un JSON similar a este:

{
  "id": "2576",
  "name": "admin",
  "description": null,
  "entity_id": "1303",
  "created_at": "2026-02-06 18:09:56.966671",
  "updated_at": "2026-02-06 18:09:56.966671",
  "crm_user": false,
  "crm_admin": false,
  "crm_supervisor": false
}

Eliminar rol

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X DELETE \
  https://app.zauru.com/access_control/roles/1.json

En caso de exito, retorna un codigo HTTP 204 No Content (sin cuerpo).