Generación de Custom API Keys
Generación de Custom API Keys en Vtex para Seller Center
En este apartado, aprenderás cómo generar las API Keys necesarias para que el Seller Center pueda obtener las órdenes del vendedor de manera segura, eficiente y puedas aprovechas las Funcionalidades de Seller Center. Sigue los pasos a continuación, y asegúrate de prestar atención a las imágenes adjuntas en cada paso.
Paso 1: Acceder a «Account Settings»
Primero, ingresa a tu cuenta de Vtex y dirígete a la sección de Account Settings. Esta sección se encuentra en el menú principal y es el punto de partida para gestionar las configuraciones de tu cuenta.
Paso 2: Seleccionar «Application Keys»
Dentro de «Account Settings», haz clic en la opción Application Keys. Aquí es donde podrás gestionar las llaves de API que se utilizan para interactuar con diferentes aplicaciones dentro de Vtex.
Paso 3: Hacer clic en «Manage Keys»
A continuación, haz clic en Manage Keys. Este botón te permitirá ver y gestionar las API Keys que ya han sido creadas, así como generar nuevas llaves según sea necesario.
Paso 4: Generar una nueva API Key
Para crear una nueva API Key, haz clic en Generate New. Esto abrirá un formulario donde podrás configurar los detalles de la nueva llave.
Paso 5: Configurar la API Key para Seller Center
En el formulario de configuración, asigna un nombre descriptivo a la API Key en el campo Label. Por ejemplo, utiliza RT Seller Center para identificar fácilmente su propósito. Luego, selecciona el rol de permisos Owner Admin para garantizar que la API Key tenga los permisos necesarios para acceder a las órdenes del vendedor.
Paso 6: Guardar el Token y enviarlo al Admin del Seller Center
Una vez generada la API Key, es indispensable que guardes el Token en un archivo seguro. Este Token es necesario para la integración con el Seller Center, por lo que debes enviarlo al administrador del Seller Center de inmediato.
Agregar 3rd Party Key en Vtex para Seller Center
Otra de las Funcionalidades de Seller Center es poder agregar las llaves API de terceros necesarias para integrar servicios como API Shipment y API Items en Vtex. Sigue estos pasos con atención, y asegúrate de utilizar las imágenes proporcionadas para guiarte a lo largo del proceso.
Paso 1: Acceder a «Add 3rd Party Keys»
Primero, es necesario ingresar a la sección de Application Keys dentro de Account Settings. Una vez allí, haz clic en Add 3rd Party Keys para comenzar a agregar las llaves API de los servicios que deseas integrar.
Paso 2: Agregar las API Keys de los servicios del Seller Center
En el formulario que se presenta, deberás agregar las API Keys correspondientes a API Shipment y API Items. Estas llaves permiten que el Seller Center se comunique eficientemente con los servicios externos que manejan envíos y artículos.
Paso 3: Asignar Rol de Permisos «Owner Admin»
Una vez que hayas agregado las API Keys, selecciona el rol de permisos Owner Admin. Este rol garantiza que las llaves tengan acceso completo a las funcionalidades necesarias para operar correctamente con los servicios integrados.
Paso 4: Verificación de las Keys en la Pantalla Principal
Después de agregar las llaves y configurar los permisos, vuelve a la pantalla principal de Application Keys. Aquí deberías ver listadas las API Keys de API Shipment y API Items del Seller Center, confirmando que se han añadido correctamente.
Vistas como Administrador
Sellers
El módulo de Sellers en Vtex está diseñado exclusivamente para usuarios con permisos de SuperAdmin, quienes tienen control total sobre los vendedores registrados en la plataforma. A continuación, se describen las funcionalidades disponibles en esta vista, con el soporte de imágenes donde sea necesario.
Pantalla Principal del Módulo de Sellers
Al acceder a este módulo, los usuarios SuperAdmin pueden visualizar todos los sellers registrados. Desde esta pantalla, es posible filtrar a los sellers por nombre y acceder a diversas funcionalidades críticas para la gestión de estos vendedores:
Agregar: Permite agregar nuevos sellers a la plataforma.
Editar: Facilita la modificación de los datos del seller.
Ir al Seller: Acceso directo a las vistas del seller para gestionar órdenes y productos.
Sincronizar: Sincroniza los datos del seller seleccionado con la plataforma.
Archivar: Opción para archivar un seller cuando sea necesario.
Estas funcionalidades ofrecen a los administradores una gestión integral y efectiva de los sellers dentro de Vtex.
Agregar un Seller
Cuando un nuevo seller debe ser añadido, los SuperAdmin pueden hacerlo mediante la opción Agregar. Los campos necesarios para la creación de un seller incluyen:
Nombre del seller
Email de contacto
Vtex ID
API Token
API Key
Tipo de Seller (puede ser un vendedor o un marketplace)
Estos datos aseguran que el seller esté correctamente configurado y conectado a la plataforma Vtex.
Editar Seller o Marketplace
Los usuarios SuperAdmin tienen la capacidad de editar la información básica de cualquier seller o marketplace registrado. Específicamente, pueden modificar el nombre del seller y cambiar su estatus dentro de la plataforma. Esta funcionalidad es crucial para mantener los datos actualizados y correctos.
Sincronizar Datos del Seller
La opción Sincronizar permite a los SuperAdmin actualizar todos los datos relacionados con el seller seleccionado.
Archivar Seller
Si un seller ya no está activo o necesita ser removido de la vista principal, los SuperAdmin pueden utilizar la función Archivar. Esta opción mueve al seller a un estado archivado, evitando su visualización activa, pero manteniendo sus datos para referencia futura si fuera necesario.
Agregar Nuevos Sellers
Desde el botón Agregar, los SuperAdmin pueden iniciar el proceso de incorporación de nuevos sellers a la plataforma. Este acceso directo facilita la expansión y el manejo de múltiples vendedores dentro de Vtex.
Ir a Seller
Finalmente, la opción Ir a Seller ofrece a los SuperAdmin la posibilidad de visualizar las órdenes y productos asociados a cualquier seller registrado. Al seleccionar esta opción, el administrador es redirigido a la vista específica del seller, donde puede gestionar y revisar todos los aspectos operativos del vendedor.
Vistas como Administrador: Módulo de Usuarios
Una de las Funcionalidades de Seller Center es el Módulo de Usuarios en Vtex es una herramienta exclusiva para usuarios con permisos de SuperAdmin, quienes tienen la capacidad de gestionar todos los usuarios registrados en la plataforma. A continuación, se detallan las funcionalidades principales disponibles en esta vista.
Pantalla Principal del Módulo de Usuarios
En la pantalla principal del módulo, los SuperAdmin tienen acceso a una lista completa de todos los usuarios registrados en el sistema.
Acción Editar Usuario
Los SuperAdmin pueden realizar modificaciones a los usuarios existentes mediante la acción Editar.
Acción Agregar Usuario
Desde el botón Agregar, los SuperAdmin pueden incorporar nuevos usuarios al sistema. Este acceso directo permite una expansión y gestión continua de los usuarios dentro de Vtex, asegurando que se pueda añadir personal adicional o nuevos vendedores según sea necesario.
Vista como Seller: Funcionalidades y Elementos
La vista como Seller es una funcionalidades de Seller Center diseñada para ofrecer a los vendedores un control total sobre sus productos, órdenes y otras operaciones clave. A continuación, se describen las funcionalidades y elementos disponibles en esta vista.
Menú Seller
El Menú Seller es la puerta de entrada a todas las funcionalidades disponibles para los vendedores en la plataforma. Desde aquí, los sellers pueden acceder a los diferentes módulos y herramientas para gestionar su tienda en Vtex.
Dashboard
Este módulo está disponible para todos los sellers y ofrece un resumen visual de las órdenes del mes en curso. Los sellers pueden ver esta información en una gráfica y filtrar las órdenes por su estatus (pendiente, enviado, completado, etc.), permitiendo un monitoreo efectivo de las operaciones.
Productos
En este módulo, los sellers pueden visualizar todos sus productos registrados en la plataforma. Además, los Super Administradores tienen la capacidad de ver los productos de todos los sellers, facilitando la gestión y supervisión global.
Acciones Masivas
Este apartado permite a los sellers realizar cambios significativos en múltiples productos simultáneamente, ahorrando tiempo y esfuerzo en la gestión del catálogo.
Carga de Actualización Masiva
Otra característica que ofrecen las Funcionalidades de Seller Center es el poder subir archivos .xlsx o .csv para actualizar en bloque la información de productos existentes. Esta funcionalidad es ideal para mantener los datos actualizados de manera eficiente y sin necesidad de realizar cambios manuales producto por producto.
Descarga de Productos
Desde el botón Descargar Productos, los sellers pueden obtener un archivo .csv que contiene la información completa de sus productos. Esta herramienta es útil para análisis externos o para mantener un registro fuera de la plataforma.
Sincronizar Productos
El botón Sincronizar Productos permite a los sellers actualizar los datos de sus productos en tiempo real. Al presionarlo, los productos seleccionados se sincronizan instantáneamente con la plataforma Vtex.
Indicador de Sincronización en Proceso
Mientras los productos se están sincronizando, se muestra un mensaje indicando que la actualización está en proceso: «Se están actualizando los datos del seller.»
Área de Notificaciones
Una vez completada la sincronización, el resultado se mostrará en el área de notificaciones, informando al seller sobre el éxito o cualquier problema durante el proceso.
Creación Masiva de Productos
Después de llenar y validar correctamente la plantilla de creación de productos, los sellers pueden subirla para registrar múltiples productos de una sola vez, agilizando el proceso de expansión del catálogo.
Acciones Individuales
Además de las acciones masivas, los sellers pueden realizar ajustes individuales en sus productos mediante varias funcionalidades:
Crear Producto: Permite agregar un nuevo producto especificando detalles como nombre, SKU, código de barras, precio, peso, dimensiones, categoría, subcategoría y marca.
Editar Stock: Posibilidad de ajustar la cantidad disponible de un producto directamente desde los botones de acción.
Editar Precio: Modifica el precio de un producto directamente desde la tabla, utilizando los botones de acción disponibles.
Repricing: Esta funcionalidad permite ajustar el precio mínimo, precio máximo y el estatus de los productos, asegurando que los precios estén alineados con las políticas comerciales.
Ver Logs de Productos: Al hacer clic en el botón Ver Log, se abre un modal que muestra en detalle cada movimiento realizado en un producto, como cambios en el stock, precios, etc.
Sincronizar Producto: Con el botón Sincronizar, los sellers pueden actualizar en segundo plano el producto seleccionado con Vtex.
Archivar producto: Al hacer clic en el botón de archivar, podremos archivar el producto, de tal manera que ya no se encontrará activo pero contaremos aún con la información dentro del sistema, para el caso de ser necesario.
Actualmente Seller Center no cuenta con opción para poder generar variantes de los productos, sin embargo se puede utilizar los medio de los cuales dispone Vtex para poder realizar esta acción, donde al crear un producto nuevo y agregar la información correspondiente se debe dar clic a la opción de Al hacer clic en + Crear variaciones
esto generará más de un SKU, según las posibles variaciones de su producto. Además, se eliminarán los campos que hubiere rellenado en Información de SKU.
Tras hacer clic en + Crear variaciones, será enviado al apartado de Crear especificaciones, donde se debe llenar la siguiente información:
- Nombre de la especificación; y
- Opciones: En este campo, debe ingresar las opciones que desea incluir.
Si desea crear más especificaciones, haga clic en el botón + Agregar especificación y rellene los nuevos campos.
Cuando haya terminado de configurar las especificaciones, haga clic en el botón Crear.
Para más información de como generar las variaciones, puede ingresar al manual de Vtex o ponerse en contacto con nuestro equipo 3Dadv.
Para poder estar al día con las funcionalidades de Seller Center, no olvides que puedes visitar nuestro sitio web, en el apartado de control de cambios para enterarte de las nuevas correcciones y actualizaciones realizadas en el sistem.