Guide · pain.001 / ISO 20022

Adresses structurées dans un pain.001 : le guide pratique

Votre banque vous demande des adresses structurées dans vos remises de virement ? Voici à quoi ressemble un bloc PstlAdr conforme, les pièges classiques, et comment convertir l'existant sans tout ressaisir.

Avant / après : le même bloc PstlAdr

Rejeté après le 14 novembre 2026 — tout en lignes libres, ville et pays noyés dans le texte :

<Cdtr>
  <Nm>Atelier Garnier</Nm>
  <PstlAdr>
    <AdrLine>8 bis boulevard Voltaire</AdrLine>
    <AdrLine>75011 Paris, France</AdrLine>
  </PstlAdr>
</Cdtr>

Entièrement structuré — chaque élément dans son champ, la cible recommandée :

<Cdtr>
  <Nm>Atelier Garnier</Nm>
  <PstlAdr>
    <StrtNm>Boulevard Voltaire</StrtNm>
    <BldgNb>8 bis</BldgNb>
    <PstCd>75011</PstCd>
    <TwnNm>Paris</TwnNm>
    <Ctry>FR</Ctry>
  </PstlAdr>
</Cdtr>

Hybride — accepté au-delà de 2026 : le détail en AdrLine (2 lignes de 70 caractères max), ville et pays structurés :

<PstlAdr>
  <AdrLine>8 bis Boulevard Voltaire</AdrLine>
  <PstCd>75011</PstCd>
  <TwnNm>Paris</TwnNm>
  <Ctry>FR</Ctry>
</PstlAdr>

Les erreurs qui font rejeter un fichier

  • AdrLine seuleville et pays absents des champs dédiés — le cas le plus fréquent, interdit après novembre 2026.
  • Pays manquant ou mal codéCtry attend un code ISO 3166-1 alpha-2 (FR, DE, CH…) — pas « France ».
  • Ville dans la mauvaise case« 75011 Paris » entier dans TwnNm : le code postal doit aller dans PstCd.
  • Dépassements de longueurchaque élément a un maximum (StrtNm 70, TwnNm 35, BldgNb 16…).
  • Mélange interditselon les usages de place, AdrLine ne doit pas dupliquer ce qui est déjà structuré.

Convertir l'existant sans tout ressaisir

La bonne nouvelle : il est inutile de retaper vos référentiels. Un convertisseur sérieux doit savoir auditer votre pain.001 tel quel (quels blocs seront rejetés ?), structurer chaque adresse, puis ré-émettre le document à l'identique — mêmes références, mêmes montants, mêmes IBAN — avec uniquement les blocs PstlAdrremplacés. C'est exactement ce que fait Struct20022, au choix en full structuré ou en hybride.

Questions fréquentes

Qu'est-ce qu'un fichier pain.001 ?

C'est le message ISO 20022 de remise d'ordres de virement (Customer Credit Transfer Initiation) qu'une entreprise envoie à sa banque. La version 9 (pain.001.001.09) devient la référence : au 14 novembre 2026, les remises MT101 via FIN disparaissent au profit du pain.001 v9.

Où se trouvent les adresses dans un pain.001 ?

Dans les blocs <PstlAdr> attachés aux parties : le donneur d'ordre (Dbtr), le bénéficiaire (Cdtr), et le cas échéant les bénéficiaires/donneurs d'ordre ultimes. Chaque bloc contient soit des champs structurés (StrtNm, BldgNb, PstCd, TwnNm, Ctry…), soit des lignes libres AdrLine, soit un mélange (hybride).

Mon pain.001 actuel sera-t-il rejeté ?

S'il contient des blocs PstlAdr composés uniquement d'AdrLine, oui : après le 14 novembre 2026, la ville (TwnNm) et le pays (Ctry) doivent figurer dans leurs champs dédiés. Un audit du fichier tel quel permet de le savoir en quelques secondes.

Faut-il viser le full structuré ou l'hybride ?

L'hybride (AdrLine + ville/pays structurés) reste accepté au-delà de 2026 et constitue une étape de transition raisonnable. Le full structuré est la cible recommandée : moins de faux positifs au filtrage sanctions, moins de réparations manuelles, meilleure traçabilité.

Déposez votre pain.001, récupérez-le conforme

Audit gratuit du fichier tel quel, puis ré-émission à l'identique avec les adresses structurées en place. 100 crédits offerts, sans carte bancaire.