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. La difficulté est de placer chaque donnée dans le bon élément, sans la dupliquer ni inventer ce qui manque.

Rédigé par Struct20022 · mis à jour le 23 septembre 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 sont le minimum exigé. Les autres champs ajoutent de la précision quand la donnée existe.

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. Les équipes finance et référentiels peuvent alors corriger seulement les lignes qui en ont besoin.

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 aide à lever les ambiguïtés 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.