Bling - Integração nativa
Bling é um sistema de ERP online para pequenas empresas e lojas virtuais que visa descomplicar o seu negócio. Esse artigo visa explicar como realizar a integração e habilitar a Mandaê diretamente pelo Bling, além de instruir sobre a criação e acompanhamento dos pedidos pelo ERP.
Neste artigo:
- Visão geral sobre a integração Mandaê e Bling
- Pré-requisitos para habilitar a integração
- Habilitando a integração - Configurações
- Utilização dos serviços
- Remessas de encomendas
- Impressão de etiquetas
- Rastreamento
- Cotação de frete
1) Visão geral sobre a integração Mandaê e Bling
O Bling possui integração nativa com nossa plataforma, possibilitando a impressão de etiquetas de transporte, obtenção de cotações de frete, criação e envio de coletas e acompanhamento da entrega das mercadorias.
A integração nativa, fornece o conjunto completo de serviços da Mandaê no Bling, suprindo funcionalidades não disponíveis através da integração personalizada.
2) Pré-requisitos para habilitar a integração
Para realizar a configuração desta integração é necessário obter as seguintes informações:
- Access Token (chave de acesso à API da Mandaê): Acesse sua conta Mandaê e verifique seu token na opção Configurações → API.
- Customer ID (o seu código na Mandaê) - Acesse sua conta Mandaê e verifique seu token na opção Configurações → API.
- Prefixo de rastreamento (prefixo dos códigos de rastreamento) - Acione seu gerente de contas ou encaminhe um e-mail para integracao@nuvemshop.com.br para solicitar esse código.
3) Habilitando a integração - Configurações
Para autenticar a sua integração com a Mandaê, posicione o mouse sobre o ícone de engrenagem 
e clique em Configurações de Logísticas.
Nesta tela, pesquise pela logística e clique sobre ela para adicionar.
A logística da Mandaê possui as seguintes configurações:
Caso você já tenha uma integração da Mandaê salva, algumas abas disponíveis no canto esquerdo da tela poderão diferir da explicação deste artigo. Se isso ocorrer, recomendamos que não as configure.
1. Autenticação
-
Descrição: Crie um nome para a integração
- Adicione os dados fornecidos pela Mandaê
Em seguida, clique em Testar para validar os campos preenchidos.
Se os dados estiverem corretos, será retornada a mensagem de sucesso.
Caso uma mensagem de erro seja informada, verifique o erro e, caso seja preciso, corrija os dados inseridos com a orientação da equipe da Mandaê.
2. Rastreamento
- Você também pode Personalizar URL de Rastreamento, se precisar.
Por padrão, a URL será enviada para o cliente com o código de rastreio do pedido, mas você 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
- Você pode escolher se deseja enviar um e-mail pelo Bling para o cliente, sempre que a situação da entrega for atualizada.
- Caso ative a opção acima, você também pode configurar uma mensagem de rastreamento. Esta mensagem é enviada quando o código de rastreio é enviado por e-mail para o seu cliente e pode ser editada.
3. Preenchimento dos Serviços de Entrega
Ative os Serviços de Entrega que você utilizará, conforme seu contrato.
Ao ativar um serviço logístico, os aliases serão preenchidos corretamente na configuração logística.
Isso fará com que a logística seja selecionada no pedido de venda da sua loja virtual automaticamente.
Não recomendamos apagar nenhum alias gerado automaticamente, apenas inserir se necessário.
Ative todos os serviços que você utilizará.
Caso queira editar um serviço, basta clicar no símbolo do lápis 
|
|
Para finalizar, clique em salvar.
Selecionar o serviço da integração nativa da Mandaê no pedido
Após adicionar os serviços da Mandaê e os aliases, conforme mostrado no passo anterior, os pedidos importados das lojas terão o serviço de entrega automaticamente vinculados à venda.
Caso tenha o ícone da sua logística 
na mesma linha do pedido, siga para o próximo passo
Caso esse vínculo automático não tenha sido realizado, é necessário verificar os aliases configurados para os serviços e vincular manualmente.
Os pedidos importados antes da configuração, é necessário vincular manualmente a logística na venda ou na nota fiscal:
|
Pedidos de Venda
|
Notas Fiscais
|
|
Nota fiscal: Se o pedido de venda já possui nota fiscal gerada, será necessário realizar o processo a partir da nota. Pedido de Venda: Caso a nota ainda não tenha sido gerada, realize o processo a partir do pedido de venda.
É possível identificar os lançamentos a partir dos ícones à frente das vendas |
na mesma linha do pedido.
Se o campo Selecione a Integração
e
.
- Cada linha (ou objeto de postagem) adicionado ao pedido, representa um volume.
- Os códigos de rastreamento são gerados logo após salvar o pedido, de forma automática para cada volume.
É importante ressaltar, que o vínculo automático do serviço de entrega, através dos aliases, gera apenas 1 código de rastreamento.
Quando for necessário enviar o pedido em múltiplos volumes, é necessário inserir manualmente os volumes adicionais. Veja mais detalhes abaixo!
Múltiplos Volumes
Quando houverem múltiplos volumes, com o mesmo serviço de entrega, o início dos códigos de rastreamento serão iguais, apenas o final do código diferencia o número do volume.
Por exemplo:
Um múltiplos volumes com V1 para volume 1, V2 para volume 2, e assim por diante.
Nesse caso, a Mandaê entregará os múltiplos volumes juntos. No entanto, se forem adicionados vários volumes no mesmo pedido ou nota fiscal, mas com serviços de entrega diferentes, cada volume terá um código de rastreamento diferente, e serão entregues separadamente.
|
Os volumes com mesmo serviço de entrega serão agrupados para gerar etiquetas no formato de múltiplos volumes. Quando esse fluxo não for seguido, a mensagem a seguir será exibida: “Alguns trackings não foram gerados." "Motivo: A venda/nota já possui etiquetas vinculadas. Para criar etiquetas com múltiplos volumes, apague as etiquetas atuais e adicione novamente.” É possível inserir novos volumes, apenas em vendas sem rastreamentos. Nesse caso, para adicionar mais volumes, é preciso:
|
Passos para importação de pedidos com múltiplos volumes
A BLING possui configuração para operar com múltiplos volumes junto a Mandaê porem não como uma opção/ funcionalidade direta.
|
AVISO: |
Em resumo para criar um pedidos múltiplos volumes no BLING o cliente precisa ir em Pedido de venda e selecionar a Logística como Mandaê.
Depois selecionar a modalidade de envio do pedido, Rápido ou Econômico.
|
AVISO: |
Posteriormente adicionar outros objetos conforme a necessidade/ quantidade dos itens em Adicionar novo objeto seguindo o padrão que para múltiplos volumes da Mandaê, conforme consta no manual da BLING, manual que foi informado acima.
Por exemplo:
Um item com múltiplos volumes com V1 para volume 1, V2 para volume 2, e assim por diante.
|
AVISO: |
Cotação do frete da integração nativa da Mandaê
Se os aliases estiverem corretos, ao importar o pedido de venda da loja, o sistema importará o serviço logístico na venda e a cotação, se ele tiver sido realizada na loja virtual.
Nesse caso, você poderá apenas conferir e seguir para o próximo passo 
Mas é possível realizar o cálculo de cotação dos serviços da Mandaê no Bling, caso ainda não tenha sido feita. Para isso, clique no símbolo do caminhão 
, localizado à frente do serviço, dentro do pedido de venda ou da nota fiscal.
A imagem a seguir demonstra os passos para se obter as cotações na seção de transporte de um pedido de venda:
-
Dados da Entrega:
• CEP Origem: Se o pedido/nota possuir uma loja e unidade de negócio vinculada, é considerado o CEP da unidade, caso contrário, é considerado o CEP do cadastro de sua empresa no Bling.
• CEP Destino: É considerado o CEP do cadastro de seu cliente, ou o CEP do Endereço de Entrega, se estiver preenchido na venda.
-
Dados do Volume:
• 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
• 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).
• Peso: O campo é preenchido conforme o campo peso bruto na venda. Representa a soma dos pesos dos produtos no volume. Pode ser editado conforme a distribuição dos produtos em cada volume.
• Dimensões: Preencha com a largura, altura e comprimento do pacote/caixa do volume.
Se a Embalagem estiver selecionada, os campos serão preenchidos automaticamente.
- Clique em Obter Cotação, caso queira obter uma nova cotação.
Quando houver múltiplos volumes na mesma venda ou nota fiscal, certifique-se de adicionar na mesma remessa de postagem. Se forem enviados para a Mandaê em remessas separadas, serão criados envios distintos e não seguirão juntos para a entrega.
Gerar e enviar a remessa para a integração nativa da Mandaê
 ATENÇÃO:Primeiramente, é necessário certificar-se de que o serviço logístico foi inserido nas vendas. Para isso, acesse em Vendas > Notas Fiscais ou em Vendas > Pedidos de Venda e note se há o ícone da sua logística  à frente da venda.Caso haja o ícone da logística, basta prosseguir à geração e envio da remessa. Se não houver, será necessário inserir o serviço manualmente na venda 
|
Para acessar a área de gerenciamento das remessas, acesse Vendas > Integrações Logísticas e selecione a integração logística no filtro.
- Selecione os objetos de postagem desejados.
- Clique em + Gerar Remessa.
Confira as remessas que serão criadas e salve.
Remessas com Erro
Se houver objetos com erro, clique no símbolo 
para verificar qual o erro que deve ser corrigido.
Envio de Remessas
Após as informações do objeto serem corretamente preenchidas, pode ser realizado o envio das remessas de encomendas. Esta operação pode ser realizada individualmente (uma remessa por vez), ou em lote, conforme a imagem a seguir.
|
|
Validação de Remessas
Na validação das encomendas podem ocorrer as seguintes situações:
As notas fiscais devem ser emitidas.
Se for gerada nota fiscal do pedido de venda, a nota deve ser emitida antes de enviar o pedido de coleta, para que os dados fiscais sejam enviados junto.
Campos do remetente ou destinatário não preenchidos, ou ultrapassando o limite
Quando um campo não for preenchido ou estiver ultrapassando o limite de caracteres, será exibida uma mensagem com a descrição do campo que deve ser ajustado.
Para ajustar os dados do destinatário, basta abrir o objeto de postagem, ajustar o campo e salvar.
Para ajustar os seus dados (remetente), acesse Preferências 
> Todas as Configurações > Empresa > Alterar Dados da Empresa.
Dados de endereço como nome da pessoa, rua, número, bairro, cidade, estado e CEP devem estar devidamente preenchidos para ambos. Exclusivamente para o destinatário, os seguintes campos também são obrigatórios: documento (CPF/CNPJ), telefone e e-mail.
Campos dos produtos não preenchidos ou ultrapassando o limite
Com as remessas, são enviados dados dos produtos presentes em cada encomenda.
Informações dos produtos como nome, código, preço e quantidade devem estar devidamente preenchidos na venda.
Demais problemas de validação
As situações descritas acima são resultantes da pré-validação no Bling. Quaisquer outros avisos, são resultantes da validação por parte da Mandaê no momento do envio do pedido. Nestes casos deve-se avaliar a mensagem retornada, se possível deve-se corrigir o problema e enviar o pedido novamente. Caso não seja possível resolver, deve-se entrar em contato com o suporte do Bling, informando a mensagem erro.
Etiqueta da integração nativa da Mandaê
As etiquetas possuem os dados necessários para que a Mandaê possa realizar o recebimento das encomendas de forma organizada.
A impressão da etiqueta deve ser realizada logo após o envio da remessa.
A impressão pode ser realizada na listagem de vendas ou notas fiscais, na opção Imprimir Etiqueta de Envio, localizada ao clicar no menu à frente de cada venda/nota.
Para imprimir em lote (várias etiquetas), entre no módulo Vendas > Integrações Logísticas, selecione a Logística, selecione os objetos que deseja imprimir e clique na opção Imprimir Etiquetas.
A imagem a seguir demonstra o modelo padrão de etiquetas da Mandaê, quando a venda tiver múltiplos volumes:
Já a imagem a seguir, demonstra a etiqueta de uma venda com volume único:
Algumas preferências básicas da etiqueta dos Correios também são refletidas na impressão das etiquetas da Mandaê.
Para alterar o layout da etiqueta, posicione o mouse sobre o ícone da engrenagem 
> Todas as Configurações > Logística > Configurações de Logísticas > Impressão de Etiquetas Correios.
Saiba mais 
As preferências refletidas na etiqueta da Mandaê são as seguintes:
• Dimensão
• Margens entre as etiquetas
• Imprimir uma etiqueta por página
• Exibir peso bruto
• Exibir borda pontilhada
• Endereço de remetente personalizado
• Exibir número do pedido de venda
• Exibir informações dos itens da venda
As demais preferências não podem ser editadas pois seguem o padrão exigido.
Para ter o melhor aproveitamento, sugere-se a impressão no tamanho A4.
Ao reduzir as margens de impressão em seu navegador é possível realizar a impressão de 4 etiquetas por folha.
Rastrear a encomenda da integração nativa da Mandaê
O acompanhamento de entrega e rastreamento pode ser consultado após o envio da remessa.
Após o envio dos pedidos de coleta, é possível acompanhar o andamento da entrega da mercadoria, verificando as mudanças na situação de rastreamento, 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 símbolo da logística.
Vendas > Integrações Logísticas
Para acessar o rastreamento do objeto pelo módulo de integrações logísticas, acesse Vendas > Integrações Logísticas:
- Selecione a logística no topo da tela
- Clique no objeto de postagem
- Em seguida, clique em Rastreamento
Também é possível enviar as informações do rastro do objeto para o e-mail do cliente.
Para entender como configurar as mensagens de acompanhamento dos rastros, acesse o Manual de Rastreamento de Objetos 
