{"section":"tutorials","requestedLocale":"es","requestedSlug":"activar-delivery-promise","locale":"es","slug":"activar-delivery-promise","path":"docs/es/tutorials/envío/delivery-promise/activar-delivery-promise.md","branch":"main","content":"La activación de [Delivery Promise](https://help.vtex.com/es/docs/tutorials/delivery-promise) se hace directamente en el Admin VTEX, siguiendo un flujo guiado. En este flujo puedes probar la funcionalidad sin afectar la tienda en producción; puedes revisar las opciones de envío usadas en los filtros, configurar los componentes en el storefront y, por último, publicar Delivery Promise para tus compradores.\n\nConsulta en este artículo cada etapa de la activación:\n\n1. [Activar el modo de prueba](#etapa-1-activa-el-modo-de-prueba): selecciona las políticas comerciales y confirma los términos de uso para probar Delivery Promise sin afectar la tienda en producción.\n2. [Revisa las Opciones de envío](#opcional-etapa-2-revisa-las-opciones-de-envío): elige las opciones de envío que los compradores podrán usar como filtros en la tienda.\n3. [Configurar la tienda](#etapa-3-configurar-la-tienda): implementa o configura los componentes de Delivery Promise según la tecnología de tu tienda.\n4. [Publicar en producción](#etapa-4-publicar-en-producción): publica la versión de la tienda con los cambios implementados y activa Delivery Promise para los compradores.\n\nTambién puedes consultar [cómo desactivar Delivery Promise](#desactivar-delivery-promise) y [qué hacer cuando la cuenta no es compatible](#cuenta-no-compatible-con-delivery-promise).\n\n## Antes de comenzar\n\nRevisa los siguientes puntos antes de iniciar la activación:\n\n- **Compatibilidad de la cuenta:** al acceder a la página **Delivery Promise** en el Admin VTEX, la plataforma verifica automáticamente si la cuenta cumple con los [requisitos de Delivery Promise](https://help.vtex.com/es/docs/tutorials/delivery-promise#requisitos). Consulta estos requisitos para verificar si tu cuenta es compatible. Si lo es, puedes utilizar Delivery Promise sin costo adicional.\n- **Acceso al código de la tienda:** las [etapas 3](#etapa-3-configurar-la-tienda) y [4](#etapa-4-publicar-en-producción) requieren cambios en el código del storefront. Para acceder, ponte en contacto con el equipo responsable del desarrollo de la tienda o con un [partner de implementación](https://help.vtex.com/es/docs/tracks/cuentas-y-arquitectura#partners-de-implementacion). Si no tienes acceso al código pide al equipo responsable que realice los cambios necesarios.\n- **Permiso para publicar:** solo los usuarios con el rol Super Admin de la cuenta pueden publicar Delivery Promise en producción. Más información en [Roles](https://help.vtex.com/es/docs/tutorials/roles).\n\nPara comenzar accede a **Storefront > Delivery Promise** en el Admin VTEX. Desde esta página puedes verificar la compatibilidad de la cuenta e iniciar el flujo de activación.\n\n> ℹ️ Puedes salir del flujo y volver después. Las etapas completadas quedan marcadas en la parte izquierda de la página con un resumen de las elecciones realizadas, como las políticas comerciales seleccionadas y las opciones de envío destacadas.\n\n## Etapa 1: activa el modo de prueba\n\nEn esta etapa eliges dónde se va a utilizar Delivery Promise y confirmas los términos de uso. El modo de prueba no afecta tu tienda en producción.\n\nCompleta las siguientes secciones:\n\n1. **Políticas comerciales:** selecciona las [políticas comerciales](https://help.vtex.com/es/docs/tutorials/como-funciona-una-politica-comercial) en las que se va a utilizar Delivery Promise. Puedes seleccionar hasta cuatro políticas comerciales.\n2. **Términos de uso:** marca la opción **Estoy de acuerdo con estas restricciones**. Delivery Promise no es compatible con las siguientes funcionalidades, y usarlas puede causar problemas en el funcionamiento de la tienda:\n\n   - [Multilevel Omnichannel Inventory](https://help.vtex.com/es/docs/tutorials/multilevel-omnichannel-inventory)\n   - [Capacidad operativa](https://help.vtex.com/es/docs/tutorials/capacidad-operativa)\n   - VTEX Shipping Network\n   - [Assembly Options](https://help.vtex.com/es/docs/tutorials/assembly-options) para sellers externos\n\n   Para entender el impacto de cada una de las funcionalidades no compatibles en tu tienda y qué hacer para usar Delivery Promise ponte en contacto con el [Soporte VTEX](https://help.vtex.com/es/support).\n3. **Integración de sellers externos:** marca la opción **Estoy de acuerdo con este requisito**. Si tu cuenta tiene sellers externos, deben informar la disponibilidad de los productos mediante [Delivery Promise Notification API](https://developers.vtex.com/docs/api-reference/delivery-promise-notification-api). Sin esta integración, los productos de estos sellers pueden no encontrarse disponibles en la tienda.\n4. Haz clic en `Activar`.\n\n> ⚠️ Una vez completada esta etapa no es posible cambiar las políticas comerciales desde el Admin. Para incluir más políticas comerciales o cambiar las seleccionadas ponte en contacto con el [Soporte VTEX](https://help.vtex.com/es/support).\n\n## (Opcional) Etapa 2: revisa las Opciones de envío\n\nEsta etapa es opcional para activar Delivery Promise. Sin embargo, para mostrar filtros de plazo de envío en la tienda debes configurar las Opciones de envío.\n\nDelivery Promise usa las [Opciones de envío](https://help.vtex.com/es/docs/tutorials/opciones-de-envio) registradas en tu cuenta para crear los filtros que se muestran a los compradores. En esta etapa revisa y activa las sugerencias:\n\n1. Haz clic en `Acceder a Opciones de envío`.\n2. En la pantalla de preferencias de Opciones de envío elige las opciones que deben aparecer como filtro en la tienda (hasta tres) y define el orden de visualización. La primera opción de la lista se destaca más cuando se activa el filtro en el storefront.\n3. Guarda los cambios y vuelve a la página **Delivery Promise**.\n4. Haz clic en `Siguiente`.\n\n## Etapa 3: Configurar la tienda\n\nEn esta etapa configuras Delivery Promise en el storefront. Las instrucciones varían según la tecnología que usa tu tienda. Selecciona la pestaña correspondiente: **VTEX IO**, **FastStore** o **Headless**.\n\n> ⚠️ Para esta etapa es necesario tener acceso al código de la tienda.\n\n### Store Framework (VTEX IO)\n\n1. **Activar en la versión de prueba:** crea un workspace de desarrollo y en la app **GraphQL resolver for the VTEX store APIs** activa la opción `enableDeliveryPromisePreview`. Para activarla, accede a la siguiente URL. Sustituye `{workspace}` por el nombre del workspace y `{conta}` por el nombre de tu cuenta:\n\n    ```\n    https://{workspace}--{conta}.myvtex.com/admin/apps/vtex.search-resolver/setup\n    ```\n\n2. **Instalar y adaptar los componentes al tema de tu tienda:** elige los componentes que van a mostrarse en la tienda, como selección de ubicación, forma de entrega y punto de recogida, y ajusta el comportamiento de cada uno, por ejemplo si el código postal es obligatorio o si se permite la ubicación geográfica. Más información en [Setting up Delivery Promise components](https://developers.vtex.com/docs/guides/setting-up-delivery-promise-components).\n\n### FastStore\n\n> ⚠️ FastStore no tiene una versión de prueba aislada. Para ver Delivery Promise funcionando en la tienda es necesario completar la [etapa 4](#etapa-4-publicar-en-producción).\n\n1. **Activar en el código de la tienda:** activa Delivery Promise en el archivo `discovery.config.js` de la tienda. Más información en [Delivery Promise for FastStore](https://developers.vtex.com/docs/guides/faststore/features-delivery-promise).\n2. **Instalar y adaptar los componentes al tema de tu tienda:** en Headless CMS elige los componentes que se van a mostrar en la tienda, como selección de ubicación, forma de entrega y punto de recogida, y ajusta el comportamiento de cada uno, por ejemplo si el código postal es obligatorio o si se permite la ubicación geográfica.\n\n### Headless\n\n1. **Implementar la API en modo de prueba:** en las búsquedas realizadas por la tienda incluye el parámetro `dpPreview=true` junto con los parámetros de ubicación del comprador (`deliveryZonesHash` y `pickupPointsHash`). De esta forma, verás Delivery Promise activo en modo de prueba. Por ejemplo:\n\n    ```\n    https://{{accountName}}.vtexcommercestable.com.br/api/intelligent-search/v1/product-search?sc=1&deliveryZonesHash=0ecce2ea9d3b57d4ef994efba4fe3ee9&pickupPointsHash=0b79d8a9979a5f4f5f30a7849da5da16&dpPreview=true\n    ```\n\n   Los valores del ejemplo son ilustrativos. Los parámetros de ubicación se generan a partir de la ubicación proporcionada por el comprador.\n\n   > ❗ Usa el parámetro `dpPreview=true` solamente en un entorno de prueba, nunca en llamadas de producción.\n\n2. **Implementar los componentes:** implementa la captura de la ubicación del comprador para generar los parámetros de Delivery Promise y crea la interfaz de filtros de envío y recogida con los datos devueltos por Intelligent Search API. Más información en [Delivery Promise for headless stores](https://developers.vtex.com/docs/guides/delivery-promise-for-headless-stores).\n\nAl finalizar la configuración haz clic en `Siguiente`.\n\n## Etapa 4: Publicar en producción\n\nEn esta etapa publicas Delivery Promise para los clientes de tu tienda.\n\n> ⚠️ Para esta etapa es necesario tener acceso al código de la tienda. Solo los usuarios con rol Super Admin de la cuenta pueden publicar Delivery Promise en producción.\n\n1. **Publicar la versión de tu tienda en producción:** la versión de tu tienda con el componente de captura de código postal tiene que publicarse en producción para que el código postal llegue a la búsqueda.\n2. **Activar Delivery Promise en producción para los resultados de búsqueda:** marca la opción **Entiendo que los sellers externos tienen que informar la disponibilidad vía protocolo para que Delivery Promise funcione correctamente**.\n3. Haz clic en `Activar en producción`.\n4. En la ventana de confirmación haz clic en `Publicar`.\n\n> ⚠️ Delivery Promise se publica en todos los storefronts de las políticas comerciales seleccionadas en la etapa 1. No es posible publicar en un solo storefront a la vez. Para saber cómo revertir la publicación consulta [Desactivar Delivery Promise](#desactivar-delivery-promise).\n\nLa activación puede tardar hasta cinco minutos. Al final la página muestra el mensaje **Delivery Promise está en producción en tu tienda**, con la lista de las políticas comerciales en las que la funcionalidad está activa. Haz clic en `Finalizar` para terminar.\n\nA partir de ese momento, cuando la tienda identifique la ubicación del comprador (por código postal o por otros datos de ubicación), los resultados de la búsqueda muestran solo los productos disponibles para envío a esa dirección.\n\n> ℹ️ Si la activación falla la página muestra el mensaje **Se produjo un error**. Haz clic en `Reintentar`. Si el error continúa ponte en contacto con el [Soporte VTEX](https://help.vtex.com/es/support).\n\nPara activar Delivery Promise en otras políticas comerciales ponte en contacto con el [Soporte VTEX](https://help.vtex.com/es/support).\n\n## Desactivar Delivery Promise\n\nPor el momento, no es posible desactivar Delivery Promise desde la página **Delivery Promise** en el Admin VTEX. Para revertir la publicación elige una de las siguientes opciones:\n\n- Ponte en contacto con el [Soporte VTEX](https://help.vtex.com/es/support) y solicita la desactivación.\n- Remueve del storefront el componente de captura de código postal o deja de enviar el código postal y los parámetros de ubicación del comprador en la búsqueda. Para esta etapa es necesario tener acceso al código de la tienda.\n\n## Cuenta no compatible con Delivery Promise\n\nSi tu cuenta no cumple con los requisitos de Delivery Promise la página muestra el mensaje **Tu cuenta no es compatible con Delivery Promise en este momento**, y las etapas de activación no están disponibles. La siguiente tabla muestra los motivos posibles y qué hacer en cada caso:\n\n| Motivo                                                                                                                             | Qué hacer                                                                                                                                                                    |\n| ---------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| La cuenta no usa [Intelligent Search](https://help.vtex.com/es/docs/tutorials/intelligent-search-vision-general).  | Comienza a usar Intelligent Search y solicita la activación nuevamente.                                                                                      |\n| La funcionalidad [Capacidad operativa](https://help.vtex.com/es/docs/tutorials/capacidad-operativa) está activada. | Desactiva la Capacidad operativa y ponte en contacto con el [Soporte VTEX](https://help.vtex.com/es/support) para solicitar una nueva evaluación.       |\n| Uno o más sellers conectados a la cuenta no son compatibles con Delivery Promise.                                  | Ajusta la configuración de los sellers y ponte en contacto con el [Soporte VTEX](https://help.vtex.com/es/support) para solicitar una nueva evaluación. |\n\n## Más información\n\n- [Delivery Promise](https://help.vtex.com/es/docs/tutorials/delivery-promise)\n- [Delivery Promise: preguntas frecuentes](https://help.vtex.com/es/docs/tutorials/delivery-promise-faq)\n- [Opciones de envío](https://help.vtex.com/es/docs/tutorials/opciones-de-envio)"}