Check-out para Salesforce Commerce Cloud

Assim que metadata.zip estiver preparado, importe-o para sua sandbox SFCC:

1. Vá para Gerenciador de Negócios > Administração > Desenvolvimento de Site > Importação e Exportação de Site.
2. Carregue metadata.zip usando a opção de carregamento Local.
3. Após o upload, localize o arquivo na lista e clique em Importar.

Esta etapa cria as preferências de site, serviços, credenciais e objetos personalizados necessários usados pela integração Zonos.

Adicione o cartucho int_zonos ao caminho do cartucho do seu site para ativar seus controladores, scripts e modelos:

1. Navegue até Administração > Sites > Gerenciar sites > [Seu site de destino] > Configurações.
2. Insira int_zonos no caminho do cartucho antes do cartucho base da vitrine SFRA (app_storefront_base).

Existem 2 pipelines personalizados incluídos no cartucho que devem ter aliases de pipeline adicionados no Business Manager:

Zonos-OrderConfirmation

Usado para confirmação personalizada do pedido no SFCC assim que o pedido for concluído na finalização da compra do Zonos. O usuário será redirecionado aqui. Por exemplo, o alias poderia ser zonos-order-confirmation. Selecione e adicione um alias apropriado para o seu negócio que seja diferente do alias que você usa para a página nativa de confirmação de pedido SFCC/SFRA (COSummary-Submit).

Zonos-PlaceSFCCOrder

Ele é usado para o endpoint personalizado que cria o pedido Zonos dentro do SFCC/SFRA e o alias é assumido como zonos-placesfccorder. Se você usar um alias diferente aqui, precisará anotá-lo quando chegar à configuração do serviço. Este não é um URL público, portanto é recomendado que você use zonos-placesfccorder para configuração inicial para manter a usabilidade deste cartucho.

Para configurar esses dois aliases, no Business Manager, navegue até Ferramentas para comerciantes > Regras de URL > URLs de pipeline.

Com a importação do site na etapa 2, foram criados dois serviços SFCC (com perfis e credenciais correspondentes): zonos.api.graphql e create.order.api.sfra.

Configuração de site único

Se sua organização tiver um único site de loja dentro de sua organização SFCC, não há nada adicional a fazer aqui e você pode continuar para a próxima etapa.

Configuração de vários sites

Se sua organização tiver vários sites de vitrine, ou planeja ter vários sites de vitrine, dentro de sua organização SFCC, você precisará fazer atualizações ou adições aos seus serviços SFCC. Quando você tiver vários sites SFCC que usarão a integração Zonos, você precisará de um serviço de API de criação de pedidos para cada site. Para cada site, faça o seguinte:

1. Crie uma nova credencial com o nome create.order.api.[siteID].
2. Mapeie o URL da credencial para: https://[Sandbox Host]/s/[Site ID]/Zonos-PlaceSFCCOrder (por exemplo: https://wxyz-001.dx.commercecloud.salesforce.com/s/RefArch/zonos-placesfccorder).
3. Crie um novo serviço com o nome create.order.api.[siteID] e atribua a ele o perfil create.order.api e a credencial create.order.api.[siteID] que você criou na etapa 1.

Depois de concluído, você deverá ter um serviço de API de criação de pedidos para cada um de seus sites.

Observação: Se você não renomeou o serviço original create.order.api.sfra para ser o serviço de criação de pedidos de um de seus sites e ele ainda existir, você pode excluí-lo. Deixe o nome do serviço zonos.api.graphql como está. Mesmo com vários sites, você precisará apenas de um único serviço Zonos API.

No Business Manager, navegue até Ferramentas para comerciantes > Preferências do site > Preferências personalizadas e clique no grupo de preferências zonos para acessar as preferências personalizadas do site Zonos.

Defina as seguintes preferências de site para seus sites:

Durante o Zonos Modal Checkout, os compradores selecionam os métodos de envio definidos em seu Zonos Dashboard. Quando esses pedidos são importados para o SFCC, seus métodos de envio devem corresponder a um método de envio válido do SFCC. Para apoiar isso:

1. Configure um ou mais métodos de envio no SFCC para os quais seus métodos de envio em Zonos devem ser mapeados.
2. Na preferência de site personalizado Mapeamento de método de envio Zonos descrita acima, estabeleça um ou mais mapeamentos de método de envio entre seu(s) método(s) de envio Zonos e seu(s) método(s) de envio SFCC.

Mapeamento do método de envio

Na forma de um objeto JSON, o mapeamento do método de expedição mapeia seus métodos de expedição Zonos para seus métodos de expedição SFCC. Este mapeamento deve ter um registro de mapeamento para todos métodos de entrega Zonos possíveis (nível de serviço) que podem ser selecionados em seu checkout Zonos. É altamente recomendado que você também inclua um registro de mapeamento default para ser usado nos casos em que um pedido Zonos é feito com um método de envio para o qual não há mapeamento para um método de envio SFCC, evitando assim falhas subsequentes causadas pela falta de um método de envio no pedido SFCC.

O formato do objeto JSON é:

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

Exemplo

Suponha que você tenha habilitado os seguintes níveis de serviço em seu Zonos Dashboard:

Por qualquer motivo (ou seja, requisitos de backoffice, integração adicional de serviço de remessa de terceiros, etc.), você pode estar limitado aos seguintes métodos de remessa no SFCC para o seu site:

Quando um novo pedido Zonos é recebido e colocado no SFCC, o método de envio deve estar nesta lista.

Para construir seu mapeamento, faça login em seu Zonos Dashboard, vá em Frete > Gerenciar Taxas e clique em cada um dos Níveis de serviço habilitados exibidos, onde você verá uma tela semelhante a esta:

Em cada um, clique em Editar detalhes para obter (ou configurar) o código de nível de serviço de remessa Zonos (veja abaixo).

Usando o código de nível de serviço de remessa, crie um registro de mapeamento que mapeie você para o método de remessa SFCC que você deseja que apareça em seus pedidos SFCC quando esse nível de serviço de remessa (método de remessa Zonos) for escolhido na finalização da compra do Zonos.

Depois de adicionar um registro para cada código de nível de serviço de remessa habilitado, bem como um mapeamento de método de remessa default, seu objeto JSON Zonos Ship Method Mapping deverá ser semelhante a este:

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

Observação: Como este é apenas um mapeamento dos métodos de envio do Zonos para os métodos de envio do SFCC, é importante apenas incluir todos os métodos de envio do Zonos no mapeamento. Não é necessário incluir cada um dos métodos de envio SFCC no mapeamento.

Estão incluídos na instalação dois trabalhos SFCC para dar suporte à integração Zonos:

CreateOrdersFromZonos

Este trabalho procura referências de pedidos Zonos recém-criadas no armazenamento de objeto personalizado zonosOrders, obtém os detalhes completos do pedido Zonos e cria pedidos correspondentes no SFCC.

Programação: você pode agendar esse trabalho com base nas necessidades do seu negócio, mas normalmente esse trabalho deve ser configurado para ser executado periodicamente, com relativa frequência (ou seja, a cada 5 a 10 minutos) e todos os dias da semana.

Parâmetros personalizados: A tarefa CreateOrdersFromZonos não inclui parâmetros personalizados.

CreateMissingZonosOrders

Embora seja raro, é possível que devido a circunstâncias imprevistas haja pedidos feitos em Zonos que não cheguem à sua instância SFCC através do processo normal. Por esse motivo, incluímos o trabalho CreateMissingZonosOrders. Este trabalho verifica seu histórico de pedidos Zonos e SFCC para identificar e importar quaisquer pedidos ausentes.

Agendar: Você pode agendar esse trabalho com base nas necessidades do seu negócio, mas deve programá-lo para ser executado com menos frequência que o trabalho CreateOrdersFromZonos. Alguns aspectos a serem considerados ao programar a frequência de execução deste trabalho:

1. Assim como acontece com todos os trabalhos, depois de considerar todos os fatores, incluindo carga/largura de banda de processamento e suas necessidades de negócios, você deve agendar esse trabalho para ser executado com a frequência que considerar apropriada.
2. Como esse trabalho consultará todos os pedidos durante um período de tempo, os sites de alto volume deverão executá-lo com mais frequência (para que menos pedidos sejam processados por execução de trabalho), enquanto os sites de menor volume podem arcar com uma frequência menor.
3. Nossa frequência básica sugerida para CreateMissingZonosOrders, que acreditamos que funcionará para a maioria dos sites, é uma vez a cada 90 minutos.

Parâmetros personalizados: Existem dois parâmetros personalizados associados à etapa de trabalho CreateMissingZonosOrders que você deve configurar:

1. LookBackHours: Este é o número de horas (a partir do momento em que o trabalho é executado) no passado em que o trabalho deve consultar as Zonos em busca de pedidos ausentes. Dependendo da frequência agendada do trabalho, este valor deve ser pelo menos igual ao tempo entre as execuções do trabalho e idealmente deve ter uma sobreposição. Por exemplo, se o trabalho estiver programado para ser executado a cada 90 minutos, defina LookBackHours como 2 (horas). Valor padrão (se nenhum valor for definido): 2
2. OrderSize: Número máximo de pedidos a serem recuperados por consulta interna ao Zonos. Considere este o tamanho da página que o trabalho usa ao consultar pedidos nas Zonos. Valor padrão (se nenhum valor for definido): 20

Zonos Hello fornece recursos de localização do lado do cliente, como seleção dinâmica de idioma, mensagens tarifárias/impostos e conversão de moeda online. Depois que o Zonos estiver habilitado nas preferências do site, o Hello será carregado automaticamente na sua loja por meio do script do cliente Zonos.

Os scripts do cliente Zonos são adicionados usando uma inclusão SFCC remota do endpoint Zonos-ClientScriptInclude, localizado na parte inferior dos seguintes modelos de sobreposição:

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

Se o seu projeto substituir esses modelos em cartuchos de prioridade mais alta, certifique-se de que a inclusão remota seja adicionada às suas versões personalizadas:

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

Saiba mais sobre o Zonos Hello.

Zonos Hello converte automaticamente os valores de preços exibidos na vitrine para a moeda local do comprador. Para que isso funcione corretamente:

1. Os valores de preços devem ser agrupados em elementos HTML usando nomes de classes ou IDs que podem ser selecionados usando jQuery. Por exemplo: <p class="text-right sub-total zonos-price">${pdict.totals.subTotal}</p>
2. Esses valores do seletor devem ser incluídos na preferência do site Seletor de Elemento de Moeda (ou no Zonos Dashboard).

Alterações no código de exibição de preço

O cartucho Zonos inclui os seguintes modelos de sobreposição para onde os preços são renderizados no site de arquitetura de referência, usando os nomes de classe zonos-list-price, zonos-sales-price e zonos-price atribuídos aos elementos HTML que contêm esses vários preços:

• /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

Se não houver cartuchos contendo esses modelos e eles estiverem definidos com uma prioridade mais alta que int_zonos no caminho do cartucho, nenhuma alteração de código será necessária para que o Zonos Hello converta as moedas dessas exibições de preços em seu site. Se você tiver versões personalizadas desses modelos em um ou mais cartuchos com prioridade mais alta que int_zonos no caminho do cartucho, você precisará incluir um nome de classe exclusivo nos wrappers HTML em torno de seus preços (conforme ilustrado acima) nesses modelos personalizados.

Configurações da cadeia do seletor de elemento de preço

A string do seletor de moeda é um valor de string do seletor no estilo jQuery usado pelo script Zonos para identificar elementos HTML que contêm valores de preços que devem receber atualizações de conversão de moeda. Este valor deve ser uma lista delimitada por espaço dos nomes de classes CSS e/ou IDs atribuídos aos elementos HTML que envolvem as exibições de preços do seu site descritas na etapa anterior, onde os nomes das classes são prefixados com . e os IDs são prefixados com # (sem as aspas). Por exemplo, se o seu site usar os modelos de exibição de preços incluídos no cartucho Zonos, a string do seletor será .zonos-list-price .zonos-sales-price .zonos-price (sem as aspas).

A string do seletor de moeda pode ser configurada por meio do Zonos Dashboard ou na preferência do site Seletor de elemento de moeda de suas preferências personalizadas do site Zonos no Business Manager.

Observação: Se definido em ambos os locais, o valor no Business Manager terá prioridade.

Saiba mais sobre a conversão de moeda do Zonos Hello.

A string do seletor do botão de checkout é um valor da string do seletor jQuery usado pelo script Zonos para identificar elementos HTML em seu site que servem como controles de botão que, quando clicados, levam o cliente ao fluxo de checkout do seu site.

Quando os compradores clicam em um botão Checkout que corresponde à string do seletor configurada, o Zonos intercepta automaticamente a ação e abre o checkout modal.

A cadeia de seletores de botões de checkout pode ser configurada por meio do painel do Zonos ou na preferência do site Seletor de botão de pedido (checkout) de suas preferências personalizadas do site Zonos no Business Manager.

Quando o usuário conclui um pedido no checkout hospedado no Zonos, ele é redirecionado para um Pipeline personalizado que exibe uma confirmação do pedido no SFCC (Zonos-OrderConfirmation). O principal modelo de renderização para esta confirmação de pedido é /int_zonos/cartridge/templates/default/checkout/confirmation/zonosConfirmation.isml.

Esta página de confirmação de pedido usa o mesmo estilo da página nativa de confirmação de pedido SFCC/SFRA e compartilha alguns arquivos .isml com a página nativa de confirmação de pedido SFCC/SFRA. Isso pode exigir algumas atualizações de estilo para corresponder a quaisquer atualizações de estilo personalizado já feitas no site. Os modelos básicos de renderização usados pelo modelo de confirmação de pedido Zonos incluem:

• 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

A função subjacente relacionada a esse pipeline personalizado, além de exibir uma confirmação de pedido ao usuário, está relacionada a um novo tipo de objeto personalizado incluído na importação de dados, zonosOrders. Quando a confirmação do pedido é exibida ao usuário, o SFCC usa o ID do pedido Zonos exibido no URL de confirmação do pedido e cria um objeto personalizado correspondente com o ID do pedido Zonos como o atributo chave do objeto personalizado. Isso é então usado para fazer o pedido no SFCC usando o trabalho CreateOrdersFromZonos. Este trabalho irá iterar por todos os objetos personalizados do tipo zonosOrders com createdStatus = - None -. O trabalho executará algumas tarefas:

1. Consulte a Zonos para obter detalhes do pedido.
2. Use esta resposta para criar o pedido no SFCC com base nas configurações definidas nas preferências do site para método de envio e método de pagamento, além de item, envio, cobrança e detalhes do cliente na resposta.
3. Atualize o Zonos com o número do pedido SFCC usando uma mutação para associá-lo ao número do pedido Zonos no Painel do Zonos.

Se as etapas acima forem bem-sucedidas, o atributo do objeto personalizado createdStatus será definido como created para remover o objeto de considerações posteriores. Se as etapas acima não forem bem-sucedidas, o atributo do objeto personalizado createdStatus será definido como failed e uma mensagem de erro será registrada dentro do objeto no atributo errorResponse (Zonos) ou sfccErrorResponse (SFCC) dependendo de qual sistema responder com o erro durante o processo.

Se precisar tentar novamente fazer o pedido, basta redefinir createdStatus para - None - e isso será levado em consideração na próxima execução do trabalho.

Opcional: as configurações a seguir são configurações avançadas. Existem valores padrão definidos, portanto nenhuma ação é necessária. Se você quiser fazer ajustes, siga estas orientações:

Criar fatura na importação

Defina como Sim por padrão. Zonos criará uma fatura ao importar o pedido. Se você optar por desativar esse recurso, precisará criar sua própria fatura e o Zonos definirá uma retenção de revisão de fraude para o status zonos_hold. Assim que a fraude for eliminada, voltaremos ao estado anterior.

Login do cliente

Defina como Não por padrão. Se você quiser solicitar uma conta para finalizar a compra, altere para Sim. Você também precisará acessar Configuração do cliente > Opções de login e atualizar Redirecionar o cliente para o painel da conta após fazer login para Não.

Exportação de pedido SFCC

Se você usa ou planeja usar a exportação de pedido SFCC, certifique-se de que os atributos de Zonos personalizadas atribuídos aos objetos Pedido e Produto estejam incluídos em seus arquivos de exportação de pedido SFCC. Em Ferramentas do comerciante > Preferências do site > Pedidos, defina a versão do esquema de exportação do pedido para a versão mais recente.

Agora que configurou sua conta e seu aplicativo, você está pronto para testar sua integração. Você precisará ativar o Checkout e o Hello no SFCC durante o teste. Para fazer isso:

1. Vá para Ferramentas para comerciantes > Preferências do site > Preferências personalizadas > Zonos.
2. Altere Zonos Enabled para Sim.

Depois de configurar as informações da sua conta Zonos nas preferências personalizadas do seu site e a chave de recurso Zonos Enabled estiver definida como SIM, você poderá testar os recursos do Zonos em sua vitrine adicionando o seguinte parâmetro ao URL do seu site: zCountry=[country code of a country you have enabled in your Zonos Dashboard]

Por exemplo, se você tiver o Canadá ativado: https://abcd-001.dx.commercecloud.salesforce.com/on/demandware.store/Sites-RefArch-Site?zCountry=CA

Observação: Isso só é necessário para testes em ambientes que não sejam de produção, onde seu token de API público Zonos está configurado com um token de credencial de teste. Quando configurado com seu token de API ativo/de produção, o parâmetro de URL zCountry não é obrigatório nem esperado.

Se você ainda não estiver pronto para entrar no ar, lembre-se de alterar Zonos Enabled de volta para Não quando terminar o teste. Após concluir os testes, habilite a Zonos seguindo as mesmas etapas acima.

As informações do produto podem afetar o valor dos direitos e impostos devidos e o custo do envio. Quanto mais informações do produto você fornecer à Zonos, mais precisa será a cotação retornada. Zonos pode gerar uma cotação mesmo quando esta informação não estiver disponível, mas recomenda fornecer os seguintes detalhes principais do produto para melhorar a precisão:

• Peso: O peso afeta o custo de envio, o que pode afetar taxas ou impostos. Os pesos em suas listagens de produtos SFCC são usados automaticamente pelo Zonos quando presentes.
• Dimensões: As dimensões podem afetar o custo de envio, o que pode afetar taxas ou impostos. O Zonos pode usar as dimensões do produto (comprimento, largura e altura) configuradas em cada produto no SFCC, mas você deve mapeá-las para as preferências personalizadas do site do Zonos para uma integração adequada.
• Códigos HS: Os códigos HS afetam as taxas tarifárias e às vezes podem afetar os impostos. O Zonos pode usar os códigos HS configurados em suas listagens de produtos no SFCC, mas você deve mapear o campo do código HS nas preferências personalizadas do site Zonos.
• País de origem: O país de origem de um produto afeta as tarifas e pode afetar os impostos. O país de origem definido em suas listagens de produtos SFCC é usado automaticamente pelo Zonos quando presente.

Nota: Alternativamente, você pode inserir as informações no Catálogo, substituindo as informações armazenadas e transmitidas do SFCC.

Saiba mais sobre informações de produtos por plataforma.