{"section":"tutorials","requestedLocale":"es","requestedSlug":"gestionar-roles-y-permisos-de-storefront-personalizados","locale":"es","slug":"gestionar-roles-y-permisos-de-storefront-personalizados","path":"docs/es/tutorials/b2b/b2b-buyer-portal/gestionar-roles-y-permisos-de-storefront-personalizados.md","branch":"main","content":"> ⚠️ Esta funcionalidad se encuentra disponible únicamente para tiendas que utilizan [B2B Buyer Portal](https://help.vtex.com/es/docs/tutorials/b2b-buyer-portal-es), actualmente disponible para cuentas seleccionadas.\n\nLa página **Permisos personalizados** te permite ver los roles y permisos de storefront personalizados de tu cuenta, y gestionarlos desde el Admin VTEX.\n\nPara más información sobre los conceptos, las reglas y la lista de roles y permisos predefinidos, consulta [Roles y permisos de storefront personalizados](https://help.vtex.com/es/docs/tutorials/roles-y-permisos-de-storefront-personalizados).\n\nPara acceder a la página en el Admin VTEX, haz clic en **Configuración > Permisos personalizados**.\n\nEn esta página puedes:\n\n- Gestionar roles personalizados:\n  - [Crear rol de storefront personalizado](#crear-rol-de-storefront-personalizado)\n  - [Editar rol de storefront personalizado](#editar-rol-de-storefront-personalizado)\n  - [Eliminar rol de storefront personalizado](#eliminar-rol-de-storefront-personalizado)\n- Gestionar permisos personalizados:\n  - [Crear permiso de storefront personalizado](#crear-permiso-de-storefront-personalizado)\n  - [Eliminar permiso de storefront personalizado](#eliminar-permiso-de-storefront-personalizado)\n\n## Requisitos\n\nHay dos requisitos que deben cumplirse para acceder a la página **Permisos personalizados**:\n\n- Tu cuenta debe utilizar [B2B Buyer Portal](https://help.vtex.com/es/docs/tutorials/b2b-buyer-portal-es). En las cuentas que no usan esta solución, la página no está visible ni se puede acceder a ella.\n- El usuario debe tener un rol del Admin con el [recurso de License Manager](https://help.vtex.com/es/docs/tutorials/recursos-del-license-manager) **Edit Storefront User Permissions** en la categoría **Services access control**. Sin este recurso, el usuario no verá la página.\n\n### Pestaña Roles\n\nLa pestaña **Roles** muestra únicamente los roles personalizados de la cuenta. Los roles predefinidos no se muestran en la lista, pero puedes consultarlos mediante el link **Roles predefinidos**, disponible en la pestaña. Si la cuenta aún no tiene ningún rol personalizado, la pestaña muestra un mensaje con el botón `Crear rol`.\n\nEn la parte superior de la pestaña, el botón `Crear rol` abre el formulario para crear un nuevo rol.\n\nDebajo del botón la lista de roles muestra los roles en orden alfabético de la A a la Z. Para invertir el orden haz clic en el título de la columna **Nombre**. Cuando hay muchos roles la lista se divide en páginas.\n\n| Columna | Descripción |\n| --- | --- |\n| **Nombre** | Nombre que identifica el rol, definido al momento de creación. |\n| **Acciones** | Menú con las acciones de `Editar rol` o `Eliminar`. |\n\nEl menú en la fila de cada rol muestra las siguientes opciones:\n\n- **Editar rol:** abre el formulario de edición del rol. Consulta [Editar rol de storefront personalizado](#editar-rol-de-storefront-personalizado).\n- **Eliminar:** elimina el rol después de confirmar. La opción permanece desactivada mientras el rol esté asignado a algún usuario. Consulta [Eliminar rol de storefront personalizado](#eliminar-rol-de-storefront-personalizado).\n\n### Pestaña Permisos\n\nLa pestaña **Permisos** muestra solo los permisos personalizados de la cuenta. Los permisos predefinidos no se muestran en la lista, pero puedes consultarlos mediante el link **Permisos predefinidos**, disponible en la pestaña. Si la cuenta aún no tiene ningún permiso personalizado, la pestaña muestra un mensaje con el botón `Crear permiso`.\n\nEn la parte superior de la pestaña se muestra el:\n\n- **Contador de permisos:** indica cuántos permisos personalizados ha creado la cuenta, en el formato `{n} de 10 permisos personalizados`. Un ícono de ayuda a su lado explica que cada cuenta puede tener hasta 10 permisos personalizados y que los predefinidos no cuentan para el límite.\n- **Botón `Crear permiso`:** abre el formulario de creación de un nuevo permiso. Cuando la cuenta alcanza el límite de 10, el botón se desactiva y una notificación encima de la lista explica que es necesario eliminar un permiso que no esté en uso para crear otro.\n\nLa lista de permisos muestra los permisos personalizados de la cuenta e incluye la siguiente información:\n\n| Columna | Descripción |\n| --- | --- |\n| **Nombre** | Nombre que identifica el permiso, definido al momento de la creación. |\n| **Descripción** | Texto que explica la autorización que el permiso otorga. |\n| **Roles que lo utilizan** | Roles que contienen el permiso. Cuando hay más de un rol, la columna muestra el nombre del primero seguido del total de roles adicionales, por ejemplo, `Comprador, +2`. Al pasar el cursor sobre el texto un tooltip lista todos los roles. |\n| **Creado el** | Fecha de creación del permiso. Al pasar el cursor sobre la fecha un tooltip muestra el día y la hora exactos. |\n| **Acciones** | Menú con la acción de `Eliminar` un permiso. |\n\nNo puedes editar un permiso después de crearlo, solo eliminarlo usando la opción **Eliminar** en el menú de la fila del permiso y confirmando la acción. La opción se desactiva mientras algún rol esté usando el permiso. Para más detalles, consulta [Eliminar permiso de storefront personalizado](#eliminar-permiso-de-storefront-personalizado).\n\n## Gestionar roles de storefront personalizados\n\nEn esta sección se describe cómo crear, editar y eliminar roles personalizados.\n\n### Crear rol de storefront personalizado\n\nPara crear un rol personalizado sigue las instrucciones a continuación:\n\n1. En el Admin VTEX, accede a **Configuración > Permisos personalizados**.\n2. En la pestaña **Roles** haz clic en `Crear rol`.\n3. En **Nombre** ingresa el nombre del rol.\n\n    > ⚠️ Elige nombres descriptivos para los roles, que dejen claro el tipo de usuario al que cada rol está destinado.\n4. En la lista marca los permisos que el rol debe contener. Para encontrarlos más rápido, puedes buscar por el nombre del permiso o filtrar por **Tipo**: **Todos**, **Personalizados** o **Predefinidos**.\n5. Haz clic en `Crear rol`.\n\n    Un mensaje confirma la creación y el rol se muestra en la pestaña **Roles**. El botón `Crear rol` solo se activa después de que el nombre se completa con un valor válido.\n\n#### Crear permiso de storefront durante la creación del rol\n\nSi el permiso que necesitas aún no existe, puedes crearlo sin salir del formulario de creación del rol:\n\n1. Con el formulario del rol abierto, debajo de la lista de permisos, haz clic en `Crear permiso`.\n2. Completa el **Nombre** y **Descripción** del permiso y finaliza la creación.\n\n    El nombre y los permisos que ya marcaste en el rol se mantienen.\n3. En la lista de permisos, busca el nuevo permiso identificado con la etiqueta **Nuevo**. Se mostrará sin marcar. Márcalo para incluirlo en el rol.\n4. Haz clic en `Crear rol`.\n\nSi la cuenta ya tiene 10 permisos personalizados, la opción **Crear permiso** no se muestra. En su lugar, un mensaje informa que se alcanzó el límite y sugiere eliminar los permisos que no estén en uso en la pestaña **Permisos**. La lista sigue mostrando todos los permisos existentes, así que aún puedes crear el rol.\n\n### Editar rol de storefront personalizado\n\n> ⚠️ Al remover un permiso de un rol, el cambio entra en vigor de inmediato para todos los usuarios que tienen ese rol.\n\nPara editar un rol personalizado sigue las instrucciones a continuación:\n\n1. En el Admin VTEX, accede a **Configuración > Permisos personalizados**.\n2. En la pestaña **Roles** haz clic en el ícono de menú (⋮) del rol que deseas editar y selecciona `Editar rol`.\n3. Cambia el nombre o los permisos del rol.\n\n    Los permisos actuales se muestran marcados. Los permisos creados después de la última vez que se guardó el rol se muestran sin marcar y con la etiqueta **Nuevo** para que decidas si deseas incluirlos.\n4. Haz clic en `Guardar cambios`.\n\n    Un mensaje confirma la actualización. Si cambiaste el nombre, el rol pasa a la posición correspondiente en el orden alfabético.\n\n### Eliminar rol de storefront personalizado\n\nPara eliminar un rol personalizado sigue las instrucciones a continuación:\n\n1. En el Admin VTEX, accede a **Configuración > Permisos personalizados**.\n2. En la pestaña **Roles**, haz clic en el ícono de menú (⋮) del rol que deseas eliminar.\n3. Haz clic en `Eliminar`.\n4. En la ventana de confirmación, haz clic en `Eliminar` nuevamente.\n\n    Un mensaje confirma la eliminación y el rol se elimina de la lista.\n\nSi la opción **Eliminar** está desactivada, el rol sigue asignado a algún usuario. Pasa el cursor sobre la opción para ver el motivo. Para eliminar el rol, remuévelo de todos los usuarios que lo utilizan. Más información en [Agregar usuarios a la organización compradora](https://help.vtex.com/es/docs/tutorials/agregar-usuarios-a-la-organizacion-compradora).\n\n## Gestionar permisos de storefront personalizados\n\nEn esta sección se describe cómo crear y eliminar permisos personalizados. No es posible editar un permiso después de creado.\n\n### Crear permiso de storefront personalizado\n\nPara crear un permiso personalizado sigue las instrucciones a continuación:\n\n1. En el Admin VTEX, accede a **Configuración > Permisos personalizados**.\n2. En la pestaña **Permisos**, haz clic en `Crear permiso`.\n3. En **Nombre**, ingresa el nombre del permiso.\n\n    > ⚠️ El nombre debe seguir las [reglas de los permisos personalizados](https://help.vtex.com/es/docs/tutorials/roles-y-permisos-de-storefront-personalizados#reglas-y-limites-de-los-permisos-de-storefront-personalizados) y no se puede cambiar después de la creación.\n4. En **Descripción**, explica la autorización que el permiso otorga.\n5. Haz clic en `Crear`.\n\n    Un mensaje confirma la creación y el permiso se muestra en la tabla. Para que tenga efecto, asócialo a un rol. En el propio mensaje, el botón `Ir a la pestaña Roles` te lleva a la lista de roles.\n\n### Eliminar permiso de storefront personalizado\n\nPara eliminar un permiso personalizado sigue las instrucciones a continuación:\n\n1. En el Admin VTEX, accede a **Configuración > Permisos personalizados**.\n2. En la pestaña **Permisos**, haz clic en el ícono de menú (⋮) del permiso que deseas eliminar.\n3. Haz clic en `Eliminar`.\n4. En la ventana de confirmación, haz clic en `Eliminar` nuevamente.\n\n    Un mensaje confirma la eliminación y el permiso se elimina de la lista. Si la cuenta había alcanzado el límite de 10 permisos personalizados, el botón `Crear permiso` vuelve a estar activo.\n\nSi la opción **Eliminar** está desactivada, significa que un rol aún utiliza el permiso. Pasa el cursor sobre la opción para ver cuántos roles lo utilizan. La columna **Roles que lo utilizan** muestra cuáles son. Para eliminar el permiso, remuévelo de cada uno de esos roles siguiendo los pasos de [Editar rol de storefront personalizado](#editar-rol-de-storefront-personalizado).\n\n> ℹ️ Para gestionar roles y permisos personalizados vía API, accede a [Storefront Roles API](https://developers.vtex.com/docs/api-reference/storefront-roles-api) y a la guía para desarrolladores [Custom storefront roles and resources](https://developers.vtex.com/docs/guides/custom-storefront-roles-and-resources).\n\n## Más información\n\n- [Roles y permisos de storefront personalizados](https://help.vtex.com/es/docs/tutorials/roles-y-permisos-de-storefront-personalizados)\n- [Agregar usuarios a la organización compradora](https://help.vtex.com/es/docs/tutorials/agregar-usuarios-a-la-organizacion-compradora)\n- [Recursos de License Manager](https://help.vtex.com/es/docs/tutorials/recursos-del-license-manager)"}