Comment extraire les données Boleto Bancário
vers Excel pour le rapprochement des paiements
Le système brésilien Boleto Bancário traite près de 37 milliards de transactions par an, chacune régie par une norme FEBRABAN précise qui définit la position de chaque chiffre du code-barres à 44 caractères. Pourtant, la majorité des équipes financières qui gèrent des paiements transfrontaliers extraient encore ces données de la même manière qu'avant l'existence de la norme : à la main. Entre le PDF reçu d'un fournisseur brésilien et la ligne de rapprochement finale dans votre feuille de calcul se trouve un écart de saisie manuelle, de copier-coller et de vérification visuelle que la structure même du document était conçue pour éliminer.
Points clés à retenir
- 37 milliards de transactions Boleto par an — chacune repose sur une norme FEBRABAN qui place chacun des 44 chiffres du code-barres à une position prévisible.
- La même norme structurée qui permet à tout scanner bancaire de vérifier un paiement en quelques millisecondes exige encore qu'un humain lise et saisisse chaque champ dans une ligne de feuille de calcul.
- Définissez vos colonnes une seule fois — Code-barres, Date d'échéance, Montant, Bénéficiaire — et extrayez par lots des dizaines de Boletos en une seule ligne Excel par document.
Qu'est-ce qu'un Boleto Bancário et pourquoi comporte-t-il deux séries de numéros ?
Un Boleto Bancário — souvent abrégé en Boleto — est un instrument de paiement réglementé émis par les banques brésiliennes. Considérez-le comme un hybride entre une facture et un bordereau de paiement : le bénéficiaire (beneficiário) l'émet via sa banque, et le payeur (pagador) l'utilise pour effectuer un paiement dans plus de 40 000 points de service au Brésil — banques, loteries, supermarchés, bureaux de poste ou via la banque en ligne.
Chaque Boleto comporte un code-barres à 44 chiffres (código de barras) optimisé pour la lecture optique et une ligne lisible à 47 chiffres (linha digitável) conçue pour la saisie manuelle aux guichets automatiques et dans les applications bancaires. Les deux représentent le même paiement — ils l'encodent simplement différemment.
Les 44 chiffres du code-barres se décomposent en cinq sections définies par la norme de layout de code-barres FEBRABAN (Layout - Código de Barras - Versão 7) :
| Positions | Champ | Exemple | Fonction |
|---|---|---|---|
| 1–3 | Code banque (código do banco) | 001 | Identifie la banque émettrice (001 = Banco do Brasil, 237 = Bradesco, 341 = Itaú) |
| 4 | Code devise (código da moeda) | 9 | 9 = réal brésilien (R$) |
| 5 | Chiffre de contrôle (dígito verificador geral) | 3 | Vérifie l'intégrité de l'ensemble du code-barres à l'aide du modulo-11 |
| 6–9 | Facteur de date d'échéance (fator de vencimento) | 3737 | Jours depuis la date de référence (07/10/1997) — correspond à la date d'échéance |
| 10–19 | Montant (valor) | 0000000100 | Montant en centavos (R$1,00 dans cet exemple) |
| 20–44 | Champ libre (campo livre) | 0500940144816060680935031 | Défini par la banque : notre numéro, agence, compte, portefeuille — varie selon la banque |
Depuis 2018, suite à une directive de la FEBRABAN, tous les Boletos doivent être enregistrés (boletos registrados) — la banque émettrice est informée de chaque Boleto au moment de sa création, et non seulement lors de son paiement. L'ancien système de Boleto non enregistré (boleto sem registro), où les banques ne prenaient connaissance d'un Boleto qu'à sa présentation pour paiement, a été abandonné pour réduire la fraude et améliorer la traçabilité. Aujourd'hui, chaque Boleto que vous recevez présente la même structure standardisée avec un enregistrement complet côté banque.
Pour une vue d'ensemble du paysage documentaire brésilien — y compris la Nota Fiscal Eletrônica (NF-e), le système de facturation électronique obligatoire du pays — consultez notre guide complet sur les documents fiscaux et financiers brésiliens.
Le goulot d'étranglement du traitement des Boletos, bien connu des équipes de rapprochement
Un seul Boleto contient environ une douzaine de points de données essentiels au rapprochement des paiements. Mais contrairement à une facture dont les données sont conceptuellement liées (lignes d'article → sous-total → taxes → total), les données d'un Boleto sont conçues pour l'exécution du paiement, et non pour la tenue de registres. Le code-barres encode le montant du paiement et la date d'échéance, mais il ne vous indique pas l'objet du paiement, la facture de référence, ni si le payeur a déjà envoyé une remise correspondante.
Ce décalage de conception crée un problème de flux de travail spécifique pour les équipes financières :
Le coût réel ne réside pas dans la vitesse de saisie, mais dans le cycle de rapprochement : extraction manuelle → correspondance manuelle → vérification manuelle du statut. Chaque étape introduit un délai et une erreur potentielle, et avec 37 milliards de transactions par an, ces délais se cumulent en une inefficacité structurelle dans l'ensemble du système de paiement B2B.
Comment extraire les données d'un Boleto vers Excel — étape par étape
L'extraction de Boleto ne nécessite pas un flux de travail complexe. La structure du document est standardisée et les champs nécessaires au rapprochement sont clairement définis. La seule pièce manquante est un outil capable de les lire depuis n'importe quel format — que le Boleto arrive sous forme de PDF depuis un portail bancaire, de capture d'écran depuis une application mobile ou de reçu papier scanné.
Le processus se déroule en trois étapes :
Essayez avec une capture d'écran ou un PDF de Boleto ci-dessous — aucune inscription requise :
Les fichiers sont traités en toute sécurité et ne sont pas stockés.
Quels champs du Boleto sont les plus importants pour le rapprochement des paiements
Tous les champs d'un Boleto ne sont pas aussi utiles pour le rapprochement. Le tableau suivant répertorie les champs qui pilotent réellement la correspondance des paiements, le suivi des statuts et les rapports — organisés selon leur utilisation pratique, et non selon leur emplacement sur le document.
| Champ (anglais) | Terme portugais | Utilisation en rapprochement |
|---|---|---|
| Code-barres (44 chiffres) | Código de barras | Identifiant principal — correspond à la référence du code-barres sur les lignes du relevé bancaire. Utilisez-le pour lier les paiements aux créances. |
| Ligne lisible (47 chiffres) | Linha digitável | Version lisible du code-barres. Utile lorsqu'une capture d'écran de Boleto n'inclut pas le graphique du code-barres. |
| Date d'échéance | Vencimento | Détermine la date limite de paiement et le risque de protêt. Suivez le statut en retard ou en attente par tranche d'ancienneté. |
| Montant | Valor | Montant principal pour le rapprochement des paiements. Recoupez avec les crédits du relevé bancaire. |
| Notre numéro | Nosso número | Référence interne attribuée par la banque — souvent l'élément le plus proche d'un identifiant de transaction unique pour le rapprochement. |
| Bénéficiaire | Beneficiário / Cedente | Identifie l'entité réceptrice. Essentiel lors du rapprochement des paiements entre plusieurs filiales ou unités commerciales. |
| Payeur | Pagador / Sacado | Identifie la personne ayant effectué le paiement. Utilisez-le pour les rapports de vieillissement des comptes clients et le suivi client. |
| Portefeuille | Carteira | Type de contrat de collecte entre le bénéficiaire et la banque. Utile pour le calcul des frais et le mappage des catégories de rapprochement. |
| Votre numéro | Número do documento / Seu número | Champ facultatif où le bénéficiaire insère sa référence interne de facture ou de contrat — le lien le plus direct entre un paiement Boleto et vos propres enregistrements. |
Le code-barres est la clé de rapprochement la plus fiable car il apparaît à la fois sur le Boleto et sur le relevé bancaire. Si vous ne pouvez extraire qu'un seul champ, extrayez le code-barres. Notre numéro est la deuxième meilleure référence lorsque le code-barres n'est pas disponible.
Et le traitement par lots de dizaines de boletos ?
Le processus d'extraction décrit ci-dessus fonctionne de la même manière, que vous traitiez un seul boleto ou une centaine. Le modèle de Traitement par lots en priorité est conçu pour le volume généré par la réconciliation B2B : importez tous les boletos d'une période donnée, définissez vos colonnes une fois, et laissez l'IA extraire chaque fichier selon les mêmes définitions de champs. Le résultat est un fichier Excel unique avec une ligne par boleto — prêt à être importé dans votre ERP ou outil de réconciliation.
Si vous devez régulièrement faire correspondre les boletos avec les relevés bancaires, envisagez de mettre en place une routine d'extraction mensuelle : rassemblez tous les boletos émis et reçus au cours du mois, extrayez-les par lot, et réconciliez le tableur obtenu avec le relevé mensuel de votre banque. L'ensemble du processus prend quelques minutes au lieu d'heures, et comme chaque champ est extrait selon les mêmes définitions de colonnes, vous éliminez l'erreur de réconciliation la plus courante — les formats de champs incompatibles entre des boletos de différentes banques.
Par exemple, un lot de 50 boletos provenant de divers émetteurs — Banco do Brasil, Bradesco, Itaú, Santander — nécessitait auparavant qu'un employé ouvre chaque PDF, localise les chiffres du code-barres, la date d'échéance (vencimento) et le montant (valor), les saisisse dans un tableur, puis vérifie manuellement que les totaux correspondent au relevé bancaire. Avec l'extraction par lots, ces 50 PDF sont importés en moins d'une minute, l'extraction s'effectue en parallèle, et le résultat arrive sous la forme d'un fichier structuré unique contenant les 50 lignes prêtes pour la réconciliation — aucune manipulation document par document n'est nécessaire.
Questions fréquentes sur l'extraction de données de boletos
L'extraction fonctionne-t-elle pour les boletos enregistrés et non enregistrés ?
Depuis 2018, tous les boletos émis au Brésil sont enregistrés (boletos registrados). Le format non enregistré (sem registro) a été progressivement abandonné par FEBRABAN. Si vous traitez des boletos courants, ils suivent la structure standard à 44 chiffres du code-barres décrite ci-dessus. Les boletos non enregistrés plus anciens peuvent avoir des dispositions de champs légèrement différentes, mais les champs d'identification principaux — code bancaire, montant, date d'échéance — suivent le même encodage FEBRABAN.
Quelle est la différence entre les nombres à 44 et 47 chiffres ?
Le code-barres à 44 chiffres (código de barras) est la version lisible par machine utilisée par les scanners de codes-barres. La ligne lisible à 47 chiffres (linha digitável) est la version lisible par l'humain qui inclut trois chiffres de contrôle supplémentaires — un inséré dans chacun des trois premiers blocs — afin qu'un guichetier bancaire ou un DAB puisse valider le nombre au fur et à mesure de sa saisie, chiffre par chiffre. Les deux encodent les mêmes informations de paiement. Certains PDF de Boleto n'affichent qu'un seul format ; l'outil d'extraction peut lire l'un ou l'autre.
Les Boletos peuvent-ils arriver sous forme de PDF cryptés ?
Oui — certaines banques et plateformes de paiement envoient des PDF de Boleto protégés par mot de passe. L'outil d'extraction prend en charge les PDF protégés par mot de passe si vous fournissez le mot de passe. Pour les Boletos récurrents provenant de la même source, vous pouvez pré-enregistrer le mot de passe afin que les pièces jointes cryptées soient déverrouillées automatiquement à leur arrivée.
Que faire si le Boleto est manuscrit ou endommagé ?
Les documents Boleto Bancário sont toujours générés et imprimés par ordinateur, donc l'écriture manuscrite et les dommages aux documents sont rares. Cependant, si un Boleto a été manipulé physiquement — plié, déchiré ou taché — l'IA peut toujours lire les champs partiellement obscurs tant que le code-barres ou la ligne lisible est intact. Les impressions délavées ou à faible contraste sont le problème de qualité le plus courant, et l'extraction les traite avec la même précision que les documents propres.
Puis-je extraire les données du XML du Boleto plutôt que du PDF ?
Certaines banques fournissent les données du Boleto au format XML ou JSON via leurs API. Si vous avez un accès programmatique à ces fichiers, l'extraction de données structurées est un processus différent de l'extraction visuelle à partir de PDF/images. La méthode décrite dans cet article est destinée aux cas où vous recevez des Boletos sous forme de documents visuels — PDF, captures d'écran ou scans imprimés — ce qui reste le modèle dominant dans les transactions B2B transfrontalières où le destinataire n'a pas d'intégration directe avec chaque banque brésilienne.
Les Boletos sont-ils émis dans d'autres devises que le BRL ?
La quasi-totalité des Boletos sont libellés en réal brésilien. Le code devise (position 4 du code-barres à 44 chiffres) est toujours 9 pour le BRL. Bien que les normes FEBRABAN prennent techniquement en charge d'autres codes (2 pour l'USD commercial, 14 pour l'EUR), ceux-ci sont extrêmement rares en pratique et quasiment jamais rencontrés dans le traitement standard des Boletos B2B.
Le schéma récurrent de chaque Boleto que vous traiterez est la standardisation — un code-barres à 44 chiffres, une structure de champs fixe et un système bancaire réglementé qui définit exactement où se trouve chaque donnée. L'écart ne réside pas dans des données manquantes. Il s'agit de la traduction de ce format standardisé vers les lignes de votre feuille de rapprochement. L'extraction sémantique supprime entièrement cette étape de traduction — non pas en prédisant où un champ pourrait apparaître, mais en comprenant la signification de chaque champ, que le Boleto provienne de Banco do Brasil, de Bradesco ou d'une capture d'écran de plateforme de paiement.