API Correios : ce qu'on peut faire et comment l'utiliser avec des agents IA
L'API des Correios, la poste brésilienne, permet de consulter le prix et le délai d'envoi, de suivre les objets et de préparer les envois avec le contrat de l'entreprise. Elle sert aux boutiques en ligne, aux ERP et aux opérations logistiques qui expédient avec SEDEX et PAC. L'accès dépend d'un contrat avec les Correios et d'identifiants générés pour ce contrat. Elle concerne les entreprises qui expédient au Brésil.
Ce que propose l’API Correios
Suivi
Consultation des événements d'un objet à partir du code de suivi, de la prise en charge à la livraison.
Prix et délai
Calcul du tarif et du délai par service, code postal (CEP) d'origine et de destination, poids et dimensions.
Pré-envoi
Enregistrement anticipé des objets à expédier, avec les données de l'expéditeur, du destinataire et du service.
Étiquettes
Génération des étiquettes et des codes d'objet utilisés à l'expédition.
Consultation de CEP
Recherche d'adresse à partir du CEP pour valider les données de livraison.
Services du contrat
Consultation des services activés dans le contrat et des unités d'accueil.
Comment accéder à l’API Correios
- Avec les identifiants de votre entrepriseL'accès utilise l'utilisateur du portail des Correios lié au contrat et un code d'accès aux API, échangés contre un jeton de durée limitée. Les services disponibles dépendent de ce qui est activé dans le contrat.
- Le jeton expire : iTeam le renouvelle automatiquement, mais des identifiants révoqués interrompent les consultations.
- Les données des destinataires sont personnelles : seul l'agent logistique doit les voir en entier (LGPD, la loi brésilienne de protection des données).
- Respectez les limites de consultation du contrat et évitez de suivre le même objet plusieurs fois par jour.
Documentation officielle: cws.correios.com.br
Ce qu’un agent iTeam fait avec l’API Correios
Commande bloquée au centre de tri
L'agent passe en revue les objets en transit et isole ceux sans nouvel événement depuis plusieurs jours. L'équipe logistique reçoit la liste avec le dernier événement et la commande correspondante.
Transport choisi selon la marge
Pour un devis B2B, l'agent compare SEDEX et PAC pour le CEP et le volume, et suggère le service qui respecte le délai convenu au moindre coût.
Pré-envoi en lot
Les commandes facturées dans l'ERP deviennent des pré-envois dont l'agent a vérifié les données. Une adresse incomplète ou un CEP divergent part en revue avant l'étiquette.
Déclaration de colis perdu
Quand le suivi indique un objet introuvable, l'agent réunit le code, la facture et les données du destinataire, et prépare la déclaration que la personne responsable enverra.
De l’identifiant à l’agent au travail, avec validation
Générer le code d'accès sur le portail des Correios
Avec l'utilisateur du contrat, le responsable génère le code d'accès aux API et confirme les services activés.
Enregistrer dans le coffre d'iTeam
Utilisateur, code et carte d'expédition sont placés dans le coffre. Chaque agent ne reçoit que le nécessaire : le suivi pour le support, le pré-envoi pour la logistique.
Tester avec validation
Les premiers suivis et devis tournent en lecture seule. Les pré-envois démarrent avec une validation humaine, jusqu'à ce que l'équipe fasse confiance au flux.
Équipes IA prêtes à l’emploi qui utilisent Correios
Questions sur l’API Correios
L'API des Correios est-elle gratuite ?
En général, l'usage des API est lié au contrat de l'entreprise avec les Correios : vous payez les services postaux, pas la consultation elle-même. Vérifiez les conditions de votre contrat.
Faut-il programmer pour utiliser l'API des Correios avec iTeam ?
Pas nécessairement. L'outil HTTP d'iTeam lit la documentation de l'API et l'équipe de déploiement configure les flux avec vous.
Peut-on utiliser l'API sans contrat ?
Le suivi à l'unité existe sur le site, mais l'intégration par API demande un identifiant rattaché à un contrat.
