VTEX - IS Entrega
Documentação para integração Vtex
Introdução
Este guia foi criado com o objetivo de ajudá-lo a instalar, configurar e utilizar a integração da IS Entrega em sua plataforma e-commerce VTEX. Nele, você encontrará instruções detalhadas e passo a passo para integrar o serviço de frete da IS Entrega à sua loja virtual e oferecer aos seus clientes opções de entrega eficientes e seguras.
Funcionalidades
Configuração
Links uteis
Gerando API TOKEN
Para realizar integrações API, você ou seu desenvolvedor poderá precisar de um TOKEN.
Ao acessar a tela, clique no botão "Gerar access key e secret". Após isso, insira um nome para o par de chave e TOKEN que está sendo criado e clique em Gerar novos Tokens.
Será exibido o Token para utilização na API. Ele é exibido apenas uma vez, então certifique-se de guarda-lo em um local seguro.
Configurando o perfil para chave de API
Dentro da tela Perfis de acesso, clique no botão "Novo perfil"
Configurando novo perfil de acesso
Para realizar a configuração do novo perfil de acesso, é necessário realizar o preenchimento das informações de forma manual.
Para isso, é necessário preencher o campo: "Perfil de acesso", "Nome do perfil" e "Produtos e recursos".
Após realizar o preenchimento dos dados de perfis de acesso, é necessário atribuir as permissões para a chave da API gerada.
Para isso realize o preenchimento da chave da API gerada "vtexappkey-nomedaloja-XXXXXX" no campo "Email" e clique no botão "Adicionar" e "Salvar".
Configurando estratégia de envio
Ao realizar o acesso na tela, clique no botão "Criar política de envio".
Ao realizar o acesso na tela de "Cadastro de politica de envio" é necessário realizar o preenchimento dos campos com as seguintes informações:
É essencial que o campo "Nome" seja preenchido corretamente como IS Entrega
*A ausência ou erro na informação deste campo impedirá que a integração seja validada com sucesso. Certifique-se de inserir o nome apropriadamente para garantir que o processo ocorra sem problemas.
Necessário que o campo ID seja enviado em branco para que o sistema VTEX realize atribuição automática de ID.
Após realizar o preenchimento da politica de envio, é necessário realizar o upload da planilha de fretes fornecida pela IS Entrega.
Na seção de Dimensões do Pacote, preencha a Soma das Dimensões com o valor 240 e a Maior Aresta com o valor 80, deixando o restante como padrão.
Após realizar todos os preenchimentos, basta apertar no botão "Salvar alterações".
Associando estratégia de envio
Para realizar a associação da estratégia de envio é necessário clicar na guia "Docas" > Selecione a doca desejada e clique em "Editar".
Após realizar todo o procedimento de associação de politica, basta clicar no botão "Salvar alterações".
Envio de informação para IS Entrega
Para conferir detalhes sobre a utilização do portal minha.is, acesse o nosso Manual de usabilidade ou clique no link abaixo:
FAQ
Não estou recebendo o e-mail com número de rastreamento, entro em contato com a IS?
Se você não está recebendo o e-mail com o número de rastreamento, é importante entrar em contato com a plataforma de e-commerce ou o sistema ERP que está sendo utilizado. A IS Entrega não é responsável pelo envio desse e-mail e, portanto, não tem acesso a informações sobre o motivo da ausência do mesmo. Recomendamos entrar em contato com a plataforma ou o sistema responsável pelo envio do e-mail para obter mais informações e solucionar o problema.
Preciso enviar XML via Email?
Não é necessário enviar XML por e-mail, mas solicitamos que você forneça um modelo de XML durante o cadastro para que possamos utilizá-lo como contingência em caso de falhas na integração. No entanto, para as outras integrações que não são pareadas com as plataformas listadas, existem duas opções:
a) O cliente pode preencher manualmente os dados das notas fiscais (NFs) no portal da IS Entrega, o que garante que o rastreio será atualizado automaticamente assim que a integração for realizada. Dessa forma, é possível garantir que o rastreio esteja sempre atualizado e disponível para acompanhamento pelo cliente. Além disso, o preenchimento manual dos dados das NFs pode ser útil em situações em que a integração ainda não foi realizada ou em caso de falhas na integração.
b) O cliente pode optar por enviar o XML por e-mail, mas é importante lembrar que isso pode afetar a atualização automática do rastreio através da integração. Enviar o XML por e-mail pode ser útil em caso de falhas na integração ou quando não há outra opção disponível, mas é importante levar em consideração que o rastreio não será atualizado automaticamente via integração.
Por que a modalidade de entrega não aparece no site?
Isso pode ocorrer quando a Estratégia de Envio não está associada a uma Doca ativa, então é recomendado que o cliente verifique se esta associação está feita corretamente. Após a verificação, é recomendado que seja feito um teste através do Simulador de Envio, disponível no painel administrativo da VTEX, pois dessa forma, caso a transportadora seja descartada como opção de frete, uma mensagem de erro com o motivo do descarte será exibida.
Last updated