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).
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 () >Todas as configurações > Sistemas > Usuários e usuário API Na tela de usuários cadastrados clique em Incluir um usuário
Escolha a opção Usuário API
Preencha os campos de nome e e-mail com os seguintes dados
Nome: IS Entrega
E-Mail: tecnologia@isentrega.com.br
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".
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 ()> 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
Modelo de etiqueta: selecione o modelo que deverá ser usado como padrão. Veja como configurar uma etiqueta personalizada
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:
Clique no objeto e encontre o campo apresentado no erro.
Por fim, corrija a informação do campo e salve.
Clicando no Objeto Logístico, consegue conferir dados como:
Dados Gerais: dados do cliente e o serviço logístico.
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