> For the complete documentation index, see [llms.txt](https://wikiedoc.guru-soft.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wikiedoc.guru-soft.com/fr/integrations-et-services/rest/consultation/recuperation-de-fichier-de-facture.md).
# Récupération de Fichier de Facture
## Introduction
La **récupération de fichier de facture** permet d’obtenir le fichier généré associé à une facture électronique précédemment traitée dans le système eDoc.
Cette fonctionnalité permet d’identifier précisément le document à partir de son **identifiant** et de sa **date d’émission**, puis de sélectionner le **type de fichier** à récupérer selon le format nécessaire. Le service prend en charge les types `original`, `cii`, `ubl` et `facture-x`.
Lorsque le document est disponible, le service retourne les informations du fichier ainsi que son contenu encodé en **Base64**, accompagné notamment du type de fichier, du format technique, du nom du fichier et du type MIME.
Cette fonctionnalité facilite l’intégration des documents électroniques dans les systèmes ERP, les applications de gestion documentaire ou tout autre système ayant besoin de récupérer et d’exploiter les fichiers produits dans le cadre du processus de facturation électronique.
Elle contribue également à la traçabilité des documents en permettant de récupérer à tout moment la représentation électronique correspondant à une facture identifiée.
### Authentification et Gestion des Accès
### Introduction
L’accès aux services du portail de facturation électronique nécessite une authentification préalable permettant d’identifier et d’autoriser l’application qui effectue les opérations.
La collection de référence utilise un mécanisme **OpenID Connect** avec le flux `client_credentials`. Dans ce modèle, l’application s’authentifie au moyen d’un identifiant client et d’un secret client afin d’obtenir un jeton d’accès destiné à la consommation des services autorisés.
Ce mécanisme est principalement destiné aux intégrations système à système, dans lesquelles une application doit accéder aux services sans intervention directe d’un utilisateur à chaque requête.
### Caractéristiques
* **Authentification centralisée** : L’application obtient ses droits d’accès auprès du service d’identité avant de consommer les fonctionnalités protégées du portail.
* **Utilisation d’OpenID Connect** : L’authentification s’appuie sur un point d’accès OpenID Connect dédié à l’obtention de jetons.
* **Flux `client_credentials`** : L’application s’authentifie avec ses propres informations d’identification, sans nécessiter la connexion interactive d’un utilisateur. La collection indique explicitement la valeur `client_credentials` pour le paramètre `grant_type`.
* **Identification de l’application** : Chaque intégration utilise un `client_id` permettant au système d’identité de reconnaître l’application qui demande l’accès.
* **Secret d’authentification** : Le `client_secret` est une information confidentielle associée à l’application et utilisée avec le `client_id` pour effectuer l’authentification.
* **Accès contrôlé aux services** : Le jeton obtenu permet à l’application de s’authentifier lors de la consommation des services auxquels elle est autorisée.
* **Protection des identifiants** : Le `client_secret` ne doit pas être publié dans la documentation, stocké dans le code source ou partagé avec des utilisateurs non autorisés.
### Obtention du Jeton D’accès
#### Méthode
`POST`
#### Ressource
[`https://labid-la.guru-soft.com/realms/fr-realm-qa/protocol/openid-connect/token`](https://labid-la.guru-soft.com/realms/fr-realm-qa/protocol/openid-connect/token)
La collection Postman de référence configure cette opération au moyen d’une requête `POST` vers le service OpenID Connect.
#### Paramètres d’authentification
La demande contient les informations suivantes :
* **grant\_type** : Définit le mécanisme utilisé pour obtenir le jeton. La valeur configurée est `client_credentials`.
* **client\_id** : Identifie l’application autorisée à demander un jeton.
* **client\_secret** : Secret confidentiel associé à l’application.
## Consultation
## Récupérer un fichier de facture
> Récupère un fichier généré à partir de l'identifiant du document, de sa date d'émission et du type de fichier demandé.
```json
{"openapi":"3.0.3","info":{"title":"eDoc France - Consultation de fichier de facture","version":"1.0.0"},"tags":[{"name":"QueryFile","description":"Opérations de consultation et récupération des fichiers de facturation électronique française."}],"servers":[{"url":"https://qas-fr-entpr-rest-issuing-qry.edoclab.com","description":"Environnement QA"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","name":"Authorization","in":"header","description":"Utiliser la valeur `Bearer `. Le jeton d'accès est obtenu via `POST https://labid-la.guru-soft.com/realms/fr-realm-qa/protocol/openid-connect/token`."}},"schemas":{"DocumentFileQueryResponse":{"type":"object","description":"Réponse retournée par le service de récupération du fichier documentaire.","required":["context","result"],"properties":{"context":{"$ref":"#/components/schemas/RequestContext"},"result":{"$ref":"#/components/schemas/FileQueryResult"}}},"RequestContext":{"type":"object","description":"Contexte permettant d'identifier et de tracer la requête.","properties":{"request-id":{"type":"string","description":"Identifiant unique de la requête."},"timestamp":{"type":"string","format":"date-time","description":"Date et heure de la requête."},"request-version":{"type":"string","description":"Version du contrat de la requête."},"country":{"type":"string","description":"Code pays du modèle fiscal."},"sender-id":{"type":"string","description":"Identifiant de l'émetteur."},"integration":{"$ref":"#/components/schemas/IntegrationContext"}}},"IntegrationContext":{"type":"object","description":"Informations relatives au système ERP ou à l'intégration.","properties":{"id":{"type":"string","description":"Identifiant de l'intégration."},"name":{"type":"string","description":"Nom de l'intégration."},"version":{"type":"string","description":"Version de l'intégration."}}},"FileQueryResult":{"type":"object","description":"Résultat fonctionnel de la récupération du fichier.","properties":{"status":{"$ref":"#/components/schemas/ResultStatus"},"content":{"description":"Contenu retourné lorsque le fichier est disponible.","oneOf":[{"$ref":"#/components/schemas/FileResultContent"}]}}},"ResultStatus":{"type":"object","description":"État fonctionnel et technique de l'opération.","properties":{"code":{"type":"integer","format":"int32","description":"Code d'état retourné par eDoc."},"name":{"type":"string","description":"Nom de l'état."},"message":{"type":"string","description":"Message descriptif associé à l'état."},"content-into":{"type":"string","description":"Indique si la réponse contient un fichier ou aucun contenu.","enum":["file","none"]}}},"FileResultContent":{"type":"object","description":"Contenu d'une réponse contenant un fichier.","properties":{"file":{"$ref":"#/components/schemas/DocumentFile"}}},"DocumentFile":{"type":"object","description":"Fichier documentaire retourné par l'API.","properties":{"file-type":{"type":"string","description":"Type de fichier retourné.","enum":["original","cii","ubl","facture-x"]},"format":{"type":"string","description":"Format technique du fichier."},"filename":{"type":"string","description":"Nom du fichier."},"mime-type":{"type":"string","description":"Type MIME du fichier."},"transport":{"type":"string","description":"Mode de transport du contenu."},"data":{"type":"string","description":"Contenu du fichier encodé en Base64."}}}}},"paths":{"/invoice/file":{"get":{"tags":["QueryFile"],"summary":"Récupérer un fichier de facture","description":"Récupère un fichier généré à partir de l'identifiant du document, de sa date d'émission et du type de fichier demandé.","operationId":"getDocumentFile","parameters":[{"name":"document-id","in":"query","description":"Numéro de facture normatif ou identifiant externe du document. Exemple : FA2026-000123.","required":true,"schema":{"type":"string"}},{"name":"issue-date","in":"query","description":"Date d'émission du document au format yyyy-MM-dd.","required":true,"schema":{"type":"string","format":"date"}},{"name":"file-type","in":"query","description":"Type de fichier demandé. Valeurs autorisées : original, cii, ubl, facture-x.","required":true,"schema":{"type":"string","enum":["original","cii","ubl","facture-x"]}},{"name":"X-Request-Id","in":"header","description":"Identifiant unique de la requête généré par le système client.","required":true,"schema":{"type":"string"}},{"name":"X-Timestamp","in":"header","description":"Horodatage de la requête au format ISO 8601.","required":true,"schema":{"type":"string"}},{"name":"X-Request-Version","in":"header","description":"Version du contrat de la requête.","required":true,"schema":{"type":"string"}},{"name":"X-Country","in":"header","description":"Code pays correspondant au modèle fiscal cible.","required":true,"schema":{"type":"string"}},{"name":"X-Sender-Id","in":"header","description":"Identifiant unique de l'émetteur.","required":true,"schema":{"type":"string"}},{"name":"X-Integration-Id","in":"header","description":"Identifiant de transaction de l'ERP ou du système d'intégration.","required":true,"schema":{"type":"string"}},{"name":"X-Integration-Name","in":"header","description":"Nom de l'intégration.","required":true,"schema":{"type":"string"}},{"name":"X-Integration-Version","in":"header","description":"Version de l'intégration.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentFileQueryResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentFileQueryResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentFileQueryResponse"}}}},"403":{"description":"Forbidden"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentFileQueryResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentFileQueryResponse"}}}}}}}}}
```
## Consumo
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://wikiedoc.guru-soft.com/fr/integrations-et-services/rest/consultation/recuperation-de-fichier-de-facture.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.