Pular para o conteúdo

Conectando a Intelipost

Frete e logísticaConexão: credenciaisAtualizado em

Ver o que a Toca faz com o Intelipost →

Em homologação

Abrir integrações no app

A conexão com a Intelipost usa a api-key da conta da sua loja no TMS da Intelipost, a mesma chave que plataformas e ERPs usam para falar com ela. Não é o seu e-mail nem a sua senha do painel. Com ela, a Toca consulta a sua conta a cada pergunta e prepara as alterações que você aprovar.

Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.

Antes de começar

  • A api-key é fornecida pelo suporte da Intelipost: abra um chamado na central de ajuda da Intelipost pedindo a chave de API da sua conta. Se a sua loja já usa a Intelipost por uma plataforma de e-commerce ou um ERP, a chave da conta é a mesma.
  • Use a chave da sua conta de produção. A documentação da Intelipost cita uma chave de teste, de uma conta de demonstração; com ela, a Toca mostraria pedidos e métodos de envio que não são os seus.
  • A chave dá acesso a tudo na conta: a Intelipost não tem chave só de leitura.

Passo a passo

  1. Acesse Configurações → Integrações na Toca.
  2. Localize o card Intelipost e clique em Conectar.
  3. Cole a chave no campo api-key.
  4. Clique em Salvar. O card fica marcado como conectado.

O que a Toca acessa

Com a conexão ativa, a Toca lê os pedidos de envio e de reversa pelo número do pedido, do pedido de venda, da nota fiscal, da chave da nota ou do código de rastreio, com o status e o histórico de cada volume, a previsão e o atraso na entrega, o frete cobrado do cliente e o custo da transportadora; as etiquetas, entregues como link do PDF (ou do ZPL) para você imprimir; os métodos de envio e as transportadoras da conta; as cotações de frete por CEP; as origens (centros de distribuição); os pontos de retirada; os grupos de produtos; os dias não úteis; os status de rastreio da Intelipost; e as pré-faturas e cobranças da auditoria de frete, entregues como link do arquivo.

A Intelipost não oferece, pela API, busca de pedidos por data ou status. Para perguntas sobre muitos pedidos, como os atrasados do mês, a Toca consulta um a um os pedidos que a sua loja ou o seu ERP conhecem; os relatórios gerais continuam no painel da Intelipost.

A Toca também altera: cria pedidos de envio e de reversa; marca pedidos como prontos para envio e como despachados; grava nota fiscal, declaração de conteúdo, volumes e código de rastreio; troca o método de envio; cancela pedidos de envio; dispara a pré-lista de postagem (PLP) para a transportadora; reserva códigos de rastreio dos Correios; lança eventos de rastreio; anexa arquivos por link; liga e desliga o aviso de rastreio por WhatsApp; anonimiza dados pessoais pela LGPD; e cuida de pontos de retirada, origens, grupos de produtos, dias não úteis, motoristas e veículos. Toda alteração só acontece mediante sua aprovação explícita, pedido a pedido, dentro do chat.

Algumas alterações não se desfazem, e o pedido de aprovação diz isso: cancelar pedido de envio, anonimizar dados, reservar códigos de rastreio e excluir cadastros. Ao cotar frete e criar pedidos, a Toca se identifica para a Intelipost como origem Toca; regras de frete que você criou para uma plataforma específica podem não valer para essas chamadas.

Manutenção da conexão

A chave não vence por tempo de uso; ela deixa de valer se a Intelipost a trocar ou revogar. Para trocar, peça a nova ao suporte, abra o card em Configurações → Integrações pelo botão Gerenciar, cole a chave nova e clique em Atualizar. Por segurança, a chave salva aparece mascarada.

A Intelipost limita o número de chamadas por minuto em algumas APIs. A Toca faz poucas consultas por vez; se outros sistemas usam a mesma chave, o limite é dividido entre eles.

Problemas comuns

  • A Intelipost responde que o pedido requer autenticação (401) — confira se colou a chave inteira, sem espaço. Se o suporte trocou a chave, atualize o card com a nova.
  • A Toca não encontra um pedido — confira se o número é o do pedido de envio na Intelipost. A Toca também procura pelo número do pedido de venda, pela nota fiscal e pelo código de rastreio.
  • Os pedidos e métodos de envio não são os da sua loja — a chave é de outra conta, como a de demonstração da documentação. Peça ao suporte a chave da sua conta de produção.
  • A Intelipost pede para esperar (429) — o limite de chamadas estourou. Espere um minuto e peça de novo.
  • A auditoria de frete volta vazia — pré-faturas e cobranças só existem para quem contratou o módulo de auditoria (conciliação de fretes) da Intelipost.
  • Conectou a conta errada — use Excluir integração no menu ⋯ do card e conecte de novo, com a chave da conta certa.

Outras integrações de frete e logística

Abrir integrações no app