Comment on page
VTEX - IS Entrega
Documentação para integração Vtex
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.
.gif?alt=media&token=b657aa32-94bb-4bf4-b055-09c92c67b45e)
Cotação | Envio XML | Rastreamento |
---|---|---|
Sim | Sim, desde que esteja configurado | Sim |
Links uteis
Para realizar integrações API, você ou seu desenvolvedor poderá precisar de um TOKEN.
Realize a geração do token em: Configurações da conta (
) > Conta > Segurança


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.
Realize a configuração do perfil acessando: Configurações da conta (
) > Gerenciamento da conta > Perfis de acesso

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".

Perfil de acesso | Nome de perfil | Produtos e recursos |
Custom | API | OMS access(Full) |
| | Logistics(Full) |
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".
Para realizar a configuração da estratégia de envio acesse: Pedidos (
) > Estoque & entrega > 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:

Nome | ID | Método de Envio |
IS Entrega | | Normal |
É 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".
Para realizar a associação da estratégia de envio é necessário clicar na guia "Docas" > Selecione a doca desejada e clique em "Editar".

Agora basta ir até a seção Políticas de envio e canais de venda e selecionar a política da IS Entrega no campo Políticas de envio associadas.


Após realizar todo o procedimento de associação de politica, basta clicar no botão "Salvar alterações".
Para conferir detalhes sobre a utilização do portal minha.is, acesse o nosso Manual de usabilidade ou clique no link abaixo:
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.
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.
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 modified 1mo ago