factpulse 2.0.34 → 2.0.36

data/docs/VrificationPDFXMLApi.md

@@ -0,0 +1,435 @@
+# FactPulse::VrificationPDFXMLApi
+
+All URIs are relative to *http://localhost*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**obtenir_statut_verification_api_v1_verification_verifier_async_id_tache_statut_get**](VrificationPDFXMLApi.md#obtenir_statut_verification_api_v1_verification_verifier_async_id_tache_statut_get) | **GET** /api/v1/verification/verifier-async/{id_tache}/statut | Obtenir le statut d'une vérification asynchrone |
+| [**obtenir_statut_verification_api_v1_verification_verifier_async_id_tache_statut_get_0**](VrificationPDFXMLApi.md#obtenir_statut_verification_api_v1_verification_verifier_async_id_tache_statut_get_0) | **GET** /api/v1/verification/verifier-async/{id_tache}/statut | Obtenir le statut d'une vérification asynchrone |
+| [**verifier_pdf_async_api_v1_verification_verifier_async_post**](VrificationPDFXMLApi.md#verifier_pdf_async_api_v1_verification_verifier_async_post) | **POST** /api/v1/verification/verifier-async | Vérifier la conformité PDF/XML Factur-X (asynchrone) |
+| [**verifier_pdf_async_api_v1_verification_verifier_async_post_0**](VrificationPDFXMLApi.md#verifier_pdf_async_api_v1_verification_verifier_async_post_0) | **POST** /api/v1/verification/verifier-async | Vérifier la conformité PDF/XML Factur-X (asynchrone) |
+| [**verifier_pdf_sync_api_v1_verification_verifier_post**](VrificationPDFXMLApi.md#verifier_pdf_sync_api_v1_verification_verifier_post) | **POST** /api/v1/verification/verifier | Vérifier la conformité PDF/XML Factur-X (synchrone) |
+| [**verifier_pdf_sync_api_v1_verification_verifier_post_0**](VrificationPDFXMLApi.md#verifier_pdf_sync_api_v1_verification_verifier_post_0) | **POST** /api/v1/verification/verifier | Vérifier la conformité PDF/XML Factur-X (synchrone) |
+
+
+## obtenir_statut_verification_api_v1_verification_verifier_async_id_tache_statut_get
+
+> <StatutTache> obtenir_statut_verification_api_v1_verification_verifier_async_id_tache_statut_get(id_tache)
+
+Obtenir le statut d'une vérification asynchrone
+
+Récupère le statut et le résultat d'une tâche de vérification asynchrone.  **Statuts possibles:** - `PENDING`: Tâche en attente dans la file - `STARTED`: Tâche en cours d'exécution - `SUCCESS`: Tâche terminée avec succès (voir `resultat`) - `FAILURE`: Erreur système (exception non gérée)  **Note:** Le champ `resultat.statut` peut être \"SUCCES\" ou \"ERREUR\" indépendamment du statut Celery (qui sera toujours SUCCESS si la tâche s'est exécutée).
+
+### Examples
+
+```ruby
+require 'time'
+require 'factpulse'
+# setup authorization
+FactPulse.configure do |config|
+  # Configure Bearer authorization: HTTPBearer
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = FactPulse::VrificationPDFXMLApi.new
+id_tache = 'id_tache_example' # String | 
+
+begin
+  # Obtenir le statut d'une vérification asynchrone
+  result = api_instance.obtenir_statut_verification_api_v1_verification_verifier_async_id_tache_statut_get(id_tache)
+  p result
+rescue FactPulse::ApiError => e
+  puts "Error when calling VrificationPDFXMLApi->obtenir_statut_verification_api_v1_verification_verifier_async_id_tache_statut_get: #{e}"
+end
+```
+
+#### Using the obtenir_statut_verification_api_v1_verification_verifier_async_id_tache_statut_get_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<StatutTache>, Integer, Hash)> obtenir_statut_verification_api_v1_verification_verifier_async_id_tache_statut_get_with_http_info(id_tache)
+
+```ruby
+begin
+  # Obtenir le statut d'une vérification asynchrone
+  data, status_code, headers = api_instance.obtenir_statut_verification_api_v1_verification_verifier_async_id_tache_statut_get_with_http_info(id_tache)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <StatutTache>
+rescue FactPulse::ApiError => e
+  puts "Error when calling VrificationPDFXMLApi->obtenir_statut_verification_api_v1_verification_verifier_async_id_tache_statut_get_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id_tache** | **String** |  |  |
+
+### Return type
+
+[**StatutTache**](StatutTache.md)
+
+### Authorization
+
+[HTTPBearer](../README.md#HTTPBearer)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## obtenir_statut_verification_api_v1_verification_verifier_async_id_tache_statut_get_0
+
+> <StatutTache> obtenir_statut_verification_api_v1_verification_verifier_async_id_tache_statut_get_0(id_tache)
+
+Obtenir le statut d'une vérification asynchrone
+
+Récupère le statut et le résultat d'une tâche de vérification asynchrone.  **Statuts possibles:** - `PENDING`: Tâche en attente dans la file - `STARTED`: Tâche en cours d'exécution - `SUCCESS`: Tâche terminée avec succès (voir `resultat`) - `FAILURE`: Erreur système (exception non gérée)  **Note:** Le champ `resultat.statut` peut être \"SUCCES\" ou \"ERREUR\" indépendamment du statut Celery (qui sera toujours SUCCESS si la tâche s'est exécutée).
+
+### Examples
+
+```ruby
+require 'time'
+require 'factpulse'
+# setup authorization
+FactPulse.configure do |config|
+  # Configure Bearer authorization: HTTPBearer
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = FactPulse::VrificationPDFXMLApi.new
+id_tache = 'id_tache_example' # String | 
+
+begin
+  # Obtenir le statut d'une vérification asynchrone
+  result = api_instance.obtenir_statut_verification_api_v1_verification_verifier_async_id_tache_statut_get_0(id_tache)
+  p result
+rescue FactPulse::ApiError => e
+  puts "Error when calling VrificationPDFXMLApi->obtenir_statut_verification_api_v1_verification_verifier_async_id_tache_statut_get_0: #{e}"
+end
+```
+
+#### Using the obtenir_statut_verification_api_v1_verification_verifier_async_id_tache_statut_get_0_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<StatutTache>, Integer, Hash)> obtenir_statut_verification_api_v1_verification_verifier_async_id_tache_statut_get_0_with_http_info(id_tache)
+
+```ruby
+begin
+  # Obtenir le statut d'une vérification asynchrone
+  data, status_code, headers = api_instance.obtenir_statut_verification_api_v1_verification_verifier_async_id_tache_statut_get_0_with_http_info(id_tache)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <StatutTache>
+rescue FactPulse::ApiError => e
+  puts "Error when calling VrificationPDFXMLApi->obtenir_statut_verification_api_v1_verification_verifier_async_id_tache_statut_get_0_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id_tache** | **String** |  |  |
+
+### Return type
+
+[**StatutTache**](StatutTache.md)
+
+### Authorization
+
+[HTTPBearer](../README.md#HTTPBearer)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## verifier_pdf_async_api_v1_verification_verifier_async_post
+
+> <ReponseTache> verifier_pdf_async_api_v1_verification_verifier_async_post(fichier_pdf, opts)
+
+Vérifier la conformité PDF/XML Factur-X (asynchrone)
+
+Vérifie la conformité PDF/XML Factur-X de manière asynchrone.  **IMPORTANT**: Seuls les PDF Factur-X (avec XML embarqué) sont acceptés. Les PDF sans XML Factur-X retourneront une erreur `NOT_FACTURX` dans le résultat.  Cette version utilise une tâche Celery et peut faire appel au service OCR si le PDF est une image ou si `forcer_ocr=true`.  **Retourne immédiatement** un ID de tâche. Utilisez `/verifier-async/{id_tache}/statut` pour récupérer le résultat.  **Principe de vérification (Factur-X 1.08):** - Principe n°2: Le XML ne peut contenir que des infos présentes dans le PDF - Principe n°4: Toute info XML doit être présente et conforme dans le PDF  **Champs vérifiés:** - Identification: BT-1 (n° facture), BT-2 (date), BT-3 (type), BT-5 (devise), BT-23 (cadre) - Vendeur: BT-27 (nom), BT-29 (SIRET), BT-30 (SIREN), BT-31 (TVA) - Acheteur: BT-44 (nom), BT-46 (SIRET), BT-47 (SIREN), BT-48 (TVA) - Montants: BT-109 (HT), BT-110 (TVA), BT-112 (TTC), BT-115 (à payer) - Ventilation TVA: BT-116, BT-117, BT-118, BT-119 - Lignes de facture: BT-153, BT-129, BT-146, BT-131 - Notes obligatoires: PMT, PMD, AAB - Règle BR-FR-09: cohérence SIRET/SIREN  **Avantages par rapport à la version synchrone:** - Support OCR pour les PDF images (via service DocTR) - Timeout plus long pour les gros documents - Ne bloque pas le serveur
+
+### Examples
+
+```ruby
+require 'time'
+require 'factpulse'
+# setup authorization
+FactPulse.configure do |config|
+  # Configure Bearer authorization: HTTPBearer
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = FactPulse::VrificationPDFXMLApi.new
+fichier_pdf = File.new('/path/to/some/file') # File | Fichier PDF Factur-X à vérifier
+opts = {
+  forcer_ocr: true # Boolean | Forcer l'utilisation de l'OCR même si le PDF contient du texte natif
+}
+
+begin
+  # Vérifier la conformité PDF/XML Factur-X (asynchrone)
+  result = api_instance.verifier_pdf_async_api_v1_verification_verifier_async_post(fichier_pdf, opts)
+  p result
+rescue FactPulse::ApiError => e
+  puts "Error when calling VrificationPDFXMLApi->verifier_pdf_async_api_v1_verification_verifier_async_post: #{e}"
+end
+```
+
+#### Using the verifier_pdf_async_api_v1_verification_verifier_async_post_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ReponseTache>, Integer, Hash)> verifier_pdf_async_api_v1_verification_verifier_async_post_with_http_info(fichier_pdf, opts)
+
+```ruby
+begin
+  # Vérifier la conformité PDF/XML Factur-X (asynchrone)
+  data, status_code, headers = api_instance.verifier_pdf_async_api_v1_verification_verifier_async_post_with_http_info(fichier_pdf, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ReponseTache>
+rescue FactPulse::ApiError => e
+  puts "Error when calling VrificationPDFXMLApi->verifier_pdf_async_api_v1_verification_verifier_async_post_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **fichier_pdf** | **File** | Fichier PDF Factur-X à vérifier |  |
+| **forcer_ocr** | **Boolean** | Forcer l&#39;utilisation de l&#39;OCR même si le PDF contient du texte natif | [optional][default to false] |
+
+### Return type
+
+[**ReponseTache**](ReponseTache.md)
+
+### Authorization
+
+[HTTPBearer](../README.md#HTTPBearer)
+
+### HTTP request headers
+
+- **Content-Type**: multipart/form-data
+- **Accept**: application/json
+
+
+## verifier_pdf_async_api_v1_verification_verifier_async_post_0
+
+> <ReponseTache> verifier_pdf_async_api_v1_verification_verifier_async_post_0(fichier_pdf, opts)
+
+Vérifier la conformité PDF/XML Factur-X (asynchrone)
+
+Vérifie la conformité PDF/XML Factur-X de manière asynchrone.  **IMPORTANT**: Seuls les PDF Factur-X (avec XML embarqué) sont acceptés. Les PDF sans XML Factur-X retourneront une erreur `NOT_FACTURX` dans le résultat.  Cette version utilise une tâche Celery et peut faire appel au service OCR si le PDF est une image ou si `forcer_ocr=true`.  **Retourne immédiatement** un ID de tâche. Utilisez `/verifier-async/{id_tache}/statut` pour récupérer le résultat.  **Principe de vérification (Factur-X 1.08):** - Principe n°2: Le XML ne peut contenir que des infos présentes dans le PDF - Principe n°4: Toute info XML doit être présente et conforme dans le PDF  **Champs vérifiés:** - Identification: BT-1 (n° facture), BT-2 (date), BT-3 (type), BT-5 (devise), BT-23 (cadre) - Vendeur: BT-27 (nom), BT-29 (SIRET), BT-30 (SIREN), BT-31 (TVA) - Acheteur: BT-44 (nom), BT-46 (SIRET), BT-47 (SIREN), BT-48 (TVA) - Montants: BT-109 (HT), BT-110 (TVA), BT-112 (TTC), BT-115 (à payer) - Ventilation TVA: BT-116, BT-117, BT-118, BT-119 - Lignes de facture: BT-153, BT-129, BT-146, BT-131 - Notes obligatoires: PMT, PMD, AAB - Règle BR-FR-09: cohérence SIRET/SIREN  **Avantages par rapport à la version synchrone:** - Support OCR pour les PDF images (via service DocTR) - Timeout plus long pour les gros documents - Ne bloque pas le serveur
+
+### Examples
+
+```ruby
+require 'time'
+require 'factpulse'
+# setup authorization
+FactPulse.configure do |config|
+  # Configure Bearer authorization: HTTPBearer
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = FactPulse::VrificationPDFXMLApi.new
+fichier_pdf = File.new('/path/to/some/file') # File | Fichier PDF Factur-X à vérifier
+opts = {
+  forcer_ocr: true # Boolean | Forcer l'utilisation de l'OCR même si le PDF contient du texte natif
+}
+
+begin
+  # Vérifier la conformité PDF/XML Factur-X (asynchrone)
+  result = api_instance.verifier_pdf_async_api_v1_verification_verifier_async_post_0(fichier_pdf, opts)
+  p result
+rescue FactPulse::ApiError => e
+  puts "Error when calling VrificationPDFXMLApi->verifier_pdf_async_api_v1_verification_verifier_async_post_0: #{e}"
+end
+```
+
+#### Using the verifier_pdf_async_api_v1_verification_verifier_async_post_0_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ReponseTache>, Integer, Hash)> verifier_pdf_async_api_v1_verification_verifier_async_post_0_with_http_info(fichier_pdf, opts)
+
+```ruby
+begin
+  # Vérifier la conformité PDF/XML Factur-X (asynchrone)
+  data, status_code, headers = api_instance.verifier_pdf_async_api_v1_verification_verifier_async_post_0_with_http_info(fichier_pdf, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ReponseTache>
+rescue FactPulse::ApiError => e
+  puts "Error when calling VrificationPDFXMLApi->verifier_pdf_async_api_v1_verification_verifier_async_post_0_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **fichier_pdf** | **File** | Fichier PDF Factur-X à vérifier |  |
+| **forcer_ocr** | **Boolean** | Forcer l&#39;utilisation de l&#39;OCR même si le PDF contient du texte natif | [optional][default to false] |
+
+### Return type
+
+[**ReponseTache**](ReponseTache.md)
+
+### Authorization
+
+[HTTPBearer](../README.md#HTTPBearer)
+
+### HTTP request headers
+
+- **Content-Type**: multipart/form-data
+- **Accept**: application/json
+
+
+## verifier_pdf_sync_api_v1_verification_verifier_post
+
+> <ReponseVerificationSucces> verifier_pdf_sync_api_v1_verification_verifier_post(fichier_pdf)
+
+Vérifier la conformité PDF/XML Factur-X (synchrone)
+
+Vérifie la conformité entre le PDF et son XML Factur-X embarqué.  **IMPORTANT**: Seuls les PDF Factur-X (avec XML embarqué) sont acceptés. Les PDF sans XML Factur-X seront rejetés avec une erreur 400.  Cette version synchrone utilise uniquement l'extraction PDF native (pdfplumber). Pour les PDF images nécessitant de l'OCR, utilisez l'endpoint `/verifier-async`.  **Principe de vérification (Factur-X 1.08):** - Principe n°2: Le XML ne peut contenir que des infos présentes dans le PDF - Principe n°4: Toute info XML doit être présente et conforme dans le PDF  **Champs vérifiés:** - Identification: BT-1 (n° facture), BT-2 (date), BT-3 (type), BT-5 (devise), BT-23 (cadre) - Vendeur: BT-27 (nom), BT-29 (SIRET), BT-30 (SIREN), BT-31 (TVA) - Acheteur: BT-44 (nom), BT-46 (SIRET), BT-47 (SIREN), BT-48 (TVA) - Montants: BT-109 (HT), BT-110 (TVA), BT-112 (TTC), BT-115 (à payer) - Ventilation TVA: BT-116, BT-117, BT-118, BT-119 - Lignes de facture: BT-153, BT-129, BT-146, BT-131 - Notes obligatoires: PMT, PMD, AAB - Règle BR-FR-09: cohérence SIRET/SIREN
+
+### Examples
+
+```ruby
+require 'time'
+require 'factpulse'
+# setup authorization
+FactPulse.configure do |config|
+  # Configure Bearer authorization: HTTPBearer
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = FactPulse::VrificationPDFXMLApi.new
+fichier_pdf = File.new('/path/to/some/file') # File | Fichier PDF Factur-X à vérifier
+
+begin
+  # Vérifier la conformité PDF/XML Factur-X (synchrone)
+  result = api_instance.verifier_pdf_sync_api_v1_verification_verifier_post(fichier_pdf)
+  p result
+rescue FactPulse::ApiError => e
+  puts "Error when calling VrificationPDFXMLApi->verifier_pdf_sync_api_v1_verification_verifier_post: #{e}"
+end
+```
+
+#### Using the verifier_pdf_sync_api_v1_verification_verifier_post_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ReponseVerificationSucces>, Integer, Hash)> verifier_pdf_sync_api_v1_verification_verifier_post_with_http_info(fichier_pdf)
+
+```ruby
+begin
+  # Vérifier la conformité PDF/XML Factur-X (synchrone)
+  data, status_code, headers = api_instance.verifier_pdf_sync_api_v1_verification_verifier_post_with_http_info(fichier_pdf)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ReponseVerificationSucces>
+rescue FactPulse::ApiError => e
+  puts "Error when calling VrificationPDFXMLApi->verifier_pdf_sync_api_v1_verification_verifier_post_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **fichier_pdf** | **File** | Fichier PDF Factur-X à vérifier |  |
+
+### Return type
+
+[**ReponseVerificationSucces**](ReponseVerificationSucces.md)
+
+### Authorization
+
+[HTTPBearer](../README.md#HTTPBearer)
+
+### HTTP request headers
+
+- **Content-Type**: multipart/form-data
+- **Accept**: application/json
+
+
+## verifier_pdf_sync_api_v1_verification_verifier_post_0
+
+> <ReponseVerificationSucces> verifier_pdf_sync_api_v1_verification_verifier_post_0(fichier_pdf)
+
+Vérifier la conformité PDF/XML Factur-X (synchrone)
+
+Vérifie la conformité entre le PDF et son XML Factur-X embarqué.  **IMPORTANT**: Seuls les PDF Factur-X (avec XML embarqué) sont acceptés. Les PDF sans XML Factur-X seront rejetés avec une erreur 400.  Cette version synchrone utilise uniquement l'extraction PDF native (pdfplumber). Pour les PDF images nécessitant de l'OCR, utilisez l'endpoint `/verifier-async`.  **Principe de vérification (Factur-X 1.08):** - Principe n°2: Le XML ne peut contenir que des infos présentes dans le PDF - Principe n°4: Toute info XML doit être présente et conforme dans le PDF  **Champs vérifiés:** - Identification: BT-1 (n° facture), BT-2 (date), BT-3 (type), BT-5 (devise), BT-23 (cadre) - Vendeur: BT-27 (nom), BT-29 (SIRET), BT-30 (SIREN), BT-31 (TVA) - Acheteur: BT-44 (nom), BT-46 (SIRET), BT-47 (SIREN), BT-48 (TVA) - Montants: BT-109 (HT), BT-110 (TVA), BT-112 (TTC), BT-115 (à payer) - Ventilation TVA: BT-116, BT-117, BT-118, BT-119 - Lignes de facture: BT-153, BT-129, BT-146, BT-131 - Notes obligatoires: PMT, PMD, AAB - Règle BR-FR-09: cohérence SIRET/SIREN
+
+### Examples
+
+```ruby
+require 'time'
+require 'factpulse'
+# setup authorization
+FactPulse.configure do |config|
+  # Configure Bearer authorization: HTTPBearer
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = FactPulse::VrificationPDFXMLApi.new
+fichier_pdf = File.new('/path/to/some/file') # File | Fichier PDF Factur-X à vérifier
+
+begin
+  # Vérifier la conformité PDF/XML Factur-X (synchrone)
+  result = api_instance.verifier_pdf_sync_api_v1_verification_verifier_post_0(fichier_pdf)
+  p result
+rescue FactPulse::ApiError => e
+  puts "Error when calling VrificationPDFXMLApi->verifier_pdf_sync_api_v1_verification_verifier_post_0: #{e}"
+end
+```
+
+#### Using the verifier_pdf_sync_api_v1_verification_verifier_post_0_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ReponseVerificationSucces>, Integer, Hash)> verifier_pdf_sync_api_v1_verification_verifier_post_0_with_http_info(fichier_pdf)
+
+```ruby
+begin
+  # Vérifier la conformité PDF/XML Factur-X (synchrone)
+  data, status_code, headers = api_instance.verifier_pdf_sync_api_v1_verification_verifier_post_0_with_http_info(fichier_pdf)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ReponseVerificationSucces>
+rescue FactPulse::ApiError => e
+  puts "Error when calling VrificationPDFXMLApi->verifier_pdf_sync_api_v1_verification_verifier_post_0_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **fichier_pdf** | **File** | Fichier PDF Factur-X à vérifier |  |
+
+### Return type
+
+[**ReponseVerificationSucces**](ReponseVerificationSucces.md)
+
+### Authorization
+
+[HTTPBearer](../README.md#HTTPBearer)
+
+### HTTP request headers
+
+- **Content-Type**: multipart/form-data
+- **Accept**: application/json
+

data/lib/factpulse/api/traitement_facture_api.rb

@@ -169,7 +169,7 @@ module FactPulse
     end
 
     # Obtenir le statut d'une tâche de génération
-    # Récupère l'état d'avancement d'une tâche de génération de facture.  ## États possibles  Le champ `statut` utilise l'enum `StatutCelery` avec les valeurs : - **PENDING, STARTED, SUCCESS, FAILURE, RETRY**  Voir la documentation du schéma `StatutCelery` pour les détails.  ## Résultat métier  Quand `statut=\"SUCCESS\"`, le champ `resultat` contient : - `statut` : \"SUCCES\" ou \"ERREUR\" (résultat métier) - `chemin_fichier` : Chemin du fichier généré (si succès) - `message_erreur` : Détails de l'erreur (si échec métier)  ## Usage  Appelez cet endpoint en boucle (polling) toutes les 2-3 secondes jusqu'à ce que `statut` soit `SUCCESS` ou `FAILURE`.
+    # Récupère l'état d'avancement d'une tâche de génération de facture.  ## États possibles  Le champ `statut` utilise l'enum `StatutCelery` avec les valeurs : - **PENDING, STARTED, SUCCESS, FAILURE, RETRY**  Voir la documentation du schéma `StatutCelery` pour les détails.  ## Résultat métier  Quand `statut=\"SUCCESS\"`, le champ `resultat` contient : - `statut` : \"SUCCES\" ou \"ERREUR\" (résultat métier) - `chemin_fichier` : Chemin du fichier généré (si succès) - `errorCode`, `errorMessage`, `details` : Format AFNOR (si échec métier)  ## Usage  Appelez cet endpoint en boucle (polling) toutes les 2-3 secondes jusqu'à ce que `statut` soit `SUCCESS` ou `FAILURE`.
     # @param id_tache [String] 
     # @param [Hash] opts the optional parameters
     # @return [StatutTache]
@@ -179,7 +179,7 @@ module FactPulse
     end
 
     # Obtenir le statut d'une tâche de génération
-    # Récupère l'état d'avancement d'une tâche de génération de facture.  ## États possibles  Le champ `statut` utilise l'enum `StatutCelery` avec les valeurs : - **PENDING, STARTED, SUCCESS, FAILURE, RETRY**  Voir la documentation du schéma `StatutCelery` pour les détails.  ## Résultat métier  Quand `statut=\"SUCCESS\"`, le champ `resultat` contient : - `statut` : \"SUCCES\" ou \"ERREUR\" (résultat métier) - `chemin_fichier` : Chemin du fichier généré (si succès) - `message_erreur` : Détails de l'erreur (si échec métier)  ## Usage  Appelez cet endpoint en boucle (polling) toutes les 2-3 secondes jusqu'à ce que `statut` soit `SUCCESS` ou `FAILURE`.
+    # Récupère l'état d'avancement d'une tâche de génération de facture.  ## États possibles  Le champ `statut` utilise l'enum `StatutCelery` avec les valeurs : - **PENDING, STARTED, SUCCESS, FAILURE, RETRY**  Voir la documentation du schéma `StatutCelery` pour les détails.  ## Résultat métier  Quand `statut=\"SUCCESS\"`, le champ `resultat` contient : - `statut` : \"SUCCES\" ou \"ERREUR\" (résultat métier) - `chemin_fichier` : Chemin du fichier généré (si succès) - `errorCode`, `errorMessage`, `details` : Format AFNOR (si échec métier)  ## Usage  Appelez cet endpoint en boucle (polling) toutes les 2-3 secondes jusqu'à ce que `statut` soit `SUCCESS` ou `FAILURE`.
     # @param id_tache [String] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(StatutTache, Integer, Hash)>] StatutTache data, response status code and response headers
@@ -617,7 +617,7 @@ module FactPulse
     end
 
     # Valider un PDF Factur-X (asynchrone avec polling)
-    # Valide un PDF Factur-X de manière asynchrone avec système de polling.  ## Fonctionnement  1. **Soumission** : Le PDF est mis en file d'attente pour validation asynchrone 2. **Retour immédiat** : Vous recevez un `id_tache` (HTTP 202) 3. **Suivi** : Utilisez l'endpoint `/taches/{id_tache}/statut` pour suivre l'avancement  ## Avantages du mode asynchrone  - **Pas de timeout** : Idéal pour les gros PDFs ou la validation VeraPDF (qui peut prendre plusieurs secondes) - **Scalabilité** : Les validations sont traitées par des workers Celery dédiés - **Suivi d'état** : Permet de suivre la progression de la validation - **Non-bloquant** : Votre client ne reste pas en attente pendant la validation  ## Quand utiliser ce mode ?  - **Validation VeraPDF activée** (`use_verapdf=True`) : La validation stricte peut prendre 2-10 secondes - **Gros fichiers PDF** : PDFs > 1 MB - **Traitement par lots** : Validation de multiples factures en parallèle - **Intégration asynchrone** : Votre système supporte le polling  ## Contrôles effectués  ### 1. Extraction et validation du XML Factur-X - Vérifie la présence d'un fichier XML embarqué conforme Factur-X - Détecte automatiquement le profil utilisé (MINIMUM, BASIC, EN16931, EXTENDED) - Valide le XML contre les règles Schematron du profil détecté  ### 2. Conformité PDF/A - **Sans VeraPDF** : Validation basique par métadonnées (rapide, ~100ms) - **Avec VeraPDF** : Validation stricte selon ISO 19005 (146+ règles, 2-10s)   - Détecte la version PDF/A (PDF/A-1, PDF/A-3, etc.)   - Rapports détaillés des non-conformités  ### 3. Métadonnées XMP - Vérifie la présence de métadonnées XMP dans le PDF - Valide la conformité des métadonnées Factur-X (profil, version) - Extrait toutes les métadonnées XMP disponibles  ### 4. Signatures électroniques - Détecte la présence de signatures ou cachets électroniques - Extrait les informations sur chaque signature (signataire, date, raison) - Compte le nombre de signatures présentes  ## Paramètres  - **fichier_pdf** : Le fichier PDF Factur-X à valider - **profil** : Le profil Factur-X attendu (optionnel). Si non spécifié, le profil   sera automatiquement détecté depuis le fichier XML embarqué. - **use_verapdf** : Active la validation stricte PDF/A avec VeraPDF.   ⚠️ **Attention** : VeraPDF peut prendre 2-10 secondes selon la taille du PDF.   Recommandé uniquement en mode asynchrone pour éviter les timeouts.  ## Récupération du résultat  Après soumission, utilisez l'endpoint `GET /taches/{id_tache}/statut` pour récupérer le résultat.  **Exemple de polling** : ```python import requests import time  # 1. Soumettre la tâche response = requests.post(\"/valider-facturx-async\", files={\"fichier_pdf\": pdf_file}) task_id = response.json()[\"id_tache\"]  # 2. Polling toutes les 2 secondes while True:     status_response = requests.get(f\"/taches/{task_id}/statut\")     status = status_response.json()      if status[\"statut\"] == \"SUCCESS\":         resultat = status[\"resultat\"][\"resultat_validation\"]         print(f\"Conforme: {resultat['est_conforme']}\")         break     elif status[\"statut\"] == \"FAILURE\":         print(f\"Erreur: {status['resultat']['message_erreur']}\")         break      time.sleep(2)  # Attendre 2 secondes avant le prochain check ```  ## Cas d'usage  - Valider des factures avant envoi avec VeraPDF (validation stricte) - Traiter des lots de factures en parallèle - Intégrer la validation dans un pipeline asynchrone - Valider des PDFs volumineux sans risque de timeout
+    # Valide un PDF Factur-X de manière asynchrone avec système de polling.  ## Fonctionnement  1. **Soumission** : Le PDF est mis en file d'attente pour validation asynchrone 2. **Retour immédiat** : Vous recevez un `id_tache` (HTTP 202) 3. **Suivi** : Utilisez l'endpoint `/taches/{id_tache}/statut` pour suivre l'avancement  ## Avantages du mode asynchrone  - **Pas de timeout** : Idéal pour les gros PDFs ou la validation VeraPDF (qui peut prendre plusieurs secondes) - **Scalabilité** : Les validations sont traitées par des workers Celery dédiés - **Suivi d'état** : Permet de suivre la progression de la validation - **Non-bloquant** : Votre client ne reste pas en attente pendant la validation  ## Quand utiliser ce mode ?  - **Validation VeraPDF activée** (`use_verapdf=True`) : La validation stricte peut prendre 2-10 secondes - **Gros fichiers PDF** : PDFs > 1 MB - **Traitement par lots** : Validation de multiples factures en parallèle - **Intégration asynchrone** : Votre système supporte le polling  ## Contrôles effectués  ### 1. Extraction et validation du XML Factur-X - Vérifie la présence d'un fichier XML embarqué conforme Factur-X - Détecte automatiquement le profil utilisé (MINIMUM, BASIC, EN16931, EXTENDED) - Valide le XML contre les règles Schematron du profil détecté  ### 2. Conformité PDF/A - **Sans VeraPDF** : Validation basique par métadonnées (rapide, ~100ms) - **Avec VeraPDF** : Validation stricte selon ISO 19005 (146+ règles, 2-10s)   - Détecte la version PDF/A (PDF/A-1, PDF/A-3, etc.)   - Rapports détaillés des non-conformités  ### 3. Métadonnées XMP - Vérifie la présence de métadonnées XMP dans le PDF - Valide la conformité des métadonnées Factur-X (profil, version) - Extrait toutes les métadonnées XMP disponibles  ### 4. Signatures électroniques - Détecte la présence de signatures ou cachets électroniques - Extrait les informations sur chaque signature (signataire, date, raison) - Compte le nombre de signatures présentes  ## Paramètres  - **fichier_pdf** : Le fichier PDF Factur-X à valider - **profil** : Le profil Factur-X attendu (optionnel). Si non spécifié, le profil   sera automatiquement détecté depuis le fichier XML embarqué. - **use_verapdf** : Active la validation stricte PDF/A avec VeraPDF.   ⚠️ **Attention** : VeraPDF peut prendre 2-10 secondes selon la taille du PDF.   Recommandé uniquement en mode asynchrone pour éviter les timeouts.  ## Récupération du résultat  Après soumission, utilisez l'endpoint `GET /taches/{id_tache}/statut` pour récupérer le résultat.  **Exemple de polling** : ```python import requests import time  # 1. Soumettre la tâche response = requests.post(\"/valider-facturx-async\", files={\"fichier_pdf\": pdf_file}) task_id = response.json()[\"id_tache\"]  # 2. Polling toutes les 2 secondes while True:     status_response = requests.get(f\"/taches/{task_id}/statut\")     status = status_response.json()      if status[\"statut\"] == \"SUCCESS\":         resultat = status[\"resultat\"][\"resultat_validation\"]         print(f\"Conforme: {resultat['est_conforme']}\")         break     elif status[\"statut\"] == \"FAILURE\":         print(f\"Erreur: {status['resultat']['errorMessage']}\")         break      time.sleep(2)  # Attendre 2 secondes avant le prochain check ```  ## Cas d'usage  - Valider des factures avant envoi avec VeraPDF (validation stricte) - Traiter des lots de factures en parallèle - Intégrer la validation dans un pipeline asynchrone - Valider des PDFs volumineux sans risque de timeout
     # @param fichier_pdf [File] Fichier PDF Factur-X à valider (format .pdf).
     # @param [Hash] opts the optional parameters
     # @option opts [ProfilAPI] :profil 
@@ -629,7 +629,7 @@ module FactPulse
     end
 
     # Valider un PDF Factur-X (asynchrone avec polling)
-    # Valide un PDF Factur-X de manière asynchrone avec système de polling.  ## Fonctionnement  1. **Soumission** : Le PDF est mis en file d&#39;attente pour validation asynchrone 2. **Retour immédiat** : Vous recevez un &#x60;id_tache&#x60; (HTTP 202) 3. **Suivi** : Utilisez l&#39;endpoint &#x60;/taches/{id_tache}/statut&#x60; pour suivre l&#39;avancement  ## Avantages du mode asynchrone  - **Pas de timeout** : Idéal pour les gros PDFs ou la validation VeraPDF (qui peut prendre plusieurs secondes) - **Scalabilité** : Les validations sont traitées par des workers Celery dédiés - **Suivi d&#39;état** : Permet de suivre la progression de la validation - **Non-bloquant** : Votre client ne reste pas en attente pendant la validation  ## Quand utiliser ce mode ?  - **Validation VeraPDF activée** (&#x60;use_verapdf&#x3D;True&#x60;) : La validation stricte peut prendre 2-10 secondes - **Gros fichiers PDF** : PDFs &gt; 1 MB - **Traitement par lots** : Validation de multiples factures en parallèle - **Intégration asynchrone** : Votre système supporte le polling  ## Contrôles effectués  ### 1. Extraction et validation du XML Factur-X - Vérifie la présence d&#39;un fichier XML embarqué conforme Factur-X - Détecte automatiquement le profil utilisé (MINIMUM, BASIC, EN16931, EXTENDED) - Valide le XML contre les règles Schematron du profil détecté  ### 2. Conformité PDF/A - **Sans VeraPDF** : Validation basique par métadonnées (rapide, ~100ms) - **Avec VeraPDF** : Validation stricte selon ISO 19005 (146+ règles, 2-10s)   - Détecte la version PDF/A (PDF/A-1, PDF/A-3, etc.)   - Rapports détaillés des non-conformités  ### 3. Métadonnées XMP - Vérifie la présence de métadonnées XMP dans le PDF - Valide la conformité des métadonnées Factur-X (profil, version) - Extrait toutes les métadonnées XMP disponibles  ### 4. Signatures électroniques - Détecte la présence de signatures ou cachets électroniques - Extrait les informations sur chaque signature (signataire, date, raison) - Compte le nombre de signatures présentes  ## Paramètres  - **fichier_pdf** : Le fichier PDF Factur-X à valider - **profil** : Le profil Factur-X attendu (optionnel). Si non spécifié, le profil   sera automatiquement détecté depuis le fichier XML embarqué. - **use_verapdf** : Active la validation stricte PDF/A avec VeraPDF.   ⚠️ **Attention** : VeraPDF peut prendre 2-10 secondes selon la taille du PDF.   Recommandé uniquement en mode asynchrone pour éviter les timeouts.  ## Récupération du résultat  Après soumission, utilisez l&#39;endpoint &#x60;GET /taches/{id_tache}/statut&#x60; pour récupérer le résultat.  **Exemple de polling** : &#x60;&#x60;&#x60;python import requests import time  # 1. Soumettre la tâche response &#x3D; requests.post(\&quot;/valider-facturx-async\&quot;, files&#x3D;{\&quot;fichier_pdf\&quot;: pdf_file}) task_id &#x3D; response.json()[\&quot;id_tache\&quot;]  # 2. Polling toutes les 2 secondes while True:     status_response &#x3D; requests.get(f\&quot;/taches/{task_id}/statut\&quot;)     status &#x3D; status_response.json()      if status[\&quot;statut\&quot;] &#x3D;&#x3D; \&quot;SUCCESS\&quot;:         resultat &#x3D; status[\&quot;resultat\&quot;][\&quot;resultat_validation\&quot;]         print(f\&quot;Conforme: {resultat[&#39;est_conforme&#39;]}\&quot;)         break     elif status[\&quot;statut\&quot;] &#x3D;&#x3D; \&quot;FAILURE\&quot;:         print(f\&quot;Erreur: {status[&#39;resultat&#39;][&#39;message_erreur&#39;]}\&quot;)         break      time.sleep(2)  # Attendre 2 secondes avant le prochain check &#x60;&#x60;&#x60;  ## Cas d&#39;usage  - Valider des factures avant envoi avec VeraPDF (validation stricte) - Traiter des lots de factures en parallèle - Intégrer la validation dans un pipeline asynchrone - Valider des PDFs volumineux sans risque de timeout
+    # Valide un PDF Factur-X de manière asynchrone avec système de polling.  ## Fonctionnement  1. **Soumission** : Le PDF est mis en file d&#39;attente pour validation asynchrone 2. **Retour immédiat** : Vous recevez un &#x60;id_tache&#x60; (HTTP 202) 3. **Suivi** : Utilisez l&#39;endpoint &#x60;/taches/{id_tache}/statut&#x60; pour suivre l&#39;avancement  ## Avantages du mode asynchrone  - **Pas de timeout** : Idéal pour les gros PDFs ou la validation VeraPDF (qui peut prendre plusieurs secondes) - **Scalabilité** : Les validations sont traitées par des workers Celery dédiés - **Suivi d&#39;état** : Permet de suivre la progression de la validation - **Non-bloquant** : Votre client ne reste pas en attente pendant la validation  ## Quand utiliser ce mode ?  - **Validation VeraPDF activée** (&#x60;use_verapdf&#x3D;True&#x60;) : La validation stricte peut prendre 2-10 secondes - **Gros fichiers PDF** : PDFs &gt; 1 MB - **Traitement par lots** : Validation de multiples factures en parallèle - **Intégration asynchrone** : Votre système supporte le polling  ## Contrôles effectués  ### 1. Extraction et validation du XML Factur-X - Vérifie la présence d&#39;un fichier XML embarqué conforme Factur-X - Détecte automatiquement le profil utilisé (MINIMUM, BASIC, EN16931, EXTENDED) - Valide le XML contre les règles Schematron du profil détecté  ### 2. Conformité PDF/A - **Sans VeraPDF** : Validation basique par métadonnées (rapide, ~100ms) - **Avec VeraPDF** : Validation stricte selon ISO 19005 (146+ règles, 2-10s)   - Détecte la version PDF/A (PDF/A-1, PDF/A-3, etc.)   - Rapports détaillés des non-conformités  ### 3. Métadonnées XMP - Vérifie la présence de métadonnées XMP dans le PDF - Valide la conformité des métadonnées Factur-X (profil, version) - Extrait toutes les métadonnées XMP disponibles  ### 4. Signatures électroniques - Détecte la présence de signatures ou cachets électroniques - Extrait les informations sur chaque signature (signataire, date, raison) - Compte le nombre de signatures présentes  ## Paramètres  - **fichier_pdf** : Le fichier PDF Factur-X à valider - **profil** : Le profil Factur-X attendu (optionnel). Si non spécifié, le profil   sera automatiquement détecté depuis le fichier XML embarqué. - **use_verapdf** : Active la validation stricte PDF/A avec VeraPDF.   ⚠️ **Attention** : VeraPDF peut prendre 2-10 secondes selon la taille du PDF.   Recommandé uniquement en mode asynchrone pour éviter les timeouts.  ## Récupération du résultat  Après soumission, utilisez l&#39;endpoint &#x60;GET /taches/{id_tache}/statut&#x60; pour récupérer le résultat.  **Exemple de polling** : &#x60;&#x60;&#x60;python import requests import time  # 1. Soumettre la tâche response &#x3D; requests.post(\&quot;/valider-facturx-async\&quot;, files&#x3D;{\&quot;fichier_pdf\&quot;: pdf_file}) task_id &#x3D; response.json()[\&quot;id_tache\&quot;]  # 2. Polling toutes les 2 secondes while True:     status_response &#x3D; requests.get(f\&quot;/taches/{task_id}/statut\&quot;)     status &#x3D; status_response.json()      if status[\&quot;statut\&quot;] &#x3D;&#x3D; \&quot;SUCCESS\&quot;:         resultat &#x3D; status[\&quot;resultat\&quot;][\&quot;resultat_validation\&quot;]         print(f\&quot;Conforme: {resultat[&#39;est_conforme&#39;]}\&quot;)         break     elif status[\&quot;statut\&quot;] &#x3D;&#x3D; \&quot;FAILURE\&quot;:         print(f\&quot;Erreur: {status[&#39;resultat&#39;][&#39;errorMessage&#39;]}\&quot;)         break      time.sleep(2)  # Attendre 2 secondes avant le prochain check &#x60;&#x60;&#x60;  ## Cas d&#39;usage  - Valider des factures avant envoi avec VeraPDF (validation stricte) - Traiter des lots de factures en parallèle - Intégrer la validation dans un pipeline asynchrone - Valider des PDFs volumineux sans risque de timeout
     # @param fichier_pdf [File] Fichier PDF Factur-X à valider (format .pdf).
     # @param [Hash] opts the optional parameters
     # @option opts [ProfilAPI] :profil