{"section":"tutorials","requestedLocale":"es","requestedSlug":"roles-y-permisos-de-storefront-personalizados","locale":"es","slug":"roles-y-permisos-de-storefront-personalizados","path":"docs/es/tutorials/b2b/b2b-buyer-portal/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\nEn B2B Buyer Portal, las acciones que cada usuario de una organización compradora puede realizar en la tienda se definen mediante [roles de storefront](#roles-de-storefront), que reúnen [permisos](#permisos-de-storefront) para acceder a recursos en el sitio web de la tienda, como por ejemplo `PlaceOrders` (realizar pedidos) o `ApproveOrders` (aprobar pedidos).\n\nVTEX ofrece roles y permisos predefinidos. Para escenarios específicos de tu negocio, también puedes crear roles y permisos personalizados vía API o desde el Admin VTEX.\n\n> ℹ️ En el Admin VTEX los permisos personalizados se muestran como **permisos**. En la API y en los eventos de [Audit](https://help.vtex.com/es/docs/tutorials/audit), se les llama **recursos** (_resources_), como `Create Storefront Custom Resource`. No los confundas con los [recursos de License Manager](https://help.vtex.com/es/docs/tutorials/recursos-del-license-manager), que controlan el acceso al Admin.\n\nConsulta a continuación más información sobre estos conceptos.\n\n## Permisos de storefront\n\nUn permiso autoriza el acceso a un recurso o una acción específica en el storefront. Por ejemplo, el permiso `PlaceOrders` permite que un usuario cree y envíe pedidos.\n\nExisten dos tipos de permisos:\n\n- **Predefinidos:** proporcionados por VTEX, no se pueden editar ni eliminar. Consulta la lista completa en [Permisos de storefront predefinidos](#permisos-de-storefront-predefinidos).\n- **Personalizados:** creados por tu cuenta para autorizar el acceso a un recurso que los permisos predefinidos no cubren. Cada permiso personalizado tiene un nombre y una descripción. En la API se le llama custom storefront resource (recurso de storefront personalizado).\n\nLos permisos personalizados tienen el mismo comportamiento que los predefinidos al autorizar una acción.\n\n### Permisos de storefront predefinidos\n\nConsulta en la siguiente tabla los permisos predefinidos disponibles. La columna **Clave** indica el identificador del permiso, usado en la API y en Audit.\n\n| Clave | Descripción |\n| --- | --- |\n| `ManageOrganizationAndContract` | Permite gestionar la estructura de la organización, los contratos y la configuración relacionada. |\n| `ManageOrganizationHierarchy` | Permite al usuario ignorar los límites de las unidades organizativas y gestionar entidades en el nivel de la organización raíz, incluyendo acceso y administración en todas las unidades organizativas. |\n| `ManageUsers` | Permite crear, editar y eliminar usuarios. |\n| `ViewUsers` | Otorga acceso de solo lectura a los detalles y a las listas de usuarios. |\n| `ManageBuyingPolicies` | Permite crear, editar y eliminar políticas de compras y flujos de aprobación. |\n| `ViewBuyingPolicies` | Otorga permiso para ver las políticas de compras configuradas, incluyendo reglas de aprobación y restricciones de gastos. |\n| `ManageBudgets` | Permite control total sobre la creación, edición, asignación y eliminación de presupuestos. |\n| `ViewBudget` | Otorga acceso de solo lectura a los detalles de presupuestos, incluyendo asignaciones, límites e historial de gastos. |\n| `ManageAccountingFields` | Permite crear, editar y eliminar campos contables. |\n| `ViewAccountingFields` | Otorga acceso de solo lectura a la configuración de los campos contables. |\n| `ManageCreditCards` | Permite gestionar las tarjetas de crédito guardadas, incluyendo agregar, editar y remover tarjetas. |\n| `ViewCreditCards` | Otorga acceso de solo lectura a las tarjetas de crédito guardadas. |\n| `PlaceOrders` | Otorga la capacidad de crear y enviar pedidos. |\n| `ViewMyContractOrders` | Permite al usuario ver los pedidos realizados en el contrato al que está asignado. |\n| `ViewMyOrgUnitOrders` | Permite al usuario ver todos los pedidos de su unidad organizativa. |\n| `ModifyOrders` | Otorga permiso para usar la funcionalidad de modificación de pedidos en todos los pedidos a los que el usuario tiene acceso. |\n| `ApproveOrders` | Otorga la capacidad de aprobar o rechazar pedidos según flujos predefinidos. |\n| `ManageAddresses` | Permite agregar una nueva dirección durante el checkout y guardarla para el contrato o la unidad organizativa. También permite modificar la información de dirección en el checkout. |\n| `ViewAddresses` | Permite al usuario ver sus direcciones guardadas. |\n| `UseAdHocCard` | Otorga permiso para usar una nueva tarjeta de crédito en el checkout. |\n\n### Reglas y límites de los permisos de storefront personalizados\n\n- Cada cuenta puede tener hasta **10 permisos personalizados**. Los permisos predefinidos no cuentan para el límite.\n- El nombre debe tener de 5 a 80 caracteres y ser único en la cuenta, sin distinguir entre mayúsculas y minúsculas.\n- El nombre no puede coincidir con el de ningún permiso o rol predefinido.\n- El nombre funciona como identificador del permiso y no puede modificarse después de la creación. Para cambiarlo es necesario eliminar el permiso y crear otro.\n- Un permiso personalizado no puede eliminarse mientras esté en uso por algún rol.\n\n## Roles de storefront\n\nUn **rol de storefront** determina el conjunto de permisos de un grupo de usuarios de la tienda. Cada usuario puede tener uno o más roles y, en ese caso, recibe la combinación de todos los permisos de esos roles.\n\nPor ejemplo, un comprador que realiza pedidos y un gestor que aprueba pedidos necesitan permisos diferentes. En este caso, cada uno recibe un rol que incluye solo los permisos necesarios para su función.\n\nExisten dos tipos de roles:\n\n- **Predefinidos:** proporcionados por VTEX para cubrir los casos de uso más comunes; no se pueden editar ni eliminar. Consulta la lista completa en [Roles de storefront predefinidos](#roles-de-storefront-predefinidos).\n- **Personalizados:** creados por tu cuenta combinando permisos predefinidos y personalizados. Un ejemplo es el rol **Visualizador de informes**, que reúne el permiso predefinido `ViewUsers` y un permiso personalizado que autoriza el acceso a un servicio externo de informes.\n\n### Roles de storefront predefinidos\n\nConsulta en la siguiente tabla los roles predefinidos disponibles y los permisos asociados a cada uno. La columna **ID** indica el identificador del rol usado en la API.\n\n| Roles | ID | Descripción | Permisos asociados | Disponibilidad |\n| -------------------------- | -- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |\n| Organizational Unit Admin | 1 | Gestiona la estructura de la organización, los contratos y la configuración relacionada. | `ManageOrganizationAndContract`, `ManageUsers`, `ViewUsers`, `ManageBuyingPolicies`, `ViewBuyingPolicies`, `ManageBudgets`, `ViewBudget`, `ManageAccountingFields`, `ViewAccountingFields`, `ManageCreditCards`, `ViewCreditCards` | Admin y API |\n| Order Approver | 2 | Puede aprobar o rechazar pedidos según flujos predefinidos. | `ApproveOrders` | Admin y API |\n| Order Modifier | 3 | Puede usar la funcionalidad de modificación de pedidos en todos los pedidos a los que tiene acceso. | `ModifyOrders` | Admin y API |\n| Buyer | 4 | Puede crear y enviar pedidos. | `PlaceOrders` | Admin y API |\n| Personal Cards User | 5 | Puede usar una nueva tarjeta de crédito en el checkout. | `UseAdHocCard` | Admin y API |\n| Contract Manager | 6 | Puede ver los pedidos realizados en el contrato al que está asignado. | `ViewMyContractOrders` | Admin y API |\n| Buyer Organization Manager | 7 | Puede ver todos los pedidos de su unidad organizativa. | `ViewMyOrgUnitOrders` | Admin y API |\n| User Manager | 10 | Puede gestionar usuarios y ver los detalles de los usuarios de la organización. | `ManageUsers`, `ViewUsers` | Admin y API |\n| Buying Policy Manager | 11 | Puede crear, editar y eliminar políticas de compras y flujos de aprobación, además de ver las políticas de compras. | `ManageBuyingPolicies`, `ViewBuyingPolicies` | Solo API |\n| Budget Manager | 12 | Puede crear, editar, asignar y eliminar presupuestos, además de ver los detalles, las asignaciones, los límites y el historial de gastos. | `ManageBudgets`, `ViewBudget` | Solo API |\n| Accounting Field Manager | 13 | Puede crear, editar y eliminar campos contables, además de ver la configuración de los campos. | `ManageAccountingFields`, `ViewAccountingFields` | Solo API |\n| Super Buyer Admin | 16 | Tiene control administrativo total sobre la estructura de la organización compradora, incluida la gestión de unidades organizativas y de la configuración jerárquica. | `ManageOrganizationHierarchy` | Admin y API |\n| Credit Card Manager | 41 | Puede gestionar y ver las tarjetas de crédito guardadas. | `ManageCreditCards`, `ViewCreditCards` | Admin y API |\n\n> ℹ️ Los roles marcados como \"Solo API\" solo pueden asignarse a usuarios mediante los endpoints [Assign storefront roles](https://developers.vtex.com/docs/api-reference/storefront-roles-api#post-/api/license-manager/storefront/user/roles) o [Assign one storefront role](https://developers.vtex.com/docs/api-reference/storefront-roles-api#post-/api/license-manager/storefront/roles/assign).\n\n> ℹ️ El 21 de septiembre de 2026, se removió el rol **Address Manager** (ID `9`). Los permisos `ManageAddresses` y `ViewAddresses` ahora solo pueden usarse en un rol personalizado. Las cuentas que tenían ese rol fueron migradas a un rol personalizado equivalente y mantienen el acceso.\n\n### Reglas y límites de los roles de storefront personalizados\n\n- El nombre debe ser único en la cuenta y no puede coincidir con el de ningún rol predefinido.\n- A diferencia de los permisos personalizados, los roles pueden editarse después de creados. Al editar un rol, el cambio en los permisos se aplica de inmediato a todos los usuarios que tienen ese rol.\n- Un rol no puede eliminarse mientras esté asignado a algún usuario.\n\nCrear un rol no lo asigna a ningún usuario. La asignación se realiza al gestionar los usuarios de la organización compradora. 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## Auditoría\n\nToda creación, edición y eliminación de roles y permisos personalizados se registra en [Audit](https://help.vtex.com/es/docs/tutorials/audit). Los eventos relacionados con esta funcionalidad, como `Create Storefront Custom Role` y `Delete Storefront Custom Resource`, están listados en la sección License Manager del artículo [Eventos disponibles en Audit](https://help.vtex.com/es/docs/tutorials/eventos-disponibles-en-audit#license-manager).\n\n## Gestionar roles y permisos de storefront personalizados\n\nPuedes crear, consultar, editar y eliminar roles y permisos personalizados desde el Admin VTEX en la página **Permisos personalizados**. Para conocer los requisitos de acceso, los componentes de la página y las instrucciones de cada acción, consulta [Gestionar roles y permisos de storefront personalizados](https://help.vtex.com/es/docs/tutorials/gestionar-roles-y-permisos-de-storefront-personalizados).\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- [Gestionar roles y permisos de storefront personalizados](https://help.vtex.com/es/docs/tutorials/gestionar-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)"}