Visão geral
O Bling possui integração com a plataforma logística Mandaê, 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 aos clientes.
A integração nativa, fornece o conjunto completo de serviços da Mandaê no Bling.
Se você possui a versão de integração personalizada e deseja migrar para a nova versão, entre em contato com a Mandaê através do e-mail integracao@mandae.com.br
Pré-requisitos
Para realizar a configuração desta integração é necessário obter as seguintes informações:
- Access Token (chave de acesso à API da Mandaê) - obter na plataforma da Mandaê em Configurações → API.
- Customer ID (o seu código na Mandaê) - obter na plataforma da Mandaê em Configurações → API.
- Prefixo de rastreamento (prefixo dos códigos de rastreamento) - contatar a Mandaê através do e-mail integracao@mandae.com.br.
Neste manual você irá ver:
- Como fazer a configuração
- Como utilizar os serviços e envios com múltiplos volumes
- Gerenciar remessas
- Imprimir etiquetas
- Rastreamento
- Cotação de frete
Configuração no Bling
Acesse Preferências → Logística → Configurações de integrações logísticas
Ao incluir uma nova integração ou editar uma existente, existirá os seguintes campos a serem configurados:
- Nome da integração logística: crie um nome para sua integração.
- Integração: seletor com as integrações logísticas disponíveis. Selecione a integração Mandaê.
- Access Token: preencha com seu Token de acesso fornecido pela Mandaê.
- Modelo de etiqueta: seletor do modelo de etiqueta personalizada. O modelo é utilizado para a impressão das etiquetas.
- Configurar mensagem de rastreamento: o Bling possibilita o envio de mensagens de rastreamento das encomendas de seus clientes. É possível realizar a configuração do modelo de e-mail ao clicar no link. Para maiores informações consulte o manual de rastreamento de objetos
- Customer ID: preencha com o seu código identificador na Mandaê.
- Prefixo de rastreamento: prefixo com 4 ou 5 letras, sem caracteres especiais, fornecido pela Mandaê, que será concatenado no início de seus códigos de rastreamento.
Você pode conferir esta informação no painel da Mandaê nas 'Configurações':
- Transportadora: você pode cadastrar o contato da transportadora e vincular aos serviços de entrega, assim os dados do transportador serão atualizados automaticamente nas suas vendas quando aquele serviço for selecionado (opcional).
- Serviço: selecione as modalidades de entrega que deseja utilizar no Bling.
Para adicionar os serviços de sua integração logística, antes é necessário realizar a autenticação clicando no botão Autenticar. A autenticação é realiza apenas com o Token inserido, caso for bem-sucedida, será exibida uma mensagem de sucesso e os serviços serão carregados no seletor Serviço (campo 12).
Para adicionar os serviços, selecione o contato da Transportadora previamente cadastrada (opcional), escolha o Serviço e clique em Adicionar.
Você pode configurar Aliases para os serviços. Estes aliases serão utilizados para a vinculação automática da modalidade de frete, ao importar os pedidos das lojas virtuais.
Os serviços disponibilizados pela integração são:
- Econômico
- Rápido
- Super Rápido
- Same Day
Utilização dos serviços e envios com múltiplos volumes
Após configurar sua integração, os serviços serão listados na seção Transportador dos Pedidos de Venda e Notas Fiscais, conforme a figura abaixo:
- Logística: selecione a integração logística da Mandaê que foi configurada.
- Serviço: selecione o serviço de entrega a ser utilizado.
- Adicionar novo objeto: adicione um novo objeto de postagem e escolha o serviço de entrega para este.
Cada linha - ou objeto de postagem - adicionado ao pedido, representa um volume.
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 (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 códigos de rastreamento são gerados logo após salvar o pedido, de forma automática para cada volume.
Na importação de pedidos das lojas virtuais, o vínculo do serviço de entrega pode ocorrer automaticamente, basta adicionar aliases nos serviços de entrega (conforme a seção anterior de configuração). Cada alias adicionado, identifica o serviço de entrega em uma de suas lojas virtuais.
É importante ressaltar, que o vínculo automático do serviço de entrega, através dos aliases, gera 1 código de rastreamento. Quando for necessário enviar o pedido em múltiplos volumes, é necessário inserir manualmente os volumes adicionais.
Atenção:
Se a venda já tiver códigos de rastreamento gerados, e for necessário adicionar mais volumes, é preciso apagar os volumes existentes e salvar a venda. Somente em uma venda sem rastreamentos será possível inserir novos volumes.
Somente assim, 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.”
Remessas de encomendas
As remessas são criadas a partir dos objetos de postagem (volumes logísticos) gerados nas vendas e notas fiscais. Para acessar a área de gerenciamento das remessas, acesse Vendas → Integrações Logísticas.
Geração de remessas
Ao acessar a tela, será listado todos os objetos de postagem gerados no Bling, separados por tipo de integração. Para gerar uma remessa, selecione os objetos de postagem desejados e clique em Gerar remessa selecionados.
Observações:
- Caso você possua muitos objetos, poderá selecioná-los em diferentes páginas, a sua seleção é mantida ao mudar a página.
- Para visualizar os registros de coleta gerados, pressione Visualizar Remessas, para visualizar os objetos de postagem pressione Visualizar Objetos, ambos no menu de ações no canto direito da tela.
Após clicar em Gerar remessa selecionados você será redirecionado para a página da remessa, onde serão exibidos os dados da remessa e a lista com os objetos de postagem (encomendas) selecionadas anteriormente.
Neste momento os objetos serão validados, aqueles com problemas serão destacados, conforme o exemplo a seguir.
- Ao clicar sob um objeto de postagem da lista, serão exibidas as informações dele, estas informações podem ser editadas a qualquer momento, antes que a remessa seja enviada.
- Objetos com problemas de validação recebem um ícone de informação, ao clicar sob ele, será exibida uma lista com os problemas a serem corrigidos.
Ao clicar sob o ícone de informação (2), é exibida uma lista com os problemas a serem corrigidos, conforme a imagem a seguir:
No objeto de postagem, é possível editar as seguintes características do objeto (utilizadas para o cálculo de frete e envio das encomendas):
- Serviços adicionais: clique para expandir e preencher o valor declarado.
- Valor declarado: valor declarado dos produtos, é o 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).
- Características: clique para expandir os detalhes do objeto de postagem.
- Tipo do objeto: tipo de objeto que será enviado (mantenha sempre selecionado o tipo Pacote/Caixa).
- Embalagem: é possível escolher a embalagem para envio do produto (são consultadas apenas embalagens com situação ativa, para mais informações acesse o Manual Embalagens ).
- Peso bruto: peso total do volume em quilogramas (peso bruto = peso líquido + peso embalagem) .
- Dimensões (se uma embalagem for selecionada, 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.
Na aba Endereço destinatário é possível informar um endereço de entrega alternativo, diferente do endereço cadastrado no contato do cliente.
Na aba Cotação é possível obter a estimativa da data de entrega e o valor aproximado da entrega (veja a seção Cotação de frete deste manual).
Na aba Rastreamento será exibida a última situação de sua entrega, caso houver (veja a seção Rastreamento deste manual).
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.
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.
Observações:
- As remessas que possuem encomendas com erros, não poderão ser enviadas.
- As remessas podem ser excluídas a qualquer momento, enquanto estiverem com a situação Em aberto ou Cancelado.
- As encomendas 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 → 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
Juntamente 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 for possível resolver, deve-se entrar em contato com o suporte do Bling, informando a mensagem erro.
Impressão de etiquetas
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 do pedido de coleta.
Onde a funcionalidade de impressão está disponível?
- Na listagem de pedidos de venda e notas fiscais, através da opção "Imprimir Etiqueta de Envio", localizada no menu de três pontinhos à frente de cada venda;
- Na listagem de objetos de postagem, no módulo de integrações logísticas (Vendas → Integrações Logísticas), onde pode ser feita a impressão de várias etiquetas, selecionando o objeto e clicando em 'Imprimir etiquetas'
- No módulo de Checkout de Pedidos de Venda.
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, acesse Preferências → Logística → Correios → Impressão de etiquetas correios.
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.
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.
É possível visualizar estas informações na listagem de pedidos de venda, notas fiscais e de objetos de postagem no módulo de integrações logísticas.
Os rastreamentos são sincronizados de forma automática, de hora em hora. Também é possível realizar a sincronização manual para cada objeto, pressionando o botão SINCRONIZAR.
Para mais detalhes é necessário acessar o link Histórico na logística, onde é possível consultar o histórico completo da entrega da mercadoria.
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
Cotação de frete
É possível realizar a simulação do valor do frete para os serviços logísticos da Mandaê.
Ao salvar uma venda com Objetos de Postagem, a obtenção da cotação é realizada automaticamente levando em consideração os parâmetros da venda.
Pode-se também realizar a cotação manualmente tanto no contexto das vendas (pedidos de venda e notas fiscais), quanto no módulo de Integrações Logísticas. A imagem a seguir demonstra os passos para se obter as cotações na seção de transporte de um pedido de venda:
- CEP Origem: Se a venda possuir uma loja vinculada, é considerado o CEP de origem da loja, 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 configurado.
- Valor declarado: o campo é preenchido automaticamente conforme o valor total da venda,. Pode ser alterado para obter cotações com múltiplos volumes.
- Peso: o campo é preenchido conforme o campo peso bruto na venda. Para vendas com múltiplos volumes, deve ser editado conforme a distribuição dos produtos em cada volume.
- Largura: preencha com a altura do pacote/caixa do volume.
- Altura: preencha com a altura do pacote/caixa do volume.
- Comprimento: preencha com a altura do pacote/caixa do volume.
Após preencher os dados acima, pressione Obter cotação. Será obtido os valores de frete para cada serviço logístico da Mandaê.
- Serviço de entrega: selecione o serviço de entrega que preferir para o volume, e clique em salvar.
Observações:
- Somente após selecionar um serviço de entrega válido e salvar a cotação, os dados do volume e o seletor do serviço serão atualizados.
- O processo de obter a cotação, selecionar um serviço de entrega válido, salvar a cotação e salvar a venda, quando feito a partir de um volume já existente, faz com que o vínculo deste com a venda seja perdido e gerado um novo objeto com os dados salvos - se houver código de rastreamento no objeto, este será perdido.
Após salvar a venda com volumes configurados, a cotação também pode ser obtida no módulo de integrações logísticas. Em Vendas → Integrações Logísticas escolha sua integração Mandaê no filtro de integrações. Será exibida a listagem de objetos de postagem. Clique no objeto que deseja obter a cotação, verifique os dados do volume, e pressione Obter Cotação, conforme a imagem a seguir:
Na aba de Dados gerais, no link Serviços adicionais, pode-se setar o valor declarado. Clicando no link Características pode-se visualizar e editar as características do volume.
Enquanto na aba Cotação, é possível obter a cotação. Neste contexto, o serviço de entrega já estará configurado, por esse motivo é retornada somente a cotação para o serviço específico.