5.1Présentation générale 5.1.1Définition
Les données transmises entre un ordonnateur et HELIOS sont véhiculées dans des messages, adressés par un émetteur à un destinataire (cf. 5.2).
Un message correspond toujours à un fichier informatisé dont le nom interne a une structure conventionnelle. Il inclut sa date d’émission pour une longueur totale de 41 caractères maximum.
-
Code du type de fichiers sur 7 caractères.
-
Sigle de l’émetteur sur 10 caractères maximum.
-
Sigle du récepteur sur 10 caractères maximum.
-
Date/heure/minute/seconde de génération du fichier (format 2007-01-10HHNNSS)
Les sigles de l’émetteur et de récepteurs sont communiqués à chaque partenaire par la DGCP.
5.1.2Différents types de messages et modalités de circulation
Les messages suivants sont définis, chacun d’eux étant identifiés par un code de type de fichiers structuré de la manière suivante :
-
Les trois premiers caractères sont imposés : PES.
-
Les trois caractères suivants identifient le type de message
-
Le numéro situé en fin de code de fichier (‘i’) donne un numéro de version du message.
Nom du message
|
Type de fichier
|
Objet
|
Circulation
|
PES Aller
|
PESALR2
|
Protocole Aller
|
Ordonnateur vers HELIOS.
|
Ack
|
PESACK2
|
Acquit par HELIOS d’un message de type PES Aller
|
HELIOS vers ordonnateur
|
Nack
|
PESREJ2
|
Rejet par HELIOS d’un message de type PES Aller
|
HELIOS vers ordonnateur
|
PES Retour
|
PESRET2
|
Protocole Retour
|
HELIOS vers ordonnateur.
|
5.1.3Principes de modélisation XML
Les schémas XML décrivant les messages du PES (PES_Ack.xsd, PES_Nack.xsd, PES_Aller_1.1.xsd, PES_Retour.xsd), sont stockés à la racine du répertoire SchemaPES/PESV2/Rev0
Les messages PES_Aller, PES_Ack et PES_Nack sont en référence à l’espace de noms « http://www.minefi.gouv.fr/cp/helios/pes_v2/Rev0/aller» de suffixe ‘pesa’
Le message PES_Retour est en référence à l’espace de noms « http://www.minefi.gouv.fr/cp/helios/pes_v2/Rev0/retour» de suffixe ‘pesr’.
Ces messages PES_Aller et PES_Retour incorporent (instruction « xs:import ») les schémas racines des différents domaines fonctionnels du PES ainsi que ceux de XML signature, Xades, Encryption selon une logique présentée aux paragraphes 5.5 et 5.6.
5.2Structure générale d’un message 5.2.1Définition
Un message se compose toujours des parties suivantes :
-
Une enveloppe technique comprenant les champs suivants :
-
Les paramètres du message
-
Le numéro de version du message. Ce numéro est relatif à l’enveloppe.
-
Le code du type de fichier tel que défini en 5.1.
-
Le nom du fichier.
-
La carte de visite du partenaire émetteur. Cette dernière contient les champs suivants :
-
Le sigle de l’émetteur tel que défini en 5.1.
-
L’adresse physique de l’émetteur.
-
La carte de visite du partenaire récepteur. Cette dernière contient les champs suivants :
-
Le sigle de l’émetteur tel que défini en 5.1.
-
L’adresse physique du récepteur.
-
Le corps du message, selon une structure décrite dans les paragraphes suivants.
Attention : le nom physique du fichier transmis peut être différent du nom déclaré dans le message, en particulier si le nom intègre une déclaration de l’heure précise de constitution du fichier.
5.2.2Enveloppe technique 5.2.2.1Liste des blocs
Liste des blocs.
|
Enveloppe Technique.
|
|
|
|
|
Nom Bloc
|
Parent
|
O/F
|
Pluralité
|
All./Ret.
|
Description
|
Enveloppe
|
|
O
|
N
|
A/R
|
ENVELOPPE TECHNIQUE.
|
Parametres
|
Enveloppe
|
O
|
N
|
A/R
|
|
Emetteur
|
Enveloppe
|
F
|
N
|
A/R
|
|
Recepteur
|
Enveloppe
|
F
|
N
|
A/R
|
|
5.2.2.2Représentation des données
Bloc Enveloppe – Obligatoire - Unique
|
Bloc Parametres – Obligatoire - Unique
|
Nom zone
|
O/F
|
All./Ret.
|
Type
|
Taille
|
Exemple de valeurs
|
Description
|
Version
|
O
|
A/R
|
Numérique
|
2
|
1
|
Numéro de version du message.
|
TypeFic
|
O
|
A/R
|
Texte
|
32
|
PESALR1
|
Identifiant du message
|
NomFic
|
O
|
A/R
|
Texte
|
100
|
PESALR1COL121HELIOS120030402120222
|
Nom du fichier
|
Bloc Emetteur – Facultatif - Unique
|
Nom zone
|
O/F
|
All./Ret.
|
Type
|
Taille
|
Exemple de valeurs
|
Description
|
Sigle
|
F
|
A/R
|
Texte
|
32
|
Chaîne de caractères
|
Référence technique fournie par HELIOS.
|
Adresse
|
F
|
A/R
|
Texte
|
38
|
Une adresse
|
Raison sociale / Nom : Norme postale
|
Bloc Recepteur – Facultatif - Unique
|
Nom zone
|
O/F
|
All./Ret.
|
Type
|
Taille
|
Exemple de valeurs
|
Description
|
Sigle
|
F
|
A/R
|
Texte
|
32
|
Chaîne de caractères
|
Référence technique fournie par HELIOS.
|
Adresse
|
F
|
A/R
|
Texte
|
38
|
Une adresse
|
Raison sociale / Nom : Norme postale
|
5.3Message d’Acquit
Ce paragraphe ne concerne que les messages faisant l’objet d’une transmission asynchrone (CFT).
Chaque message émis par un ordonnateur ayant fait l’objet d’une intégration réussie dans HELIOS (données mises à disposition du comptable) fait l’objet d’un message Acquit délivré par HELIOS vers l’ordonnateur.
5.3.1Bloc de données Acquit
Le message Acquit (« PESACK1 ») fournit le nom du fichier qui fait l’objet de l’acquittement
ACQUIT
|
Paramètre du message
|
Nom zone
|
O/F
|
All./Ret.
|
Type
|
Taille
|
Exemple de valeurs
|
Description
|
NomFic
|
O
|
R
|
Texte
|
100
|
PESALR1COL121HELIOS120030402120222
|
Nom du fichier
|
5.3.2Assemblage d’un message Acquit
Un message d’acquit est formé de la concaténation de deux blocs :
-
Une enveloppe technique construite en conformité au schéma Class_Enveloppe.xd
-
Le bloc de données acquit construit en conformité au schéma Class_Acquit.xsd.
5.4Message de Non Acquit
Chaque message émis par un ordonnateur faisant l’objet d’un échec d’intégration dans HELIOS fait l’objet d’un message de Non Acquit. Le message de Non Acquit fournit :
-
Le nom du fichier ayant fait l’objet d’un rejet.
-
La cause du rejet.
5.4.1Bloc de données de Non Acquit
Le message de Non Acquit (« PESREJ2 ») fournit le nom du fichier qui fait l’objet d’un non acquittement ainsi que la cause du rejet.
ACQUIT
|
Paramètre du message
|
Nom zone
|
O/F
|
All./Ret.
|
Type
|
Taille
|
Exemple de valeurs
|
Description
|
NomFic
|
O
|
R
|
Texte
|
100
|
PESALR1COL121HELIOS120030402120222
|
Nom du fichier rejeté.
|
Motif
|
O
|
R
|
Texte
|
100
|
ERR_SYNT
|
Type du rejet
|
Les cause de rejets identifiés à cet indice de document sont les suivants :
Cause de rejet
|
Interprétation
|
ERR_SYNT
|
le fichier est non conforme au schéma xsd du PES pour la version précisée en en-tête..
|
ERR_POST
|
le codique du poste comptable fourni n’est pas correct
|
ERR_CODBUD
|
Le code de la collectivité et/ou le code budget fourni est incorrect
|
ERR_IDCOL
|
L’identification de collectivité ou de l'établissement public local fournie est incorrect.
|
ERR_CHECKSUM
|
L'empreinte de la signature technique n'est pas valide
|
Un message de Non Acquit est formé de la concaténation de deux blocs :
-
Une enveloppe technique construite en conformité au schéma Class_Enveloppe.xd
-
Le bloc de données Non Acquit construit en conformité au schéma Class_NonAcquit.xsd.
5.5Message PES Aller 5.5.1Principes de base
Les données du Protocole Aller (Ordonnateur vers HELIOS) sont transmises par l’intermédiaire d’un message PES Aller (type de fichier PESALR2).
Les données véhiculées dans un message PES Aller doivent être relatives à un budget collectivité unique.
Selon les caractéristiques de la collectivité émettrice, un même message PES Aller peut ou non mixer des données issues des différents domaines (Depense, Recette, Role, Budget, Etat de l’actif, Marche, Etat du passif) ainsi que des pièces justificatives présentés au chapitre 3. Des règles de configurations, établies en commun entre l’ordonnateur et le comptable précisent ces possibilités par collectivité/budget. Ces règles sont mises en œuvre de manière extérieure au PES et ne sont donc pas intégrées au niveau de la syntaxe XML. La présente version du PES ne permet pas l’échange de tels paramètres de configuration.
Un message PES Aller est composé de la concaténation des blocs suivants :
-
Une enveloppe technique conforme au schema XML Enveloppe.xsd
-
Une enveloppe fonctionnelle conforme au schema XML Class_EnTetePES.xsd
-
La suite de blocs optionnels suivante, par import des NameSpace correspondant :
-
Un bloc Depense conforme au schéma XML PES_DepenseAller.xsd.
-
Un bloc Recette conforme au schéma XML PES_RecetteAller.xsd.
-
Un bloc Rôle conforme au schéma XML PES_RoleAller.xsd.
-
Un bloc Budget conforme au schéma XML PES_BudgetAller.xsd.
-
Un bloc Etat de l’actif conforme au schéma XML PES_EtatActif.xsd.
-
Un bloc Marche conforme au schéma XML PES_Marche.xsd.
-
Un bloc Etat du passif conforme au schéma XML PES_EtatPassif.xsd.
-
Un bloc PJ conforme au schéma XML PES_PJ.xsd
-
Un bloc signature conforme au schéma XML class_signature.xsd
Il a donc la structure suivante conforme au schéma XML PES_Aller.xsd.
Message PES Aller (PESALR1)
5.6Message PES Retour 5.6.1Principes de base
Les données du Protocole Retour (HELIOS vers ordonnateur) sont transmises par l’intermédiaire d’un message PES RETOUR (type de fichier PERET2).
Les données véhiculées dans un message PES Retour sont relatives à un budget collectivité unique.
Selon la configuration effectuée pour la collectivité destinataire un même message PES Retour peut ou non mixer des données issues des différents domaines (Depense, Recette, Role, Budget, Etat de l’actif, Marche, Etat du passif) présentés au chapitre 3.
Un message PES Retour est composé de la concaténation des blocs suivants :
-
Une enveloppe technique conforme au schéma XML Enveloppe.xsd
-
Une enveloppe fonctionnelle conforme au schéma XML Class_EnTetePES.xsd
-
La suite de blocs optionnels suivante, par import des NameSpace correspondants :
-
Un bloc Depense conforme au schéma XML PES_DepenseRetour.xsd.
-
Un bloc Recette conforme au schéma XML PES_RecetteRetour.xsd.
-
Un bloc Rôle conforme au schéma XML PES_RoleRetour.xsd.
-
Un bloc Budget conforme au schéma XML PES_BudgetRetour.xsd.
-
Un bloc Comptabilite conforme au schéma XML PES_Comptabilité.xsd.
-
Un bloc PieceJusticative conforme au schéma XML Class_PJ_Retour.xsd
Il a donc la structure suivante conforme au schéma XMl PES_Retour.xsd.
Message PES Retour (PESRET1)
|