Este artículo explica cómo obtener acceso al entorno VTEX abarcando información desde la firma del contrato con VTEX hasta la configuración inicial de la tienda. Antes de empezar, es importante que te familiarices con los términos utilizados en el artículo, según se recogen en la siguiente tabla:
Término | Definición |
---|---|
Admin VTEX / Entorno VTEX | Plataforma para gestionar la experiencia de ecommerce. |
Master Service Agreement | El conjunto de políticas que rigen el uso de los servicios de la plataforma de ecommerce VTEX de acuerdo con los términos del contrato firmado entre la parte contratante y la parte contratada. |
Anexo 1 - Order Form | Documento que complemente el Master Services Agreement. Se envía a la parte contratante para ser firmado digitalmente y contiene la información del acuerdo comercial y los datos jurídicos de la parte contratante y VTEX. |
Autenticación | La acción de verificar la identidad del usuario que está iniciando sesión. |
Autorización | Las acciones determinadas que el usuario puede realizar después de ser autenticado. |
Canal de ventas | Tiendas donde los sellers pueden poner a la venta los productos de su catálogo. |
Rol | El conjunto de recursos creado para asignarse a un tipo común de usuario. |
Recursos de License Manager | Un recurso es una entidad asociada a una acción o información en la infraestructura VTEX. |
Sponsor account | Sponsor Account es la cuenta responsable del desarrollo, mantenimiento y distribución de Edition Apps. Su objetivo principal es acelerar la instalación de varias aplicaciones y configuraciones en un grupo definido de cuentas. |
Firmar el contrato
El proceso de contratación de VTEX se lleva a cabo entre el representante de ventas de VTEX, la contratante y el representante legal de ambas partes. Una vez se completa la negociación, la contratante recibe una solicitud de firma digital del Anexo 1 - Order Form, que contiene la siguiente información:
- Condiciones jurídicas establecidas en la negociación.
- Datos de los representantes legales de VTEX y la contratante.
- Datos de los testigos de VTEX y la contratante.
- Link al MSA (Master Services Agreement).
Tras la firma del contrato, todas las partes reciben por email una copia del MSA y el Anexo 1 - Order Form. Los clientes nuevos deben consultar el MSA (Master Services Agreement) y tener en cuenta la región en se encuentra la empresa.
Los clientes que hayan formalizado una asociación con VTEX mediante firma pueden encontrar el MSA en la parte superior del Anexo 1 - Order Form o en la página de Contratos Anteriores, conforme a la región y fecha de firma del Anexo 1.
Recibir acceso al Admin VTEX
Tras la firma del acuerdo comercial, el usuario titular recibirá acceso al Admin VTEX por email en hasta 10 días laborables. El usuario titular es el principal responsable de la tienda y el único usuario que tiene acceso total a todas las secciones del Admin VTEX, incluyendo acciones importantes de mantenimiento y autorización.
Al principio, las principales acciones que solo pueden ser ejecutadas por el usuario titular son:
- Solicitar un entorno de prueba para el gerente de la cuenta.
- Agregar nuevos usuarios al entorno VTEX, lo que requiere conocimiento de los roles existentes.
- Activar inicio de sesión por autenticación de dos factores para los operadores.
- Definir los métodos de inicio de sesión para los clientes de la tienda.
Existen otras acciones que están restringidas a este usuario. Puedes ver la lista en el artículo Usuario titular.
El usuario titular difiere del usuario Owner (Admin Super). El usuario Owner (Admin Super) es un rol de License Manager que define los permisos concedidos a un usuario y puede asignarse a varios usuarios. Sin embargo, solo hay un usuario titular por cuenta.
Usuarios y permisos
Todos los usuarios administrativos registrados en una cuenta VTEX pueden ejecutar acciones de acuerdo con su rol asignado y con los respectivos permisos para acceder a los recursos de la plataforma. Por ejemplo, para recuperar una transacción, el usuario debe tener un rol con permiso para utilizar el recurso View Payment Data
.
Agregar usuarios administrativos
Los nuevos usuarios se deben registrar en el Admin VTEX a través de la página Configuración de la cuenta, siguiendo los pasos del artículo Gestionar usuarios. En esta página también puedes editar, eliminar o exportar usuarios.
Definir roles y permisos para los usuarios
Para definir las acciones que un usuario puede realizar en el Admin VTEX, sigue las instrucciones del artículo Roles. Puedes asignar usuarios a roles predefinidos o, si necesitas grupos de permisos más allá de los abarcados en estos roles, puedes crear roles personalizados.
Autenticación para la plataforma y storefront
Debes configurar el método de autenticación que los clientes emplearán para iniciar sesión en la tienda y que los usuarios administrativos utilizarán para iniciar sesión en el Admin VTEX. Existen diversas formas de completar la autenticación en el entorno VTEX. Por ejemplo, los métodos de código de acceso y contraseña siempre están disponibles, mientras que la autenticación mediante Google es opcional.
Para iniciar sesión en la tienda, VTEX ofrece la autenticación por código de acceso, contraseña, Facebook y Google. Se pueden activar uno o más métodos de autenticación. Las instrucciones para activar las soluciones se detallan en el artículo Autenticación.
Autenticación para integraciones y desarrollo de aplicaciones
La autenticación es esencial en integraciones de API para conectar tu cuenta VTEX con sistemas externos y también para el desarrollo de aplicaciones en la plataforma VTEX. El proceso de autenticación garantiza la autorización del usuario para acceder a los recursos de la plataforma mediante credenciales como claves de aplicación o tokens.
La tabla a continuación detalla los tres tipos de autenticación disponibles:
Tipo de autenticación | Descripción |
---|---|
Autenticación de requests a API mediante claves de aplicación (appKeys) | Las claves de aplicación (appKeys) se utilizan para autenticar requests a API de VTEX. Los administradores de la tienda pueden crear las claves para diferentes integraciones. Para más información, consulta API authentication using application keys. |
Autenticación de requets a API mediante tokens de usuario | Los tokens de usuarios se utilizan para autenticar requests a API, especialmente en aplicaciones frontend desarrolladas con VTEX IO. Para más información, consulta API authentication using user tokens. |
Autenticación de aplicaciones mediante tokens de autenticación | El uso de tokens de autenticación (auth tokens) es necesario para la autenticación cuando se desarrollan aplicaciones en VTEX IO. Para más información, consulta App authentication using auth tokens. |
Políticas comerciales
Las políticas comerciales son un concepto importante en VTEX. Una política comercial es un conjunto de configuraciones, que incluye:
Toda integración con un canal de ventas debe tener una política comercial asociada. Cuando alguna de las configuraciones antes mencionadas es diferente para un nuevo canal, es necesario crear una nueva política comercial.
Dependiendo de su arquitectura en VTEX, la tienda puede beneficiarse de tener más de una política comercial, o asociar estrategias de varias políticas comerciales a multitiendas y entornos adicionales. El artículo Cuentas y arquitectura explica en detalle la relación entre estos conceptos.
Para crear una política comercial y para contratar políticas comerciales adicionales, debes ponerte en contacto con el equipo de soporte de VTEX.
Edition Apps
Edition Apps son paquetes que agrupan configuraciones y aplicaciones. Se crean mediante sponsor accounts para facilitar la configuración de cuentas franquicia. Algunos ejemplos incluyen Edition Store y Edition Business, que se ofrecen de forma nativa. Toda Edition App depende de vtex.edition-business
o vtex.edition-store
.
Para editar una Edition App, debes ponerte en contacto con nuestro equipo de soporte. Ten en cuenta que solo la sponsor account puede realizar cambios. Para crear una Edition App, se deben cumplir los requisitos descritos en Developing an Edition App.
VTEX IO CLI
VTEX IO CLI (command-line interface) es una herramienta de línea de comando desarrollada por VTEX y es una parte importante de la plataforma VTEX IO que permite que los equipos de desarrollo creen y personalicen tiendas y aplicaciones en la plataforma VTEX.
A través de VTEX IO CLI, los desarrolladores pueden realizar una variedad de tareas de desarrollo, tales como:
- Crear proyectos: la CLI permite crear y empezar proyectos en la plataforma VTEX IO y definir su estructura y configuración básicas.
- Desarrollo local: es posible desarrollar, personalizar y probar aplicaciones localmente antes de implementarlas en la plataforma VTEX.
- Implementación: la CLI facilita la implementación de aplicaciones en la plataforma VTEX IO y permite actualizar y gestionar las aplicaciones de manera eficiente.
- Integración con el ecosistema VTEX: VTEX IO CLI se integra con otros servicios y herramientas de la plataforma VTEX, lo que facilita la integración con API, bases de datos y otros recursos.
La instalación de VTEX IO CLI depende del sistema operativo utilizado. Para instalar la herramienta para el sistema operativo correspondiente, consulta las instrucciones en el artículo Installing VTEX IO CLI.
Para conocer los comandos y funcionalidades de la CLI y empezar a utilizarla, consulta los artículos Using VTEX IO CLI y Managing plugins.