Bling - IS Entrega
Documentação para integração Bling
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 Bling. 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=d44b22ef-85c0-41f6-8f88-85938e7f225b)
Cotação | Envio de XML | Rastreamento | Rastreamento por email |
|---|---|---|---|
Não oferece cotação. | Sim. | Link, código de rastreio e status. | Encaminhado automaticamente através da plataforma Bling. |
Para que seja realizada a integração com a IS Entrega é necessário seguir todos os passos abaixo para configurar a sua plataforma Bling.
Para realizar integrações API, você ou seu desenvolvedor poderá precisar de um usuário e uma chave API (API key).
Cadastre o usuário API no menu Preferências (
) >Todas as configurações > Sistemas > Usuários e usuário API
Na tela de usuários cadastrados clique em Incluir um usuário
- 1.Escolha a opção Usuário API
- 2.
- 3.Clique em ‘Gerar’ e uma nova API key será gerada.
Depois de gerar a chave da API, configure as permissões.
Em Perfil para acesso você não precisa selecionar uma das opções, pois o perfil de acesso será customizado e será exibido a seguir.
Na aba de cadastros, configure as seguintes permissões:
Na aba de vendas, configure as seguintes permissões:
Na aba de serviços, configure as seguintes permissões:
Na aba de preferências, configure as seguintes permissões:
Após conceder as permissões, clique em Salvar
Após salvar, você encontrará o usuário API criado, clicando em Filtros, selecione API em "Tipos de Usuário".
Para seguir com as configurações personalizadas é necessário aguardar até 24hs para a ativação da integração.
Passo 1 - Verifique se o serviço foi criado e esta ativo, acesse Preferências (
)> Logística > Configurações de integrações logísticas
Na listagem de integrações verifique se a IS Entrega esta ativa.
Para acessar as configurações personalizadas basta clicar duas vezes na integração
- 1.Modelo de etiqueta: selecione o modelo que deverá ser usado como padrão. Veja como configurar uma etiqueta personalizada
- 2.Enviar e-mail ao destinatário ao atualizar situação de rastreamentos: ativar apenas se desejar que o sistema envie um e-mail informando o cliente sempre que a situação de rastreamento for atualizada. → Caso ative essa opção você pode configurar uma mensagem de rastreamento. Veja como editar
- 3.Personalizar URL de rastreamento: por padrão, a URL será enviada para o cliente com o código de rastreio do pedido, mas caso você queira pode utilizar a URL https://rastreamento.is/#/?t=[CODIGO_RASTREAMENTO] ou pode utilizar outras variáveis para utilizar neste link, como o número do pedido, da remessa ou de algum outro dado (dependendo da necessidade da logística utilizada). Saiba mais
Para utilizar os nossos serviços, é necessário antes ter configurado todos os passos anteriores relacionados a Configuração Bling.
Uma vez que as configurações de usuário foram feitas e a API Key foi gerada, o nosso sistema vai criar automaticamente na plataforma o serviço IS Entrega de logística e a transportadora. Para utilizar os nossos serviços basta seguir os passos abaixo.
Passo 1- Selecione o serviço logístico IS Entrega na venda
Para automatizar a seleção do serviço logístico é necessário editar as configurações personalizada conforme esta no Passo 1 e acrescentar o Alias na seção Serviços de Entrega conforme abaixo:
Alias: nome do serviço da transportadora de acordo como esta cadastrado na loja virtual.
Pode ser adicionado quantos ALIASES forem necessários.
Passo 2 - Geração de remessas (Registro de coleta)
Entre no menu Vendas > Integrações Logísticas, escolha a logística, selecione os objetos de postagem desejados e clique em '+ Gerar remessa'.
Após clicar em Gerar remessa selecionados você será redirecionado para a página do registro de coleta, onde serão exibidos os dados da remessa e a lista com os objetos de postagem selecionados anteriormente.
Nesse momento, o sistema validará os pedidos, de acordo com as regras da logística.
Caso tenha algum objeto com erros, ele será destacado. Veja como corrigir com um exemplo:
- 1.Clique no símbolo "" e confira o erro.
- 2.Clique no objeto e encontre o campo apresentado no erro.
- 3.Por fim, corrija a informação do campo e salve.
Clicando no Objeto Logístico, consegue conferir dados como:
- 1.Dados Gerais: dados do cliente e o serviço logístico.
- 2.Serviços adicionais → Valor declarado: valor que será assegurado pela transportadora (apesar de estar vinculado ao volume, o valor é referente ao valor total da coleta, portanto, quando houver múltiplos volumes eles devem possuir o mesmo valor declarado).
- 3.Características: Embalagem: é possível escolher a embalagem para envio do produto. São consultadas apenas embalagens com situação ativa, para mais informações, veja como cadastrar embalagens Peso bruto: peso total do volume em quilogramas (peso bruto = peso líquido + peso embalagem) Se uma embalagem for selecionada (campo 3), os dados a seguir serão ajustados automaticamente: - Altura: altura da embalagem, em centímetros. - Comprimento: comprimento da embalagem, em centímetros. - Largura: largura da embalagem, em centímetros.
Após o envio das remessas de encomendas, é possível acompanhar o andamento da entrega das mercadorias, verificando as mudanças na situação de rastreamento.
A consulta pode ser feita em 3 módulos:
Vendas > Pedido de Venda
Para acessar o rastreamento do objeto pelo módulo de Pedidos de venda, acesse Vendas > Pedidos de Venda e clique no símbolo da logística.
Vendas > Notas Fiscais
Para acessar o rastreamento do objeto pelo módulo de Notas Fiscais, acesse Vendas > Notas Fiscais e clique no botão "Logística".
Vendas > Integrações Logísticas
Para acessar o rastreamento do objeto pelo módulo de Pedidos de venda, acesse Vendas > Pedidos de Venda, selecione a logística, clique no objeto de postagem e clique em 'Rastreamento'.
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.
Para realizar a geração da API Key na plataforma Bling, siga os passos abaixo:
Ative a opção: Enviar e-mail ao destinatário ao atualizar situação de rastreamentos.
Para mais informações, consulte a documentação:
Verifique se as configurações estão de acordo com o manual Bling Manual Bling (Configurações personalizadas), nos casos em questão. Se estiverem corretas, desative e ative-as novamente.
Para mais informações, consulte a nossa documentação:
Para realizar a configuração de perfil de acesso na plataforma Bling, siga os passos abaixo:
Para geração dos dados é necessário antes seguir todos os passos elencados na documentação. Caso ainda não tenha feito, siga o passo a passo no link a seguir.
- CNPJ;
- Razão social;
- API KEY gerada.
Para mais informações, consulte a nossa documentação:
Para realizar a verificação do serviço, entre em: Preferências ()> Logística >Configurações de integrações logísticas
Para mais informações, consulte a nossa documentação:
Last modified 3mo ago