Links
Comment on page

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

Cotação
Envio XML
Rastreamento
Sim
Sim, desde que esteja configurado
Sim

Configuração

Links uteis

Gerando API TOKEN

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 (
cog.png
) > 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.

Configurando o perfil para chave de API

Realize a configuração do perfil acessando: Configurações da conta (
cog.png
) > 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".

Configurando estratégia de envio

Para realizar a configuração da estratégia de envio acesse: Pedidos (
cog.png
) > 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".

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

Envio de informação para IS Entrega

Envio de informação

Após a realização de todos os passos anteriores você deve preencher o formulário com as seguintes informações:
  • CNPJ;
  • Razão social;
  • Endereço de coleta
  • ID da estratégia de envio
  • Chave de aplicação e TOKEN gerados.
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.