Un package de rapport ESEF est une archive ZIP contenant votre document iXBRL et les fichiers de support dans une structure spécifique. Une mauvaise structure cause des échecs de validation immédiats. Ce guide explique chaque composant d'un package de rapport valide.
Points clés
- Les packages de rapport doivent suivre la spécification XBRL Report Package
- La structure du dossier META-INF est strictement appliquée
- Les conventions de nommage des fichiers affectent la validation
- L'encodage UTF-8 sans BOM est requis
- Les taxonomies intégrées ont des règles d'emplacement spécifiques
Aperçu de la structure du package
Un package de rapport ESEF valide contient :
report-2025.zip
├── META-INF/
│ ├── catalog.xml
│ ├── reports.json
│ └── taxonomyPackage.xml
├── reports/
│ └── ifrs-report-2025.xhtml
└── taxonomy/ (optionnel)
└── extension.xsd
Le ZIP de niveau supérieur doit contenir les dossiers META-INF et reports. L'intégration de taxonomie est optionnelle mais recommandée pour les éléments d'extension.
Dossier META-INF
Le dossier META-INF contient les métadonnées du package :
• catalog.xml - Catalogue XML pour la résolution des URI
• reports.json - Métadonnées du rapport (requis)
• taxonomyPackage.xml - Descripteur du package de taxonomie
Le fichier reports.json doit lister tous les rapports du package avec leurs points d'entrée et types de documents.
Dossier Reports
Le dossier reports contient vos documents iXBRL :
• Fichier XHTML principal avec le balisage iXBRL
• Feuilles de style CSS liées (le cas échéant, doivent être dans le même dossier)
• Fichiers image référencés par le rapport
Tous les fichiers doivent utiliser l'encodage UTF-8. Les références de fichiers externes doivent être des chemins relatifs dans le package.
Intégration de taxonomie
Lors de l'intégration de la taxonomie d'extension : Placez les fichiers XSD et linkbase dans un sous-dossier taxonomy. Mettez à jour catalog.xml avec les règles de réécriture. Assurez-vous que toutes les références schemaLocation se résolvent correctement dans le package.
Erreurs courantes
Évitez ces erreurs de packaging fréquentes :
• Dossier META-INF manquant ou vide
• Format reports.json incorrect
• Chemins absolus dans les références de fichiers
• Caractères BOM dans les fichiers UTF-8
• Mauvaise méthode de compression ZIP
• Dossiers de niveau supérieur supplémentaires
Utilisez un outil de packaging dédié ou un modèle pré-validé pour éviter les problèmes structurels.
Checklist
- Le dossier META-INF existe à la racine du ZIP
- reports.json est un JSON valide
- Tous les chemins de fichiers sont relatifs
- Les fichiers sont en UTF-8 sans BOM
- Le ZIP utilise la compression DEFLATE
- Pas de dossiers de niveau supérieur inattendus
- Le package valide avec la suite de conformité ESEF