Comment extraire les données d'un Boleto Bancário
vers Excel pour le rapprochement de 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 les paiements transfrontaliers extraient encore ces données de la même manière qu'avant l'existence de cette norme : manuellement. Entre le PDF reçu d'un fournisseur brésilien et la saisie de rapprochement finale dans votre tableur, il y a un fossé de saisie manuelle, de copier-coller et de vérification visuelle que la structure même du document a été 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 à n'importe quel scanner bancaire de vérifier un paiement en quelques millisecondes exige encore qu'un humain lise et saisisse chaque champ dans une ligne de tableur.
- Définissez vos colonnes une fois — Code-barres, Date d'échéance, Montant, Bénéficiaire — et extrayez par lots des dizaines de Boletos dans une seule ligne Excel par document.
Qu'est-ce qu'un Boleto Bancário et pourquoi comporte-t-il deux séries de chiffres ?
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 l'un des plus de 40 000 points de vente au Brésil — banques, loteries, supermarchés, bureaux de poste, ou via les services bancaires 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 disposition des codes-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 | Clé de contrôle (dígito verificador geral) | 3 | Vérifie l'intégrité de l'ensemble du code-barres via le 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 que lorsqu'il était présenté pour paiement, a été progressivement abandonné pour réduire la fraude et améliorer la traçabilité. Aujourd'hui, chaque Boleto que vous recevez adopte la même structure standardisée avec un enregistrement complet côté banque.
Pour un aperçu plus large du paysage documentaire brésilien — y compris la Nota Fiscal Eletrônica (NF-e), le système de facture électronique obligatoire du pays — consultez notre guide complet des documents fiscaux et financiers brésiliens.
Le goulot d'étranglement du traitement des Boletos que les équipes de rapprochement connaissent bien
Un seul Boleto contient environ une douzaine de points de données importants pour le rapprochement des paiements. Mais contrairement à une facture où les données sont conceptuellement liées (lignes d'articles → sous-total → taxe → 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 à quoi servait le paiement, quelle facture il référence, ni si le payeur a déjà envoyé un avis de remise correspondant.
Ce décalage de conception crée un problème de flux de travail spécifique pour les équipes financières :
Le vrai coût n'est pas la vitesse de frappe. C'est le cycle de rapprochement : extraction manuelle → mise en 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 pour créer 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 d'un Boleto ne nécessite pas un processus complexe. La structure du document est standardisée et les champs nécessaires à votre rapprochement sont clairement définis. Il ne vous manque qu'un outil capable de les lire depuis n'importe quel format — que le Boleto vous parvienne en PDF depuis un portail bancaire, en capture d'écran depuis une application mobile, ou en version papier scannée.
Le processus se déroule en trois étapes :
Essayez-le ci-dessous avec une capture d'écran ou un PDF de Boleto — aucune inscription requise :
Les fichiers sont traités de manière sécurisée et ne sont pas conservés.
Quels champs du Boleto sont les plus importants pour le rapprochement des paiements
Tous les champs d'un Boleto ne se valent pas pour le rapprochement. Le tableau ci-dessous répertorie les champs qui permettent réellement l'appariement des paiements, le suivi des statuts et le reporting — organisés par leur usage pratique, et non par leur emplacement sur le document.
| Champ (anglais) | Terme en portugais | Utilité pour le 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 par l'homme 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 l'appariement des paiements. Recoupez-le avec les crédits du relevé bancaire. |
| Notre numéro | Nosso número | Référence interne attribuée par la banque — souvent ce qui se rapproche le plus d'un identifiant de transaction unique pour le rapprochement. |
| Bénéficiaire | Beneficiário / Cedente | Identifie l'entité qui reçoit le paiement. Essentiel lors du rapprochement des paiements entre plusieurs filiales ou unités commerciales. |
| Payeur | Pagador / Sacado | Identifie qui a effectué le paiement. Utilisez-le pour les rapports d'ancienneté des comptes clients et le suivi client. |
| Portefeuille | Carteira | Type de contrat de recouvrement 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 le deuxième meilleur ancrage 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.