DOCS

Bigcommerce

/

Checkout para BigCommerce

Integre o plugin Checkout para BigCommerce.

Antes de integrar o Checkout, certifique-se de que ele funcionará como você espera. Quando você usa o Checkout:

  • O Zonos Hello identificará automaticamente os compradores internacionais com base na localização do endereço IP deles. Quando os clientes internacionais prosseguirem para o checkout, eles serão redirecionados para o Zonos Checkout para concluir o pedido.
  • No processo de checkout, forneceremos um custo total de landed cost, que inclui o envio (com base nas suas próprias tarifas de envio ou tarifas fixas), taxas, impostos e taxas do transportador. Ao coletar esses custos durante o checkout, seus clientes não precisarão pagar nada extra na entrega.
  • Seus clientes terão a conveniência de uma experiência semelhante à doméstica: completando o processo de checkout no idioma local deles, com campos de endereço adaptados ao país específico deles e a opção de pagar na moeda local. Os pedidos serão protegidos contra fraudes.
  • Você pode gerenciar facilmente seus pedidos internacionais tanto pelo BigCommerce quanto pelo Dashboard. Os números de rastreamento serão sincronizados entre as duas plataformas, garantindo um gerenciamento de pedidos tranquilo.
  • Os códigos promocionais do BigCommerce podem ser inseridos na página do carrinho e serão transferidos para o Checkout. Uma vez no Checkout, eles não podem ser editados. No entanto, podemos ocultar o campo de código promocional do BigCommerce na página do carrinho e, em vez disso, gerenciar seus códigos promocionais dentro do Dashboard. Crie códigos promocionais no Dashboard para seus clientes internacionais.

Integração 

Integre perfeitamente o Checkout com sua loja BigCommerce seguindo as etapas desta seção:

1

Comece

Comece completando nosso formulário de inscrição. O processo de integração começará assim que o acordo da sua conta estiver em vigor.

2

Integração

Dentro de 24 horas após a inscrição, um representante de integração dedicado entrará em contato com você para iniciar um processo de integração personalizado.

Importante: As etapas listadas abaixo são para sua referência e você será guiado por elas pelo seu representante de integração.

3

Instalar aplicativos

Tanto o Checkout quanto o Hello devem ser instalados para que o Checkout funcione corretamente, pois o Hello informará quando redirecionar os clientes internacionais para o nosso Checkout.

  1. Instale o aplicativo Checkout na BigCommerce Marketplace clicando em Obter este aplicativo.
  2. Instale o aplicativo Hello na BigCommerce Marketplace clicando em Obter este aplicativo.
4

Configurar o Checkout

Depois de instalar ambos os aplicativos, configure suas configurações:

  1. Dentro do seu backend do BigCommerce, vá para AplicativosMeus aplicativosZonos Checkout.
  2. Insira suas credenciais de integração para vincular suas configurações do Dashboard ao seu site BigCommerce.
    1. Copie o número da conta do Zonos do Dashboard e insira como seu ID da Loja.
    2. Copie a chave da API do Zonos do Dashboard e insira como seu Segredo da Loja.
  3. Ative o aplicativo em modo de teste ou ao vivo:
    1. Em Zonos Checkout, selecione Ativar.
    2. Em Modo de teste, selecione Ativar. Quando este modo estiver ativado, você deve adicionar ?zonos=true à URL para habilitar a funcionalidade do Zonos, permitindo que você teste o Zonos enquanto seus compradores ainda experimentam o fluxo nativo. Mude isso para Desativar quando estiver pronto para ir ao ar.
  4. Personalize nosso aplicativo para funcionar de acordo com as necessidades do seu site:
    1. Em Criar cliente na importação do pedido, selecione sua preferência.
    2. Em Reservar estoque do produto durante o checkout, selecione Ativar se deseja que o Zonos reserve o estoque do produto enquanto estiver em nosso Checkout. Saiba como isso funciona nas perguntas frequentes no final desta página.
    3. Em Mostrar provedor de pagamento como personalizado, selecione Ativado se deseja que todos os seus pedidos do Zonos mostrem Personalizado como o provedor de pagamento no BigCommerce.
  5. Clique em Atualizar configurações para salvar suas seleções.
5

Configurar o Hello

  1. Dentro do seu backend do BigCommerce, vá para AplicativosMeus aplicativosZonos Hello.
  2. Copie a chave da API do Hello do Dashboard e insira como sua Chave do Site.
  3. Ative o aplicativo Hello alterando Zonos Hello para ativar. O Hello pode ser ativado antes do Checkout e não redirecionará para o Zonos Checkout a menos que o Checkout também esteja ativado.
  4. Alterne Cotação de impostos e taxas para ativar.
  5. Se deseja que o Zonos aproveite a conversão de moeda do BigCommerce, alterne Conversão de moeda para ativar. Isso permitirá que o Hello habilite moedas para você em ConfiguraçõesMoedas. Verifique suas configurações de moeda lá para garantir que os pagamentos sejam feitos na moeda de sua preferência.
  6. Clique em Atualizar configurações para salvar suas seleções.
6

Adicionar informações de produto ausentes

Versões do BigCommerce anteriores à V3 têm limitações com os dados que passam para Zonos para cotações de landed cost. Saiba quais informações de produto Zonos recebe de cada versão do BigCommerce e quando você deve usar o Zonos Catalog para adicionar informações específicas do produto necessárias para nossos cálculos.

Informações opcionais do produto

Informações específicas do produto não são necessárias para que o Zonos retorne uma cotação. Zonos pode usar os padrões da sua conta para códigos HS e país de origem, estimar o peso com um fator personalizado e cotar sem dimensões. No entanto, quanto mais informações específicas do produto forem fornecidas, mais precisos serão nossos cálculos.

Informações do produto passadas pelo BigCommerce

  • Pesos
  • Dimensões
  • Códigos HS*
  • País de origem*

*Importa apenas se estiver usando a experiência de produto BigCommerce V3

Se você não estiver usando o BigCommerce V3, adicione seus produtos com seus códigos HS e país de origem ao Catalog. Saiba como usar o Catalog.

Se você adicionar peso, dimensões, código(s) HS ou país de origem ao Catalog, o Catalog sempre usará esses campos. Se qualquer informação estiver presente tanto na sua plataforma de ecommerce quanto no Catalog, a informação no Catalog substituirá a informação enviada pela plataforma de ecommerce ao executar nossos cálculos. Por exemplo, suponha que o peso de um produto esteja presente no Shopify e no Catalog. Nesse caso, Zonos usará o peso no Catalog para calcular o envio.

7

Teste sua integração

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

  1. Dentro do seu backend do BigCommerce, vá para AppsMy appsZonos Hello.
  2. Mude Zonos Hello para enable.
  3. Em seguida, vá para AppsMy appsZonos Checkout.
  4. Em Zonos Checkout, selecione Enable.
  5. Em Test mode, selecione Enable.

Quando este modo estiver habilitado, você deve adicionar ?zonos=true ao URL para habilitar a funcionalidade do Zonos, permitindo que você teste o Zonos enquanto seus clientes ainda experimentam seu fluxo nativo.

Após concluir os testes, habilite o Zonos definindo Test mode como Disable.

Algumas coisas para lembrar:

  • De minimis—Se o subtotal do carrinho do seu pedido estiver abaixo do De minimis do país de destino, pode não haver nenhum imposto ou taxa devida. Isso é refletido em nossos cálculos.
  • Reembolsos e cancelamentos—Estamos coletando o pagamento, então se você precisar fazer reembolsos ou cancelamentos, por favor, processe-os no Dashboard.
  • Etiquetas—Imprima etiquetas para todos os pedidos internacionais no Dashboard, a menos que você tenha sido certificado para imprimir etiquetas fora do Dashboard. Isso nos permite pagar os impostos e taxas em seu nome.

Nota: Se você precisar que façamos ajustes, entre em contato com o suporte do Zonos para assistência.

Opções avançadas de configuração 

Ocultar elementos domésticos

Se você tiver elementos que precisa ocultar apenas para usuários internacionais, por exemplo, provedores de pagamento apenas para os EUA, estimadores de envio, banners com mensagens apenas para os EUA, etc., use os próximos passos para ocultá-los quando o país do Zonos Hello for internacional. Para corrigir isso, vá para BigCommerce Admin Panel -> Storefront -> Script Manager -> Create Script.

Para ocultar os elementos domésticos, siga os passos abaixo:

  1. Vá para BigCommerce Storefront -> Script Manager -> Create Script.

  2. Crie um novo script personalizado para Zonos usando o seguinte:

    1. Nome do script: Zonos Custom - [nome relevante do script]
    2. Descrição: [O que este script faz]
    3. Colocação: Rodapé
    4. Localização: Todas as páginas
    5. Categoria do script: Essencial
    6. Tipo de script: Script
    7. Conteúdo do script: Copie o seguinte e cole no conteúdo do script.
  3. No script abaixo, edite os seletores em var domesticElements = fazendo o seguinte:

    1. Encontre os seletores de elementos que você deseja ocultar para usuários internacionais no seu site atual do BigCommerce.
    2. Depois de obter esses seletores, adicione-os onde diz .hide-me.
    3. Certifique-se de cercar cada seletor com aspas e separá-los por uma vírgula, veja o exemplo a seguir: [".hide-1", ".hide-2", ".hide-3", ".hide-4"]
    4. Quando o script estiver pronto e salvo, teste indo para a página onde os elementos foram ocultados e alterne o país do Zonos Hello de EUA para internacional e de volta para EUA. Esses elementos devem ser ocultados quando um país internacional for selecionado.

Zonos integration script

1
2
3
4
5
6
7
8
9
10
11
12
13
<script>
  var domesticElements = ['.hide-me'];

  let cssElement = document.createElement('style'),
    sheet;
  document.head.appendChild(cssElement);
  sheet = cssElement.sheet;
  let count = 0;
  for (let domesticHide of domesticElements) {
    sheet.insertRule(`.z-intl ${domesticHide} { display:none; }`, count);
    count++;
  }
</script>

Solução de problemas 

Botões de Checkout não estão redirecionando

Se o Zonos Checkout estiver em modo de teste ou configurado como ao vivo (e os botões de checkout não estiverem redirecionando para o Zonos), pode ser devido aos seletores dos botões de checkout. Nosso aplicativo Zonos Checkout usa uma lista definida de seletores padrão de botões de checkout. Se um usuário internacional não estiver sendo redirecionado, esses seletores podem precisar ser ajustados.

Para corrigir esse problema, siga as etapas abaixo:

  1. Acesse o Painel de Administração do BigCommerce -> Loja -> Gerenciador de Scripts -> Criar Script.

  2. Crie um novo script personalizado para o Zonos usando o seguinte:

    1. Nome: Zonos Personalizado - [nome relevante do script]
    2. Descrição: [O que este script faz]
    3. Local na página: Rodapé
    4. Selecionar páginas onde o script será adicionado: Todas as páginas
    5. Conteúdo do script: Copie o seguinte e cole no conteúdo do script.
  3. Depois de inserir o código abaixo no conteúdo do script, você precisará ajustar um dos seletores para corresponder aos seus botões de checkout atuais ou adicionar um novo seletor à lista.

  4. Certifique-se de salvar este novo script e testar o site.

Zonos script de integração

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
<script>
  window.onload = () => {
    selectors = {
      '.previewCartCheckout .button--primary': 'checkout',
      '.cart-actions .button--primary': 'Check out',
      '.previewCartAction-checkout': 'Check out now',
      '.ProceedToCheckout .btn': 'Proceed To Checkout',
      '.CheckoutLink': 'Checkout',
      '.button--primary': 'Checkout',
      '.button-checkout': 'Checkout',
      '.btn': 'Proceed To Checkout',
      '.CheckoutButton': 'Proceed To Checkout',
    };
    for (let key in selectors) {
      let button = contains(key, selectors[key]);
      for (i = 0; i < button.length; i++) {
        button[i].addEventListener('click', function (e) {
          zonosCheckout(e);
        });
      }
    }
  };
</script>

Perguntas frequentes 

Como faço para saber se estou no tema Stencil?

Para determinar se está a utilizar o tema Stencil, no Painel de Administração do BigCommerce, se a opção Storefront -> Footer Scripts estiver disponível, significa que a sua loja está a utilizar um tema Stencil.

Que informações do produto devo fornecer para obter a cotação mais precisa sobre taxas, impostos e custos de envio?

As informações do produto podem impactar a quantidade de taxas e impostos devidos, bem como o custo de envio. Quanto mais informações do produto você fornecer para o Zonos, mais precisa será a cotação retornada. O Zonos pode gerar uma cotação mesmo quando essas informações não estão disponíveis, mas recomenda fornecer os seguintes detalhes-chave do produto para melhorar a precisão:

  • Peso: O peso impacta o custo de envio, o que pode afetar as taxas ou impostos. Os pesos nas listagens de produtos do BigCommerce são automaticamente utilizados pelo Zonos quando presentes.
  • Dimensões: As dimensões podem impactar o custo de envio, o que pode afetar as taxas ou impostos. O Zonos pode utilizar as dimensões do produto (comprimento, largura e altura) definidas em cada produto no BigCommerce.
  • Códigos HS: Os códigos HS impactam as taxas de imposto e às vezes afetam os impostos. O BigCommerce não pode enviar códigos HS para o Zonos, portanto, eles devem ser adicionados usando o Catálogo do Zonos. Se estiver a utilizar a experiência de produto BigCommerce V3, os códigos HS são recebidos.
  • País de origem: O país de origem de um produto impacta as taxas de imposto e pode afetar os impostos. O BigCommerce não pode enviar códigos HS para o Zonos, portanto, eles devem ser adicionados usando o Catálogo do Zonos. Se estiver a utilizar a experiência de produto BigCommerce V3, o país de origem é recebido.

Detalhes do produto passados para o Zonos pelo BigCommerce

Detalhes do produtoPesosDimensõesCódigo HSPaís de origem
Passados automaticamente
Adicionar com Catálogo

Detalhes do produto passados para o Zonos pelo BigCommerce V3

Detalhes do produtoPesosDimensõesCódigo HSPaís de origem
Passados automaticamente

Nota: Alternativamente, você pode inserir qualquer uma das informações acima no Catálogo, substituindo as informações armazenadas e passadas pelo BigCommerce.

Saiba mais sobre informações do produto por plataforma.

Esta página foi útil?