factpulse 2.0.34 → 2.0.36

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bea096152beab1702e0dc8563a51b1444575b3ab10b46faa132c463131da4343
-  data.tar.gz: 3ea017cd3b79701bb002780bc5418473de106394ff92db1361078929a6e0c8ad
+  metadata.gz: 7dbc55ff926146b1aee68f04ca98f17cd21db83b86a10df194a2f0d13c52d325
+  data.tar.gz: c0e117fdc04f6a3cbd9d9f3ef401bbd87bcddc03f2b298ec56f64727c6a1435a
 SHA512:
-  metadata.gz: b4b21cadcc71ca317d3e7821be917f70971218cde09c9b2387f81753d23f8744fcf8e31bac878987ed51d76de6f257473b2faa4c147871b855c6e7d40bffae88
-  data.tar.gz: 2535bd23ad2f501c80eb7984e975416f77ae14539c0edda187ca3dc3e3152c2f84a22df952bb0a3dfd4f691b287fe9f559b5b53702cc7e3423cb2581577ea01c
+  metadata.gz: 45955e137fa25ed155c989b2c4c5d7f1c3dbb0000f7aa0d2cd41849973455daf7a6aa34337b4ef2911838c468ca2fe7c025c2c021e26968f9d10ec0940c2fc64
+  data.tar.gz: 533cf8e7c28f08553a9511eb9b34fe372d762a6dbb6003c3ca42dbc0ec53d40dc5cad4ae998ed45ca254f390cd1797329d917d141d040379ba6f0cd2eae47bf2

data/CHANGELOG.md

@@ -7,7 +7,7 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
-## [2.0.34] - 2025-11-29
+## [2.0.36] - 2025-12-08
 
 ### Added
 - Version initiale du SDK ruby
@@ -24,5 +24,5 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 - Guide d'authentification JWT
 - Configuration avancée (timeout, proxy, debug)
 
-[Unreleased]: https://github.com/factpulse/sdk-ruby/compare/v2.0.34...HEAD
-[2.0.34]: https://github.com/factpulse/sdk-ruby/releases/tag/v2.0.34
+[Unreleased]: https://github.com/factpulse/sdk-ruby/compare/v2.0.36...HEAD
+[2.0.36]: https://github.com/factpulse/sdk-ruby/releases/tag/v2.0.36

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    factpulse (2.0.34)
+    factpulse (2.0.36)
       typhoeus (~> 1.0, >= 1.0.1)
 
 GEM
@@ -55,7 +55,7 @@ GEM
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 1.4.0, < 1.6)
     ruby-progressbar (1.13.0)
-    stringio (3.1.8)
+    stringio (3.1.9)
     typhoeus (1.5.0)
       ethon (>= 0.9.0, < 0.16.0)
     unicode-display_width (1.5.0)

data/docs/BoundingBoxSchema.md

@@ -0,0 +1,30 @@
+# FactPulse::BoundingBoxSchema
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **x0** | **Float** | Coordonnée X gauche |  |
+| **y0** | **Float** | Coordonnée Y bas |  |
+| **x1** | **Float** | Coordonnée X droite |  |
+| **y1** | **Float** | Coordonnée Y haut |  |
+| **page** | **Integer** | Numéro de page (0-indexed) | [optional][default to 0] |
+| **width** | **Float** | Largeur de la zone |  |
+| **height** | **Float** | Hauteur de la zone |  |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::BoundingBoxSchema.new(
+  x0: null,
+  y0: null,
+  x1: null,
+  y1: null,
+  page: null,
+  width: null,
+  height: null
+)
+```
+

data/docs/CadreDeFacturation.md

@@ -5,6 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **code_cadre_facturation** | [**CodeCadreFacturation**](CodeCadreFacturation.md) |  |  |
+| **nature_operation** | [**NatureOperation**](NatureOperation.md) |  | [optional] |
 | **code_service_valideur** | **String** |  | [optional] |
 | **code_structure_valideur** | **String** |  | [optional] |
 
@@ -15,6 +16,7 @@ require 'factpulse'
 
 instance = FactPulse::CadreDeFacturation.new(
   code_cadre_facturation: null,
+  nature_operation: null,
   code_service_valideur: null,
   code_structure_valideur: null
 )

data/docs/ChampVerifieSchema.md

@@ -0,0 +1,34 @@
+# FactPulse::ChampVerifieSchema
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **business_term** | **String** | Business Term EN16931 (ex: BT-1) |  |
+| **label** | **String** | Libellé du champ (ex: N° Facture) |  |
+| **valeur_pdf** | **String** |  | [optional] |
+| **valeur_xml** | **String** |  | [optional] |
+| **statut** | [**StatutChampAPI**](StatutChampAPI.md) | Statut de conformité |  |
+| **message** | **String** |  | [optional] |
+| **confiance** | **Float** | Score de confiance (0-1) | [optional][default to 1.0] |
+| **source** | **String** | Source d'extraction | [optional][default to 'pdf_natif'] |
+| **bbox** | [**BoundingBoxSchema**](BoundingBoxSchema.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::ChampVerifieSchema.new(
+  business_term: null,
+  label: null,
+  valeur_pdf: null,
+  valeur_xml: null,
+  statut: null,
+  message: null,
+  confiance: null,
+  source: null,
+  bbox: null
+)
+```
+

data/docs/DimensionPageSchema.md

@@ -0,0 +1,20 @@
+# FactPulse::DimensionPageSchema
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **width** | **Float** | Largeur en points PDF |  |
+| **height** | **Float** | Hauteur en points PDF |  |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::DimensionPageSchema.new(
+  width: null,
+  height: null
+)
+```
+

data/docs/DirectionFlux.md

@@ -0,0 +1,15 @@
+# FactPulse::DirectionFlux
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::DirectionFlux.new()
+```
+

data/docs/FluxResume.md

@@ -0,0 +1,32 @@
+# FactPulse::FluxResume
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **flow_id** | **String** |  |  |
+| **tracking_id** | **String** |  | [optional] |
+| **nom** | **String** |  |  |
+| **type_flux** | **String** |  | [optional] |
+| **direction_flux** | **String** |  | [optional] |
+| **statut_acquittement** | **String** |  | [optional] |
+| **date_creation** | **String** |  | [optional] |
+| **date_maj** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::FluxResume.new(
+  flow_id: null,
+  tracking_id: null,
+  nom: null,
+  type_flux: null,
+  direction_flux: null,
+  statut_acquittement: null,
+  date_creation: null,
+  date_maj: null
+)
+```
+

data/docs/LigneDeTVA.md

@@ -9,6 +9,8 @@
 | **taux** | **String** |  | [optional] |
 | **taux_manuel** | [**Tauxmanuel**](Tauxmanuel.md) |  | [optional] |
 | **categorie** | [**CategorieTVA**](CategorieTVA.md) |  | [optional] |
+| **motif_exoneration** | **String** |  | [optional] |
+| **code_vatex** | **String** |  | [optional] |
 
 ## Example
 
@@ -20,7 +22,9 @@ instance = FactPulse::LigneDeTVA.new(
   montant_tva: null,
   taux: null,
   taux_manuel: null,
-  categorie: null
+  categorie: null,
+  motif_exoneration: null,
+  code_vatex: null
 )
 ```
 

data/docs/NatureOperation.md

@@ -0,0 +1,15 @@
+# FactPulse::NatureOperation
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::NatureOperation.new()
+```
+

data/docs/Note.md

@@ -4,8 +4,8 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **subject_code** | **String** |  | [optional] |
-| **content** | **String** |  |  |
+| **code_sujet** | **String** |  | [optional] |
+| **contenu** | **String** |  |  |
 
 ## Example
 
@@ -13,8 +13,8 @@
 require 'factpulse'
 
 instance = FactPulse::Note.new(
-  subject_code: null,
-  content: null
+  code_sujet: null,
+  contenu: null
 )
 ```
 

data/docs/NoteObligatoireSchema.md

@@ -0,0 +1,30 @@
+# FactPulse::NoteObligatoireSchema
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **code_sujet** | **String** | Code sujet (PMT, PMD, AAB) |  |
+| **label** | **String** | Libellé (ex: Indemnité recouvrement) |  |
+| **valeur_pdf** | **String** |  | [optional] |
+| **valeur_xml** | **String** |  | [optional] |
+| **statut** | [**StatutChampAPI**](StatutChampAPI.md) | Statut de conformité (CONFORME si XML trouvé dans PDF) | [optional] |
+| **message** | **String** |  | [optional] |
+| **bbox** | [**BoundingBoxSchema**](BoundingBoxSchema.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::NoteObligatoireSchema.new(
+  code_sujet: null,
+  label: null,
+  valeur_pdf: null,
+  valeur_xml: null,
+  statut: null,
+  message: null,
+  bbox: null
+)
+```
+

data/docs/PDPCredentials.md

@@ -0,0 +1,26 @@
+# FactPulse::PDPCredentials
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **flow_service_url** | **String** | URL de base du Flow Service AFNOR |  |
+| **directory_service_url** | **String** |  | [optional] |
+| **token_url** | **String** | URL du serveur OAuth2 |  |
+| **client_id** | **String** | Client ID OAuth2 |  |
+| **client_secret** | **String** | Client Secret OAuth2 (sensible) |  |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::PDPCredentials.new(
+  flow_service_url: https://api.pdp-example.fr/flow/v1,
+  directory_service_url: null,
+  token_url: https://auth.pdp-example.fr/oauth/token,
+  client_id: factpulse_prod_abc123,
+  client_secret: secret_xyz789
+)
+```
+

data/docs/ProfilFlux.md

@@ -0,0 +1,15 @@
+# FactPulse::ProfilFlux
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::ProfilFlux.new()
+```
+

data/docs/ReponseHealthcheckAFNOR.md

@@ -0,0 +1,22 @@
+# FactPulse::ReponseHealthcheckAFNOR
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **flow_service_ok** | **Boolean** | État du Flow Service API |  |
+| **directory_service_ok** | **Boolean** | État du Directory Service API |  |
+| **message** | **String** | Message descriptif de l'état |  |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::ReponseHealthcheckAFNOR.new(
+  flow_service_ok: null,
+  directory_service_ok: null,
+  message: null
+)
+```
+

data/docs/ReponseRechercheFlux.md

@@ -0,0 +1,24 @@
+# FactPulse::ReponseRechercheFlux
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **total** | **Integer** | Nombre total de résultats |  |
+| **offset** | **Integer** | Décalage appliqué |  |
+| **limit** | **Integer** | Limite de résultats |  |
+| **resultats** | [**Array<FluxResume>**](FluxResume.md) | Liste des flux trouvés |  |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::ReponseRechercheFlux.new(
+  total: null,
+  offset: null,
+  limit: null,
+  resultats: null
+)
+```
+

data/docs/ReponseSoumissionFlux.md

@@ -0,0 +1,30 @@
+# FactPulse::ReponseSoumissionFlux
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **flow_id** | **String** | Identifiant unique du flux généré par la PDP |  |
+| **tracking_id** | **String** |  | [optional] |
+| **nom** | **String** | Nom du flux |  |
+| **syntaxe_flux** | **String** | Syntaxe du flux (CII, UBL, etc.) |  |
+| **profil_flux** | **String** |  | [optional] |
+| **sha256** | **String** | Hash SHA256 du fichier soumis |  |
+| **message** | **String** | Message de confirmation |  |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::ReponseSoumissionFlux.new(
+  flow_id: null,
+  tracking_id: null,
+  nom: null,
+  syntaxe_flux: null,
+  profil_flux: null,
+  sha256: null,
+  message: null
+)
+```
+

data/docs/ReponseVerificationSucces.md

@@ -0,0 +1,36 @@
+# FactPulse::ReponseVerificationSucces
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **est_conforme** | **Boolean** | True si aucun écart critique |  |
+| **score_conformite** | **Float** | Score de conformité (0-100%) |  |
+| **champs_verifies** | **Integer** | Nombre de champs vérifiés | [optional][default to 0] |
+| **champs_conformes** | **Integer** | Nombre de champs conformes | [optional][default to 0] |
+| **est_facturx** | **Boolean** | True si le PDF contient du XML Factur-X | [optional][default to false] |
+| **profil_facturx** | **String** |  | [optional] |
+| **champs** | [**Array<ChampVerifieSchema>**](ChampVerifieSchema.md) | Liste des champs vérifiés avec valeurs, statuts et coordonnées PDF | [optional] |
+| **notes_obligatoires** | [**Array<NoteObligatoireSchema>**](NoteObligatoireSchema.md) | Notes obligatoires (PMT, PMD, AAB) avec localisation PDF | [optional] |
+| **dimensions_pages** | [**Array<DimensionPageSchema>**](DimensionPageSchema.md) | Dimensions de chaque page du PDF (largeur, hauteur) | [optional] |
+| **avertissements** | **Array<String>** | Avertissements non bloquants | [optional] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::ReponseVerificationSucces.new(
+  est_conforme: null,
+  score_conformite: null,
+  champs_verifies: null,
+  champs_conformes: null,
+  est_facturx: null,
+  profil_facturx: null,
+  champs: null,
+  notes_obligatoires: null,
+  dimensions_pages: null,
+  avertissements: null
+)
+```
+

data/docs/RequeteRechercheFlux.md

@@ -0,0 +1,34 @@
+# FactPulse::RequeteRechercheFlux
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **date_maj_apres** | **Time** |  | [optional] |
+| **date_maj_avant** | **Time** |  | [optional] |
+| **type_flux** | [**Array<TypeFlux>**](TypeFlux.md) |  | [optional] |
+| **direction_flux** | [**Array<DirectionFlux>**](DirectionFlux.md) |  | [optional] |
+| **tracking_id** | **String** |  | [optional] |
+| **flow_id** | **String** |  | [optional] |
+| **statut_acquittement** | [**StatutAcquittement**](StatutAcquittement.md) |  | [optional] |
+| **offset** | **Integer** | Décalage pour la pagination | [optional][default to 0] |
+| **limit** | **Integer** | Nombre maximum de résultats (max 100) | [optional][default to 25] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::RequeteRechercheFlux.new(
+  date_maj_apres: null,
+  date_maj_avant: null,
+  type_flux: null,
+  direction_flux: null,
+  tracking_id: null,
+  flow_id: null,
+  statut_acquittement: null,
+  offset: null,
+  limit: null
+)
+```
+

data/docs/RequeteSoumissionFlux.md

@@ -0,0 +1,28 @@
+# FactPulse::RequeteSoumissionFlux
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **nom_flux** | **String** | Nom du flux (ex: 'Facture 2025-001') |  |
+| **syntaxe_flux** | [**SyntaxeFlux**](SyntaxeFlux.md) | Syntaxe du flux (CII pour Factur-X) | [optional] |
+| **profil_flux** | [**ProfilFlux**](ProfilFlux.md) |  | [optional] |
+| **tracking_id** | **String** |  | [optional] |
+| **request_id** | **String** |  | [optional] |
+| **pdp_credentials** | [**PDPCredentials**](PDPCredentials.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::RequeteSoumissionFlux.new(
+  nom_flux: Facture 2025-001,
+  syntaxe_flux: null,
+  profil_flux: null,
+  tracking_id: null,
+  request_id: null,
+  pdp_credentials: null
+)
+```
+

data/docs/StatutAcquittement.md

@@ -0,0 +1,15 @@
+# FactPulse::StatutAcquittement
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::StatutAcquittement.new()
+```
+

data/docs/StatutChampAPI.md

@@ -0,0 +1,15 @@
+# FactPulse::StatutChampAPI
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::StatutChampAPI.new()
+```
+

data/docs/SyntaxeFlux.md

@@ -0,0 +1,15 @@
+# FactPulse::SyntaxeFlux
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::SyntaxeFlux.new()
+```
+

data/docs/TraitementFactureApi.md

@@ -171,7 +171,7 @@ 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`.
 
 ### Examples
 
@@ -619,7 +619,7 @@ 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
 
 ### Examples
 

data/docs/TypeFlux.md

@@ -0,0 +1,15 @@
+# FactPulse::TypeFlux
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::TypeFlux.new()
+```
+