Bem-vindo!
Como podemos te ajudar?

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:

  1. Visão geral sobre a integração Mandaê e Bling
  2. Pré-requisitos para habilitar a integração
  3. Habilitando a integração - Configurações
  4. Utilização dos serviços
  5. Remessas de encomendas
  6. Impressão de etiquetas
  7. Rastreamento
  8. 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 engrenagem.png e clique em Configurações de Logísticas.

Nesta tela, pesquise pela logística e clique sobre ela para adicionar.

0log_stica-caminho-geral.gif

 

A logística da Mandaê possui as seguintes configurações:

  1. Autenticação
  2. Rastreamento
  3. Serviço de Entrega

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

  1. Descrição: Crie um nome para a integração

  2. Adicione os dados fornecidos pela Mandaê 

mceclip0.png

 

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ê a-link-externo.png

 

2. Rastreamento

  1. 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 a-link-externo.png

  2. Você pode escolher se deseja enviar um e-mail pelo Bling para o cliente, sempre que a situação da entrega for atualizada.

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

mceclip1.png

 

3. Preenchimento dos Serviços de Entrega

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

 

alerta-M.png 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 pencil-alt.png

 

mceclip3.png

 

alerta-M.png OBSERVAÇÕES

  • O preenchimento do campo Transportador não é obrigatório.

  • Você pode adicionar o cadastro de uma transportadora, caso queira que essa informação seja preenchida automaticamente (após selecionar o serviço logístico) no pedido de venda ou nota fiscal.

    Para isso, é necessário ter a transportadora cadastrada no menu Cadastros > Clientes e Fornecedores, e depois selecioná-la na integração logística clicando em Editar o Serviço de entrega.
    Veja mais detalhes link-externo.png

 

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 log-mandae.png 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

  1. Acesse em Vendas > Pedidos de Venda e clique no pedido de venda que deseja inserir a logística.

  2. No campo Logística, clique em Selecione a Logística e selecione a Mandaê.

  3. Em Objetos de Postagem, selecione o serviço logístico.

  4. Salve a venda.

Notas Fiscais

  1. Acesse em Vendas > Notas fiscais e clique na nota fiscal que deseja inserir a logística.

  2. No campo Logística, clique em Selecione a Logística e selecione a Mandaê.

  3. Em Objetos de Postagem, selecione o serviço logístico.

  4. Salve a nota.

 

Frame_1__1_.png

 

alerta.png Em qual menu realizar o processo?

Nota fiscal: Se o pedido de venda já possui nota fiscal gerada, será necessário realizar o processo a partir da nota.

Para identificar se a nota já foi gerada, acesse Vendas > Pedidos de Venda, clique em Limpar para remover todos os filtros. Note se há o ícone simbolo_notaGerada.png na mesma linha do pedido.

Pedido de Venda: Caso a nota ainda não tenha sido gerada, realize o processo a partir do pedido de venda.

DICA.png Se o campo Selecione a Integração estiver bloqueado, retorne em Vendas > Pedidos de Venda ou Vendas > Notas fiscais, clique no menu à frente da venda, clique em Estornar Contas e Estornar Estoque.

É possível identificar os lançamentos a partir dos ícones à frente das vendas simbolo_estoqueNota.png e simbolo_contasNota.png.

 

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

alerta_.png É 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: 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.

alerta_.png ATENÇÃO:

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:

  1. Apagar os volumes existentes e salvar a venda.
  2. Em seguida, adicione os volumes novamente e salve.

 

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 link-externo__1_.png

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 caminh_o.png, localizado à frente do serviço, dentro do pedido de venda ou da nota fiscal.

Screenshot_1_.png

 

A imagem a seguir demonstra os passos para se obter as cotações na seção de transporte de um pedido de venda:

cota__o_manda_.png

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

  2. 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 link-externo__1_.png

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

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

alerta_.png 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 log-mandae.png à 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 link-external.png

 

Para acessar a área de gerenciamento das remessas, acesse Vendas > Integrações Logísticas e selecione a integração logística no filtro.

 

intg-log-mandae.gif

 

  1. Selecione os objetos de postagem desejados.
  2. Clique em + Gerar Remessa.

obj-post-mandae.png

 

Confira as remessas que serão criadas e salve.

conferir-remessa.png

 

Remessas com Erro

Se houver objetos com erro, clique no símbolo alerta_logistica_1.png para verificar qual o erro que deve ser corrigido.

corrigir-remessa-2.gif

 

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.

remessa-mandae.png

 

alerta_.png OBSERVAÇÕES:

  • As remessas que possuem encomendas com erros, não poderão ser enviadas.

  • As remessas podem ser excluídas, apenas enquanto estiverem com a situação Em Aberto ou Cancelado.

  • As encomendas (objetos) podem ser adicionadas ou removidas de uma remessa, enquanto esta estiver em situação Em Aberto.

  • Após o envio, caso a remessa for recebida corretamente pela Mandaê, sua situação é alterada automaticamente para Emitida.

 

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

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

 

etiqueta-pv-mandae.gif

 

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.

 

etiqueta-int-mandae.gif

 

A imagem a seguir demonstra o modelo padrão de etiquetas da Mandaê, quando a venda tiver múltiplos volumes:

mandae0.png

 

Já a imagem a seguir, demonstra a etiqueta de uma venda com volume único:

mandae1.png

 

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 cog.png > Todas as Configurações > Logística > Configurações de Logísticas > Impressão de Etiquetas Correios.
Saiba mais link-externo__1_.png

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

 

alerta_.png As demais preferências não podem ser editadas pois seguem o padrão exigido.

DICA.png 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:

  1. Vendas > Pedido de Venda
  2. Vendas > Nota Fiscal 
  3. Vendas > Integrações Logísticas

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.

 

mandaerastrearobjetopedido.gif

 

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.

 

rastreiomandaenotasfiscaisnfe-.gif

 

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:

  1. Selecione a logística no topo da tela

  2. Clique no objeto de postagem

  3. Em seguida, clique em Rastreamento

mandae-rastreio-int.gif

 

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 a-link-externo.png

 

 

 

 

Esse artigo foi útil?