Principal Integrações Integração com a Loggi

Integração com a Loggi

Última atualização em Mar 20, 2026

1. Integrando com a Loggi

A Loggi é uma das principais transportadoras tecnológicas do Brasil, especializada em entregas expressas para e-commerce. Ao integrá-la à Secret Solutions, é possível cotar fretes, criar envios, gerar etiquetas e rastrear pacotes automaticamente, sem precisar acessar o painel da Loggi manualmente.

2. Antes de começar — O que você vai precisar

Para realizar a integração, é necessário obter as credenciais de acesso à API da Loggi: o Client ID e o Client Secret. Essas informações são fornecidas diretamente pelo time de vendas da Loggi.

Entre em contato com a Loggi pela Central de Ajuda para solicitar o acesso à API e receber suas credenciais antes de seguir os próximos passos.

⚠️ Atenção: Nunca solicite ou compartilhe seu Client ID e Client Secret com terceiros. Essas credenciais são pessoais e intransferíveis.

3. Passo a Passo — Conectando a Loggi à Secret Solutions

3.1 Gerando o Token de Acesso

O Token é a "chave" que autoriza a Secret Solutions a se comunicar com a Loggi. Ele é gerado automaticamente a partir do seu Client ID e Client Secret.

  1. Acesse a Central de Integrações da Secret Solutions clicando no ícone de tomada no canto superior direito da tela de aplicativos.

  2. No menu de categorias, clique em Transportadoras.

  3. Localize e clique sobre o card da Loggi.

  4. Preencha os campos com o Client ID e o Client Secret fornecidos pela Loggi.

  5. Clique em Salvar — o sistema irá gerar e armazenar o Token de Acesso automaticamente.

  6. Clique em Testar para validar se a conexão foi estabelecida com sucesso.

  7. Quando a integração estiver ativa, o status Conectado será exibido na tela.

4. O que é possível fazer após a integração

Com a Loggi conectada à Secret Solutions, as seguintes operações passam a funcionar de forma automática:

Cotação de Frete: Antes de criar um envio, a plataforma consulta automaticamente a Loggi e retorna as opções de preço e prazo disponíveis para o CEP de destino, levando em conta o peso, as dimensões e o endereço de origem do pacote.

Criação de Envios (Shipment): Ao confirmar um pedido, a Secret Solutions cria o envio na Loggi de forma assíncrona — ou seja, o sistema registra o pedido de envio e aguarda a confirmação da Loggi antes de prosseguir, garantindo que nenhum envio seja criado com erro.

Para criar um envio, são necessários:

  • Endereço de origem (remetente).

  • Endereço de destino (destinatário).

  • Dados do pacote: peso e dimensões.

Geração de Etiqueta Após a confirmação do envio pela Loggi, a etiqueta de despacho é gerada automaticamente no padrão Loggi. A etiqueta fica vinculada ao envio e pode ser impressa diretamente pela plataforma.

Rastreio de Pacotes O acompanhamento dos envios pode ser feito de duas formas:

  • Consulta Manual — verifique o status de um pacote a qualquer momento usando o código de rastreio.

  • Webhook — a Loggi envia atualizações automáticas de status em tempo real sempre que houver uma movimentação no pacote. Esta é a forma mais recomendada para manter o status dos pedidos sempre atualizado na plataforma.

Para ativar o Webhook, informe ao time de vendas da Loggi a URL de destino da Secret Solutions. A Loggi irá configurar o envio automático das notificações para essa URL.

Cancelamento de Envio Caso precise interromper um envio, é possível cancelá-lo diretamente pela Secret Solutions. O cancelamento é enviado automaticamente à Loggi, e o pacote terá seu envio interrompido.

Loggi Pontos A integração também permite consultar os pontos de entrega e retirada da Loggi próximos ao endereço do destinatário, facilitando o oferecimento de opções de retirada no checkout.

5. Entendendo os status de rastreio

Após a integração, os pedidos exibirão os status atualizados automaticamente pela Loggi. Confira os principais:

  • Adicionado no sistema — etiqueta criada, pacote pronto para coleta.

  • Coletado — a Loggi já retirou o pacote.

  • Em rota — pacote a caminho do destinatário.

  • Preparando para entrega — pacote na base da Loggi, saindo em breve para entrega.

  • Entregue — pacote recebido pelo destinatário.

  • Destinatário ausente — tentativa de entrega sem sucesso, nova tentativa será realizada.

  • Cancelado — envio interrompido.

  • Devolução iniciada / Devolvido — pacote em processo de retorno ao remetente.

  • Endereço errado — dados do destinatário precisam ser corrigidos.

  • Extraviado / Avariado — pacote com ocorrência durante o transporte.

💡 Dicas de Boas Práticas

Prefira o Webhook ao rastreio manual. O Webhook garante que os status dos pedidos sejam atualizados em tempo real, sem necessidade de consultas periódicas.

Preencha sempre os dados completos do pacote. Quanto mais informações forem fornecidas na cotação (peso exato, dimensões, tipo de coleta), mais preciso será o valor de frete retornado pela Loggi.

Aguarde a confirmação antes de imprimir a etiqueta. Como os envios são criados de forma assíncrona, a etiqueta só estará disponível após a Loggi confirmar o registro do pacote. Tentar gerar a etiqueta antes dessa confirmação resultará em erro.

⚠️ Atenção: O Token de Acesso gerado pela Loggi possui prazo de validade. Caso a integração pare de funcionar, verifique se o token ainda está válido e repita o processo de autenticação para renová-lo.