API dos Correios: o que dá para fazer e como usar com agentes de IA
A API dos Correios permite consultar preço e prazo de envio, rastrear objetos e preparar postagens com o contrato da empresa. É usada por lojas virtuais, ERPs e operações logísticas que enviam com SEDEX e PAC. O acesso depende de contrato com os Correios e de credenciais geradas para ele.
Os grandes recursos da API, em português claro.
Consulta dos eventos de um objeto a partir do código de rastreio, do aceite à entrega.
Cálculo de valor e prazo por serviço, CEP de origem e destino, peso e dimensões.
Registro antecipado dos objetos a postar, com dados de remetente, destinatário e serviço.
Geração das etiquetas e códigos de objeto usados na postagem.
Busca de endereço a partir do CEP para validar dados de entrega.
Consulta dos serviços habilitados no contrato e de unidades de atendimento.
Como se acessa a API do Correios.
- Com credencial da sua empresaO acesso usa o usuário do portal dos Correios vinculado ao contrato e um código de acesso às APIs, trocados por um token com validade limitada. Os serviços disponíveis dependem do que está habilitado no contrato.
- Documentação oficialcws.correios.com.br
- O token expira: o iTeam renova automaticamente, mas credenciais revogadas param as consultas.
- Dados de destinatário são pessoais: só o agente de logística deve vê-los completos (LGPD).
- Respeite os limites de consulta do contrato e evite rastrear o mesmo objeto várias vezes ao dia.
- api correios
- api dos correios rastreamento
- api correios preço e prazo
- api correios pré-postagem
- integração api correios
- correios api documentação
- api correios etiqueta
O que um agente do iTeam faz com a API do Correios.
O agente varre os objetos em trânsito e separa os que estão sem novo evento há dias. A equipe de logística recebe a lista com o último evento e o pedido correspondente.
Na cotação para um cliente B2B, o agente compara SEDEX e PAC para o CEP e o volume e sugere o serviço que cabe no prazo combinado com o menor custo.
Pedidos faturados no ERP viram pré-postagens com os dados conferidos pelo agente. Endereço incompleto ou CEP divergente vai para revisão antes da etiqueta.
Quando o rastreio indica objeto não localizado, o agente reúne código, nota e dados do destinatário e prepara a manifestação para a pessoa responsável enviar.
Da credencial ao agente trabalhando, com aprovação.
Gere o código de acesso no portal dos Correios
Com o usuário do contrato, o responsável gera o código de acesso às APIs e confirma quais serviços estão habilitados.
Cadastre no cofre do iTeam
Usuário, código e cartão de postagem ficam no cofre. Cada agente recebe só o que precisa: rastreio para o atendimento, pré-postagem para a logística.
Teste com aprovação
Os primeiros rastreios e cotações rodam em modo leitura. Pré-postagens começam com aprovação humana até a equipe confiar no fluxo.
Dúvidas sobre a API do Correios.
A API dos Correios é gratuita?
De forma geral, o uso das APIs está atrelado ao contrato da empresa com os Correios: você paga os serviços postais, não a consulta em si. Confirme as condições do seu contrato.
Preciso programar para usar a API dos Correios com o iTeam?
Não necessariamente. A ferramenta HTTP do iTeam lê a documentação da API e o time de implantação configura os fluxos com você.
Dá para usar a API sem contrato?
O rastreio avulso existe no site, mas a integração via API pede credencial vinculada a um contrato.
Quais consultas e serviços um agente de IA faz com a API dos Correios?
O agente consulta rastreamento, calcula preço e prazo, valida CEP e prepara a pré-postagem com o contrato da empresa. Em uma loja, ele avisa o cliente quando o objeto sai para entrega e abre um chamado se o rastreio para. Os serviços disponíveis dependem do que está habilitado no contrato. No iTeam, o agente de logística recebe só o acesso que essa função precisa.
Existe ambiente de homologação nos Correios para testar a integração?
Sim, a documentação do Correios Web Service indica um endereço de homologação separado do de produção, o que permite testar token e chamadas antes de ir ao ar. O acesso ao cwshom usa as mesmas credenciais de contrato, e nem todos os serviços respondem lá como em produção. Confira no manual de integração quais APIs estão disponíveis no ambiente de teste.
Como a autenticação da API dos Correios funciona com contrato e código de acesso?
Você entra no portal CWS com o usuário do Meu Correios, gera um código de acesso às APIs e troca esse código por um token, informando contrato ou cartão de postagem. O token tem validade limitada e precisa ser renovado. Cada chave de acesso usa um tipo de autorização, então misturar contrato e cartão na mesma chave não funciona.
Dá para usar a API dos Correios sem contrato com a empresa?
Preço e prazo personalizados, pré-postagem e etiqueta dependem de contrato e do cartão de postagem, segundo os manuais do CWS. Sem contrato, uma alternativa é usar um agregador de frete que já tenha o seu próprio contrato, pagando pelo serviço dele. Confira com um representante comercial dos Correios o que o seu perfil de cliente consegue habilitar.
Por que o rastreio dos Correios às vezes falha ou volta sem atualização no agente?
O objeto pode não ter sido lido ainda no sistema, o token pode ter expirado ou a credencial ter sido revogada. O agente deve diferenciar erro de autenticação, que exige renovar o token, de objeto sem evento, que é espera. Para não gastar o limite do contrato, ele consulta o mesmo objeto em intervalos espaçados e só em pedidos em trânsito.
Como o agente evita tarifa errada ao calcular frete e prazo dos Correios?
Ele usa o CEP de origem do contrato, peso e dimensões reais do cadastro do produto e o serviço correto, como SEDEX ou PAC, em vez de números aproximados. Peso cubado errado é a causa mais comum de diferença entre o frete cotado e o cobrado. Se o cadastro de produto está incompleto, o agente sinaliza para uma pessoa corrigir antes de cotar.
Quanto custa usar a API dos Correios com agentes de IA?
O acesso à API acompanha o contrato com os Correios, e o que se paga são os serviços postais efetivamente usados, com a tabela do seu contrato. O custo muda conforme serviço, peso e distância, e não há valor único para citar. Confira com o seu representante comercial. O custo do modelo de IA que opera o agente é separado, e aparece por agente no iTeam.
O destinatário dos Correios é dado pessoal e como o agente deve tratá-lo?
É: nome, endereço e telefone identificam a pessoa, e a LGPD pede uso restrito à entrega e ao atendimento. Só o agente de logística deve ver o endereço completo; um agente de marketing não precisa dele. Evite colar etiquetas em conversas abertas. A trilha de auditoria mostra qual agente consultou qual objeto e quando.
