# La Norme : Format des Bilans de Contrôle

Les bilan PASRAU seront enregistrés au formt XML.

## Bilan XML

Le format XML reflète la structure du bilan de contrôle spécifié par le projet PASRAU.

Chaque section infra décrit une balise en utilisant un tableau dont la première colonne contient le nom de la balise et la seconde la description de son contenu. Toutes les balises ne font pas pour autant l’objet d’une section. Dans certains tableaux, la première colonne contient une séquence de balises séparées par des caractères ‘/’ (par exemple, description/code). Dans ce cas, la table contient la description de la balise code contenue dans la balise description.

### <rapport>

L’élément rapport est l’élément racine des fichiers XML contenant les bilans de validation. Cet élément comporte les sous éléments décrits dans le tableau suivant :

envoi | Ensemble des données concernant les anomalies relevées dans les rubriques décrivant l’envoi.
declaration | Ensemble des données concernant les anomalies relevées dans les rubriques décrivant les déclarations. Il y a autant de sous-éléments déclaration que l’envoi contrôlé comporte de déclarations (valides ou invalides).

### <envoi>

L’élément envoi comporte l’ensemble des données relatives aux anomalies portant sur les rubriques de niveau envoi (les anomalies sur les rubriques de niveau déclaration sont décrites séparément).

envoi_identification | Ensemble des données permettant d’identifier le fichier auquel se rapporte le bilan concerné (c.f. détail infra.).
envoi_bilan | Bilan de l’envoi (données synthétiques sur l’envoi (c.f. détail infra).
envoi_anomalie | Ensemble des données concernant les anomalies relevées dans les rubriques décrivant l‘envoi.

### <envoi_identification>

La balise identification de l’envoi contient tous les éléments permettant d’identifier un envoi.

identifiant | Nom du fichier contenant l’envoi contrôlé.
version norme | Version de la norme utilisée pour le contrôle.
point_de_depot | 01 pour net-entreprises, 02 pour MSA.
type_envoi | Cette rubrique permet de définir s’il s’agit d’un envoi normal, ou d’un envoi contenant uniquement des déclarations mensuelles «néant».
essai_reel | 01 pour envoi de test, 02 pour envoi réel.
emetteur_siret | SIRET de l’émetteur de l’envoi.
nom_logiciel | Nom du logiciel utilisé pour produire l’envoi.
editeur_logiciel | Editeur du logiciel utilisé pour produire l’envoi.
version_logiciel | Version du logiciel utilisé pour produire l’envoi.
code_conformite | Code de conformité attribué par une solution de contrôle en local permettant de dispenser l’envoi de certains contrôles sur serveur.
date_reception | Date de la réception du fichier.
heure_reception | Heure de la réception du fichier.

### <envoi_bilan>

La balise envoi_bilan contient des éléments synthétiques sur les anomalies contenues dans un envoi.

envoi_etat | OK ou KO selon que l’envoi est réputé valide ou pas.
envoi_contenu | Nombre de déclarations dans l’envoi et nombre de salariés concernés par l’envoi.
Envoi_compteurs | Nombre total d’anomalies (si balise envoi_categorie contient « total »).
Envoi_compteurs | Nombre total d’anomalies de niveau déclaration (si balise envoi_categorie contient « declaration »).
Envoi_compteurs | Nombre total d’anomalies de niveau envoi (si balise envoi_categorie contient « generale »).

### <envoi_anomalie>

La balise envoi_anomalie contient les éléments sur une anomalie de niveau envoi.

description/code | Code de l’erreur (identifiant du contrôle en échec, le plus souvent).
description/categorie | Catégorie d’anomalie (bloquant/non-bloquant).
description/message | Message d’erreur associée à l’anomalie.
description/numero_ligne | Numéro de ligne de la rubrique déclenchante.
valeurs/rubrique_declenchante/identifiant | Identifiant de la rubrique déclenchante.
valeurs/rubrique_declenchante/libelle | Libellé de la rubrique déclenchante.
valeurs/rubrique_declenchante/valeur | Valeur de la rubrique déclenchante dans l’envoi.

### <declaration>

L’élément declaration comporte l’ensemble des données relatives aux anomalies portant sur les rubriques de niveau déclaration (les anomalies sur les rubriques de niveau envoi sont décrites séparément).

declaration_identification | Ensemble des données permettant d’identifier la déclaration concernée (c.f. détail infra.).
declaration_bilan | Bilan de la déclaration (données synthétiques sur l’envoi (c.f. détail infra).
declaration_anomalie (multiple) | Ensemble des données concernant les anomalies relevées dans les rubriques des déclarations.

### <declaration_identification>

La balise declaration_identification contient tous les éléments nécessaires pour l’identification des déclarations.

rang | Rang de la déclaration dans l’envoi.
nature | Code nature (PASRAU mensuelle ...).
type | Code type (normale, néant, annule et remplace…).
fraction | Numéro de la fraction de déclaration.
ordre | Rang de constitution de la déclaration au cours du mois courant.
mois | Mois concernant la déclaration.
date | Date de la déclaration.
SIREN | SIREN de l’entreprise déclarante.
nic_siege | NIC du siège social de l’entreprise déclarante.
nic_affectation | NIC de l’établissement d’affectation du salarié concerné par l’anomalie.

### <declaration_bilan>

La balise declaration_bilan contient des éléments faisant la synthèse des anomalies pour la déclaration concernée.

etat | OK ou KO selon que la déclaration est réputée valide ou pas.
declaration_contenu | Nombre de salariés concernés par la déclaration.
declaration_compteurs | Nombre total d’anomalies bloquante dans la déclaration(si balise envoi_categorie contient « bloquant »).
declaration_compteurs | Nombre total d’anomalies non bloquante dans la déclaration (si balise envoi_categorie contient « non-bloquant»).

### <declaration_anomalie>

La balise declaration_anomalie contient des éléments décrivant une anomalie dans une déclaration.

description/code | Code de l’erreur (identifiant du contrôle en échec, le plus souvent).
description/categorie | Catégorie d’anomalie (bloquant/non-bloquant).
description/message | Message d’erreur associée à l’anomalie.
description/numero_ligne | Numéro de ligne de la rubrique déclenchante.
valeurs/rubrique_declenchante/identifiant | Identifiant de la rubrique déclenchante.
valeurs/rubrique_declenchante/libelle | Libellé de la rubrique déclenchante.
valeurs/rubrique_declenchante/valeur | Valeur de la rubrique déclenchante dans l’envoi.
environnement | Description de l’environnement de la rubrique déclenchante (informations utiles sur le salarié, c.f. détails infra.).

### <environnement>

La balise environnement contient des éléments relatifs au salarié concerné par l’anomalie.

salarie | salarié auquel se rattache l’anomalie.
contrat | contrat du salarié auquel se rattache l’anomalie.

##### <salarie>

salarie origine | L’attribut origine est toujours égal à PASRAU en bilan de contrôle. Il indique que l’origine des données salarié est la déclaration et non p.ex. le SNGI en cas de bilan métier remontant du bloc applicatif de stockage des données PASRAU.
NIR | NIR du salarié.
nom_famille | Nom de famille du salarié.
nom_usage | Nom d’usage du salarié.
prenoms | Prénom(s) du salarié.
sexe | Sexe du salarié.
date_naissance | Date de naissance du salarié.
lieu_naissance | Lieu de naissance du salarié.
matricule | Matricule du salarié dans l’entreprise concernée.
rang | Rang du salarié dans la déclaration.

##### <contrat>

date_debut_contrat | Date de début du contrat.
num_contrat | Numéro du contrat.