API de Correios: qué puedes hacer y cómo usarla con agentes de IA
Correios es el servicio postal de Brasil. Su API permite consultar precio y plazo de envío, rastrear objetos y preparar envíos con el contrato de la empresa. La usan tiendas online, ERP y operaciones logísticas que envían con SEDEX y PAC. El acceso depende de un contrato con Correios y de las credenciales generadas para él.
Qué ofrece la API de Correios
Seguimiento
Consulta de los eventos de un objeto a partir del código de seguimiento, desde la admisión hasta la entrega.
Precio y plazo
Cálculo de importe y plazo por servicio, código postal de origen y destino, peso y dimensiones.
Preenvío
Registro anticipado de los objetos a enviar, con datos del remitente, del destinatario y del servicio.
Etiquetas y rótulos
Generación de las etiquetas y de los códigos de objeto que se usan en el envío.
Consulta de código postal
Búsqueda de la dirección a partir del código postal para validar los datos de entrega.
Servicios del contrato
Consulta de los servicios habilitados en el contrato y de las unidades de atención.
Cómo acceder a la API de Correios
- Con las credenciales de tu empresaEl acceso usa el usuario del portal de Correios vinculado al contrato y un código de acceso a las APIs, que se cambian por un token de validez limitada. Los servicios disponibles dependen de lo que esté habilitado en el contrato.
- El token caduca: iTeam lo renueva automáticamente, pero las credenciales revocadas detienen las consultas.
- Los datos del destinatario son personales: solo el agente de logística debería verlos completos. En Brasil se rigen por la LGPD, la ley de protección de datos.
- Respeta los límites de consulta del contrato y evita rastrear el mismo objeto varias veces al día.
Documentación oficial: cws.correios.com.br
Qué hace un agente de iTeam con la API de Correios
Pedido detenido en el centro de distribución
El agente revisa los objetos en tránsito y separa los que llevan días sin un nuevo evento. El equipo de logística recibe la lista con el último evento y el pedido correspondiente.
Envío elegido por margen
En la cotización para un cliente B2B, el agente compara SEDEX y PAC para el código postal y el volumen, y sugiere el servicio que cumple el plazo acordado con el menor costo.
Preenvío por lotes
Los pedidos facturados en el ERP se convierten en preenvíos con los datos verificados por el agente. Una dirección incompleta o un código postal que no coincide pasa a revisión antes de la etiqueta.
Reclamación por extravío
Cuando el seguimiento indica objeto no localizado, el agente reúne el código, la factura y los datos del destinatario y prepara la reclamación para que la envíe la persona responsable.
De la credencial al agente trabajando, con aprobación
Genera el código de acceso en el portal de Correios
Con el usuario del contrato, el responsable genera el código de acceso a las APIs y confirma qué servicios están habilitados.
Regístralo en la bóveda de iTeam
El usuario, el código y la tarjeta de envío se guardan en la bóveda. Cada agente recibe solo lo que necesita: seguimiento para atención al cliente, preenvío para logística.
Prueba con aprobación
Los primeros seguimientos y cotizaciones funcionan en modo lectura. Los preenvíos empiezan con aprobación humana hasta que el equipo confíe en el flujo.
Equipos de IA listos que usan Correios
Preguntas sobre la API de Correios
¿La API de Correios es gratuita?
En general, el uso de las APIs va ligado al contrato de la empresa con Correios: pagas los servicios postales, no la consulta en sí. Confirma las condiciones de tu contrato.
¿Necesito programar para usar la API de Correios con iTeam?
No necesariamente. La herramienta HTTP de iTeam lee la documentación de la API y el equipo de implantación configura los flujos contigo.
¿Se puede usar la API sin contrato?
El seguimiento suelto existe en el sitio web, pero la integración por API pide una credencial vinculada a un contrato.
