Checkout for Salesforce Commerce Cloud

Una vez que metadata.zip esté preparado, impórtelo en su sandbox de SFCC:

1. Vaya a Business Manager > Administration > Site Development > Site Import & Export.
2. Cargue metadata.zip utilizando la opción de carga Local.
3. Después de cargar, localice el archivo en la lista y haga clic en Import.

Este paso crea las preferencias de sitio, servicios, credenciales y objetos personalizados necesarios utilizados por la integración de Zonos.

Agregue el cartucho int_zonos a la ruta de cartuchos de su sitio para activar sus controladores, scripts y plantillas:

1. Navegue a Administration > Sites > Manage Sites > [Your Target Site] > Settings.
2. Inserte int_zonos en la ruta de cartuchos antes del cartucho base del escaparate SFRA (app_storefront_base).

Hay 2 Pipelines personalizados incluidos con el cartucho que deben tener alias de pipeline agregados en Business Manager:

Zonos-OrderConfirmation

Se utiliza para la confirmación de pedido personalizada dentro de SFCC una vez que el pedido se completa en el checkout de Zonos. El usuario será redirigido aquí. Por ejemplo, el alias podría ser zonos-order-confirmation. Seleccione y agregue un alias apropiado para su negocio que sea diferente del alias que utiliza para la página de confirmación de pedido nativa de SFCC/SFRA (COSummary-Submit).

Zonos-PlaceSFCCOrder

Se utiliza para el endpoint personalizado que crea el pedido de Zonos dentro de SFCC/SFRA y se asume que el alias es zonos-placesfccorder. Si utiliza un alias diferente aquí, deberá anotarlo cuando llegue a la configuración del servicio. Esta no es una URL de cara al público, por lo que se recomienda utilizar zonos-placesfccorder para la configuración inicial a fin de mantener la facilidad de uso de este cartucho.

Para configurar estos dos alias, en Business Manager, navegue a Merchant Tools > URL Rules > Pipeline URLs.

Con la importación del sitio en el paso 2, se crearon dos servicios de SFCC (con perfiles y credenciales correspondientes): zonos.api.graphql y create.order.api.sfra.

Configuración de un solo sitio

Si su organización tiene un solo sitio de escaparate dentro de su organización SFCC, no hay nada adicional que hacer aquí y puede continuar con el siguiente paso.

Configuración de varios sitios

Si su organización tiene varios sitios de escaparate, o planea tener varios sitios de escaparate, dentro de su organización SFCC, deberá realizar actualizaciones o adiciones a sus servicios de SFCC. Cuando tenga varios sitios SFCC que utilizarán la integración de Zonos, necesitará un servicio de API de creación de pedidos para cada sitio. Para cada sitio, haga lo siguiente:

1. Cree una nueva credencial con el nombre create.order.api.[siteID].
2. Asigne la URL de la credencial a: https://[Sandbox Host]/s/[Site ID]/Zonos-PlaceSFCCOrder (por ejemplo: https://wxyz-001.dx.commercecloud.salesforce.com/s/RefArch/zonos-placesfccorder).
3. Cree un nuevo servicio con el nombre create.order.api.[siteID] y asígnele el perfil create.order.api y la credencial create.order.api.[siteID] que creó en el paso 1.

Una vez completado, debería tener un servicio de API de creación de pedidos para cada uno de sus sitios.

Nota: Si no cambió el nombre del servicio original create.order.api.sfra para que sea el servicio de creación de pedidos de uno de sus sitios y aún existe, puede eliminarlo. Deje el nombre del servicio zonos.api.graphql tal como está. Incluso con varios sitios, solo necesitará un único servicio de API de Zonos.

En Business Manager, navegue a Merchant Tools > Site Preferences > Custom Preferences, luego haga clic en el grupo de preferencias zonos para acceder a las preferencias de sitio personalizadas de Zonos.

Configure las siguientes preferencias de sitio para su(s) sitio(s):

Durante Zonos Modal Checkout, los compradores seleccionan métodos de envío definidos en su Zonos Dashboard. Cuando estos pedidos se importan a SFCC, sus métodos de envío deben corresponder a un método de envío SFCC válido. Para admitir esto:

1. Configure uno o más métodos de envío en SFCC a los que deben mapearse sus métodos de envío en Zonos.
2. En la preferencia de sitio personalizada Zonos Ship Method Mapping descrita anteriormente, establezca uno o más mapeos de métodos de envío entre su(s) método(s) de envío de Zonos y su(s) método(s) de envío de SFCC.

Asignación de método de envío

En forma de objeto JSON, el mapeo de métodos de envío asigna su(s) método(s) de envío de Zonos a su(s) método(s) de envío de SFCC. Este mapeo debe tener un registro de mapeo para cada posible método de envío de Zonos (nivel de servicio) que podría seleccionarse en su checkout de Zonos. Se recomienda encarecidamente que también incluya un registro de mapeo default que se utilizará en los casos en que se realice un pedido de Zonos con un método de envío para el cual no existe un mapeo a un método de envío SFCC, evitando así fallos posteriores causados por la falta de un método de envío en el pedido SFCC.

El formato del objeto JSON es:

{
  "[Zonos Shipping Service Level Code]": "[SFCC Shipping Method ID]",
  ...
  "default": "[Default SFCC Shipping Method ID]"
}

Ejemplo

Suponga que ha habilitado los siguientes niveles de servicio en su Zonos Dashboard:

Por cualquier motivo (es decir, requisitos de backoffice, una integración adicional de servicio de envío de terceros, etc.), podría estar limitado a los siguientes métodos de envío en SFCC para su sitio:

Cuando se recibe un nuevo pedido de Zonos y luego se coloca en SFCC, el método de envío debe estar en esta lista.

Para construir su mapeo, inicie sesión en su Zonos Dashboard, vaya a Shipping > Manage Rates y luego haga clic en cada uno de los Enabled service levels mostrados, donde verá una pantalla similar a la siguiente:

En cada uno, haga clic en Edit details para obtener (o configurar) el código de nivel de servicio de envío de Zonos (consulte a continuación).

Con el código de nivel de servicio de envío, cree un registro de mapeo que lo asigne al método de envío SFCC que desea que aparezca en sus pedidos SFCC cuando se elija ese nivel de servicio de envío (método de envío de Zonos) en el checkout de Zonos.

Una vez que haya agregado un registro para cada código de nivel de servicio de envío habilitado, así como un mapeo de método de envío default, su objeto JSON de Zonos Ship Method Mapping debería verse similar a esto:

{
  "ups.worldwide_saver": "004",
  "ups.standard": "002",
  "ups.worldwide_expedited": "012",
  "ups.worldwide_express": "012",
  "default": "001"
}

Nota: Dado que esto es solo un mapeo de métodos de envío de Zonos a métodos de envío SFCC, solo es importante incluir todos los métodos de envío de Zonos en el mapeo. No es necesario incluir cada uno de sus métodos de envío SFCC en el mapeo.

Incluidos en la instalación hay dos jobs de SFCC para respaldar la integración de Zonos:

CreateOrdersFromZonos

Este job busca referencias de pedidos de Zonos recién creados en el almacén de objetos personalizados zonosOrders, obtiene los detalles completos del pedido de Zonos y crea pedidos correspondientes en SFCC.

Programación: Puede programar este job según las necesidades de su negocio, pero normalmente este job debe configurarse para ejecutarse de forma periódica, con relativa frecuencia (es decir, cada 5-10 minutos), y cada día de la semana.

Parámetros personalizados: El job CreateOrdersFromZonos no incluye parámetros personalizados.

CreateMissingZonosOrders

Aunque debería ser poco frecuente, es posible que, debido a circunstancias imprevistas, haya pedidos realizados en Zonos que no lleguen a su instancia SFCC a través del proceso normal. Por este motivo, hemos incluido el job CreateMissingZonosOrders. Este job realiza una verificación cruzada entre su historial de pedidos de Zonos y SFCC para identificar e importar cualquier pedido faltante.

Programación: Puede programar este job según las necesidades de su negocio, pero debe programarlo para que se ejecute con menos frecuencia que el job CreateOrdersFromZonos. Algunos aspectos a considerar al programar la frecuencia de ejecución de este job:

1. Como ocurre con todos los jobs, después de considerar todos los factores, incluida la carga de procesamiento/ancho de banda y las necesidades de su negocio, debe programar este job para que se ejecute con la menor frecuencia posible según considere adecuado.
2. Dado que este job consultará todos los pedidos durante un período de tiempo, los sitios de alto volumen deben ejecutar este job con más frecuencia (de modo que se procesen menos pedidos por ejecución del job), mientras que los sitios de menor volumen pueden permitirse una frecuencia menor.
3. Nuestra frecuencia sugerida de referencia para CreateMissingZonosOrders, que consideramos funcionará para la mayoría de los sitios, es una vez cada 90 minutos.

Parámetros personalizados: Hay dos parámetros personalizados asociados con el paso del job CreateMissingZonosOrders que debe configurar:

1. LookBackHours: Este es el número de horas (desde el momento en que se ejecuta el job) hacia atrás en el tiempo durante las cuales el job debe consultar Zonos en busca de pedidos faltantes. Según la frecuencia programada del job, este valor debe ser al menos igual al tiempo entre ejecuciones del job e idealmente debe tener un solapamiento. Por ejemplo, si el job está programado para ejecutarse cada 90 minutos, configure LookBackHours en 2 (horas). Valor predeterminado (si no se configura ningún valor): 2
2. OrderSize: Número máximo de pedidos a recuperar por consulta interna a Zonos. Considérelo como el tamaño de página que el job utiliza al consultar Zonos en busca de pedidos. Valor predeterminado (si no se configura ningún valor): 20

Zonos Hello proporciona capacidades de localización del lado del cliente, como selección dinámica de idioma, mensajes de aranceles/impuestos y conversión de moneda en línea. Una vez que Zonos está habilitado en las preferencias del sitio, Hello se carga automáticamente en su escaparate a través del script de cliente de Zonos.

Los scripts de cliente de Zonos se agregan mediante una inclusión remota de SFCC del endpoint Zonos-ClientScriptInclude, ubicado en la parte inferior de las siguientes plantillas de overlay:

• /cartridge/templates/default/common/layout/page.isml
• /cartridge/templates/default/common/layout/checkout.isml

Si su proyecto sobrescribe estas plantillas en cartuchos de mayor prioridad, asegúrese de que la inclusión remota se agregue a sus versiones personalizadas:

<isinclude url="${URLUtils.url('Zonos-ClientScriptInclude', 'pageType', pdict.action)}"/>

Obtenga más información sobre Zonos Hello.

Zonos Hello convierte automáticamente los valores de precio mostrados en el escaparate a la moneda local del comprador. Para que esto funcione correctamente:

1. Los valores de precio deben estar envueltos en elementos HTML utilizando nombres de clase o IDs que puedan seleccionarse mediante jQuery. Por ejemplo: <p class="text-right sub-total zonos-price">${pdict.totals.subTotal}</p>
2. Estos valores de selector deben incluirse en la preferencia de sitio Currency Element Selector (o en su Zonos Dashboard).

Cambios de código de visualización de precios

El cartucho de Zonos incluye las siguientes plantillas de overlay para donde se renderizan los precios en todo el sitio de arquitectura de referencia, utilizando los nombres de clase zonos-list-price, zonos-sales-price y zonos-price asignados a los elementos HTML que contienen esos diversos precios:

• /cartridge/templates/default/cart/productCard/cartCouponDisplay.isml
• /cartridge/templates/default/cart/cartTotals.isml
• /cartridge/templates/default/checkout/billing/billingSummary.isml
• /cartridge/templates/default/checkout/cart/miniCart.isml
• /cartridge/templates/default/chackout/productCard/productCardProductTotalPrice.isml
• /cartridge/templates/default/product/components/pricing.isml
• /cartridge/templates/default/product/components/setPrice.isml

Si no hay cartuchos que contengan estas plantillas y estén configurados con mayor prioridad que int_zonos en la ruta de cartuchos, no se necesitan cambios de código para que Zonos Hello convierta las monedas de estas visualizaciones de precios en su sitio. Si tiene versiones personalizadas de estas plantillas en uno o más cartuchos con mayor prioridad que int_zonos en la ruta de cartuchos, deberá incluir un nombre de clase único en los contenedores HTML alrededor de sus precios (como se ilustra arriba) en esas plantillas personalizadas.

Configuración de la cadena de selector de elementos de precio

La cadena de selector de moneda es un valor de cadena de selector estilo jQuery utilizado por el script de Zonos para identificar elementos HTML que contienen valores de precio que deben recibir actualizaciones de conversión de moneda. Este valor debe ser una lista delimitada por espacios de los nombres de clase CSS y/o IDs asignados a los elementos HTML que envuelven las visualizaciones de precios de su sitio descritas en el paso anterior, donde los nombres de clase tienen el prefijo . y los IDs tienen el prefijo # (sin las comillas). Por ejemplo, si su sitio utilizará las plantillas de visualización de precios incluidas en el cartucho de Zonos, la cadena de selector será .zonos-list-price .zonos-sales-price .zonos-price (sin las comillas).

La cadena de selector de moneda se puede configurar a través de su Zonos Dashboard o en la preferencia de sitio Currency Element Selector de sus preferencias de sitio personalizadas de Zonos en Business Manager.

Nota: Si se configura en ambos lugares, el valor en Business Manager tendrá prioridad.

Obtenga más información sobre la conversión de moneda de Zonos Hello.

La cadena de selector del botón de checkout es un valor de cadena de selector jQuery utilizado por el script de Zonos para identificar elementos HTML en su sitio que sirven como controles de botón que, al hacer clic, llevan al cliente al flujo de checkout de su sitio.

Cuando los compradores hacen clic en un botón de Checkout que coincidió con su cadena de selector configurada, Zonos intercepta automáticamente la acción y abre el checkout modal.

La cadena de selector del botón de checkout se puede configurar a través de su Zonos Dashboard o en la preferencia de sitio Place Order (Checkout) Button Selector de sus preferencias de sitio personalizadas de Zonos en Business Manager.

Cuando el usuario completa un pedido dentro del checkout alojado de Zonos, se le redirige a un Pipeline personalizado que muestra una confirmación de pedido dentro de SFCC (Zonos-OrderConfirmation). La plantilla de renderizado principal para esta confirmación de pedido es /int_zonos/cartridge/templates/default/checkout/confirmation/zonosConfirmation.isml.

Esta página de confirmación de pedido utiliza el mismo estilo que la página de confirmación de pedido nativa de SFCC/SFRA y comparte algunos archivos .isml con la página de confirmación de pedido nativa de SFCC/SFRA. Esto puede requerir algunas actualizaciones de estilo para coincidir con cualquier actualización de estilo personalizada ya realizada en el sitio. Las plantillas de renderizado base utilizadas por la plantilla de confirmación de pedido de Zonos incluyen:

• app_storefront_base\cartridge\templates\default\checkout\confirmation\confirmationDetails.isml
• app_storefront_base\cartridge\templates\default\checkout\shipping\shippingSummary.isml
• int_zonos\cartridge\templates\default\checkout\billing\billingSummary.isml
• app_storefront_base\cartridge\templates\default\checkout\orderProductSummary.isml
• app_storefront_base\cartridge\templates\default\checkout\orderTotalSummary.isml

La función subyacente relacionada con este pipeline personalizado, aparte de mostrar una confirmación de pedido al usuario, está relacionada con un nuevo tipo de objeto personalizado que se incluye en la importación de datos, zonosOrders. Cuando se muestra la confirmación de pedido para el usuario, SFCC utiliza el id de pedido de Zonos mostrado en la url de la confirmación de pedido y crea un objeto personalizado correspondiente con el ID de pedido de Zonos como Key Attribute del objeto personalizado. Esto se utiliza luego para colocar el pedido dentro de SFCC mediante el job CreateOrdersFromZonos. Este job iterará a través de todos los objetos personalizados de tipo zonosOrders con createdStatus = - None -. El job realizará algunas tareas:

1. Consultar Zonos para obtener los detalles del pedido.
2. Utilizar esta respuesta para crear el pedido dentro de SFCC según la configuración establecida en las preferencias del sitio para el método de envío y el método de pago, más los detalles de artículos, envío, facturación y cliente dentro de la respuesta.
3. Actualizar Zonos con el número de pedido SFCC mediante una mutación para asociarlo con el número de pedido de Zonos dentro del Zonos Dashboard.

Si los pasos anteriores son exitosos, el atributo del objeto personalizado createdStatus se establecerá en created para eliminar el objeto de futuras consideraciones. Si los pasos anteriores no son exitosos, el atributo del objeto personalizado createdStatus se establecerá en failed y se registrará un mensaje de error dentro del objeto en el atributo errorResponse (Zonos) o sfccErrorResponse (SFCC) según el sistema que responda con el error durante el proceso.

Si necesita volver a intentar colocar el pedido, simplemente restablezca createdStatus a - None - y se tendrá en cuenta en la próxima ejecución del job.

Opcional: los siguientes ajustes son configuraciones avanzadas. Hay valores predeterminados establecidos, por lo que no se necesita ninguna acción. Si desea realizar ajustes, siga estas directrices:

Crear factura al importar

Configurado en Yes de forma predeterminada. Zonos creará una factura al importar el pedido. Si elige deshabilitar esta función, deberá crear su propia factura y Zonos establecerá una retención de revisión de fraude en un estado zonos_hold. Una vez que se levante el fraude, volveremos al estado anterior.

Inicio de sesión del cliente

Configurado en No de forma predeterminada. Si desea requerir una cuenta para el checkout, cambie a Yes. También deberá ir a Customer configuration > Login options y actualizar Redirect Customer to Account Dashboard after Logging In a No.

Exportación de pedidos de SFCC

Si utiliza, o planea utilizar, SFCC Order Export, asegúrese de que los atributos personalizados de Zonos asignados a los objetos Order y Product estén incluidos en sus archivos de exportación de pedidos de SFCC. Desde Merchant Tools > Site Preferences > Orders, configure la versión del esquema de exportación de pedidos en la versión más reciente.

Ahora que ha configurado su cuenta y su aplicación, está listo para probar su integración. Deberá habilitar Checkout y Hello en SFCC durante las pruebas. Para ello:

1. Vaya a Merchant Tools > Site Preferences > Custom Preferences > zonos.
2. Cambie Zonos Enabled a Yes.

Una vez que haya configurado la información de su cuenta de Zonos en las preferencias de sitio personalizadas de su sitio y el interruptor de función Zonos Enabled esté configurado en YES, puede probar las funciones de Zonos en su escaparate agregando el siguiente parámetro a la URL de su sitio: zCountry=[country code of a country you have enabled in your Zonos Dashboard]

Por ejemplo, si tiene Canadá habilitado: https://abcd-001.dx.commercecloud.salesforce.com/on/demandware.store/Sites-RefArch-Site?zCountry=CA

Nota: Esto solo es necesario para pruebas en entornos que no son de producción, donde su Zonos Public API Token está configurado con un token de credencial de prueba. Cuando está configurado con su token de API en vivo/producción, el parámetro de URL zCountry no es necesario ni se espera.

Si aún no está listo para estar en vivo, recuerde cambiar Zonos Enabled de nuevo a No una vez que haya terminado las pruebas. Después de completar las pruebas, habilite Zonos utilizando los mismos pasos anteriores.

La información del producto puede afectar el monto de aranceles e impuestos adeudados y el costo de envío. Cuanta más información de producto proporcione a Zonos, más precisa será la cotización devuelta. Zonos puede generar una cotización incluso cuando esta información no está disponible, pero recomienda proporcionar los siguientes detalles clave del producto para mejorar la precisión:

• Peso: El peso afecta su costo de envío, lo que puede afectar los aranceles o impuestos. Los pesos en sus listados de productos de SFCC son utilizados automáticamente por Zonos cuando están presentes.
• Dimensiones: Las dimensiones pueden afectar su costo de envío, lo que puede afectar los aranceles o impuestos. Zonos puede utilizar las dimensiones del producto (longitud, ancho y alto) configuradas en cada producto en SFCC, pero debe mapearlas en las preferencias de sitio personalizadas de Zonos para una integración adecuada.
• Códigos HS: Los códigos HS afectan las tasas de aranceles y a veces pueden afectar los impuestos. Zonos puede utilizar los códigos HS configurados en sus listados de productos en SFCC, pero debe mapear el campo de código HS en las preferencias de sitio personalizadas de Zonos.
• País de origen: El país de origen de un producto afecta las tasas de aranceles y puede afectar los impuestos. El país de origen configurado en sus listados de productos de SFCC es utilizado automáticamente por Zonos cuando está presente.

Nota: Alternativamente, puede ingresar la información en Catalog, sobrescribiendo la información almacenada y transmitida desde SFCC.

Obtenga más información sobre la información de producto por plataforma.