Integração
Integre perfeitamente o Checkout com sua loja Magento seguindo os passos desta seção:
Comece
Comece completando nosso formulário de inscrição. O processo de integração começará assim que o acordo de sua conta estiver em vigor.
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: Os passos listados abaixo são para sua referência e você será guiado por eles pelo seu representante de integração.
Instale o aplicativo Checkout
Para usar o Checkout com o Magento, você precisa comprar a extensão no Magento Marketplace e depois instalá-la em seu terminal com o Composer. Este método é mais técnico do que nossos outros plugins devido à forma como o Magento lida com extensões. Para instalar o aplicativo:
- Baixe a extensão Checkout no Magento Marketplace.
- Baixe a extensão Hello no Magento Marketplace.
- Abra um novo terminal e navegue até o diretório raiz da sua instalação do Magento e siga as instruções abaixo.
Execute o seguinte comando para adicionar o Checkout às dependências do seu site. O Hello será incluído automaticamente.
Terminal
composer require zonos/checkout
Em seguida, execute o seguinte comando para habilitar o módulo de Checkout.
Terminal
php bin/magento module:enable Zonos_Checkout
Agora, execute o seguinte comando para instalar a extensão e realizar quaisquer migrações de banco de dados necessárias.
Terminal
php bin/magento setup:upgrade
Por fim, execute o seguinte comando para compilar uma nova versão do seu site, incluindo o plugin Checkout.
Terminal
php bin/magento setup:di:compile
Nota: Checkout tem uma dependência de Hello, então os comandos acima instalarão ambos.
Configurar Magento
- Acesse o seu admin do Magento -> Lojas -> Configuração -> Zonos -> Zonos Checkout.
- Copie a sua chave da API do Zonos do Dashboard e insira como seu Token de Serviço.
- Copie o seu número da conta do Zonos do Dashboard e insira como seu Número de ID da Loja.
- Em Países de envio doméstico, clique para destacar todos os seus países domésticos.
- Em Mapeamento de atributos do item do carrinho, escolha as informações que deseja mapear. Por padrão, o Zonos irá puxar o peso do item, preço, descrição e país de fabricação (se disponível). Esta seção contém campos abertos nos quais as informações do seu item podem ser passadas para trazer códigos HS, comprimento, largura, altura ou quaisquer atributos personalizados do nível do item que possam ser usados pelo Zonos para regras especiais necessárias ao calcular cotações.
Configurar configurações gerais
Ao configurar o seu aplicativo Checkout no Magento, você também precisará fazer algumas alterações nas configurações gerais do Magento.
- Acesse o seu admin do Magento -> Lojas -> Configuração -> Geral.
- Na seção Permitir países, destaque todos os países para os quais deseja enviar, internacionalmente e domesticamente. Se um país não estiver destacado aqui, mas estiver habilitado no Zonos, o pedido será permitido ser concluído e aparecerá no Dashboard, mas falhará ao ser importado para o Magento.
- O Zonos também recomenda que você selecione todos os países, exceto os Estados Unidos, na seção O código postal é opcional para. Isso reduz erros na conclusão de pedidos, já que alguns países não usam ou exigem códigos postais. Além disso, como o Checkout vem com a proteção contra fraudes do Zonos, você não incorrerá em riscos adicionais ao remover esse requisito.
Configurar Hello
Hello é adicionado com a instalação do aplicativo Checkout. Siga as instruções de configuração abaixo para o Hello.
- Acesse o seu admin do Magento -> Lojas -> Configuração -> Zonos -> Zonos Hello.
- Copie a sua chave do site do Hello do Dashboard e insira como sua Chave do Site.
- Se deseja que o Hello converta moeda, cole seus seletores CSS no campo Seletores de conversão de moeda. Múltiplos seletores são separados por vírgula, por exemplo,
.price,.__current-price,.__subtotal,.__original-price
.- Se a moeda base da sua loja não for USD, informe ao Hello a moeda base da sua loja em Dashboard -> Hello.
- Se precisar Ocultar elementos domésticos para seus clientes internacionais, insira seletores CSS para os elementos que deseja ocultar, por exemplo,
.nav-6,.action-add
.
Ajustar configurações avançadas
Opcional—As seguintes configurações são configurações avançadas. Os padrões estão em vigor, então nenhuma ação é necessária. Se desejar fazer ajustes, siga estas diretrizes:
- Acesse o seu admin do Magento -> Lojas -> Configuração -> Zonos -> Zonos Checkout.
- Ajuste de acordo com sua preferência:
- Criar fatura na importação—Definido como Sim por padrão. O Zonos criará uma fatura após a importação do pedido. Se optar por desativar esse recurso, precisará criar sua própria fatura, e o Zonos definirá uma retenção de revisão de fraude para um status
zonos_hold
. Uma vez que a fraude for removida, voltaremos ao status anterior. - Login do cliente—Definido como Não por padrão. Se deseja exigir uma conta para o checkout, altere para Sim. Você também precisará ir para Configuração do cliente -> Opções de login e atualizar Redirecionar cliente para o painel da conta após o login para Não.
- Criar fatura na importação—Definido como Sim por padrão. O Zonos criará uma fatura após a importação do pedido. Se optar por desativar esse recurso, precisará criar sua própria fatura, e o Zonos definirá uma retenção de revisão de fraude para um status
Testar sua integração
Agora que você configurou sua conta e seu aplicativo, está pronto para testar sua integração. Você precisará habilitar o Checkout e o Hello no Magento durante o teste. Para fazer isso:
- Acesse o seu admin do Magento -> Lojas -> Configuração -> Zonos -> Zonos Checkout.
- Altere Ativado para Sim.
- Mude para Zonos Hello no menu à esquerda.
- Altere Ativado para Sim.
Se você não estiver pronto para ir ao ar ainda, lembre-se de alterar essas configurações de volta para Não assim que terminar o teste. Após concluir o teste, habilite o Zonos usando os mesmos passos acima.
Se tiver dúvidas, entre em contato com nossa equipe de suporte. Se estiver trabalhando atualmente com um Gerente de Projeto de Serviços Profissionais para integrar sua conta, entre em contato com eles para obter assistência.
Desinstalar Checkout
A desinstalação dos aplicativos deve ser realizada por um desenvolvedor Magento experiente via Composer. Execute este comando para desinstalar o Checkout e o Hello:
Terminal
php bin/magento module:uninstall Zonos_Checkout Zonos_Hello
Perguntas frequentes
Que informações do produto devo fornecer para obter o orçamento mais preciso 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 a Zonos, mais preciso será o orçamento retornado. A Zonos pode gerar um orçamento 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 em suas listagens de produtos do Magento são automaticamente usados pela Zonos quando presentes.
- Dimensões: As dimensões podem impactar o custo de envio, o que pode afetar as taxas ou impostos. A Zonos pode utilizar as dimensões do produto (comprimento, largura e altura) definidas em cada produto no Magento, mas você deve mapeá-las no aplicativo da Zonos para integração adequada.
- Códigos HS: Os códigos HS impactam as taxas de imposto e às vezes podem afetar os impostos. A Zonos pode usar os códigos HS definidos em suas listagens de produtos no Magento, mas você deve mapear o campo de código HS no aplicativo da Zonos.
- País de origem: O país de origem de um produto impacta as taxas de imposto e pode afetar os impostos. O país de origem definido em suas listagens de produtos do Magento é automaticamente usado pela Zonos quando presente.
Detalhes do produto passados para a Zonos pelo Magento
Detalhes do produto | Pesos | Dimensões | Código HS | País de origem |
---|---|---|---|---|
Passados automaticamente | ||||
Devem ser mapeados |
Nota: Alternativamente, você pode inserir as informações no Catálogo, substituindo as informações armazenadas e passadas pelo Magento.
Saiba mais sobre informações do produto por plataforma.
Checkout para Magento
Integre o plugin Checkout para Magento.Antes de integrar o Zonos Checkout, certifique-se de que ele funcionará como você espera. Aqui está como será sua experiência ao usar o Checkout: