Guia de Instalação
1 Aplicativo
Dentro da Boxlink, acesse Configurações › Transportadoras › Cadastrar Nova e localize a Loggi na lista de operadoras disponíveis.
2 Autenticação
Preencha o campo Nome da Integração com um nome de sua escolha (ex.: Loggi). Em seguida, insira as credenciais fornecidas pela Loggi durante a homologação:
| CREDENCIAL | DESCRIÇÃO |
|---|---|
| Client ID | Credencial pública da aplicação |
| Client Secret | Chave de segurança, trafegada exclusivamente via API |
| Company ID | Vinculado ao CNPJ raiz da sua conta Loggi |
✅ |
Clique em "Testar" ao lado do Identificador do integrador para que a informação seja preenchida automaticamente. |
💡 |
Em caso de erro, verifique se não existem espaços em branco antes ou depois do Identificador do integrador. |
3 Configuração
Layout da etiqueta:
| OPÇÃO | DESCRIÇÃO |
|---|---|
A4 |
4 etiquetas por folha |
A6 |
1 etiqueta por folha, ideal para impressoras térmicas |
Configure também os parâmetros de operação obrigatórios:
| PARÂMETRO | VALOR | DESCRIÇÃO |
|---|---|---|
| Variável de Coleta | Pickup Type | Obrigatório para habilitar o fluxo de retirada de pacotes |
| Identificador Loggi | DLVR | Código fornecido na homologação; essencial para o roteamento |
| Regime Tributário | ICMS Taxado | Configuração padrão para CNPJs contribuintes |
| Modalidade de Frete | Econômico | Serviço base configurado para a operação |
| Volumes por remessa | Volume Único | A API da Loggi exige que a flag de multivolume esteja desativada |
🔴 |
Restrição crítica: Volume Único A API da Loggi não aceita remessas de múltiplos volumes. A flag de multivolume deve estar desabilitada antes de ativar a operadora. |
4 Rastreamento
rastreamento funciona via Código de Rastreio gerado pela Loggi e transmitido pelo Bling (ERP). A consulta via Chave de Nota Fiscal (NFe) não é suportada pela API da Loggi nesta integração.
|
🏭 1. Geração Loggi gera o código e devolve ao Bling ERP |
🧲 2. Absorção Boxlink lê o código no Bling (ignora a NFe) |
🔍 3. Consulta Boxlink consulta a API da Loggi sem bloqueios |
🖥️ 4. Visibilidade Status em tempo real para o cliente final |
⚠️ |
Atenção operacional: a API da Loggi não localiza pacotes usando apenas a Chave da NFe. O Código de Rastreio gerado pelo Bling é estritamente obrigatório para o funcionamento do rastreamento. |
5 Serviços de enrega
Ative apenas um serviço por vez para garantir o sucesso da integração.
📦 |
Coleta Serviço de coleta pulverizada, disponibilizado sob demanda quando há pacotes integrados com a Loggi. |
🗓️ |
Coleta Recorrente Grade fixa, disponibilizado mediante negociação comercial prévia com a Loggi. |
🏃 |
Drop-off Serviço econômico. Escolha quando e onde deixar seus pacotes num LoggiPonto próximo. |
✅ |
Este é o último passo da instalação! Após salvar, você já pode fazer envios com a Loggi para todo o Brasil. |
Cotação de Frete
💡 |
Consulte o guia técnico de embalagens da Loggi para verificar os limites operacionais antes de prosseguir. |
⚡ |
Alta performance: a integração prioriza consultas à Tabela VTEX/Btex em vez de chamadas diretas à API, garantindo 0,0004 ms de resposta, essencial para eventos de alto volume. |
1. Via Marketplace
Essa é uma integração que acontece entre a Boxlink e o seu Marketplace, sujeita aos recursos disponibilizados. Se precisar de ajuda, entre em contato com o suporte da Boxlink.
2. Manual
Preencha os dados da remessa no formulário de cotação e clique em "Obter Cotação".
Integração de Pedidos
💡 |
Se você habilitou a opção "Enviar remessas de postagem automaticamente ao autorizar a NF", a integração dos pedidos será realizada automaticamente para vendas de Marketplace com Alias configurado. |
1. Vincular a Loggi ao pedido
Acesse o pedido na Boxlink, selecione a Loggi como transportadora e confirme.
✅ |
A remessa ficará no status |
2. Integrar pacotes
Os pacotes integrados ficam disponíveis para coleta ou drop-off conforme o serviço configurado na instalação.
Impressão de Etiqueta
1. Gerando etiquetas
Acesse o pedido na Boxlink ou Bling e clique em "Gerar Etiqueta". A etiqueta será gerada no formato configurado (A4 ou A6).
✅ |
Pronto, agora é só imprimir e colar a etiqueta na caixa! Confira o guia de embalagens da Loggi para garantir a melhor experiência de envio. |
2. Gerando etiquetas em massa
Para impressão em lote, acesse diretamente o painel da Loggi em app.loggi.com e utilize a funcionalidade de impressão massiva.
Acompanhamento de Envios
Os status dos pedidos serão movimentados de acordo com as atualizações do envio na Loggi. Você também pode acessar e gerir seus envios diretamente em www.loggi.com.
Ajuda
A maior parte dos problemas é causada por erros simples de configuração. Recomendamos revisar o passo a passo e garantir que todas as etapas foram cumpridas antes de abrir um chamado.
📍 |
Acesse a central de ajuda da Loggi em ajuda.loggi.com e fale com o time de suporte. |
|
Suporte Boxlink Para dúvidas sobre configuração, troca de transportadoras ou treinamento, fale com o time técnico. Falar com suporte · (48) 99191-8143 |