@factpulse/sdk 2.0.11 → 2.0.49

package/docs/FournisseurEntrant.md

@@ -0,0 +1,35 @@
+# FournisseurEntrant
+
+Fournisseur extrait d\'une facture entrante.  Contrairement au modèle Fournisseur de models.py, ce modèle n\'a pas de champ id_fournisseur car cette information n\'est pas disponible dans les XML Factur-X/CII/UBL.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**nom** | **string** | Raison sociale du fournisseur (BT-27) | [default to undefined]
+**siren** | **string** |  | [optional] [default to undefined]
+**siret** | **string** |  | [optional] [default to undefined]
+**numero_tva_intra** | **string** |  | [optional] [default to undefined]
+**adresse_postale** | [**AdressePostale**](AdressePostale.md) |  | [optional] [default to undefined]
+**adresse_electronique** | [**AdresseElectronique**](AdresseElectronique.md) |  | [optional] [default to undefined]
+**email** | **string** |  | [optional] [default to undefined]
+**telephone** | **string** |  | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { FournisseurEntrant } from '@factpulse/sdk';
+
+const instance: FournisseurEntrant = {
+    nom,
+    siren,
+    siret,
+    numero_tva_intra,
+    adresse_postale,
+    adresse_electronique,
+    email,
+    telephone,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/LigneDeTVA.md

@@ -1,6 +1,6 @@
 # LigneDeTVA
 
-Représente une ligne de totalisation par taux de TVA.
+Représente une ligne de totalisation par taux de TVA.  Pour les exonérations (catégories E, AE, K, G, O), les champs `motif_exoneration` et `code_vatex` sont requis selon EN16931.
 
 ## Properties
 
@@ -11,6 +11,8 @@ Name | Type | Description | Notes
 **taux** | **string** |  | [optional] [default to undefined]
 **tauxManuel** | [**Tauxmanuel**](Tauxmanuel.md) |  | [optional] [default to undefined]
 **categorie** | [**CategorieTVA**](CategorieTVA.md) |  | [optional] [default to undefined]
+**motifExoneration** | **string** |  | [optional] [default to undefined]
+**codeVatex** | **string** |  | [optional] [default to undefined]
 
 ## Example
 
@@ -23,6 +25,8 @@ const instance: LigneDeTVA = {
     taux,
     tauxManuel,
     categorie,
+    motifExoneration,
+    codeVatex,
 };
 ```
 

package/docs/NatureOperation.md

@@ -0,0 +1,35 @@
+# NatureOperation
+
+Nature de l\'opération (BT-23) pour Factur-X - Réforme française.  BR-FR-08: Le cadre de facturation doit être l\'un des codes suivants. La première lettre indique : B = Biens, S = Services, M = Mixte.  Ref: XP Z12-012, article_conformite_pdf_facturx.md  Exemple d\'utilisation:     >>> cadre = CadreDeFacturation(     ...     code_cadre_facturation=CodeCadreFacturation.A1_FACTURE_FOURNISSEUR,     ...     nature_operation=NatureOperation.BIENS     ... )
+
+## Enum
+
+* `B1` (value: `'B1'`)
+
+* `S1` (value: `'S1'`)
+
+* `M1` (value: `'M1'`)
+
+* `B2` (value: `'B2'`)
+
+* `S2` (value: `'S2'`)
+
+* `M2` (value: `'M2'`)
+
+* `B4` (value: `'B4'`)
+
+* `S4` (value: `'S4'`)
+
+* `M4` (value: `'M4'`)
+
+* `S3` (value: `'S3'`)
+
+* `S5` (value: `'S5'`)
+
+* `S6` (value: `'S6'`)
+
+* `B7` (value: `'B7'`)
+
+* `S7` (value: `'S7'`)
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/Note.md

@@ -6,8 +6,8 @@ Note de facture (IncludedNote en Factur-X).  Les notes obligatoires pour BR-FR-0
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**subjectCode** | **string** |  | [optional] [default to undefined]
-**content** | **string** |  | [default to undefined]
+**codeSujet** | **string** |  | [optional] [default to undefined]
+**contenu** | **string** |  | [default to undefined]
 
 ## Example
 
@@ -15,8 +15,8 @@ Name | Type | Description | Notes
 import { Note } from '@factpulse/sdk';
 
 const instance: Note = {
-    subjectCode,
-    content,
+    codeSujet,
+    contenu,
 };
 ```
 

package/docs/NoteObligatoireSchema.md

@@ -0,0 +1,33 @@
+# NoteObligatoireSchema
+
+Note obligatoire détectée avec localisation et comparaison XML/PDF.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**code_sujet** | **string** | Code sujet (PMT, PMD, AAB) | [default to undefined]
+**label** | **string** | Libellé (ex: Indemnité recouvrement) | [default to undefined]
+**valeur_pdf** | **string** |  | [optional] [default to undefined]
+**valeur_xml** | **string** |  | [optional] [default to undefined]
+**statut** | [**StatutChampAPI**](StatutChampAPI.md) | Statut de conformité (CONFORME si XML trouvé dans PDF) | [optional] [default to undefined]
+**message** | **string** |  | [optional] [default to undefined]
+**bbox** | [**BoundingBoxSchema**](BoundingBoxSchema.md) |  | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { NoteObligatoireSchema } from '@factpulse/sdk';
+
+const instance: NoteObligatoireSchema = {
+    code_sujet,
+    label,
+    valeur_pdf,
+    valeur_xml,
+    statut,
+    message,
+    bbox,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/PDPCredentials.md

@@ -0,0 +1,29 @@
+# PDPCredentials
+
+Credentials PDP pour la stratégie zero-storage (Strategy B).  Permet de fournir directement les credentials PDP dans la requête au lieu de les stocker dans Django.  Utile pour : - Tests ponctuels sans persister les credentials - Intégrations temporaires - Environnements de développement
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**flow_service_url** | **string** | URL de base du Flow Service AFNOR | [default to undefined]
+**directory_service_url** | **string** |  | [optional] [default to undefined]
+**token_url** | **string** | URL du serveur OAuth2 | [default to undefined]
+**client_id** | **string** | Client ID OAuth2 | [default to undefined]
+**client_secret** | **string** | Client Secret OAuth2 (sensible) | [default to undefined]
+
+## Example
+
+```typescript
+import { PDPCredentials } from '@factpulse/sdk';
+
+const instance: PDPCredentials = {
+    flow_service_url,
+    directory_service_url,
+    token_url,
+    client_id,
+    client_secret,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/ProfilFlux.md

@@ -0,0 +1,13 @@
+# ProfilFlux
+
+Profils de flux supportés
+
+## Enum
+
+* `Basic` (value: `'Basic'`)
+
+* `Cius` (value: `'CIUS'`)
+
+* `ExtendedCtcFr` (value: `'Extended-CTC-FR'`)
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/ReponseHealthcheckAFNOR.md

@@ -0,0 +1,25 @@
+# ReponseHealthcheckAFNOR
+
+Réponse du healthcheck des services AFNOR
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**flow_service_ok** | **boolean** | État du Flow Service API | [default to undefined]
+**directory_service_ok** | **boolean** | État du Directory Service API | [default to undefined]
+**message** | **string** | Message descriptif de l\'état | [default to undefined]
+
+## Example
+
+```typescript
+import { ReponseHealthcheckAFNOR } from '@factpulse/sdk';
+
+const instance: ReponseHealthcheckAFNOR = {
+    flow_service_ok,
+    directory_service_ok,
+    message,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/ReponseRechercheFlux.md

@@ -0,0 +1,27 @@
+# ReponseRechercheFlux
+
+Réponse d\'une recherche de flux
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**total** | **number** | Nombre total de résultats | [default to undefined]
+**offset** | **number** | Décalage appliqué | [default to undefined]
+**limit** | **number** | Limite de résultats | [default to undefined]
+**resultats** | [**Array<FluxResume>**](FluxResume.md) | Liste des flux trouvés | [default to undefined]
+
+## Example
+
+```typescript
+import { ReponseRechercheFlux } from '@factpulse/sdk';
+
+const instance: ReponseRechercheFlux = {
+    total,
+    offset,
+    limit,
+    resultats,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/ReponseSoumissionFlux.md

@@ -0,0 +1,33 @@
+# ReponseSoumissionFlux
+
+Réponse après soumission d\'un flux
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**flow_id** | **string** | Identifiant unique du flux généré par la PDP | [default to undefined]
+**tracking_id** | **string** |  | [optional] [default to undefined]
+**nom** | **string** | Nom du flux | [default to undefined]
+**syntaxe_flux** | **string** | Syntaxe du flux (CII, UBL, etc.) | [default to undefined]
+**profil_flux** | **string** |  | [optional] [default to undefined]
+**sha256** | **string** | Hash SHA256 du fichier soumis | [default to undefined]
+**message** | **string** | Message de confirmation | [default to undefined]
+
+## Example
+
+```typescript
+import { ReponseSoumissionFlux } from '@factpulse/sdk';
+
+const instance: ReponseSoumissionFlux = {
+    flow_id,
+    tracking_id,
+    nom,
+    syntaxe_flux,
+    profil_flux,
+    sha256,
+    message,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/ReponseVerificationSucces.md

@@ -0,0 +1,39 @@
+# ReponseVerificationSucces
+
+Réponse de vérification réussie avec données unifiées.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**est_conforme** | **boolean** | True si aucun écart critique | [default to undefined]
+**score_conformite** | **number** | Score de conformité (0-100%) | [default to undefined]
+**champs_verifies** | **number** | Nombre de champs vérifiés | [optional] [default to 0]
+**champs_conformes** | **number** | 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] [default to undefined]
+**champs** | [**Array<ChampVerifieSchema>**](ChampVerifieSchema.md) | Liste des champs vérifiés avec valeurs, statuts et coordonnées PDF | [optional] [default to undefined]
+**notes_obligatoires** | [**Array<NoteObligatoireSchema>**](NoteObligatoireSchema.md) | Notes obligatoires (PMT, PMD, AAB) avec localisation PDF | [optional] [default to undefined]
+**dimensions_pages** | [**Array<DimensionPageSchema>**](DimensionPageSchema.md) | Dimensions de chaque page du PDF (largeur, hauteur) | [optional] [default to undefined]
+**avertissements** | **Array<string>** | Avertissements non bloquants | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { ReponseVerificationSucces } from '@factpulse/sdk';
+
+const instance: ReponseVerificationSucces = {
+    est_conforme,
+    score_conformite,
+    champs_verifies,
+    champs_conformes,
+    est_facturx,
+    profil_facturx,
+    champs,
+    notes_obligatoires,
+    dimensions_pages,
+    avertissements,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/RequeteRechercheFlux.md

@@ -0,0 +1,37 @@
+# RequeteRechercheFlux
+
+Requête pour rechercher des flux soumis
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**date_maj_apres** | **string** |  | [optional] [default to undefined]
+**date_maj_avant** | **string** |  | [optional] [default to undefined]
+**type_flux** | [**Array<TypeFlux>**](TypeFlux.md) |  | [optional] [default to undefined]
+**direction_flux** | [**Array<DirectionFlux>**](DirectionFlux.md) |  | [optional] [default to undefined]
+**tracking_id** | **string** |  | [optional] [default to undefined]
+**flow_id** | **string** |  | [optional] [default to undefined]
+**statut_acquittement** | [**StatutAcquittement**](StatutAcquittement.md) |  | [optional] [default to undefined]
+**offset** | **number** | Décalage pour la pagination | [optional] [default to 0]
+**limit** | **number** | Nombre maximum de résultats (max 100) | [optional] [default to 25]
+
+## Example
+
+```typescript
+import { RequeteRechercheFlux } from '@factpulse/sdk';
+
+const instance: RequeteRechercheFlux = {
+    date_maj_apres,
+    date_maj_avant,
+    type_flux,
+    direction_flux,
+    tracking_id,
+    flow_id,
+    statut_acquittement,
+    offset,
+    limit,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/RequeteSoumissionFlux.md

@@ -0,0 +1,31 @@
+# RequeteSoumissionFlux
+
+Requête pour soumettre une facture à une PDP/PA via AFNOR
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**nom_flux** | **string** | Nom du flux (ex: \'Facture 2025-001\') | [default to undefined]
+**syntaxe_flux** | [**SyntaxeFlux**](SyntaxeFlux.md) | Syntaxe du flux (CII pour Factur-X) | [optional] [default to undefined]
+**profil_flux** | [**ProfilFlux**](ProfilFlux.md) |  | [optional] [default to undefined]
+**tracking_id** | **string** |  | [optional] [default to undefined]
+**request_id** | **string** |  | [optional] [default to undefined]
+**pdp_credentials** | [**PDPCredentials**](PDPCredentials.md) |  | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { RequeteSoumissionFlux } from '@factpulse/sdk';
+
+const instance: RequeteSoumissionFlux = {
+    nom_flux,
+    syntaxe_flux,
+    profil_flux,
+    tracking_id,
+    request_id,
+    pdp_credentials,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/StatutAcquittement.md

@@ -0,0 +1,13 @@
+# StatutAcquittement
+
+Statut d\'acquittement du flux
+
+## Enum
+
+* `Pending` (value: `'Pending'`)
+
+* `Ok` (value: `'Ok'`)
+
+* `Error` (value: `'Error'`)
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/StatutChampAPI.md

@@ -0,0 +1,17 @@
+# StatutChampAPI
+
+Statut de conformité d\'un champ.
+
+## Enum
+
+* `Conforme` (value: `'CONFORME'`)
+
+* `Ecart` (value: `'ECART'`)
+
+* `AbsentPdf` (value: `'ABSENT_PDF'`)
+
+* `AbsentXml` (value: `'ABSENT_XML'`)
+
+* `NonVerifie` (value: `'NON_VERIFIE'`)
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/SyntaxeFlux.md

@@ -0,0 +1,17 @@
+# SyntaxeFlux
+
+Syntaxes de flux supportées par AFNOR
+
+## Enum
+
+* `Cii` (value: `'CII'`)
+
+* `Ubl` (value: `'UBL'`)
+
+* `FacturX` (value: `'Factur-X'`)
+
+* `Cdar` (value: `'CDAR'`)
+
+* `Frr` (value: `'FRR'`)
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/TraitementFactureApi.md

@@ -139,7 +139,7 @@ const { status, data } = await apiInstance.genererFactureApiV1TraitementGenererF
 # **obtenirStatutTacheApiV1TraitementTachesIdTacheStatutGet**
 > StatutTache obtenirStatutTacheApiV1TraitementTachesIdTacheStatutGet()
 
-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`.
 
 ### Example
 
@@ -191,7 +191,7 @@ const { status, data } = await apiInstance.obtenirStatutTacheApiV1TraitementTach
 # **signerPdfApiV1TraitementSignerPdfPost**
 > any signerPdfApiV1TraitementSignerPdfPost()
 
-Signe un PDF uploadé avec le certificat électronique configuré pour le client (via client_uid du JWT).      **Standards supportés** : PAdES-B-B, PAdES-B-T (horodatage), PAdES-B-LT (archivage long terme).      **Niveaux eIDAS** : SES (auto-signé), AdES (CA commerciale), QES (PSCO - hors scope).      **⚠️ Disclaimer légal** : Les signatures générées sont des cachets électroniques au sens     du règlement eIDAS. Le niveau de validité juridique dépend du certificat utilisé (SES/AdES/QES).     FactPulse ne fournit pas de certificats qualifiés QES - vous devez obtenir un certificat auprès     d\'un PSCO (Prestataire de Services de Confiance qualifié) pour une validité juridique maximale.
+Signe un PDF uploadé avec le certificat électronique configuré pour le client (via client_uid du JWT).      **Standards supportés** : PAdES-B-B, PAdES-B-T (horodatage), PAdES-B-LT (archivage long terme).      **Niveaux eIDAS** : SES (auto-signé), AdES (CA commerciale), QES (PSCO - hors scope).      **Sécurité** : Double authentification X-Internal-Secret + JWT Bearer pour récupérer le certificat.      **⚠️ Disclaimer légal** : Les signatures générées sont des cachets électroniques au sens     du règlement eIDAS. Le niveau de validité juridique dépend du certificat utilisé (SES/AdES/QES).     FactPulse ne fournit pas de certificats qualifiés QES - vous devez obtenir un certificat auprès     d\'un PSCO (Prestataire de Services de Confiance qualifié) pour une validité juridique maximale.
 
 ### Example
 
@@ -503,7 +503,7 @@ const { status, data } = await apiInstance.validerPdfFacturxApiV1TraitementValid
 # **validerPdfFacturxAsyncApiV1TraitementValiderFacturxAsyncPost**
 > ReponseTache validerPdfFacturxAsyncApiV1TraitementValiderFacturxAsyncPost()
 
-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
 
 ### Example
 

package/docs/TypeDocument.md

@@ -0,0 +1,17 @@
+# TypeDocument
+
+Types de documents commerciaux (UNTDID 1001).  | Code | Nom | Description | |------|-----|-------------| | 380 | FACTURE | Facture commerciale | | 381 | AVOIR | Avoir | | 384 | FACTURE_RECTIFICATIVE | Facture rectificative | | 386 | ACOMPTE | Facture d\'acompte | | 389 | AUTOFACTURATION | Facture auto-facturée |
+
+## Enum
+
+* `FACTURE` (value: `'380'`)
+
+* `AVOIR` (value: `'381'`)
+
+* `FACTURE_RECTIFICATIVE` (value: `'384'`)
+
+* `ACOMPTE` (value: `'386'`)
+
+* `AUTOFACTURATION` (value: `'389'`)
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/TypeFacture.md

@@ -1,11 +1,39 @@
 # TypeFacture
 
-Type de document (facture ou avoir).
+Type de document selon BR-FR-04 (codes UNTDID 1001).  | Code | Nom | Description | |------|-----|-------------| | 380 | FACTURE | Facture commerciale | | 389 | FACTURE_AUTOFACTUREE | Facture auto-facturée | | 393 | FACTURE_AFFACTUREE | Facture affacturée | | 501 | FACTURE_AUTOFACTUREE_AFFACTUREE | Facture auto-facturée affacturée | | 386 | FACTURE_ACOMPTE | Facture d\'acompte | | 500 | FACTURE_ACOMPTE_AUTOFACTUREE | Facture d\'acompte auto-facturée | | 384 | FACTURE_RECTIFICATIVE | Facture rectificative | | 471 | FACTURE_RECTIFICATIVE_AUTOFACTUREE | Facture rectificative auto-facturée | | 472 | FACTURE_RECTIFICATIVE_AFFACTUREE | Facture rectificative affacturée | | 473 | FACTURE_RECTIFICATIVE_AUTOFACTUREE_AFFACTUREE | Facture rectificative auto-facturée affacturée | | 381 | AVOIR | Avoir | | 261 | AVOIR_AUTOFACTURE | Avoir auto-facturé | | 262 | AVOIR_REMISE_GLOBALE | Avoir pour remise globale | | 396 | AVOIR_AFFACTURE | Avoir affacturé | | 502 | AVOIR_AUTOFACTURE_AFFACTURE | Avoir auto-facturé affacturé | | 503 | AVOIR_ACOMPTE | Avoir de facture d\'acompte |
 
 ## Enum
 
-* `Facture` (value: `'FACTURE'`)
+* `FACTURE` (value: `'380'`)
 
-* `Avoir` (value: `'AVOIR'`)
+* `FACTURE_AUTOFACTUREE` (value: `'389'`)
+
+* `FACTURE_AFFACTUREE` (value: `'393'`)
+
+* `FACTURE_AUTOFACTUREE_AFFACTUREE` (value: `'501'`)
+
+* `FACTURE_ACOMPTE` (value: `'386'`)
+
+* `FACTURE_ACOMPTE_AUTOFACTUREE` (value: `'500'`)
+
+* `FACTURE_RECTIFICATIVE` (value: `'384'`)
+
+* `FACTURE_RECTIFICATIVE_AUTOFACTUREE` (value: `'471'`)
+
+* `FACTURE_RECTIFICATIVE_AFFACTUREE` (value: `'472'`)
+
+* `FACTURE_RECTIFICATIVE_AUTOFACTUREE_AFFACTUREE` (value: `'473'`)
+
+* `AVOIR` (value: `'381'`)
+
+* `AVOIR_AUTOFACTURE` (value: `'261'`)
+
+* `AVOIR_REMISE_GLOBALE` (value: `'262'`)
+
+* `AVOIR_AFFACTURE` (value: `'396'`)
+
+* `AVOIR_AUTOFACTURE_AFFACTURE` (value: `'502'`)
+
+* `AVOIR_ACOMPTE` (value: `'503'`)
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/TypeFlux.md

@@ -0,0 +1,17 @@
+# TypeFlux
+
+Types de flux de facturation
+
+## Enum
+
+* `CustomerInvoice` (value: `'CustomerInvoice'`)
+
+* `SupplierInvoice` (value: `'SupplierInvoice'`)
+
+* `CustomerInvoiceLc` (value: `'CustomerInvoiceLC'`)
+
+* `SupplierInvoiceLc` (value: `'SupplierInvoiceLC'`)
+
+* `EReporting` (value: `'eReporting'`)
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/ValidationErrorDetail.md

@@ -0,0 +1,29 @@
+# ValidationErrorDetail
+
+Détail d\'une erreur de validation (aligné sur AFNOR AcknowledgementDetail).  Format unifié pour toutes les erreurs de validation Factur-X, compatible avec la norme AFNOR XP Z12-013.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**level** | [**ErrorLevel**](ErrorLevel.md) | Niveau de gravité : \'Error\' ou \'Warning\' | [optional] [default to undefined]
+**item** | **string** | Identifiant de l\'élément concerné (XPath, champ, règle BR-FR, etc.) | [default to undefined]
+**reason** | **string** | Description de l\'erreur | [default to undefined]
+**source** | [**ErrorSource**](ErrorSource.md) |  | [optional] [default to undefined]
+**code** | **string** |  | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { ValidationErrorDetail } from '@factpulse/sdk';
+
+const instance: ValidationErrorDetail = {
+    level,
+    item,
+    reason,
+    source,
+    code,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)