Menu
Feedback
Comece aqui


Guía de onboarding
Serie de la tienda VTEX
Configuración inicial
Configuración inicial
7 min de lectura

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érminoDefinición
Admin VTEX / Entorno VTEXPlataforma para gestionar la experiencia de ecommerce.
Master Service AgreementEl 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 FormDocumento 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ónLa acción de verificar la identidad del usuario que está iniciando sesión.
AutorizaciónLas acciones determinadas que el usuario puede realizar después de ser autenticado.
Canal de ventasTiendas donde los sellers pueden poner a la venta los productos de su catálogo.
RolEl conjunto de recursos creado para asignarse a un tipo común de usuario.
Recursos de License ManagerUn recurso es una entidad asociada a una acción o información en la infraestructura VTEX.
Sponsor accountSponsor 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:

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ónDescripció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.

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.

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
¿Te ha parecido útil?
No
Sugerir cambios (GitHub)
Cuentas y arquitectura
« Previous
Integraciones de backend
Next »
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
¿Todavía tienes dudas?
Pregunte a la comunidad
Encuentra solucciones y comparte ideas en la comunidad de VTEX.
Únete a nuestra comunidad
Solicite soporte a VTEX
Para asistencia personalizada, contacte a nuestros expertos.
Abra un ticket de soporte
GithubDeveloper portalCommunityFeedback