Le guide complet de
l'extraction de données des Boleto Bancário brésiliens
Si votre équipe financière reçoit des paiements du Brésil, vous rencontrerez le Boleto Bancário — un bordereau de paiement réglementé qui est à la fois l'un des documents financiers les plus structurés au monde (chaque code-barres de 44 chiffres suit une norme immuable) et l'un des plus fastidieux à traiter manuellement (quelqu'un doit encore ouvrir chaque PDF et saisir ses données dans une ligne). Ce guide couvre tout ce qu'une équipe de comptabilité clients ou d'opérations financières doit savoir sur l'extraction de données des Boletos : la structure du document, les champs clés, la différence entre les bordereaux enregistrés et non enregistrés, et comment les outils d'extraction modernes éliminent l'étape manuelle.
Points clés à retenir
- Le Boleto Bancário suit une norme nationale unique — chaque code-barres de 44 chiffres positionne le montant aux chiffres 10 à 19 — pourtant la plupart des équipes les lisent encore à l'œil nu.
- Cette même norme permet à n'importe quel scanner bancaire de valider un paiement en quelques millisecondes. Elle peut aussi vous permettre d'extraire 500 lignes de données AR en une seule passe.
- L'outil pour lire le code-barres existe déjà — c'est le document lui-même. Ce qui manque, c'est un workflow qui le traite comme un support de données structuré plutôt que comme un PDF à recopier.
Qu'est-ce qu'un Boleto Bancário ?
Un Boleto Bancário — communément appelé Boleto — est un instrument de paiement brésilien réglementé, créé en 1993 et administré par la Banque centrale du Brésil (Banco Central do Brasil) selon la norme FEBRABAN (Federação Brasileira de Bancos, ou Fédération brésilienne des banques). Il fait office à la fois de facture et de bulletin de versement : le bénéficiaire (beneficiário) l'émet via sa banque, et le payeur (pagador) utilise le bulletin imprimé ou numérique pour effectuer un paiement dans l'un des plus de 200 000 points de vente au Brésil — agences bancaires, guichets automatiques, loteries, supermarchés, bureaux de poste et portails bancaires en ligne.
Avec environ 3,7 milliards de transactions Boleto traitées chaque année, il ne s'agit pas d'un moyen de paiement de niche. Il représente une part significative du commerce électronique brésilien et des paiements B2B, et reste essentiel pour les quelque 50 millions d'adultes brésiliens non bancarisés qui utilisent les Boletos comme principal moyen de paiement en ligne. Dans le commerce électronique transfrontalier, selon les données de Statista, 68 % des consommateurs brésiliens utilisent le Boleto Bancário lorsqu'ils achètent auprès de marchands internationaux.
La caractéristique la plus importante du Boleto, du point de vue de l'extraction de données, est qu'il est hautement standardisé. Chaque Boleto — quel que soit la banque émettrice, le montant ou le payeur — suit les mêmes règles structurelles définies par la FEBRABAN. C'est cette caractéristique qui rend l'extraction automatisée réalisable, et c'est aussi celle que la plupart des processus de traitement manuel n'exploitent pas.
Distinction clé pour les équipes Comptes fournisseurs (AP) : Un Boleto est différent d'une Nota Fiscal Eletrônica (NF-e), qui est la facture électronique brésilienne pour les transactions de biens. La NF-e est un document XML autorisé par le gouvernement, émis avant que les marchandises ne quittent le fournisseur ; le Boleto est un bulletin de versement qui peut (ou non) être lié à une NF-e. Si vous débutez avec les documents financiers brésiliens, consultez notre guide du débutant sur la NF-e pour une vue d'ensemble.
Anatomie d'un Boleto : tous les champs à extraire
Un Boleto type contient les champs de données suivants. Certains sont encodés dans le code-barres, d'autres apparaissent dans le texte visuel, et certains dans les deux. Pour le rapprochement et le suivi des comptes clients (AR), ce sont les champs qui comptent.
| Champ | Libellé en portugais | Emplacement sur le Boleto | Format / Remarques |
|---|---|---|---|
| Code-barres | Código de Barras | En haut au centre, 44 chiffres | Norme FEBRABAN. Contient le code banque, la devise, le facteur d'échéance, le montant et le champ libre. |
| Ligne lisible | Linha Digitável | Sous le code-barres, 47 chiffres | Mêmes données que le code-barres, formatées pour la saisie manuelle aux guichets automatiques et applications bancaires. |
| Bénéficiaire | Beneficiário / Cedente | Section en haut à gauche | Nom + CNPJ (CNPJ/CPF do Beneficiário) du destinataire du paiement. |
| Agence / Code bénéficiaire | Agência / Código do Beneficiário | Sous le nom du bénéficiaire | Agence bancaire et compte. Format : 9999-D/9999999-D. |
| Date d'échéance | Data de Vencimento / Vencimento | Zone centrale, près du montant | Format JJ/MM/AAAA. Champ clé pour le suivi des échéances et du protêt. |
| Montant | Valor / Valor do Documento | À côté de la date d'échéance | En BRL (R$). Utilise la notation décimale brésilienne : R$ 1.234,56. |
| Payeur | Pagador / Sacado | Section inférieure, sous le bénéficiaire | Nom + CPF (particulier) ou CNPJ (entreprise). |
| Référence bancaire | Nosso Número | Sous la zone du code-barres | Numéro d'identification interne de la banque. Longueur variable selon la banque. |
| Numéro de document | Número do Documento | Près du Nosso Número | Référence de facture ou de contrat — le lien vers la transaction d'origine. |
| Portefeuille | Carteira | Près des coordonnées bancaires | Identifie le type de recouvrement du Boleto (ex. « 17 » pour un simple enregistrement). |
| Date d'émission | Data de Emissão | Marge supérieure ou inférieure | Date de génération du Boleto. |
| Date de paiement | Data do Pagamento | Rempli par la banque après paiement | Apparaît uniquement sur les Boletos payés ou les relevés de règlement. |
La plupart des équipes Comptes clients (AR) se concentrent sur un sous-ensemble : le code-barres (identifiant unique), la date d'échéance (ancienneté), le montant (valeur attendue), le bénéficiaire (destination), le payeur (source) et le Nosso Número (référence bancaire). Ces six champs fournissent les données nécessaires pour faire le rapprochement avec les relevés de règlement bancaire et alimenter les échéanciers.
Comprendre le code-barres à 44 chiffres et la ligne lisible à 47 chiffres
Chaque Boleto comporte deux représentations lisibles par machine des mêmes données de paiement. Elles diffèrent visuellement, contiennent des clés de contrôle différentes et sont utilisées dans des contextes distincts — mais elles encodent les mêmes informations essentielles.
Le code-barres à 44 chiffres (código de barras) est le code machine principal, conçu pour la lecture optique. Sa structure est définie par la norme de disposition des codes-barres FEBRABAN (Layout - Código de Barras - Versão 7) :
- Positions 01–03 : Code d'identification de la banque (ex. : 001 = Banco do Brasil, 104 = Caixa, 237 = Bradesco, 341 = Itaú, 033 = Santander)
- Position 04 : Code monétaire (9 = Real brésilien)
- Position 05 : Clé de contrôle générale (DAC — Dígito de Auto-Conferência, ou clé d'auto-contrôle)
- Positions 06–09 : Facteur d'échéance — nombre de jours depuis la date de base de l'ère FEBRABAN. Utilisé pour calculer la date d'échéance. (Remarque : ce champ a été réinitialisé en février 2025 après avoir atteint 9999, les systèmes doivent donc gérer correctement le « Boleto Y2K ».)
- Positions 10–19 : Montant en centavos (ex. : 0000050000 = R$ 500,00). Si aucun montant n'est spécifié, ce champ est à zéro et la valeur est inscrite sur le bordereau visuel.
- Positions 20–44 : Champ libre (campo livre) — dépend de la banque. Contient le Nosso Número, l'Agência/Código do Beneficiário, la Carteira et d'autres données nécessaires à la banque émettrice pour acheminer le paiement.
La ligne lisible à 47 chiffres (linha digitável) est le format lisible par l'homme imprimé sous le code-barres. Elle reprend les 44 chiffres du code-barres, les divise en cinq groupes et insère des clés de contrôle pour chaque groupe après les positions 09, 20 et 31 (pour les Boletos bancaires). Pour les paiements de services publics (concessionárias), le format utilise 48 chiffres et suit une structure légèrement différente.
Pour l'extraction, le code-barres est généralement la source de données la plus fiable. Il contient les données standardisées sans les variations de mise en page visuelle que les différentes banques introduisent dans le bordereau imprimé. Un outil d'extraction bien conçu lit le code-barres lorsqu'il est lisible et se rabat sur le texte visuel pour les champs qui n'apparaissent que dans la zone imprimée (comme le nom du bénéficiaire ou les données du payeur).
Les différences clés : Boleto enregistré vs non enregistré
Depuis l'entrée en vigueur de la directive FEBRABAN en 2017 (avec un déploiement progressif dans les banques tout au long de l'année), tous les nouveaux Boletos émis doivent être enregistrés auprès de la Banque centrale au moment de leur création. Ce changement a été motivé par la fraude : des fraudeurs modifiaient le code-barres des Boletos non enregistrés, détournant les paiements vers leurs propres comptes, et l'absence d'enregistrement rendait difficile pour les commerçants de contester le paiement mal dirigé.
Boleto Registrado (enregistré) : L'émetteur enregistre chaque Boleto auprès de la Banque centrale lors de sa création. La banque valide les données du Boleto (bénéficiaire, montant, code-barres) par rapport à l'enregistrement avant d'accepter le paiement. Cela élimine le vecteur de fraude par falsification du code-barres. Les Boletos enregistrés donnent aux commerçants la possibilité de déposer une objection officielle si le paiement s'égare.
Boleto sem Registro (non enregistré) : Aucun enregistrement auprès de la Banque centrale lors de l'émission. La banque traite le paiement uniquement sur la base des données du code-barres, sans pré-validation par rapport à un enregistrement. Les Boletos non enregistrés sont désormais moins courants mais restent en circulation pour certains arrangements hérités.
Du point de vue de l'extraction de données, la différence pratique est minime. La disposition visuelle et la structure du code-barres sont les mêmes. La principale différence opérationnelle est que les Boletos enregistrés portent un numéro d'enregistrement auprès de la Banque centrale qui peut être conservé à des fins d'audit, et le rapport de règlement de la banque peut inclure une confirmation que le paiement a été validé par rapport à l'enregistrement.
Extraction manuelle : l'ancienne méthode (et ses coûts cachés)
Malgré la structure hautement standardisée du Boleto, la méthode d'extraction la plus courante aujourd'hui est manuelle : ouvrir le PDF, lire les six champs clés, les taper dans une ligne de tableur. Ce processus prend environ 3 minutes par Boleto pour un analyste AR expérimenté — localiser le PDF, trouver chaque champ, le taper dans la bonne colonne, et passer au document suivant.
À raison de 500 Boletos par mois, cela représente 25 heures de saisie de données. Le coût direct de la main-d'œuvre — à environ 20 R$ de l'heure, charges comprises — est de 500 R$ par mois. Mais les coûts cachés sont plus importants : le taux d'erreur (1 à 4 % par champ, référence du secteur), le temps de rapprochement passé à enquêter sur ces erreurs, et la clôture de fin de mois retardée lorsque la saisie de données entre en concurrence avec d'autres priorités.
La méthode manuelle échoue également à exploiter la fonctionnalité la plus précieuse du Boleto : le code-barres à 44 chiffres contient les mêmes données dans un format lisible par machine. Les informations tapées à partir du bordereau visuel sont déjà encodées dans le code-barres en haut de la même page. La méthode manuelle lit les champs visuels, ignore le code-barres, et retape des données que le document fournit lui-même sous une forme structurée.
Pour une analyse détaillée des coûts, consultez notre article sur ce que coûte réellement le traitement manuel des Boletos par transaction.
Extraction par IA : Ce qui change quand l'outil lit le document
L'extraction par IA — plus précisément, l'extraction par grand modèle visuel (VLM) — aborde le Boleto différemment de la lecture manuelle ou de l'OCR traditionnel. Au lieu d'essayer de « lire » chaque caractère (OCR) ou de faire correspondre une position de modèle (OCR zonal), un outil basé sur un VLM comprend le document de manière sémantique : il voit le code-barres et le reconnaît comme « ceci est un code-barres », lit les chiffres et les associe aux bons champs. Il voit le texte « R$ 1.500,00 » près de « Valor » et comprend qu'il s'agit du montant.
Cette approche sémantique est cruciale pour l'extraction des Boletos, car différentes banques impriment les mêmes champs FEBRABAN à des positions visuelles légèrement différentes. La mise en page du Boleto de Bradesco n'est pas identique à celle d'Itaú, même si les deux contiennent les mêmes données. Un outil traditionnel basé sur des modèles nécessiterait une configuration de modèle distincte pour chaque banque. Un outil basé sur un VLM lit les champs par leur signification et leur relation avec les étiquettes, et non par leurs coordonnées de pixels — le même outil fonctionne donc pour toutes les banques émettrices, sans configuration.
Extraction de colonnes personnalisées en est le mécanisme : vous définissez les colonnes de sortie souhaitées — Code-barres, Date d'échéance, Montant, Bénéficiaire, Payeur, Nosso Número — et l'IA localise les données correspondantes dans chaque Boleto, quel que soit la banque, la mise en page ou la résolution. Les noms de colonnes que vous saisissez deviennent les en-têtes de votre tableau de sortie. Cela signifie que vous définissez la structure de données une fois, et elle s'applique à chaque Boleto de chaque lot.
Les fichiers sont traités de manière sécurisée et ne sont pas conservés.
Créer votre workflow d'extraction de Boleto
Mettre en place une extraction automatisée de Boleto ne nécessite pas de refondre votre processus AR existant. Le workflow s'insère dans l'intervalle entre « réception du PDF Boleto » et « données dans le tableur » — un intervalle qui nécessite actuellement une saisie manuelle.
Qu'ils arrivent par e-mail, soient téléchargés depuis un portail bancaire, ou proviennent d'un Lien de collecte permettant aux payeurs de déposer leurs reçus acquittés, regroupez tous les PDF ou captures d'écran au même endroit. Aucun prétraitement nécessaire — l'outil d'extraction gère les PDF, les images et leurs différentes résolutions.
Spécifiez les données dont votre workflow AR a besoin — généralement Código de Barras, Vencimento, Valor, Beneficiário, Pagador et Nosso Número. Ceux-ci deviennent les en-têtes de votre tableur. L'IA lit chaque Boleto du lot et remplit les valeurs.
L'IA traite tous les fichiers simultanément. Chaque Boleto devient une ligne dans la sortie. Une fois le lot terminé, exportez un seul fichier Excel (.xlsx) ou CSV contenant les données de chaque Boleto. Pour les utilisateurs de Google Sheets, le module complémentaire Google Sheets écrit les résultats directement dans la feuille active, en sautant l'étape d'export.
Le temps de travail manuel pour un lot de 200 Boletos est d'environ 5 minutes — téléchargement, définition des colonnes, clic sur « Traiter », téléchargement. Le reste du travail est automatisé. Comparé à plus de 10 heures de saisie manuelle pour le même volume, la différence de temps n'est pas incrémentielle ; elle est catégorique.
Pour un guide pas à pas du processus, consultez comment extraire les données d'un Boleto Bancário vers Excel.
Questions fréquentes
L'IA peut-elle lire à la fois le code-barres et les champs visuels d'un Boleto ?
Oui. Un modèle d'IA visuelle lit l'intégralité du document — les chiffres du code-barres sont reconnus comme du texte, et les champs visuels (nom du bénéficiaire, payeur, etc.) sont extraits des zones imprimées. L'outil ne se limite pas à l'analyse du code-barres ; il lit ce qui figure sur la page, où qu'il se trouve. Cette double approche permet d'extraire les champs visuels même si le code-barres est partiellement masqué ou endommagé.
L'extraction fonctionne-t-elle pour les Boletos qui ont été payés et qui portent des tampons ou annotations bancaires ?
Oui. Les Boletos payés portent souvent un tampon « PAGO », une date de paiement apposée par la banque, et parfois des annotations manuscrites. L'IA traite ces éléments comme des éléments visuels supplémentaires. Le tampon de la date de paiement peut être extrait comme un champ séparé si votre flux de travail suit le moment où le paiement a eu lieu. Les annotations manuscrites sont reconnues si elles sont lisibles.
Qu'en est-il des Boletos chiffrés avec un mot de passe bancaire ?
Certaines banques envoient des PDF de Boleto avec un mot de passe pour des raisons de sécurité. L'outil d'extraction prend en charge les PDF protégés par mot de passe. Vous pouvez pré-enregistrer les mots de passe couramment utilisés (comme le CNPJ du bénéficiaire) dans les paramètres de votre compte, et l'outil les essaiera automatiquement lors du traitement des fichiers chiffrés. Cette fonctionnalité est couverte par la fonction Boîte de réception e-mail — il suffit de transférer le PDF chiffré et le mot de passe est essayé automatiquement.
Comment l'extraction de Boleto gère-t-elle les montants au format décimal brésilien (R$ 1.234,56) ?
L'IA lit le montant tel qu'il apparaît sur le document (R$ 1.234,56) et le normalise dans un format décimal standard pour la sortie. Vous pouvez choisir le format de sortie — soit conserver la convention brésilienne (1.234,56), soit la convertir en convention internationale (1234.56) pour l'importation dans un ERP. La même normalisation s'applique aux dates (JJ/MM/AAAA).
Puis-je utiliser l'extraction à la fois pour le rapprochement des paiements entrants (AR) et le traitement des paiements sortants (AP) ?
Oui, le flux de travail d'extraction est le même, quelle que soit la direction. Pour les Comptes clients (AR), vous extrayez les données des Boletos que votre entreprise a émis pour suivre les paiements entrants. Pour les Comptes fournisseurs (AP), vous extrayez les données des Boletos reçus des fournisseurs pour enregistrer les montants et les dates d'échéance pour la planification des paiements. Les définitions de colonnes diffèrent — AR a besoin des informations du payeur, AP a besoin des informations du bénéficiaire — mais l'outil gère les deux. Si vous débutez avec les documents financiers brésiliens en général, notre guide NF-e couvre le document compagnon des Boletos dans le contexte des Comptes fournisseurs (AP).
La norme existe déjà. La question est de savoir si votre flux de travail l'utilise.
Le Boleto Bancário a été conçu pour être lisible par machine. Chaque code-barres à 44 chiffres, chaque ligne lisible à 47 chiffres, chaque champ structuré sur le bordereau visuel suit une norme nationale maintenue et mise à jour depuis plus de trois décennies. Les données sont là, attendant d'être extraites. La seule pièce manquante était un outil qui traite le Boleto pour ce qu'il est — un support de données structuré — plutôt qu'un PDF à ouvrir et à saisir manuellement.
L'extraction basée sur l'IA comble cette lacune. Elle ne modifie pas le Boleto. Elle change ce qui se passe entre la réception du PDF et la saisie des données dans votre système de comptes clients (AR) — transformant une tâche de saisie de 3 minutes en une opération de moins d'une seconde qui s'adapte à 10 ou 10 000 Boletos avec le même effort.
Testez l'extraction sur vos propres fichiers Boleto.
Importez n'importe quel PDF ou capture d'écran de Boleto Bancário et recevez des données structurées en quelques secondes — sans inscription requise.
Importer un Boleto