En VTEX, puedes crear un campo para registrar el código de vendedor en el Checkout. Este campo te permite:

• Asociar un determinado pedido de compra a un vendedor.
• Ofrecer descuentos exclusivos al consumidor.
• Gestionar el desempeño de tus vendedores, extrayendo datos como número de ventas o ticket promedio por vendedor y ranking para comisiones de ventas, entre otros.

El campo Código de vendedor no sustituye el campo Cupón de descuento (que es nativo en la plataforma VTEX). Al realizar la configuración que se describe en este artículo, puedes utilizar los dos para ofrecer descuentos.

Para crear el campo y agregarlo a la pantalla del Checkout de tu tienda, debes completar tres pasos:

1. Crear una nueva entidad de datos
2. Crear una promoción Código de vendedor
3. Personalizar la pantalla del Checkout

El campo Código de Vendedor se debe registrar en Master Data como una nueva entidad. Para crear la entidad de datos, sigue los pasos a continuación:

1. En el Admin VTEX, accede a Configuración de la tienda > Storefront > Master Data o escribe Master Data en la barra de búsqueda en la parte superior de la página.
2. Crea una nueva entidad de datos con el nombre codigovendedor.
3. Dentro da nova entidade de dados, crie os seguintes campos:
   • Código do vendedor: código con un valor máximo de 10 caracteres (tipo Varchar10).
   • Email: dirección de email del vendedor (tipo Email).
   • Nombre: nombre del vendedor (tipo Text).
   • Status: indica si el vendedor está activo o inactivo (tipo Boolean).
   • Tienda: identificación de la tienda en la que el vendedor trabaja (tipo Text).
   • Otros campos (según sea necesario).

Después de crear la entidad codigovendedor, debes asociarla a una promoción. Para crear una promoción, sigue los pasos a continuación:

1. En el Admin VTEX, accede a Promociones > Promociones, o escribe Promociones en la barra de búsqueda en la parte superior de la página.
2. Crea una nueva promoción regular. Rellena la información de Resumen de la promoción y ¿A qué ítems se aplicará esta promoción? según lo desees.

Si deseas utilizar el campo Código de vendedor para ofrecer un descuento en el valor de la compra, rellena la información de ¿Cuál es el tipo y valor del descuento?.

El último paso es configurar la pantalla del Checkout para permitir que se muestre el campo Código de vendedor.

Para realizar la personalización, debes ponerte en contacto con la agencia partner responsable de la creación de tu tienda y solicitar que agreguen el nuevo campo para que el cliente pueda añadir el código del vendedor y se muestre el nombre.

También debes completar los siguientes pasos:

1. Al simular una compra e ingresar el código del vendedor en la pantalla del Checkout, asegúrate de que la llamada GET Search Documents realice la búsqueda en la entidad codigovendedor y devuelva toda la información registrada de dicho vendedor. Ejemplo de llamada: https://{accountName}.{environment}.com.br/api/dataentities/codigovendedor/search?codigovendedor=12345.

El campo status debe devolver el valor true para indicar que el código del vendedor es válido.

En la pantalla del Checkout solo debe aparecer el nombre del vendedor.

Después de ejecutar todos los pasos descritos anteriormente, el campo Código de vendedor estará disponible en la pantalla del Checkout.