Lista de verificação de integração
Siga esta lista de verificação abrangente para configurar sua conta do Zonos Dashboard e integrar a extensão Zonos Checkout para WooCommerce.
Crie uma conta Zonos
Para começar, por favor 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 micro depósitos em sua conta que precisam ser verificados.
Por favor, envie esses valores de micro depósito para accounting@zonos.com com seu ID de loja do Dashboard (CC seu representante de vendas).
Uma vez verificado, seus dados bancários serão exibidos em Dashboard -> Configurações -> Faturamento.
Configure as configurações do Dashboard e do Checkout
Após criar sua conta Zonos, você precisará configurar as configurações no Dashboard para garantir que o Checkout funcione corretamente com sua loja. Esta seção cobre todas as configurações essenciais do Dashboard.
Configure os pagamentos
Conecte uma conta bancária para receber pagamentos pontuais do 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.
- EIN da empresa.
- Número de Seguro Social de um proprietário da empresa com 25%. Para mais detalhes sobre por que isso é necessário, consulte a documentação do Stripe.
Nota: Se você precisar atualizar seu cronograma de pagamentos, entre em contato com support@zonos.com
Configure os domínios permitidos
Zonos Checkout requer uma lista de domínios permitidos por motivos de segurança. Isso impede que sites não autorizados carreguem o Checkout e garante que ele funcione apenas em seus domínios aprovados. Sem essa configuração, 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 o Checkout será usado. Por exemplo, se seu domínio for
example.com
, você deve adicionarexample.com
etest.example.com
.
Personalize as configurações de marca
Configure suas configurações de marca no Dashboard para combinar com a aparência e a sensação da sua loja.
Para fazer isso, siga estas etapas:
- Navegue até Dashboard -> Configurações -> configurações do Checkout -> Marca
- Configure as seguintes configurações:
- Logo.
- Cor da marca e cor de destaque.
- Tema, Estilo e Fonte.
Para mais informações sobre as configurações de marca, consulte nossa documentação.
Conecte um transportadora
Para cotar o frete no checkout, você precisará conectar uma transportadora à sua conta Zonos. Isso permitirá que você habilite níveis de serviço de frete específicos no checkout.
Para conectar uma transportadora, siga estas etapas:
- Navegue até Dashboard -> Configurações -> Frete -> Taxas.
- Clique em Adicionar transportadora.
- Siga as instruções de configuração da transportadora.
Para mais detalhes sobre como conectar contas de transportadoras, consulte nossa documentação.
Configure zonas de frete
As zonas de frete permitem que você configure quais transportadoras e níveis de serviço estão disponíveis para diferentes regiões do mundo.
Para configurar zonas de frete, siga estas etapas:
- Navegue até Dashboard -> Configurações -> Frete -> Localizações.
- 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 mais detalhes sobre zonas de frete, consulte nossa documentação.
Configure um país de origem e código HS de fallback
O país de origem e o código HS são usados para calcular direitos e impostos precisos.
Se você não fornecer um país de origem específico ou código HS, usaremos os fallbacks configurados no Dashboard.
Para definir seu país de origem e código HS de fallback:
- Navegue até Dashboard -> Configurações -> Frete -> Catálogo.
- Para o país de origem, selecione o país onde a maioria de 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 no Dashboard e insira o nome e a descrição do seu produto para gerar um código HS preciso.
Instalar e configurar a extensão de Checkout para WooCommerce
Siga estes passos para instalar e configurar a extensão de Checkout para WooCommerce.
Instalar a extensão
- Faça login no seu administrador do WordPress.
- Em plugins, procure por Zonos Checkout para extensão WooCommerce.
- Clique em Instalar e ativar.
Conectar a extensão à sua conta Zonos
-
No seu Administrador do WordPress, clique em Extensão Zonos Checkout na navegação à esquerda.
-
Clique em Configurações Gerais.
-
Insira sua Chave da API Privada e ID da Loja para vincular suas configurações do Painel Zonos ao seu site WooCommerce.
-
Localize a chave da API privada da sua loja em Painel. Existem algumas chaves de API diferentes disponíveis. Selecione a chave da API que tenha o nome da sua loja, o Tipo seja Secret, e o Token comece com
credential_live
. Insira esta chave da API no campo Chave da API Privada nas Configurações Gerais da extensão. -
Copie seu ID da Loja do Painel e insira-o no campo ID da Loja nas Configurações Gerais da extensão.
-
-
Ative o aplicativo no modo de teste.
- Por padrão, o Modo de Teste está ativado. Quando o modo de teste está habilitado, os compradores não serão direcionados para o Zonos Checkout.
Configurar o seu botão de checkout internacional
Você tem duas opções para configurar como os compradores internacionais acessam o Zonos Checkout.
Usar o seu botão de checkout atual para compradores domésticos e internacionais:
Configure o seu botão de checkout atual para redirecionar automaticamente os compradores internacionais para o Zonos Checkout mantendo os compradores domésticos no fluxo padrão de checkout. Para fazer isso, siga estes passos:
- Nas Configurações Gerais da extensão, insira o seletor CSS do seu botão de checkout (por exemplo,
#checkout-button
ou.woocommerce-checkout-button
). - Clique em Salvar configurações gerais.
Para encontrar o seu seletor CSS, clique com o botão direito no seu botão de checkout, selecione "Inspecionar" e procure pelo 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 do botão de checkout da página do carrinho.
Adicionar um botão dedicado de checkout internacional
Crie um botão dedicado de checkout internacional, o que é ideal se você tem muitos usuários de VPN ou compradores baseados nos EUA que precisam enviar para um endereço internacional.
Para criar um botão separado para compradores internacionais:
-
Nas Configurações Gerais da extensão, insira o seletor CSS do seu botão de checkout (por exemplo,
#checkout-button
ou.woocommerce-checkout-button
). -
Ative 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 Checkout" ou "Checkout 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 será padrão para o esquema de cores principal da sua loja. Recomendamos testar a aparência do botão em dispositivos desktop e móveis.
-
Clique em Salvar configurações gerais.
Ativar EUA nas Zonas de Envio: Quando ativado, o botão de checkout internacional dedicado aparecerá para todos os compradores. Para permitir que os compradores dos EUA usem o checkout internacional (por exemplo, ao usar uma VPN ou enviar para um endereço internacional), você deve ativar os EUA em Zonas de Envio no Painel. Sem essa configuração, os compradores dos EUA não serão redirecionados para o Zonos Checkout.
Mapear configurações do WooCommerce
Personalize Zonos para integrar perfeitamente com a sua loja WooCommerce, garantindo cálculos precisos de taxas, impostos e frete. Use a aba Configurações de Mapeamento para alinhar detalhes e atributos do produto com a configuração da sua loja de comércio eletrônico. Embora os valores padrão sejam fornecidos, você pode configurar 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 substitui quaisquer campos (*), certifique-se de que esses campos (*) sejam mapeados corretamente para os valores que o aplicativo de terceiros utiliza.
Atributos do produto
Se os seus produtos tiverem atributos únicos como cor ou tamanho aplicados a variações, você precisará mapear esses atributos na extensão de Zonos. Isso garante que, ao ser atendido um pedido, sua loja WooCommerce e inventário sejam atualizados com o produto correto que foi enviado. Para mapear atributos, siga os passos descritos em nossa documentação de mapeamento de atributos de produtos do WooCommerce.
Observação: Se 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 você configurou sua conta e seu aplicativo, está pronto para testar sua integração.
Para fazer um pedido de teste em checkout:
- Adicione
?zonosTestMode=1
à URL da sua loja para ser direcionado ao Zonos Checkout. - Altere 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 usar um único botão checkout. Você pode atualizar Hello alterando zCountry= na URL para qualquer país que você gostaria de testar. Por exemplo, se você quiser testar o Canadá, você deve inserir CA em zCountry=CA.
- Passe pelo processo de checkout e faça um pedido. Veja nossa documentação geral de testes para mais detalhes.
- Após concluir os testes, ative Zonos alternando Modo de teste para desligado. Isso tornará sua integração ativa 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 impostos ou taxas devidas. 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 isso 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 é necessário para que Zonos possa pagar os impostos e taxas em seu nome.
Pós-integração
Sua extensão Zonos importará automaticamente pedidos de Zonos para o WooCommerce. No entanto, podem ocorrer raras instâncias em que um pedido pode não ser importado ou um status de pedido no WooCommerce não está sincronizado com o Dashboard. Você pode usar os seguintes recursos na extensão para importar pedidos, sincronizar status de pedidos manualmente e habilitar 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 aba Importação de pedidos para importar pedidos manualmente para o WooCommerce:
- Faça login no Dashboard.
- Navegue até Pedidos.
- Clique no pedido que precisa ser importado e copie o número do pedido Zonos.
- No Admin do WordPress, navegue até a aba Importação de pedidos 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, o pedido aparecerá no WooCommerce e você verá um banner "Pedido importado com sucesso" na parte superior da página. Se o pedido falhar ao importar, você verá um banner com os detalhes da mensagem de erro.
Sincronizar pedidos manualmente
Se um status de pedido no WooCommerce não corresponder ao status em Zonos, você pode sincronizar o pedido manualmente.
- Faça login no Dashboard.
- Navegue até Pedidos.
- Clique no pedido que precisa ser importado e copie o número do pedido Zonos.
- No Admin do WordPress, navegue até a aba Sincronização de pedidos 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 no Dashboard.
Configurações avançadas
Modo de depuração
Ative o Modo de depuração para enviar logs detalhados do Zonos para ajudá-lo a diagnosticar quaisquer problemas e melhorar o desempenho de sua integração.
Limite de Rate
Número máximo de solicitações de webhook permitidas por endereço IP por minuto. O padrão é 30 para proteger contra possíveis abusos.
Solução de problemas comuns
Se você usar um aplicativo de cache como o WP Rockett, precisará clear seu cache quando fizer alterações em sua Extensão Zonos.
Perguntas frequentes
Que informações do produto devo fornecer para obter a cotação mais precisa sobre impostos, taxas e custos de envio?
As informações do produto podem impactar o valor dos impostos e taxas devidos, e o custo total de envio. Quanto mais informações sobre o produto você fornecer ao Zonos, mais precisa será a cotação retornada. 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 seu custo de envio, o que pode afetar impostos ou taxas. Os pesos nas listagens de produtos do WooCommerce são usados automaticamente pelo Zonos quando mapeados. Você também pode adicionar peso ao Catálogo no 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 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ê collect o valor correto de envio de seus clientes. Você também pode adicionar dimensões ao Catálogo no Dashboard para garantir cálculos de envio precisos.
- Códigos HS: Os códigos HS impactam as taxas de imposto e podem, às vezes, afetar os impostos. Você pode mapear valores de códigos HS no WooCommerce ou usar Catálogo no Dashboard.
- País de origem: O país de origem de um produto impacta as taxas de imposto e pode afetar os impostos. Você pode mapear valores de país de origem no WooCommerce ou usar Catálogo no Dashboard.
Zonos Checkout para WooCommerce
Integre a extensão Checkout para WooCommerce.