Les pièces jointes du PES V2 : comment elles sont stockées et comment les récupérer

Par Roméo Kothan · publié le 11 novembre 2026

Depuis la dématérialisation complète de la chaîne comptable, les factures et autres justificatifs ne partent plus sur papier : ils sont joints aux flux PES. Ils y sont pourtant invisibles au premier regard, car ils sont transformés pour tenir dans un fichier XML.

Le bloc PES_PJ

Les pièces justificatives se trouvent dans le bloc PES_PJ, après les dépenses et les recettes, ou dans un flux à part. Chaque pièce est une balise PJ qui contient :

• Contenu/Fichier : le fichier lui-même, avec son type (MIMEType, par exemple application/pdf) ;
• IdUnique : un identifiant unique, qui ne doit jamais avoir été utilisé auparavant ;
• NomPJ : le nom du fichier, avec son extension ;
• TypePJ : le type de pièce (003 dépense, 002 recette, 004 état de paye, 006 PES Facture…) ;
• Description : un libellé libre ;
• RefCompta : la pièce comptable à laquelle elle se rattache, quand elle voyage seule.

Pourquoi on ne voit pas le PDF

Le fichier d’origine n’est pas recopié tel quel. Il est d’abord compressé avec gzip, puis converti en base 64, c’est-à-dire en une longue suite de lettres et de chiffres que le XML peut transporter. Dans le flux, une facture d’une page ressemble donc à plusieurs milliers de caractères sans signification.

Pour la récupérer, il faut faire le chemin inverse : décoder le base 64, puis décompresser. C’est ce que fait l’outil extraire les pièces jointes d’un flux PES, sans envoyer le fichier sur internet.

Le lien avec les mandats et les titres

Un mandat ou un titre fait référence à ses justificatifs avec une ou plusieurs balises PJRef, au niveau de la pièce ou de la ligne. Chaque PJRef indique le support (01 électronique, 02 papier, 03 CD ou DVD) et l’IdUnique de la pièce. Si la pièce électronique n’est pas dans le même fichier, elle a été ou sera envoyée dans un autre flux.

Les rejets fréquents

D’après la liste des anomalies du Guichet XML :

• identifiant unique déjà utilisé (anomalie 1984) : chaque IdUnique doit être unique pour le budget, y compris d’un envoi à l’autre ;
• fichier vide ou illisible : la pièce est rejetée ;
• mauvais format : certains types de pièces exigent un PDF (2707) ou un XML ;
• pièce trop lourde pour certains usages, comme les avis des sommes à payer (2708 et 2709).

La liste complète est dans les anomalies Hélios.

Vérifier avant d’envoyer

Le lecteur de flux PES V2 liste les pièces jointes d’un flux, signale celles qui sont vides ou mal nommées, et les références à des pièces absentes du fichier. Chaque pièce peut être ouverte ou téléchargée, une par une ou toutes ensemble dans un ZIP.