Links

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

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. 1.
    Escolha a opção Usuário API
  2. 2.
    Preencha os campos de nome e e-mail com os seguintes dados
    Nome: IS Entrega
  3. 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. 1.
    Modelo de etiqueta: selecione o modelo que deverá ser usado como padrão. Veja como configurar uma etiqueta personalizada
    link-externo.png
  2. 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
    a-link-externo.png
  3. 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
    a-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. 1.
    Clique no símbolo "
    exclamation-triangle.png
    " e confira o erro.
  2. 2.
    Clique no objeto e encontre o campo apresentado no erro.
  3. 3.
    Por fim, corrija a informação do campo e salve.
Clicando no Objeto Logístico, consegue conferir dados como:
  1. 1.
    Dados Gerais: dados do cliente e o serviço logístico.
  2. 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. 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
    a-link-externo.png
    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.

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?

Não. Os e-mails são enviados pela plataforma de e-commerce ou ERP.

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 realizar a verificação do serviço, entre em: Preferências (
cog.png
)> Logística >Configurações de integrações logísticas
Para mais informações, consulte a nossa documentação: