Référence · PstlAdr

Champs PstlAdr ISO 20022 : StrtNm, BldgNb, PstCd, TwnNm et Ctry

Le bloc PstlAdr décrit l'adresse postale d'une partie dans un message ISO 20022. Le point difficile n'est pas de mémoriser les balises, mais de placer chaque donnée au bon endroit sans la dupliquer ni inventer une information absente.

Rédigé par Struct20022 · mis à jour le 16 juillet 2026

À quoi sert PstlAdr ?

Dans un fichier de paiement, PstlAdr peut être rattaché au débiteur, au créancier ou à une autre partie du message. Il regroupe les éléments de l'adresse postale sous une forme que les systèmes peuvent lire et contrôler.

Une adresse syntaxiquement valide n'est pas forcément correcte. Le schéma XML vérifie la forme ; la qualité de la rue, du code postal, de la ville et du pays doit aussi être contrôlée dans la donnée source.

Les cinq champs à connaître en premier

StrtNm contient le nom de la voie, par exemple Boulevard Voltaire. Le numéro ne doit pas être collé à la rue quand BldgNb est disponible. BldgNb contient le numéro du bâtiment et, selon la donnée source, un suffixe utile comme 8 bis.

PstCd contient le code postal dans le format du pays. TwnNm contient la ville ou localité attendue, sans y mélanger le code postal. Ctry contient le code pays ISO 3166-1 alpha-2 en deux lettres, par exemple FR, DE, GB ou CH.

Dans les formats structuré et hybride prévus pour les flux CBPR+, TwnNm et Ctry constituent le minimum décisif. Les autres champs améliorent la précision lorsque la donnée existe réellement.

Adresse entièrement structurée ou hybride

Une adresse entièrement structurée place les composants dans leurs éléments dédiés et n'utilise pas AdrLine. C'est la forme la plus simple à contrôler durablement.

Une adresse hybride conserve TwnNm et Ctry dans leurs champs dédiés, tout en autorisant jusqu'à deux lignes AdrLine de 70 caractères pour le détail qui ne peut pas être structuré de façon fiable. Une information déjà structurée ne doit pas être répétée dans AdrLine.

Les autres éléments structurés

PstlAdr prévoit aussi Dept, SubDept, BldgNm, Flr, PstBx, Room, TwnLctnNm, DstrctNm et CtrySubDvsn. Ils servent aux départements internes, bâtiments, étages, boîtes postales, bureaux, quartiers, districts ou subdivisions administratives.

Ces champs sont optionnels et dépendants du pays. Une subdivision ne doit pas être ajoutée mécaniquement quand elle n'a pas de rôle postal utile ; mieux vaut un champ absent qu'une valeur supposée.

Structure, qualité et existence sont trois contrôles différents

La structure confirme que les données occupent les bons éléments. La qualité vérifie les formats, les longueurs et les contradictions. La validation d'existence compare enfin l'adresse à une source postale ou officielle quand une telle source est disponible.

Pour un audit fiable, conservez la ligne d'origine, le statut de chaque contrôle et les avertissements. Cette traçabilité permet aux équipes finance et référentiels de corriger seulement les lignes qui le nécessitent.

Exemples PstlAdr

Adresse entièrement structurée

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

Adresse hybride sans duplication

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

Checklist champ par champ

  1. 1Séparer le nom de rue StrtNm du numéro BldgNb quand les deux sont connus.
  2. 2Conserver le format national du code postal dans PstCd.
  3. 3Mettre la ville seule dans TwnNm.
  4. 4Utiliser un code pays ISO alpha-2 dans Ctry.
  5. 5Ne pas utiliser AdrLine dans une adresse entièrement structurée.
  6. 6En hybride, ne pas répéter dans AdrLine une donnée déjà structurée.
  7. 7Ne renseigner les champs optionnels que lorsque la source les fournit.

Questions fréquentes

Tous les champs PstlAdr sont-ils obligatoires ?

Non. Pour les formats structuré et hybride visés par CBPR+, la ville TwnNm et le pays Ctry sont le minimum. Les autres éléments dépendent de la donnée disponible et des règles du flux.

PstCd est-il toujours obligatoire ?

Pas dans la règle minimale générale. Il reste fortement utile pour désambiguïser une adresse et peut être exigé par un contexte national, une banque ou un schéma d'usage particulier.

Quelle différence entre Ctry et CtrySubDvsn ?

Ctry identifie le pays avec deux lettres. CtrySubDvsn décrit une subdivision comme un État ou une province lorsqu'elle est pertinente dans l'adresse du pays.

AdrLine rend-il automatiquement l'adresse invalide ?

Non. AdrLine est incompatible avec une adresse entièrement structurée, mais peut être utilisé dans une adresse hybride qui respecte les champs obligatoires et les règles de non-duplication.

Un PstlAdr bien formé prouve-t-il que l'adresse existe ?

Non. Il prouve seulement que la structure est exploitable. Confirmer l'existence demande une source postale, officielle ou un service de validation adapté au pays.

Sources officielles

Guides associés

Contrôlez ces champs sur un vrai fichier

Struct20022 audite les blocs PstlAdr et les fichiers tabulaires, conserve les lignes d'origine et signale les corrections prioritaires.