admi.002 — Message Rejection

Le rejet technique d'un message ISO 20022. Référence du message rejeté, code raison et descriptif structuré : la brique générique de gestion d'erreur du sous-domaine admi (Administration).

Objet et place dans le flux

admi.002 est un message générique de rejet technique émis par un récepteur quand un message ISO 20022 entrant ne peut pas être traité : structure XML invalide, namespace inconnu, signature défaillante, BIC inconnu, UETR mal formé. Là où pacs.002 ou camt.029 sont des réponses métier (acceptation/rejet d'une transaction), admi.002 est une réponse technique indépendante du domaine fonctionnel du message rejeté.

Le message peut être généré à plusieurs niveaux de la chaîne : par la gateway SWIFTNet quand elle détecte un défaut avant routage, par le RTGS (T2, CHIPS, Fedwire) quand le parser XSD échoue, par la banque destinataire avant traitement métier. Il est surtout utilisé dans le sous-domaine admi mais peut techniquement répondre à tout message ISO 20022.

Structure XML

admi.002 est encapsulé dans <Document> avec le namespace de la version, puis l'élément racine <admi.002.001.01> (la dénomination de l'élément reprend le code complet). Deux blocs principaux :

• RltdRef (Related Reference) — la référence du message d'origine qui est rejeté. Doit pointer vers le MsgId du GrpHdr de l'envoi rejeté.
• Rsn (Reason) — bloc structuré du motif de rejet, contenant le code raison, la datetime, la localisation de l'erreur, le descriptif lisible.

Champs clés

• RltdRef/Ref — Identifiant du message rejeté (max 35 caractères, repris verbatim du GrpHdr/MsgId). Indispensable au rapprochement : c'est ce qui permet à l'émetteur d'origine de savoir quel message a été rejeté.
• Rsn/RjctgPtyRsn — Code raison côté partie rejetante. Codes externes en pratique : X01 Format XML invalide, X02 Validation XSD échouée, X03 Namespace inconnu, X04 Référence en double, X06 Signature invalide, X07 Émetteur inconnu, X08 Destinataire inconnu, X10 Message en dehors des heures d'ouverture.
• Rsn/RjctnDtTm — Datetime du rejet (ISO 8601 avec timezone).
• Rsn/ErrLctn — Localisation de l'erreur dans le message d'origine, idéalement en XPath (/Document/FIToFICstmrCdtTrf/CdtTrfTxInf/PmtId/UETR).
• Rsn/RsnDesc — Description en langage naturel (max 350 caractères). Lue par les opérateurs en cas de support N2/N3.
• Rsn/AddtlData — Données techniques additionnelles (identifiant de log, code interne du gateway, message ID de la couche transport).

Exemple XML

Rejet par la gateway SWIFTNet de BNP Paribas du pacs.008 BNPP-CBPR-20260514-001 pour cause d'UETR malformé. Code rejet X02 (validation XSD), XPath précis indiquant le champ fautif, description lisible.

<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:admi.002.001.01">
  <admi.002.001.01>
    <RltdRef>
      <Ref>BNPP-CBPR-20260514-001</Ref>
    </RltdRef>
    <Rsn>
      <RjctgPtyRsn>X02</RjctgPtyRsn>
      <RjctnDtTm>2026-05-14T10:31:42+01:00</RjctnDtTm>
      <ErrLctn>/Document/FIToFICstmrCdtTrf/CdtTrfTxInf/PmtId/UETR</ErrLctn>
      <RsnDesc>UETR malformé&nbsp;: la valeur fournie n'est pas un UUID v4 valide (RFC 4122). Doit être 36 caractères, minuscules, avec tirets.</RsnDesc>
      <AddtlData>BNPAFRPP gateway, msg 0x4F2A</AddtlData>
    </Rsn>
  </admi.002.001.01>
</Document>

Versions

À la différence des messages pacs/pain/camt qui ont 8 à 11 versions, admi.002 est resté figé à v01 parce que sa structure minimaliste suffit à tous les usages d'erreur technique. La Registration Authority SWIFT n'a pas planifié de v02 à la roadmap 2027.

Pièges courants

• RltdRef manquante ou incorrecte — sans la référence du message rejeté, l'émetteur ne peut pas savoir lequel de ses envois pose problème. C'est le défaut le plus fréquent et le plus pénalisant en exploitation.
• Code RjctgPtyRsn propriétaire — utiliser uniquement les codes externes ISO 20022 publiés (X01–X20). Un code interne (BNPP-001) n'est pas interprétable côté émetteur.
• ErrLctn en texte libre — préférer un XPath valide qui permet l'inspection automatique du message rejeté côté émetteur.
• admi.002 vs pacs.002 — pacs.002 est un statut métier sur une transaction (rejet pour fonds insuffisants, compte clos…). admi.002 est un rejet technique avant traitement métier. Confondre les deux brouille le diagnostic.
• Pas de timestamp — RjctnDtTm est important pour la traçabilité : avec un volume élevé, c'est ce qui permet de corréler avec les logs des gateways.
• Boucle infinie — un admi.002 lui-même mal formé ne doit pas être rejeté avec un nouvel admi.002, sinon boucle. Convention SWIFTNet : les rejets d'admi sont silencieux côté gateway, loggés mais pas renvoyés.

Messages liés

• admi.004 — System Event Notification. Notification de système (maintenance, incident).
• admi.005 — Report Query Request. Demande d'envoi de rapport.
• admi.006 — Resend Request. Demande de retransmission de message.
• admi.007 — Receipt Acknowledgement. Accusé de réception positif (par opposition à admi.002).
• pacs.008, pacs.009, pain.001 — messages typiquement rejetés par admi.002 quand leur structure est invalide.
• pacs.002 — pendant métier : statut négatif sur une transaction réussie au niveau syntaxique mais refusée en règle métier.

Voir aussi : l'index ISO 20022.