factpulse 2.0.35 → 2.0.37

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06a73a52e699e6c3d620f218c681ed6d23b67ab5294a7ea1b80178073b21429f
-  data.tar.gz: dddd83a74e6d2432ce32254a0aa2f379797bac4e063b7e8cf00a25ea57ec358e
+  metadata.gz: 166d4cbd11f2aa858bf11390ff4f5a0d7086ca7a5863299d1852f1494e138db2
+  data.tar.gz: 3e934fb8fe8d24554e071855d3931229fd92bba5b9130da3d2b3885ebe138f36
 SHA512:
-  metadata.gz: a87ce7d106b99dc59c3005ea49033138c56488aa904f0b2ca9105b177471ad35e8e0fc64f3fa96e9e4943be5d656592cdae3d3fa368e2e134c252aa07b94fd15
-  data.tar.gz: 1c969bbd50d5ae0df86858396dd5089545633985aecd9fdbb9078f9a3dd432908ff485f270f2640fd6bbe437085759bcc85aae5a9503615427198cee241ebf5f
+  metadata.gz: ab4bd63eb1f5b083f70201c9c497124bcfef7020ef3faa8a721e29d681e21942fc7d67ec5492a8c1b8feed89c553584113d7072d04889cec782a0a4fe6c3c74d
+  data.tar.gz: eaff3fcd4f35c6ad742176d3baaf4c0011d3cf09a70ed9b909ac81cda0b752cf714106817ed77a0bf1eb2b4c59b962851ec3fd3cd44eba7875a3e4380dcdc7e7

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.35] - 2025-12-04
+## [2.0.37] - 2025-12-10
 
 ### 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.35...HEAD
-[2.0.35]: https://github.com/factpulse/sdk-ruby/releases/tag/v2.0.35
+[Unreleased]: https://github.com/factpulse/sdk-ruby/compare/v2.0.37...HEAD
+[2.0.37]: https://github.com/factpulse/sdk-ruby/releases/tag/v2.0.37

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    factpulse (2.0.35)
+    factpulse (2.0.37)
       typhoeus (~> 1.0, >= 1.0.1)
 
 GEM
@@ -10,7 +10,7 @@ GEM
     ast (2.4.3)
     byebug (11.1.3)
     coderay (1.1.3)
-    date (3.5.0)
+    date (3.5.1)
     diff-lcs (1.6.2)
     ethon (0.15.0)
       ffi (>= 1.15.0)
@@ -27,7 +27,7 @@ GEM
     pry-byebug (3.10.1)
       byebug (~> 11.0)
       pry (>= 0.13, < 0.15)
-    psych (5.2.6)
+    psych (5.3.0)
       date
       stringio
     racc (1.8.1)

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/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()
+```
+