Adresses structurées dans un pain.001 : le guide pratique
Votre banque demande des adresses structurées dans vos remises de virement ? Vous trouverez ci-dessous un bloc PstlAdr conforme, les erreurs qui font rejeter un fichier et une méthode pour convertir l'existant sans ressaisie.
Rédigé par Struct20022 · mis à jour le 23 septembre 2026
Avant / après : le même bloc PstlAdr
À risque dans les flux concernés : 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. C'est le cas le plus fréquent et le plus risqué dans les flux concernés.
- 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 se trouvent 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.
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
Auditez le pain.001 tel quel, structurez chaque adresse, puis réémettez le document à l'identique : les références, les montants et les IBAN ne bougent pas, seuls les blocs PstlAdr sont remplacés.
L'outil ne doit pas toucher au paiement lui-même : il isole l'adresse, corrige sa structure et laisse le reste du XML intact.
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 format entièrement structuré ou l'hybride ?
L'hybride est une transition raisonnable quand toute l'adresse n'est pas encore découpée. Le format entièrement structuré reste la cible recommandée pour limiter les rejets et les réparations manuelles.
Sources officielles
Guides associés
Déposez votre pain.001, récupérez-le avec des adresses structurées
Audit gratuit du fichier tel quel, puis réémission à l'identique avec les adresses structurées. 100 crédits offerts, sans carte bancaire.