Bling - IS Entrega

Documentação para integração Bling

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

Funcionalidades

CotaçãoEnvio de XMLRastreamentoRastreamento por email

Não oferece cotação.

Sim.

Link, código de rastreio e status.

Encaminhado automaticamente através da plataforma Bling.

Como Configurar

Gerando API KEY

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

DICA.png Confira no manual da plataforma que está integrando se é necessário o cadastro de um usuário API.

Cadastre o usuário API no menu Preferências (cog.png) >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. Preencha os campos de nome e e-mail com os seguintes dados

    Nome: IS Entrega

    E-Mail: tecnologia@isentrega.com.br

  3. Clique em ‘Gerar’ e uma nova API key será gerada.

Depois de gerar a chave da API, configure as permissões.

Configurando perfil de acesso

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.

Cadastros

Na aba de cadastros, configure as seguintes permissões:

Vendas

Na aba de vendas, configure as seguintes permissões:

Serviços

Na aba de serviços, configure as seguintes permissões:

Preferências

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

Envio de informações

Após a realização de todos os passos anteriores você deve preencher o formulário abaixo com as seguintes informações:

  • CNPJ;

  • Razão social;

  • API KEY gerada.

Após o envio das informações é necessário aguardar até 24hs para a ativação do serviço.

Para seguir com as configurações personalizadas é necessário aguardar até 24hs para a ativação da integração.

Configurações personalizadas

Passo 1 - Verifique se o serviço foi criado e esta ativo, acesse Preferências (cog.png)> 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 link-externo.png

Manual de utilização

Requisitos

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.

Utilização

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 objeto e encontre o campo apresentado no erro.

  2. 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).

Passo 3 - Rastreamento

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

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.

Como faço para gerar API Key?

Para realizar a geração da API Key na plataforma Bling, siga os passos abaixo:

Como o Bling envia e-mail direto para o usuário ?

Ative a opção: Enviar e-mail ao destinatário ao atualizar situação de rastreamentos.

Para mais informações, consulte a documentação:

O Bling não esta mais enviando e-mail de atualização de rastreio, o que devo fazer?

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:

Como realizo a configuração de perfil de acesso?

Para realizar a configuração de perfil de acesso na plataforma Bling, siga os passos abaixo:

Quais informações devo enviar para liberarmos o uso após a finalização dos passos?

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:

Como verifico se o serviço foi criado e esta ativo?

Para mais informações, consulte a nossa documentação:

Last updated