{"section":"tutorials","requestedLocale":"es","requestedSlug":"campo-codigo-de-vendedor-en-el-checkout","locale":"es","slug":"campo-codigo-de-vendedor-en-el-checkout","path":"docs/es/tutorials/tasas-y-promociones/promociones/campo-codigo-de-vendedor-en-el-checkout.md","branch":"main","content":"En VTEX, puedes crear un campo para registrar el código de vendedor en el Checkout. Este campo te permite:\n- Asociar un determinado pedido de compra a un vendedor.\n- Ofrecer descuentos exclusivos al consumidor.\n- 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.\n\n> ⚠️ 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.\n\nPara crear el campo y agregarlo a la pantalla del Checkout de tu tienda, debes completar tres pasos:\n\n1. [Crear una nueva entidad de datos](#crear-una-nueva-entidad-de-datos)\n2. [Crear una promoción Código de vendedor](#crear-una-promocion-codigo-de-vendedor)\n3. [Personalizar la pantalla del Checkout](#personalizar-la-pantalla-del-checkout)\n\n## Crear una nueva entidad de datos\n\nEl campo **Código de Vendedor** se debe registrar en [Master Data](/es/docs/tutorials/master-data) como una nueva entidad. Para crear la entidad de datos, sigue los pasos a continuación:\n\n1. 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.\n2. Crea una nueva [entidad de datos](/es/docs/tutorials/entidade-de-datos#como-configurar) con el nombre *codigovendedor*.\n3. Dentro da nova entidade de dados, crie os seguintes campos:\n    - **Código do vendedor**: código con un valor máximo de 10 caracteres (tipo Varchar10).\n    - **Email**: dirección de email del vendedor (tipo Email).\n    - **Nombre**: nombre del vendedor (tipo Text).\n    - **Status**: indica si el vendedor está activo o inactivo (tipo Boolean).\n    - **Tienda**: identificación de la tienda en la que el vendedor trabaja (tipo Text).\n    - Otros campos (según sea necesario).\n\n<blockquote><ui>4. Registra la información de cada vendedor en los campos creados en el paso anterior.</ui>\n\n<blockquote><ui>5. Crea un [formulario](/es/docs/tutorials/creando-formulario-en-master-data) para acceder a la información de la nueva entidad *codigovendedor* a través de la interfaz de Master Data.</ui>\n\n## Crear una promoción Código de vendedor\n\nDespués de crear la entidad *codigovendedor*, debes asociarla a una promoción. Para crear una promoción, sigue los pasos a continuación:\n\n1. 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.\n2. Crea una nueva [promoción regular](/es/docs/tracks/como-funcionan-las-promociones). Rellena la información de **Resumen de la promoción** y **¿A qué ítems se aplicará esta promoción?** según lo desees.\n\n> ℹ️ 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?**.\n\n<blockquote><ui>3. En **¿Cuáles son las condiciones para que la promoción sea válida?**, haz clic en la opción **utm_campaign** e ingresa *codigovendedor* en el campo.</ui>\n\n![utm campaign codigovendedor](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/es/tutorials/tasas-y-promociones/promociones/campo-codigo-de-vendedor-en-el-checkout_1.PNG)\n\n<blockquote><ui>4. En **Restricciones y limitaciones de uso**, agrega las demás restricciones disponibles, si así lo deseas. Selecciona la opción **Aplicar con otras promociones**.</ui>\n\n<blockquote><ui>5. Haz clic en **Guardar**.</ui>\n\n## Personalizar la pantalla del Checkout\n\nEl último paso es configurar la pantalla del Checkout para permitir que se muestre el campo **Código de vendedor**.\n\nPara 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.\n\nTambién debes completar los siguientes pasos:\n\n1. 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](https://developers.vtex.com/docs/api-reference/master-data-api-v2#get-/api/dataentities/-dataEntityName-/search) 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.\n\n> ⚠️ El campo **status** debe devolver el valor **true** para indicar que el código del vendedor es válido.\n\n<blockquote><ui>2. Realiza la llamada POST [Update orderForm configuration](https://developers.vtex.com/docs/api-reference/checkout-api#post-/api/checkout/pvt/configuration/orderForm) para incluir la siguiente información en el [orderForm](https://developers.vtex.com/docs/guides/orderform-fields) de tu tienda</ui>:\n\n<blockquote><blockquote>- **marketingData**: ingresa *\"codigovendedor\"* en *\"utmCampaign\"*. Si no se describe esta información, la promoción (código de vendedor) no se aplicará al carrito y no se mostrará el campo.\n\n  <blockquote><blockquote>- **openTextField** (opcional): ingresa observaciones o comentarios como, por ejemplo, información para filtros de comisiones.\n\n> ⚠️ En la pantalla del Checkout solo debe aparecer el nombre del vendedor.\n\nDespués de ejecutar todos los pasos descritos anteriormente, el campo **Código de vendedor** estará disponible en la pantalla del Checkout.\n\n![Código de vendedor](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/es/tutorials/tasas-y-promociones/promociones/campo-codigo-de-vendedor-en-el-checkout_2.png)"}