Guia de Instalação
Aplicativo
Dentro da Boxlink, acesse Configurações › Transportadoras › Cadastrar Nova e localize a Loggi na lista de operadoras disponíveis.
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.
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.
Rastreamento
O 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.
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.
Serviços de entrega
Ative apenas um serviço por vez para garantir o sucesso da integração.
Serviço de coleta pulverizada, disponibilizado sob demanda quando há pacotes integrados com a Loggi.
Grade fixa, disponibilizado mediante negociação comercial prévia com a Loggi.
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 Em processamento até que a Loggi confirme o pacote. Quando isso ocorrer, o status será atualizado para Emitida.
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.
Para dúvidas sobre configuração, troca de transportadoras ou treinamento, fale com o time técnico.