VAVANG INVOICE / DOCS / FR

Télécharger une facture

Les artefacts de conformité se téléchargent depuis l’espace de conformité de l’Admin Sylius. Ils ne sont pas exposés via des URL publiques de stockage.

Préconditions

Il faut :

une session Sylius Admin authentifiée ;
un document de conformité déjà généré ;
le rôle ROLE_SYLIUS_INVOICE_COMPLIANCE_DOWNLOAD pour télécharger les artefacts Factur-X ou XML.

La liste des documents de conformité est disponible ici :

/admin/compliance/documents

Les actions de téléchargement ne sont affichées qu’aux administrateurs disposant de la permission correspondante.

Télécharger le PDF Factur-X

Depuis la liste des documents de conformité, utilisez l’action de téléchargement Factur-X. La route sous-jacente est :

GET /admin/compliance/documents/{id}/download/factur-x

Une réponse valide contient le PDF Factur-X gouverné sous forme de pièce jointe nommée compliance-document-factur-x.pdf.

Télécharger le XML structuré

Utilisez l’action de téléchargement XML ou sa route :

GET /admin/compliance/documents/{id}/download/xml

Une réponse valide contient le XML structuré avec le type application/xml; charset=UTF-8 et le nom de pièce jointe compliance-document.xml.

Prévisualiser le document gouverné

Pour une représentation inline, l’Admin expose également :

GET /admin/compliance/documents/{id}/document

La route renvoie le PDF Factur-X lorsqu’il est disponible, avec le XML comme représentation de repli.

Intégrité et gestion des erreurs

Invoice vérifie l’empreinte SHA-256 stockée avant de renvoyer les octets.

Statut HTTP	Signification
`200`	L’artefact demandé existe et a passé son contrôle d’intégrité.
`404`	Le document ou l’artefact stocké demandé est absent.
`409`	L’artefact stocké ne correspond plus à son empreinte d’intégrité. Ne contournez pas cette erreur en servant directement le fichier.

Les réponses de téléchargement sont privées et no-store ; le plugin envoie également la protection nosniff. Ne remplacez pas ces routes par une URL publique de stockage.

Si un artefact est légitimement absent, utilisez la procédure de récupération contrôlée Régénérer une facture. Pour le modèle de stockage, voir Stockage et intégrité et PDF et Factur-X.