Transforme a sua loja SFCC para o comércio global com o Zonos Checkout.
O Zonos Checkout integra-se diretamente na sua loja online Salesforce Commerce Cloud (SFCC), permitindo transações internacionais fluidas com cálculos de landed cost incorporados, opções de pagamento localizadas e gestão automatizada de encomendas entre a Zonos e o SFCC Business Manager.
Para os seus clientes: Checkout localizado no seu idioma e moeda, com cálculos antecipados de landed cost, proteção contra fraude e sem taxas inesperadas no momento da entrega.
Para a sua equipa: Cálculos internacionais fluidos, gestão de encomendas no SFCC Business Manager com sincronização automática de encomendas e processamento seguro de pagamentos, gerido inteiramente pela Zonos.
Se ainda não se registou na Zonos, preencha o nosso formulário de contacto com vendas para começar. Assim que o contrato da sua conta estiver em vigor, um representante de integração dedicado entrará em contacto consigo no prazo de 24 horas para o orientar ao longo do processo de integração.
Integre o Checkout na sua loja Salesforce Commerce Cloud de forma simples, seguindo estes passos:
1
Criar o arquivo de metadados
Antes de instalar o cartridge, certifique-se de que dispõe de uma sandbox funcional com um site baseado em SFRA instalado. Em seguida, crie um arquivo de metadados para importação do site:
No cartridge Zonos LINK extraído, mude o nome da pasta /link_zonos/metadata/sites/RefArch para o ID do seu site SFCC. Por exemplo, se o ID do seu site for "GlobalEcom", mude o nome de forma a obter /link_zonos/metadata/sites/GlobalEcom na estrutura de pastas.
Crie um arquivo Zip da pasta /link_zonos/metadata e atribua-lhe o nome metadata.zip. Nota: Inclua a própria pasta /metadata no arquivo zip.
2
Importar o arquivo de metadados
Depois de preparar o metadata.zip, importe-o para a sua sandbox SFCC:
Aceda a Business Manager > Administration > Site Development > Site Import & Export.
Carregue o metadata.zip através da opção de carregamento Local.
Após o carregamento, localize o arquivo na lista e clique em Import.
Este passo cria as preferências de site, os serviços, as credenciais e os objetos personalizados necessários para a integração da Zonos.
3
Adicionar o cartridge ao cartridge path
Adicione o cartridge int_zonos ao cartridge path do seu site para ativar os respetivos controladores, scripts e modelos:
Navegue até Administration > Sites > Manage Sites > [O seu site de destino] > Settings.
Insira int_zonos no cartridge path antes do cartridge base da loja online SFRA (app_storefront_base).
4
Configurar aliases de pipeline
O cartridge inclui 2 pipelines personalizados aos quais devem ser adicionados aliases de pipeline no Business Manager:
Zonos-OrderConfirmation
Este pipeline é utilizado para a confirmação personalizada da encomenda no SFCC, depois de a encomenda ser concluída no checkout da Zonos. O utilizador será redirecionado para aqui. Por exemplo, o alias pode ser zonos-order-confirmation. Selecione e adicione um alias adequado ao seu negócio, diferente do alias que utiliza para a página nativa de confirmação de encomenda do checkout SFCC/SFRA (COSummary-Submit).
Zonos-PlaceSFCCOrder
Este pipeline é utilizado para o endpoint personalizado que cria a encomenda da Zonos no SFCC/SFRA, e assume-se que o alias é zonos-placesfccorder. Se utilizar um alias diferente, terá de o anotar quando chegar à configuração do serviço. Este URL não é público, pelo que se recomenda utilizar zonos-placesfccorder na configuração inicial para facilitar a utilização deste cartridge.
Para configurar estes dois aliases, no Business Manager, navegue até Merchant Tools > URL Rules > Pipeline URLs.
5
Configurar os serviços SFCC
Com a importação do site no passo 2, foram criados dois serviços SFCC (com os respetivos perfis e credenciais): zonos.api.graphql e create.order.api.sfra.
Configuração de site único
Se a sua organização tiver um único site de loja online na sua organização SFCC, não há mais nada a fazer aqui e pode avançar para o passo seguinte.
Configuração de vários sites
Se a sua organização tiver, ou planear ter, vários sites de loja online na sua organização SFCC, terá de atualizar ou acrescentar serviços SFCC. Quando tiver vários sites SFCC que vão utilizar a integração da Zonos, precisará de um serviço de API de criação de encomendas para cada site. Para cada site, faça o seguinte:
Crie uma nova credencial com o nome create.order.api.[siteID].
Defina o URL da credencial como: https://[Sandbox Host]/s/[Site ID]/Zonos-PlaceSFCCOrder (por exemplo: https://wxyz-001.dx.commercecloud.salesforce.com/s/RefArch/zonos-placesfccorder).
Crie um novo serviço com o nome create.order.api.[siteID] e atribua-lhe o perfil create.order.api e a credencial create.order.api.[siteID] que criou no passo 1.
No final, deverá ter um serviço de API de criação de encomendas para cada um dos seus sites.
Nota: Se não mudou o nome do serviço original create.order.api.sfra para o utilizar como serviço de criação de encomendas de um dos seus sites, e este ainda existir, pode eliminá-lo. Mantenha o nome do serviço zonos.api.graphql tal como está. Mesmo com vários sites, precisará apenas de um único serviço de API da Zonos.
6
Configurar as preferências de site personalizadas da Zonos
No Business Manager, navegue até Merchant Tools > Site Preferences > Custom Preferences e clique no grupo de preferências zonos para aceder às preferências de site personalizadas da Zonos.
Defina as seguintes preferências de site para o(s) seu(s) site(s):
Nome da preferência↕
Descrição↕
Zonos Enabled
Interruptor de funcionalidade utilizado para ativar/desativar a integração da Zonos na loja online. Se não estiver definido, é utilizado o valor predefinido (No).
Main Zonos Script
(Obrigatório) URL do script do lado do cliente (navegador) para a integração da Zonos. Fornecido pela Zonos. Se não estiver definido, é utilizado o valor predefinido (https://cdn.jsdelivr.net/npm/@zonos/elements/dist/scripts/loadZonos.js).
Blur OnInit Script
(Opcional) URL do script do lado do cliente (navegador) para desfocar os valores de preço iniciais quando a conversão automática de moeda está ativada. Fornecido pela Zonos.
Public API Token
(Obrigatório) Token de integração público. Este valor encontra-se no seu Zonos Dashboard (Settings > Integrations > API Keys: Public Credential).
Private API Token
(Obrigatório) Token de integração privado. Este valor encontra-se no seu Zonos Dashboard (Settings > Integrations > API Keys: Zonos API).
Zonos Store ID
(Obrigatório) ID da loja fornecido pela Zonos. Este valor encontra-se no seu Zonos Dashboard (Settings > Integrations > App credentials: Store ID).
Currency Element Selector
(Opcional) String de seletor ao estilo jQuery (sem aspas) para os valores de preço aos quais a Zonos deve aplicar a conversão de moeda.
Place Order (Checkout) Button Selector
(Opcional) String de seletor ao estilo jQuery (sem aspas) para os botões que devem iniciar o checkout modal da Zonos.
Zonos Payment Method ID
ID do método de pagamento SFCC utilizado ao criar a encomenda da Zonos no SFCC. A importação de dados inclui um novo Payment Method e um novo Payment Processor, ambos com o id ZONOS. Este novo ID de método de pagamento é também o valor predefinido desta preferência de site personalizada. Se preferir associar um método de pagamento diferente às encomendas da Zonos, pode alterar este valor para o ID de qualquer Payment Method válido configurado no Business Manager.
Zonos Ship Method Mapping
Mapeamento JSON dos IDs de método de envio da resposta de detalhes da encomenda da Zonos para IDs de método de envio do SFCC, ao colocar encomendas da Zonos no SFCC. Defina um mapeamento predefinido para que os métodos de envio da Zonos que não estejam explicitamente mapeados sejam associados a um método de envio predefinido do SFCC. Consulte a secção "Configurar métodos de envio" abaixo para uma explicação mais detalhada.
Place Order Password
(Obrigatório) Este valor é utilizado pelo SFCC para garantir que os pedidos à API de criação de encomendas provêm de uma origem interna e fidedigna (ou seja, uma tarefa do SFCC). Este valor pode ser qualquer sequência de caracteres (letras maiúsculas/minúsculas, números e caracteres especiais comuns) à sua escolha. Exemplo: X$7eo$33B!z=
SFCC Storefront Password
Palavra-passe da loja online do site SFCC (se estiver protegido).
Place Order Service Name
(Obrigatório) O nome do serviço de API de criação de encomendas que configurou no passo 5. Nota: este nome tem de corresponder exatamente ao nome do serviço.
Origin Shipping Address
Endereço de origem do armazém de expedição, enviado para a Zonos, em formato JSON. Exemplo: {"administrativeArea": "Pennsylvania", "administrativeAreaCode": "PA", "countryCode": "US", "line1": "975 S Tech Ridge Dr", "line2": "", "locality": "Harrisburg", "postalCode": "17025"}
Zonos Default HS Code
(Obrigatório) Código HS predefinido da Zonos, utilizado se o valor do produto for nulo. Se estiver em branco, é utilizado o valor predefinido (6109.10).
7
Configurar métodos de envio
Durante o Zonos Modal Checkout, os compradores selecionam métodos de envio definidos no seu Zonos Dashboard. Quando estas encomendas são importadas para o SFCC, os respetivos métodos de envio têm de corresponder a um método de envio válido do SFCC. Para o permitir:
Configure um ou mais métodos de envio no SFCC para os quais os seus métodos de envio na Zonos devem ser mapeados.
Na preferência de site personalizada Zonos Ship Method Mapping descrita acima, estabeleça um ou mais mapeamentos de métodos de envio entre o(s) seu(s) método(s) de envio da Zonos e o(s) seu(s) método(s) de envio do SFCC.
Mapeamento de métodos de envio
Sob a forma de um objeto JSON, o mapeamento de métodos de envio associa o(s) seu(s) método(s) de envio da Zonos ao(s) seu(s) método(s) de envio do SFCC. Este mapeamento tem de ter um registo de mapeamento para todos os métodos de envio da Zonos (níveis de serviço) que possam ser selecionados no seu checkout da Zonos. É altamente recomendado que inclua também um registo de mapeamento default, que será utilizado nos casos em que uma encomenda da Zonos é feita com um método de envio para o qual não existe mapeamento para um método de envio do SFCC, evitando assim falhas a jusante causadas pela ausência de método de envio na encomenda do SFCC.
Suponha que ativou os seguintes níveis de serviço no seu Zonos Dashboard:
Por qualquer motivo (por exemplo, requisitos de backoffice, uma integração adicional com um serviço de envio de terceiros, etc.), poderá estar limitado aos seguintes métodos de envio no SFCC para o seu site:
Quando uma nova encomenda da Zonos é recebida e depois colocada no SFCC, o método de envio tem de pertencer a esta lista.
Para criar o seu mapeamento, inicie sessão no seu Zonos Dashboard, aceda a Shipping > Manage Rates e clique em cada um dos Enabled service levels apresentados, onde verá um ecrã semelhante ao seguinte:
Em cada um, clique em Edit details para obter (ou definir) o código do nível de serviço de envio da Zonos (ver abaixo).
Com o código do nível de serviço de envio, crie um registo de mapeamento que o associe ao método de envio do SFCC que pretende que apareça nas suas encomendas do SFCC quando esse nível de serviço de envio (método de envio da Zonos) for escolhido no checkout da Zonos.
Depois de adicionar um registo para cada código de nível de serviço de envio ativado, bem como um mapeamento de método de envio default, o seu objeto JSON Zonos Ship Method Mapping deverá ser semelhante a este:
Nota: Como se trata apenas de um mapeamento de métodos de envio da Zonos para métodos de envio do SFCC, só é importante que todos os métodos de envio da Zonos estejam incluídos no mapeamento. Não é necessário incluir cada um dos seus métodos de envio do SFCC no mapeamento.
8
Configurar as tarefas
A instalação inclui duas tarefas (jobs) do SFCC para suportar a integração da Zonos:
CreateOrdersFromZonos
Esta tarefa procura referências de encomendas da Zonos recém-criadas no armazenamento de objetos personalizados zonosOrders, obtém da Zonos os detalhes completos das encomendas e cria as encomendas correspondentes no SFCC.
Agendamento: Pode agendar esta tarefa de acordo com as necessidades do seu negócio, mas, normalmente, deve ser configurada para ser executada em intervalos, com relativa frequência (ou seja, a cada 5-10 minutos), todos os dias da semana.
Parâmetros personalizados: A tarefa CreateOrdersFromZonos não inclui parâmetros personalizados.
CreateMissingZonosOrders
Embora deva ser raro, é possível que, devido a circunstâncias imprevistas, existam encomendas feitas na Zonos que não chegam à sua instância SFCC através do processo normal. Por esse motivo, incluímos a tarefa CreateMissingZonosOrders. Esta tarefa efetua uma verificação cruzada entre o histórico de encomendas da Zonos e o SFCC para identificar e importar eventuais encomendas em falta.
Agendamento: Pode agendar esta tarefa de acordo com as necessidades do seu negócio, mas deve agendá-la para ser executada com menos frequência do que a tarefa CreateOrdersFromZonos. Alguns aspetos a considerar ao definir a frequência de execução desta tarefa:
Tal como acontece com todas as tarefas, depois de ponderados todos os fatores, incluindo a carga/largura de banda de processamento e as necessidades do seu negócio, deve agendar esta tarefa para ser executada com a menor frequência que considerar possível.
Uma vez que esta tarefa consulta todas as encomendas de um determinado período, os sites com grande volume devem executá-la com mais frequência (para que sejam processadas menos encomendas por execução), enquanto os sites com menor volume podem executá-la com menos frequência.
A frequência base que sugerimos para a CreateMissingZonosOrders, e que consideramos adequada para a maioria dos sites, é uma vez a cada 90 minutos.
Parâmetros personalizados: Existem dois parâmetros personalizados associados ao passo da tarefa CreateMissingZonosOrders que deve definir:
LookBackHours: Número de horas (a contar do momento em que a tarefa é executada) para trás no tempo durante as quais a tarefa deve consultar a Zonos à procura de encomendas em falta. Com base na frequência agendada da tarefa, este valor deve ser, no mínimo, igual ao intervalo entre execuções e, idealmente, deve haver uma sobreposição. Por exemplo, se a tarefa estiver agendada para ser executada a cada 90 minutos, defina LookBackHours como 2 (horas). Valor predefinido (se nenhum valor for definido): 2
OrderSize: Número máximo de encomendas a obter por consulta interna à Zonos. Considere-o como o tamanho de página que a tarefa utiliza ao consultar encomendas na Zonos. Valor predefinido (se nenhum valor for definido): 20
9
Configurar o Zonos Hello
O Zonos Hello disponibiliza funcionalidades de localização do lado do cliente, como seleção dinâmica de idioma, mensagens sobre direitos aduaneiros/impostos e conversão de moeda em linha. Depois de a Zonos ser ativada nas preferências de site, o Hello é carregado automaticamente na sua loja online através do script de cliente da Zonos.
Os scripts de cliente da Zonos são adicionados através de um remote include do SFCC do endpoint Zonos-ClientScriptInclude, localizado na parte inferior dos seguintes modelos de sobreposição:
Se o seu projeto substituir estes modelos em cartridges de prioridade mais elevada, certifique-se de que o remote include é adicionado às suas versões personalizadas:
O Zonos Hello converte automaticamente os valores de preço apresentados na loja online para a moeda local do comprador. Para que isto funcione corretamente:
Os valores de preço têm de estar envolvidos em elementos HTML com nomes de classe ou IDs que possam ser selecionados através de jQuery. Por exemplo: <p class="text-right sub-total zonos-price">${pdict.totals.subTotal}</p>
Estes valores de seletor têm de ser incluídos na preferência de site Currency Element Selector (ou no seu Zonos Dashboard).
Alterações ao código de apresentação de preços
O cartridge da Zonos inclui os seguintes modelos de sobreposição para os locais onde os preços são apresentados no site de arquitetura de referência, utilizando os nomes de classe zonos-list-price, zonos-sales-price e zonos-price atribuídos aos elementos HTML que contêm esses diferentes preços:
Se não existirem cartridges que contenham estes modelos configurados acima de int_zonos no cartridge path, não são necessárias alterações ao código para que o Zonos Hello converta a moeda destas apresentações de preços no seu site. Se tiver versões personalizadas destes modelos num ou mais cartridges acima de int_zonos no cartridge path, terá de incluir um nome de classe exclusivo nos elementos HTML que envolvem os seus preços (como ilustrado acima) nesses modelos personalizados.
Configurar a string de seletor dos elementos de preço
A string de seletor de moeda é um valor de string de seletor ao estilo jQuery utilizado pelo script da Zonos para identificar os elementos HTML que contêm valores de preço que devem receber atualizações de conversão de moeda. Este valor deve ser uma lista, delimitada por espaços, dos nomes de classe CSS e/ou IDs atribuídos aos elementos HTML que envolvem as apresentações de preços do seu site descritas no passo anterior, em que os nomes de classe têm o prefixo . e os IDs têm o prefixo # (sem as aspas). Por exemplo, se o seu site utilizar os modelos de apresentação de preços incluídos no cartridge da Zonos, a string de seletor será .zonos-list-price .zonos-sales-price .zonos-price (sem as aspas).
A string de seletor de moeda pode ser configurada através do seu Zonos Dashboard ou na preferência de site Currency Element Selector das suas preferências de site personalizadas da Zonos no Business Manager.
Nota: Se estiver configurada em ambos os locais, prevalece o valor do Business Manager.
Saiba mais sobre a conversão de moeda do Zonos Hello.
11
Configurar o botão de checkout
A string de seletor do botão de checkout é um valor de string de seletor jQuery utilizado pelo script da Zonos para identificar os elementos HTML do seu site que funcionam como botões que, quando clicados, levam o cliente para o fluxo de checkout do seu site.
Quando os compradores clicam num botão de Checkout correspondente à string de seletor configurada, a Zonos interceta automaticamente a ação e abre o checkout modal.
A string de seletor do botão de checkout pode ser configurada através do seu Zonos Dashboard ou na preferência de site Place Order (Checkout) Button Selector das suas preferências de site personalizadas da Zonos no Business Manager.
12
Compreender a confirmação de encomenda e os objetos personalizados
Quando o utilizador conclui uma encomenda no checkout alojado pela Zonos, é redirecionado para um Pipeline personalizado que apresenta uma confirmação de encomenda no SFCC (Zonos-OrderConfirmation). O principal modelo de apresentação desta confirmação de encomenda é /int_zonos/cartridge/templates/default/checkout/confirmation/zonosConfirmation.isml.
Esta página de confirmação de encomenda utiliza o mesmo estilo da página nativa de confirmação de encomenda do SFCC/SFRA e partilha alguns ficheiros .isml com essa página. Poderá ser necessário atualizar o estilo para corresponder a quaisquer personalizações de estilo já feitas no site. Os modelos de apresentação base utilizados pelo modelo de confirmação de encomenda da Zonos incluem:
Para além de apresentar uma confirmação de encomenda ao utilizador, a função subjacente deste pipeline personalizado está relacionada com um novo tipo de objeto personalizado incluído na importação de dados, zonosOrders. Quando a confirmação de encomenda é apresentada ao utilizador, o SFCC utiliza o ID da encomenda da Zonos apresentado no URL da confirmação e cria um objeto personalizado correspondente com o ID da encomenda da Zonos como Key Attribute do objeto personalizado. Este objeto é depois utilizado para colocar a encomenda no SFCC através da tarefa CreateOrdersFromZonos. Esta tarefa percorre todos os objetos personalizados do tipo zonosOrders com createdStatus = - None -. A tarefa executa algumas operações:
Consulta a Zonos para obter os detalhes da encomenda.
Utiliza esta resposta para criar a encomenda no SFCC, com base nas definições configuradas nas preferências de site para o método de envio e o método de pagamento, bem como nos detalhes de artigos, envio, faturação e cliente incluídos na resposta.
Atualiza a Zonos com o número da encomenda do SFCC através de uma mutação, para o associar ao número da encomenda da Zonos no Zonos Dashboard.
Se os passos acima forem bem-sucedidos, o atributo createdStatus do objeto personalizado passa a created, para que o objeto deixe de ser considerado. Se os passos acima não forem bem-sucedidos, o atributo createdStatus do objeto personalizado passa a failed e é registada uma mensagem de erro no objeto, no atributo errorResponse (Zonos) ou sfccErrorResponse (SFCC), consoante o sistema que respondeu com o erro durante o processo.
Se precisar de tentar colocar a encomenda novamente, basta repor o createdStatus em - None - e a encomenda será considerada na próxima execução da tarefa.
13
Ajustar as definições avançadas
Opcional—As definições seguintes são definições avançadas. Existem valores predefinidos, pelo que não é necessária qualquer ação. Se pretender fazer ajustes, siga estas orientações:
Criar fatura na importação
Definido como Yes por predefinição. A Zonos cria uma fatura aquando da importação da encomenda. Se optar por desativar esta funcionalidade, terá de criar a sua própria fatura e a Zonos colocará uma retenção para análise de fraude com o estado zonos_hold. Assim que a retenção por fraude for levantada, repomos o estado anterior.
Início de sessão do cliente
Definido como No por predefinição. Se pretender exigir uma conta para o checkout, mude para Yes. Terá também de aceder a Customer configuration > Login options e alterar Redirect Customer to Account Dashboard after Logging In para No.
Exportação de encomendas do SFCC
Se utiliza, ou planeia utilizar, a exportação de encomendas do SFCC (SFCC Order Export), certifique-se de que os atributos personalizados da Zonos atribuídos aos objetos Order e Product são incluídos nos seus ficheiros de exportação de encomendas do SFCC. Em Merchant Tools > Site Preferences > Orders, defina a versão do esquema de exportação de encomendas para a versão mais recente.
14
Testar a sua integração
Agora que configurou a sua conta e a sua aplicação, está pronto para testar a sua integração. Durante os testes, terá de ativar o Checkout e o Hello no SFCC. Para tal:
Aceda a Merchant Tools > Site Preferences > Custom Preferences > zonos.
Mude Zonos Enabled para Yes.
Depois de configurar as informações da sua conta Zonos nas preferências de site personalizadas e de definir o interruptor de funcionalidade Zonos Enabled como YES, pode testar as funcionalidades da Zonos na sua loja online 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 tiver o Canadá ativado: https://abcd-001.dx.commercecloud.salesforce.com/on/demandware.store/Sites-RefArch-Site?zCountry=CA
Nota: Isto só é necessário para testes em ambientes que não sejam de produção, em que o seu Public API Token da Zonos está configurado com um token de credencial de teste. Quando estiver configurado com o seu token de API ativo/de produção, o parâmetro de URL zCountry não é necessário nem esperado.
Se ainda não estiver pronto para entrar em produção, lembre-se de voltar a mudar Zonos Enabled para No quando terminar os testes. Após concluir os testes, ative a Zonos seguindo os mesmos passos acima.
Precisa de ajuda?
Se tiver dúvidas, contacte a nossa equipa de suporte. Se estiver a trabalhar com um gestor de projeto de Professional Services para a integração da sua conta, contacte-o para obter assistência.
Os números de seguimento adicionados no SFCC são sincronizados automaticamente com a Zonos. No entanto, os números de seguimento adicionados no Zonos Dashboard não são sincronizados de volta com o SFCC. Se adicionar ou atualizar números de seguimento no Zonos Dashboard, terá também de os atualizar manualmente no SFCC Business Manager.
Saiba mais sobre as integrações que suportam a sincronização de números de seguimento.
A desinstalação do cartridge tem de ser efetuada por um programador SFCC experiente. Contacte a sua equipa de desenvolvimento SFCC ou o suporte da Zonos para obter assistência com a desinstalação.
Que informações de produto devo fornecer para obter a cotação mais precisa de direitos aduaneiros, impostos e custos de envio?
As informações de produto podem influenciar o montante de direitos aduaneiros e impostos devidos e o custo de envio. Quanto mais informações de produto fornecer à Zonos, mais precisa será a cotação devolvida. A Zonos consegue gerar uma cotação mesmo quando estas informações não estão disponíveis, mas recomenda que forneça os seguintes dados essenciais do produto para melhorar a precisão:
Peso: O peso influencia o custo de envio, o que pode afetar os direitos aduaneiros ou os impostos. Os pesos indicados nas fichas de produto do SFCC são utilizados automaticamente pela Zonos quando existem.
Dimensões: As dimensões podem influenciar o custo de envio, o que pode afetar os direitos aduaneiros ou os impostos. A Zonos pode utilizar as dimensões do produto (comprimento, largura e altura) definidas em cada produto no SFCC, mas tem de as mapear nas preferências de site personalizadas da Zonos para uma integração correta.
Códigos HS: Os códigos HS influenciam as taxas de direitos aduaneiros e, por vezes, podem afetar os impostos. A Zonos pode utilizar os códigos HS definidos nas fichas de produto do SFCC, mas tem de mapear o campo do código HS nas preferências de site personalizadas da Zonos.
País de origem: O país de origem de um produto influencia as taxas de direitos aduaneiros e pode afetar os impostos. O país de origem definido nas fichas de produto do SFCC é utilizado automaticamente pela Zonos quando existe.
Nota: Em alternativa, pode introduzir as informações no Catalog, substituindo as informações armazenadas e transmitidas a partir do SFCC.
Saiba mais sobre as informações de produto por plataforma.
Salesforce Commerce Cloud
Checkout para Salesforce Commerce Cloud
Transforme a sua loja SFCC para o comércio global com o Zonos Checkout.
O Zonos Checkout integra-se diretamente na sua loja online Salesforce Commerce Cloud (SFCC), permitindo transações internacionais fluidas com cálculos de landed cost incorporados, opções de pagamento localizadas e gestão automatizada de encomendas entre a Zonos e o SFCC Business Manager.
Para os seus clientes: Checkout localizado no seu idioma e moeda, com cálculos antecipados de landed cost, proteção contra fraude e sem taxas inesperadas no momento da entrega.
Para a sua equipa: Cálculos internacionais fluidos, gestão de encomendas no SFCC Business Manager com sincronização automática de encomendas e processamento seguro de pagamentos, gerido inteiramente pela Zonos.
Como integrar
Se ainda não se registou na Zonos, preencha o nosso formulário de contacto com vendas para começar. Assim que o contrato da sua conta estiver em vigor, um representante de integração dedicado entrará em contacto consigo no prazo de 24 horas para o orientar ao longo do processo de integração.
Integre o Checkout na sua loja Salesforce Commerce Cloud de forma simples, seguindo estes passos:
Criar o arquivo de metadados
Antes de instalar o cartridge, certifique-se de que dispõe de uma sandbox funcional com um site baseado em SFRA instalado. Em seguida, crie um arquivo de metadados para importação do site:
/link_zonos/metadata/sites/RefArchpara o ID do seu site SFCC. Por exemplo, se o ID do seu site for "GlobalEcom", mude o nome de forma a obter/link_zonos/metadata/sites/GlobalEcomna estrutura de pastas./link_zonos/metadatae atribua-lhe o nomemetadata.zip. Nota: Inclua a própria pasta/metadatano arquivo zip.Importar o arquivo de metadados
Depois de preparar o
metadata.zip, importe-o para a sua sandbox SFCC:metadata.zipatravés da opção de carregamento Local.Este passo cria as preferências de site, os serviços, as credenciais e os objetos personalizados necessários para a integração da Zonos.
Adicionar o cartridge ao cartridge path
Adicione o cartridge
int_zonosao cartridge path do seu site para ativar os respetivos controladores, scripts e modelos:int_zonosno cartridge path antes do cartridge base da loja online SFRA (app_storefront_base).Configurar aliases de pipeline
O cartridge inclui 2 pipelines personalizados aos quais devem ser adicionados aliases de pipeline no Business Manager:
Zonos-OrderConfirmation
Este pipeline é utilizado para a confirmação personalizada da encomenda no SFCC, depois de a encomenda ser concluída no checkout da Zonos. O utilizador será redirecionado para aqui. Por exemplo, o alias pode ser
zonos-order-confirmation. Selecione e adicione um alias adequado ao seu negócio, diferente do alias que utiliza para a página nativa de confirmação de encomenda do checkout SFCC/SFRA (COSummary-Submit).Zonos-PlaceSFCCOrder
Este pipeline é utilizado para o endpoint personalizado que cria a encomenda da Zonos no SFCC/SFRA, e assume-se que o alias é
zonos-placesfccorder. Se utilizar um alias diferente, terá de o anotar quando chegar à configuração do serviço. Este URL não é público, pelo que se recomenda utilizarzonos-placesfccorderna configuração inicial para facilitar a utilização deste cartridge.Para configurar estes dois aliases, no Business Manager, navegue até Merchant Tools > URL Rules > Pipeline URLs.
Configurar os serviços SFCC
Com a importação do site no passo 2, foram criados dois serviços SFCC (com os respetivos perfis e credenciais):
zonos.api.graphqlecreate.order.api.sfra.Configuração de site único
Se a sua organização tiver um único site de loja online na sua organização SFCC, não há mais nada a fazer aqui e pode avançar para o passo seguinte.
Configuração de vários sites
Se a sua organização tiver, ou planear ter, vários sites de loja online na sua organização SFCC, terá de atualizar ou acrescentar serviços SFCC. Quando tiver vários sites SFCC que vão utilizar a integração da Zonos, precisará de um serviço de API de criação de encomendas para cada site. Para cada site, faça o seguinte:
create.order.api.[siteID].https://[Sandbox Host]/s/[Site ID]/Zonos-PlaceSFCCOrder(por exemplo:https://wxyz-001.dx.commercecloud.salesforce.com/s/RefArch/zonos-placesfccorder).create.order.api.[siteID]e atribua-lhe o perfilcreate.order.apie a credencialcreate.order.api.[siteID]que criou no passo 1.No final, deverá ter um serviço de API de criação de encomendas para cada um dos seus sites.
Configurar as preferências de site personalizadas da Zonos
No Business Manager, navegue até Merchant Tools > Site Preferences > Custom Preferences e clique no grupo de preferências zonos para aceder às preferências de site personalizadas da Zonos.
Defina as seguintes preferências de site para o(s) seu(s) site(s):
https://cdn.jsdelivr.net/npm/@zonos/elements/dist/scripts/loadZonos.js).ZONOS. Este novo ID de método de pagamento é também o valor predefinido desta preferência de site personalizada. Se preferir associar um método de pagamento diferente às encomendas da Zonos, pode alterar este valor para o ID de qualquer Payment Method válido configurado no Business Manager.X$7eo$33B!z={"administrativeArea": "Pennsylvania", "administrativeAreaCode": "PA", "countryCode": "US", "line1": "975 S Tech Ridge Dr", "line2": "", "locality": "Harrisburg", "postalCode": "17025"}6109.10).Configurar métodos de envio
Durante o Zonos Modal Checkout, os compradores selecionam métodos de envio definidos no seu Zonos Dashboard. Quando estas encomendas são importadas para o SFCC, os respetivos métodos de envio têm de corresponder a um método de envio válido do SFCC. Para o permitir:
Mapeamento de métodos de envio
Sob a forma de um objeto JSON, o mapeamento de métodos de envio associa o(s) seu(s) método(s) de envio da Zonos ao(s) seu(s) método(s) de envio do SFCC. Este mapeamento tem de ter um registo de mapeamento para todos os métodos de envio da Zonos (níveis de serviço) que possam ser selecionados no seu checkout da Zonos. É altamente recomendado que inclua também um registo de mapeamento
default, que será utilizado nos casos em que uma encomenda da Zonos é feita com um método de envio para o qual não existe mapeamento para um método de envio do SFCC, evitando assim falhas a jusante causadas pela ausência de método de envio na encomenda do SFCC.O formato do objeto JSON é:
{ "[Zonos Shipping Service Level Code]": "[SFCC Shipping Method ID]", ... "default": "[Default SFCC Shipping Method ID]" }Exemplo
Suponha que ativou os seguintes níveis de serviço no seu Zonos Dashboard:
Por qualquer motivo (por exemplo, requisitos de backoffice, uma integração adicional com um serviço de envio de terceiros, etc.), poderá estar limitado aos seguintes métodos de envio no SFCC para o seu site:
Quando uma nova encomenda da Zonos é recebida e depois colocada no SFCC, o método de envio tem de pertencer a esta lista.
Para criar o seu mapeamento, inicie sessão no seu Zonos Dashboard, aceda a Shipping > Manage Rates e clique em cada um dos Enabled service levels apresentados, onde verá um ecrã semelhante ao seguinte:
Em cada um, clique em Edit details para obter (ou definir) o código do nível de serviço de envio da Zonos (ver abaixo).
Com o código do nível de serviço de envio, crie um registo de mapeamento que o associe ao método de envio do SFCC que pretende que apareça nas suas encomendas do SFCC quando esse nível de serviço de envio (método de envio da Zonos) for escolhido no checkout da Zonos.
Depois de adicionar um registo para cada código de nível de serviço de envio ativado, bem como um mapeamento de método de envio
default, o 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" }Configurar as tarefas
A instalação inclui duas tarefas (jobs) do SFCC para suportar a integração da Zonos:
CreateOrdersFromZonos
Esta tarefa procura referências de encomendas da Zonos recém-criadas no armazenamento de objetos personalizados
zonosOrders, obtém da Zonos os detalhes completos das encomendas e cria as encomendas correspondentes no SFCC.Agendamento: Pode agendar esta tarefa de acordo com as necessidades do seu negócio, mas, normalmente, deve ser configurada para ser executada em intervalos, com relativa frequência (ou seja, a cada 5-10 minutos), todos os dias da semana.
Parâmetros personalizados: A tarefa
CreateOrdersFromZonosnão inclui parâmetros personalizados.CreateMissingZonosOrders
Embora deva ser raro, é possível que, devido a circunstâncias imprevistas, existam encomendas feitas na Zonos que não chegam à sua instância SFCC através do processo normal. Por esse motivo, incluímos a tarefa
CreateMissingZonosOrders. Esta tarefa efetua uma verificação cruzada entre o histórico de encomendas da Zonos e o SFCC para identificar e importar eventuais encomendas em falta.Agendamento: Pode agendar esta tarefa de acordo com as necessidades do seu negócio, mas deve agendá-la para ser executada com menos frequência do que a tarefa
CreateOrdersFromZonos. Alguns aspetos a considerar ao definir a frequência de execução desta tarefa:CreateMissingZonosOrders, e que consideramos adequada para a maioria dos sites, é uma vez a cada 90 minutos.Parâmetros personalizados: Existem dois parâmetros personalizados associados ao passo da tarefa
CreateMissingZonosOrdersque deve definir:LookBackHourscomo2(horas). Valor predefinido (se nenhum valor for definido):220Configurar o Zonos Hello
O Zonos Hello disponibiliza funcionalidades de localização do lado do cliente, como seleção dinâmica de idioma, mensagens sobre direitos aduaneiros/impostos e conversão de moeda em linha. Depois de a Zonos ser ativada nas preferências de site, o Hello é carregado automaticamente na sua loja online através do script de cliente da Zonos.
Os scripts de cliente da Zonos são adicionados através de um remote include do SFCC 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.ismlSe o seu projeto substituir estes modelos em cartridges de prioridade mais elevada, certifique-se de que o remote include é adicionado às suas versões personalizadas:
<isinclude url="${URLUtils.url('Zonos-ClientScriptInclude', 'pageType', pdict.action)}"/>Saiba mais sobre o Zonos Hello.
Configurar a conversão de moeda
O Zonos Hello converte automaticamente os valores de preço apresentados na loja online para a moeda local do comprador. Para que isto funcione corretamente:
<p class="text-right sub-total zonos-price">${pdict.totals.subTotal}</p>Alterações ao código de apresentação de preços
O cartridge da Zonos inclui os seguintes modelos de sobreposição para os locais onde os preços são apresentados no site de arquitetura de referência, utilizando os nomes de classe
zonos-list-price,zonos-sales-priceezonos-priceatribuídos aos elementos HTML que contêm esses diferentes 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.ismlSe não existirem cartridges que contenham estes modelos configurados acima de
int_zonosno cartridge path, não são necessárias alterações ao código para que o Zonos Hello converta a moeda destas apresentações de preços no seu site. Se tiver versões personalizadas destes modelos num ou mais cartridges acima deint_zonosno cartridge path, terá de incluir um nome de classe exclusivo nos elementos HTML que envolvem os seus preços (como ilustrado acima) nesses modelos personalizados.Configurar a string de seletor dos elementos de preço
A string de seletor de moeda é um valor de string de seletor ao estilo jQuery utilizado pelo script da Zonos para identificar os elementos HTML que contêm valores de preço que devem receber atualizações de conversão de moeda. Este valor deve ser uma lista, delimitada por espaços, dos nomes de classe CSS e/ou IDs atribuídos aos elementos HTML que envolvem as apresentações de preços do seu site descritas no passo anterior, em que os nomes de classe têm o prefixo
.e os IDs têm o prefixo#(sem as aspas). Por exemplo, se o seu site utilizar os modelos de apresentação de preços incluídos no cartridge da Zonos, a string de seletor será.zonos-list-price .zonos-sales-price .zonos-price(sem as aspas).A string de seletor de moeda pode ser configurada através do seu Zonos Dashboard ou na preferência de site Currency Element Selector das suas preferências de site personalizadas da Zonos no Business Manager.
Saiba mais sobre a conversão de moeda do Zonos Hello.
Configurar o botão de checkout
A string de seletor do botão de checkout é um valor de string de seletor jQuery utilizado pelo script da Zonos para identificar os elementos HTML do seu site que funcionam como botões que, quando clicados, levam o cliente para o fluxo de checkout do seu site.
Quando os compradores clicam num botão de Checkout correspondente à string de seletor configurada, a Zonos interceta automaticamente a ação e abre o checkout modal.
A string de seletor do botão de checkout pode ser configurada através do seu Zonos Dashboard ou na preferência de site Place Order (Checkout) Button Selector das suas preferências de site personalizadas da Zonos no Business Manager.
Compreender a confirmação de encomenda e os objetos personalizados
Quando o utilizador conclui uma encomenda no checkout alojado pela Zonos, é redirecionado para um Pipeline personalizado que apresenta uma confirmação de encomenda no SFCC (
Zonos-OrderConfirmation). O principal modelo de apresentação desta confirmação de encomenda é/int_zonos/cartridge/templates/default/checkout/confirmation/zonosConfirmation.isml.Esta página de confirmação de encomenda utiliza o mesmo estilo da página nativa de confirmação de encomenda do SFCC/SFRA e partilha alguns ficheiros .isml com essa página. Poderá ser necessário atualizar o estilo para corresponder a quaisquer personalizações de estilo já feitas no site. Os modelos de apresentação base utilizados pelo modelo de confirmação de encomenda da Zonos incluem:
app_storefront_base\cartridge\templates\default\checkout\confirmation\confirmationDetails.ismlapp_storefront_base\cartridge\templates\default\checkout\shipping\shippingSummary.ismlint_zonos\cartridge\templates\default\checkout\billing\billingSummary.ismlapp_storefront_base\cartridge\templates\default\checkout\orderProductSummary.ismlapp_storefront_base\cartridge\templates\default\checkout\orderTotalSummary.ismlPara além de apresentar uma confirmação de encomenda ao utilizador, a função subjacente deste pipeline personalizado está relacionada com um novo tipo de objeto personalizado incluído na importação de dados,
zonosOrders. Quando a confirmação de encomenda é apresentada ao utilizador, o SFCC utiliza o ID da encomenda da Zonos apresentado no URL da confirmação e cria um objeto personalizado correspondente com o ID da encomenda da Zonos como Key Attribute do objeto personalizado. Este objeto é depois utilizado para colocar a encomenda no SFCC através da tarefaCreateOrdersFromZonos. Esta tarefa percorre todos os objetos personalizados do tipozonosOrderscomcreatedStatus = - None -. A tarefa executa algumas operações:Se os passos acima forem bem-sucedidos, o atributo
createdStatusdo objeto personalizado passa acreated, para que o objeto deixe de ser considerado. Se os passos acima não forem bem-sucedidos, o atributocreatedStatusdo objeto personalizado passa afailede é registada uma mensagem de erro no objeto, no atributoerrorResponse(Zonos) ousfccErrorResponse(SFCC), consoante o sistema que respondeu com o erro durante o processo.Se precisar de tentar colocar a encomenda novamente, basta repor o
createdStatusem- None -e a encomenda será considerada na próxima execução da tarefa.Ajustar as definições avançadas
Opcional—As definições seguintes são definições avançadas. Existem valores predefinidos, pelo que não é necessária qualquer ação. Se pretender fazer ajustes, siga estas orientações:
Criar fatura na importação
Definido como Yes por predefinição. A Zonos cria uma fatura aquando da importação da encomenda. Se optar por desativar esta funcionalidade, terá de criar a sua própria fatura e a Zonos colocará uma retenção para análise de fraude com o estado
zonos_hold. Assim que a retenção por fraude for levantada, repomos o estado anterior.Início de sessão do cliente
Definido como No por predefinição. Se pretender exigir uma conta para o checkout, mude para Yes. Terá também de aceder a Customer configuration > Login options e alterar Redirect Customer to Account Dashboard after Logging In para No.
Exportação de encomendas do SFCC
Se utiliza, ou planeia utilizar, a exportação de encomendas do SFCC (SFCC Order Export), certifique-se de que os atributos personalizados da Zonos atribuídos aos objetos Order e Product são incluídos nos seus ficheiros de exportação de encomendas do SFCC. Em Merchant Tools > Site Preferences > Orders, defina a versão do esquema de exportação de encomendas para a versão mais recente.
Testar a sua integração
Agora que configurou a sua conta e a sua aplicação, está pronto para testar a sua integração. Durante os testes, terá de ativar o Checkout e o Hello no SFCC. Para tal:
Depois de configurar as informações da sua conta Zonos nas preferências de site personalizadas e de definir o interruptor de funcionalidade Zonos Enabled como YES, pode testar as funcionalidades da Zonos na sua loja online 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 tiver o Canadá ativado:
https://abcd-001.dx.commercecloud.salesforce.com/on/demandware.store/Sites-RefArch-Site?zCountry=CASe ainda não estiver pronto para entrar em produção, lembre-se de voltar a mudar Zonos Enabled para No quando terminar os testes. Após concluir os testes, ative a Zonos seguindo os mesmos passos acima.
Se tiver dúvidas, contacte a nossa equipa de suporte. Se estiver a trabalhar com um gestor de projeto de Professional Services para a integração da sua conta, contacte-o para obter assistência.
Sincronização de números de seguimento
Os números de seguimento adicionados no SFCC são sincronizados automaticamente com a Zonos. No entanto, os números de seguimento adicionados no Zonos Dashboard não são sincronizados de volta com o SFCC. Se adicionar ou atualizar números de seguimento no Zonos Dashboard, terá também de os atualizar manualmente no SFCC Business Manager.
Saiba mais sobre as integrações que suportam a sincronização de números de seguimento.
Desinstalar o Checkout
A desinstalação do cartridge tem de ser efetuada por um programador SFCC experiente. Contacte a sua equipa de desenvolvimento SFCC ou o suporte da Zonos para obter assistência com a desinstalação.
Perguntas frequentes
Que informações de produto devo fornecer para obter a cotação mais precisa de direitos aduaneiros, impostos e custos de envio?
As informações de produto podem influenciar o montante de direitos aduaneiros e impostos devidos e o custo de envio. Quanto mais informações de produto fornecer à Zonos, mais precisa será a cotação devolvida. A Zonos consegue gerar uma cotação mesmo quando estas informações não estão disponíveis, mas recomenda que forneça os seguintes dados essenciais do produto para melhorar a precisão:
Saiba mais sobre as informações de produto por plataforma.
Esta página foi útil?