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”.

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.

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

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).