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.
Rédigé par Struct20022 · mis à jour le 16 juillet 2026
Avant / après : le même bloc PstlAdr
À risque après mi-novembre 2026 : tout en lignes libres, ville et pays noyés dans le texte.
À risque
<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.
Structuré
<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 : le détail peut rester en AdrLine, mais la ville et le pays sont bien structurés.
Hybride
<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 seule — ville et pays absents des champs dédiés : le cas le plus fréquent et le plus risqué après mi-novembre 2026.
- Pays manquant ou mal codé — Ctry attend un code ISO 3166-1 alpha-2 comme FR, DE, CH ou CN, pas France ni FRA.
- Ville dans la mauvaise case — 75011 Paris entier dans TwnNm crée une donnée ambiguë ; le code postal doit aller dans PstCd.
- Dépassements de longueur — les éléments ISO ont des longueurs maximales, par exemple StrtNm 70, TwnNm 35 et BldgNb 16 caractères.
- Mélange non maîtrisé — AdrLine ne doit pas dupliquer de façon incohérente ce qui est déjà structuré.
Où se trouvent les adresses
Dans un pain.001, les adresses vivent dans les blocs PstlAdr attachés aux parties : Dbtr, Cdtr et, le cas échéant, UltmtDbtr ou UltmtCdtr. Chaque bloc peut contenir des champs structurés, des lignes libres AdrLine, ou un mélange hybride.
Le point critique est simple : un PstlAdr composé uniquement d'AdrLine risque le rejet si la ville et le pays ne sont pas fournis dans TwnNm et Ctry.
Convertir sans ressaisir
La bonne approche consiste à auditer le pain.001 tel quel, 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 PstlAdr remplacés.
C'est important : l'outil ne doit pas transformer le paiement lui-même. Il doit isoler la donnée adresse, corriger la structure, puis préserver le reste du XML.
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.
Où se trouvent les adresses dans un pain.001 ?
Dans les blocs PstlAdr attachés aux parties du paiement : donneur d'ordre, bénéficiaire et parties ultimes le cas échéant.
Mon pain.001 actuel sera-t-il rejeté ?
S'il contient des blocs PstlAdr uniquement composés d'AdrLine, il est à risque sur les flux concernés. Un audit du fichier tel quel permet de le confirmer rapidement.
Faut-il viser le full structuré ou l'hybride ?
L'hybride est une transition raisonnable quand toute l'adresse n'est pas encore découpée. Le full structuré reste la cible recommandée pour limiter les rejets et réparations manuelles.
Sources officielles
Guides associés
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.