Lista de verificação de integração
Siga esta lista de verificação abrangente para configurar sua conta Zonos Dashboard e integrar a extensão Zonos Checkout para WooCommerce.
Crie uma conta Zonos
Para começar, entre em contato com nossa equipe de vendas para criar uma conta e assinar um contrato. Assim que o contrato for assinado, você receberá dois microdepósitos em sua conta que precisam ser verificados.
Envie esses valores de microdepósito por e-mail para accounting@zonos.com com seu ID de loja Dashboard (coloque em CC seu representante de vendas).
Depois de verificados, seus dados bancários serão exibidos em Dashboard -> Configurações -> Faturamento.
Definir configurações Dashboard e Checkout
Depois de criar sua conta Zonos, você precisará definir as configurações em Dashboard para garantir que Checkout funcione corretamente com sua loja. Esta seção cobre todas as configurações essenciais do Dashboard.
Configurar pagamentos
Conecte uma conta bancária para receber pagamentos pontuais de Checkout. Os pagamentos são processados diariamente com um atraso de 2 dias a partir do pagamento capturado. Para fazer isso, siga estas etapas:
- Navegue até Dashboard -> Configurações -> Configurações do Checkout .
- Clique em Adicionar conta bancária.
- Você será direcionado a um portal Stripe para concluir a configuração e fornecer as seguintes informações:
- Informações da conta bancária.
- Empresa EIN.
- Número de Segurança Social de proprietário de 25% da empresa. Para obter mais detalhes sobre por que isso é necessário, consulte a documentação do Stripe.
Observação: Se você precisar atualizar sua programação de pagamentos, entre em contato com support@zonos.com
Configure domínios permitidos
Zonos Checkout requer uma lista de domínios permitidos para fins de segurança. Isso evita que sites não autorizados carreguem Checkout e garante que ele seja executado apenas em domínios aprovados. Sem esta configuração, Checkout retornará erros de permissão.
Para configurar isso:
- Navegue até Dashboard -> Configurações -> Configurações do Checkout.
- Em URLs, adicione seu domínio completo e quaisquer subdomínios onde Checkout será usado. Por exemplo, se o seu domínio for
example.com, você deverá adicionarexample.cometest.example.com.
Personalize as configurações da marca
Defina as configurações de sua marca em Dashboard para combinar com a aparência da sua loja.
Para fazer isso, siga estas etapas:
- Navegue até Dashboard -> Configurações -> Configurações do Checkout -> Marca
- Defina as seguintes configurações:
- Logotipo.
- Marca e cor de destaque.
- Tema, estilo e fonte.
Para obter mais informações sobre configurações de marca, consulte nossa documentação.
Conecte uma transportadora
Para cotar o frete na finalização da compra, você precisará conectar uma transportadora à sua conta Zonos. Isso permitirá que você habilite níveis de serviço de remessa específicos na finalização da compra.
Para conectar uma transportadora, siga estas etapas:
- Navegue até Dashboard -> Configurações -> Envio -> Rates.
- Clique em Adicionar transportadora.
- Siga as instruções de configuração da transportadora.
Para obter mais detalhes sobre como conectar contas de transportadoras, consulte nossa documentação.
Configurar zonas de envio
As zonas de envio permitem configurar quais transportadoras e níveis de serviço estão disponíveis para diferentes regiões do mundo.
Para configurar zonas de envio, siga estas etapas:
- Navegue até Dashboard -> Configurações -> Envio -> Locais.
- Clique em Nova zona.
- Insira um nome de zona e selecione os países para os quais deseja enviar.
- Selecione a transportadora e o nível de serviço que deseja oferecer.
Para obter mais detalhes sobre zonas de envio, consulte nossa documentação.
Configure um país de origem alternativo e um código HS
O país de origem e o código HS são usados para calcular taxas e impostos precisos.
Se você não fornecer um país de origem ou código HS específico, usaremos os substitutos configurados em Dashboard.
Para definir seu país de origem e código HS substituto:
- Navegue até Dashboard -> Configurações -> Envio -> Catálogo.
- Para o país de origem, selecione o país onde a maioria dos seus produtos é fabricada.
- Para o código HS, insira o código HS do seu produto mais comum. Se você não tiver um código HS, navegue até Classify em Dashboard e insira o nome e a descrição do seu produto para gerar um código HS preciso.
Instale e configure a extensão Checkout para WooCommerce
Siga estas etapas para instalar e configurar a extensão Checkout para WooCommerce.
Instale a extensão
- Faça login no administrador do WordPress.
- Em plug-ins, pesquise Zonos Checkout para extensão WooCommerce.
- Clique em Instalar e ativar.
Conecte a extensão à sua conta Zonos
-
No administrador do WordPress, clique na extensão Zonos Checkout na navegação à esquerda.
-
Clique em Configurações Gerais.
-
Insira sua chave de API privada e ID da loja para vincular suas configurações Zonos Dashboard ao seu site WooCommerce.
-
Localize a chave API privada da sua loja em Dashboard. Existem algumas chaves de API diferentes disponíveis. Selecione a chave de API que tem o nome da sua loja, o Tipo é Segredo e Token começa com
credential_live. Insira esta chave de API no campo Chave de API privada em Configurações gerais da extensão. -
Copie seu ID da loja de Dashboard e insira-o no campo ID da loja em Configurações gerais da extensão.
-
-
Habilite o aplicativo em modo de teste.
- Por padrão, Modo de teste está ativado. Quando o modo de teste estiver ativado, os compradores não serão direcionados para Zonos Checkout.
Configure seu botão de checkout internacional
Você tem duas opções para configurar como os compradores internacionais acessam Zonos Checkout.
Use seu botão de finalização de compra atual para compradores nacionais e internacionais:
Configure seu botão de checkout atual para redirecionar automaticamente os compradores internacionais para Zonos Checkout enquanto mantém os compradores nacionais em seu fluxo de checkout padrão. Para fazer isso, siga estas etapas:
- Em Configurações gerais da extensão, insira o seletor CSS do botão de checkout (por exemplo,
#checkout-buttonou.woocommerce-checkout-button). - Clique em Salvar configurações gerais.
Para encontrar seu seletor CSS, clique com o botão direito no botão de checkout, selecione "Inspecionar" e procure o atributo id ou class no HTML. Se você tiver vários botões de checkout, inclua o seletor CSS de cada botão ou configure todos os botões para redirecionar para a página do carrinho e use o seletor de botão de checkout da página do carrinho.
Adicione um botão de checkout internacional dedicado
Crie um botão de checkout internacional dedicado, ideal se você tiver muitos usuários de VPN ou compradores residentes nos EUA que precisam enviar para um endereço internacional.
Para criar um botão separado para compradores internacionais:
-
Em Configurações gerais da extensão, insira o seletor CSS do botão de checkout (por exemplo,
#checkout-buttonou.woocommerce-checkout-button). -
Alterne o botão de checkout internacional para a direita.
-
Configure a aparência do botão:
- Insira o texto do botão (por exemplo, "Checkout Internacional" ou "Global Checkout").
- (Opcional) Adicione CSS personalizado para combinar com o design da sua loja, conforme mostrado no exemplo abaixo. Se nenhum CSS personalizado for fornecido, o botão usará como padrão o esquema de cores primário da sua loja. Recomendamos testar a aparência do botão em computadores e dispositivos móveis.
-
Clique em Salvar configurações gerais.
Ativar os EUA nas zonas de envio: Quando ativado, o botão de checkout internacional dedicado aparecerá para todos os compradores. Para permitir que compradores baseados nos EUA usem checkout internacional (por exemplo, ao usar uma VPN ou enviar para um endereço internacional), você deve ativar os EUA em Zonas de envio em Dashboard. Sem esta configuração, os compradores dos EUA não serão redirecionados para Zonos Checkout.
Mapear configurações do WooCommerce
Personalize Zonos para integrar-se perfeitamente à sua loja WooCommerce, garantindo cálculos precisos de taxas, impostos e frete. Use a guia Configurações de mapeamento para alinhar detalhes e atributos do produto com sua configuração de comércio eletrônico. Embora sejam fornecidos valores padrão, você pode definir essas configurações para atender aos requisitos exclusivos da sua loja.
Detalhes do produto, detalhes personalizados, peso e dimensões
Esses campos são mapeados para valores comuns padrão. Os valores marcados com um asterisco (*) são obrigatórios. Se você usar um aplicativo de terceiros que substitua quaisquer campos (*), certifique-se de que esses campos (*) estejam mapeados corretamente para os valores que o aplicativo de terceiros usa.
Atributos do produto
Se seus produtos tiverem atributos exclusivos, como cor ou tamanho, aplicados a variações, você precisará mapear esses atributos na extensão Zonos. Isso garante que, quando um pedido for atendido, sua loja WooCommerce e seu estoque sejam atualizados com o produto correto que foi enviado. Para mapear atributos, siga as etapas descritas em nossa documentação de mapeamento de atributos de produtos WooCommerce.
Observação: Se você tiver dúvidas ou precisar de ajuda para mapear variações de produtos, entre em contato com support@zonos.com.
Teste sua integração
Agora que configurou sua conta e seu aplicativo, você está pronto para testar sua integração.
Para fazer um pedido de teste na finalização da compra:
- Adicione
?zonosTestMode=1ao URL da sua loja para ser direcionado para Zonos Checkout. - Mude Zonos Hello para o país que você gostaria de testar clicando na bandeira Hello e selecionando o país que você gostaria de testar. Isso é necessário, caso contrário você não será redirecionado para Zonos Checkout se estiver usando um único botão de checkout. Você pode atualizar Hello alterando zCountry= na URL para qualquer país que você gostaria de testar. Por exemplo, se você quisesse testar o Canadá, você inseriria CA em zCountry=CA.
- Execute o processo de finalização da compra e faça um pedido. Consulte nossa documentação geral de testes para obter mais detalhes.
- Após concluir o teste, ative Zonos alternando Modo de teste para desligado. Isso ativará sua integração e permitirá que compradores internacionais usem Zonos Checkout.
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 quaisquer taxas ou impostos devidos. Isso se reflete em nossos cálculos.
- Reembolsos e cancelamentos—Estamos cobrando o pagamento, então se você precisar fazer algum reembolso ou cancelamento, processe-o em Dashboard.
- Etiquetas—Imprima etiquetas para todos os pedidos internacionais em Dashboard, a menos que você tenha sido certificado para imprimir etiquetas fora de Dashboard. Isto é necessário para que Zonos possa pagar as taxas e impostos em seu nome.
Pós-integração
Sua extensão Zonos importará automaticamente pedidos de Zonos para WooCommerce. No entanto, pode haver casos raros em que um pedido não pode ser importado ou o status de um pedido no WooCommerce não está sincronizado com Dashboard. Você pode usar os seguintes recursos da extensão para importar pedidos, sincronizar status de pedidos manualmente e ativar configurações avançadas para solucionar problemas.
Importar pedidos manualmente
Se um pedido Zonos não foi importado para o WooCommerce, você pode usar a guia Importação de pedido para importar pedidos manualmente para o WooCommerce:
- Faça login em Dashboard.
- Navegue até Pedidos.
- Clique no pedido que precisa ser importado e copie o Número do pedido Zonos.
- No WordPress Admin, navegue até a guia Importação de pedido na extensão Zonos e insira o número do pedido Zonos no campo Número do pedido Zonos.
- Clique em Importar pedido. Se o pedido foi importado com sucesso, ele será exibido no WooCommerce e você verá o banner “Pedido importado com sucesso” na parte superior da página. Se o pedido não foi importado, você verá um banner com os detalhes da mensagem de erro.
Sincronizar pedidos manualmente
Se o status de um pedido no WooCommerce não corresponder ao status em Zonos, você poderá sincronizar o pedido manualmente.
- Faça login em Dashboard.
- Navegue até Pedidos.
- Clique no pedido que precisa ser importado e copie o Número do pedido Zonos.
- No WordPress Admin, navegue até a guia Sincronização de pedido na extensão Zonos e insira o número do pedido Zonos no campo Número do pedido Zonos.
- Clique em Sincronizar pedido. O status do pedido no WooCommerce agora deve corresponder ao status do pedido em Dashboard.
Configurações avançadas
Modo de depuração
Ative o Modo de depuração para enviar Zonos logs detalhados para ajudá-lo a diagnosticar quaisquer problemas e melhorar o desempenho de sua integração.
Rate limite
Número máximo de solicitações de webhook permitidas por endereço IP por minuto. O padrão é 30 para proteção contra possíveis abusos.
Solução de problemas comuns
Se você usar um aplicativo de cache como o WP Rockett, precisará limpar o cache ao fazer alterações na extensão Zonos.
Perguntas frequentes
Quais informações do produto devo fornecer para obter uma cotação mais precisa sobre taxas, impostos e custos de envio?
As informações do produto podem afetar o valor das taxas e impostos devidos e o custo total de envio. Quanto mais informações do produto você fornecer a 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 WooCommerce são usados automaticamente por Zonos quando mapeados. Você também pode adicionar peso a Catálogo em Dashboard para garantir cálculos de envio precisos.
- Dimensões: As dimensões são usadas para calcular o peso dimensional. As transportadoras cobrarão o peso que for maior entre o peso físico e o peso dimensional. Zonos pode utilizar as dimensões do produto (comprimento, largura e altura) definidas em cada produto no WooCommerce para calcular o peso dimensional e garantir que você receba a quantidade correta de remessa de seus clientes. Você também pode adicionar dimensões ao Catálogo em Dashboard para garantir cálculos de envio precisos.
- Códigos HS: Os códigos HS impactam as taxas de impostos e às vezes podem afetar os impostos. Você pode mapear valores de código HS no WooCommerce ou usar Catálogo em Dashboard.
- País de origem: O país de origem de um produto impacta as taxas de impostos e pode afetar os impostos. Você pode mapear os valores do país de origem no WooCommerce ou usar Catálogo em Dashboard.
Zonos Checkout para WooCommerce
Integre a extensão Checkout para WooCommerce.