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
- Acesse
Configurações → Integraçõesna Toca. - Localize o card Intelipost e clique em Conectar.
- Cole a chave no campo api-key.
- 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.