@factpulse/sdk 2.0.12 → 2.0.49

package/dist/models/type-document.d.ts

@@ -0,0 +1,37 @@
+/**
+ * API REST FactPulse
+ *  API REST pour la facturation électronique en France : Factur-X, AFNOR PDP/PA, signatures électroniques.  ## 🎯 Fonctionnalités principales  ### 📄 Génération de factures Factur-X - **Formats** : XML seul ou PDF/A-3 avec XML embarqué - **Profils** : MINIMUM, BASIC, EN16931, EXTENDED - **Normes** : EN 16931 (directive UE 2014/55), ISO 19005-3 (PDF/A-3), CII (UN/CEFACT) - **🆕 Format simplifié** : Génération à partir de SIRET + auto-enrichissement (API Chorus Pro + Recherche Entreprises)  ### ✅ Validation et conformité - **Validation XML** : Schematron (45 à 210+ règles selon profil) - **Validation PDF** : PDF/A-3, métadonnées XMP Factur-X, signatures électroniques - **VeraPDF** : Validation stricte PDF/A (146+ règles ISO 19005-3) - **Traitement asynchrone** : Support Celery pour validations lourdes (VeraPDF)  ### 📡 Intégration AFNOR PDP/PA (XP Z12-013) - **Soumission de flux** : Envoi de factures vers Plateformes de Dématérialisation Partenaires - **Recherche de flux** : Consultation des factures soumises - **Téléchargement** : Récupération des PDF/A-3 avec XML - **Directory Service** : Recherche d\'entreprises (SIREN/SIRET) - **Multi-client** : Support de plusieurs configs PDP par utilisateur (stored credentials ou zero-storage)  ### ✍️ Signature électronique PDF - **Standards** : PAdES-B-B, PAdES-B-T (horodatage RFC 3161), PAdES-B-LT (archivage long terme) - **Niveaux eIDAS** : SES (auto-signé), AdES (CA commerciale), QES (PSCO) - **Validation** : Vérification intégrité cryptographique et certificats - **Génération de certificats** : Certificats X.509 auto-signés pour tests  ### 🔄 Traitement asynchrone - **Celery** : Génération, validation et signature asynchrones - **Polling** : Suivi d\'état via `/taches/{id_tache}/statut` - **Pas de timeout** : Idéal pour gros fichiers ou validations lourdes  ## 🔒 Authentification  Toutes les requêtes nécessitent un **token JWT** dans le header Authorization : ``` Authorization: Bearer YOUR_JWT_TOKEN ```  ### Comment obtenir un token JWT ?  #### 🔑 Méthode 1 : API `/api/token/` (Recommandée)  **URL :** `https://www.factpulse.fr/api/token/`  Cette méthode est **recommandée** pour l\'intégration dans vos applications et workflows CI/CD.  **Prérequis :** Avoir défini un mot de passe sur votre compte  **Pour les utilisateurs inscrits via email/password :** - Vous avez déjà un mot de passe, utilisez-le directement  **Pour les utilisateurs inscrits via OAuth (Google/GitHub) :** - Vous devez d\'abord définir un mot de passe sur : https://www.factpulse.fr/accounts/password/set/ - Une fois le mot de passe créé, vous pourrez utiliser l\'API  **Exemple de requête :** ```bash curl -X POST https://www.factpulse.fr/api/token/ \\   -H \"Content-Type: application/json\" \\   -d \'{     \"username\": \"votre_email@example.com\",     \"password\": \"votre_mot_de_passe\"   }\' ```  **Paramètre optionnel `client_uid` :**  Pour sélectionner les credentials d\'un client spécifique (PA/PDP, Chorus Pro, certificats de signature), ajoutez `client_uid` :  ```bash curl -X POST https://www.factpulse.fr/api/token/ \\   -H \"Content-Type: application/json\" \\   -d \'{     \"username\": \"votre_email@example.com\",     \"password\": \"votre_mot_de_passe\",     \"client_uid\": \"550e8400-e29b-41d4-a716-446655440000\"   }\' ```  Le `client_uid` sera inclus dans le JWT et permettra à l\'API d\'utiliser automatiquement : - Les credentials AFNOR/PDP configurés pour ce client - Les credentials Chorus Pro configurés pour ce client - Les certificats de signature électronique configurés pour ce client  **Réponse :** ```json {   \"access\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\",  // Token d\'accès (validité: 30 min)   \"refresh\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\"  // Token de rafraîchissement (validité: 7 jours) } ```  **Avantages :** - ✅ Automatisation complète (CI/CD, scripts) - ✅ Gestion programmatique des tokens - ✅ Support du refresh token pour renouveler automatiquement l\'accès - ✅ Intégration facile dans n\'importe quel langage/outil  #### 🖥️ Méthode 2 : Génération via Dashboard (Alternative)  **URL :** https://www.factpulse.fr/dashboard/  Cette méthode convient pour des tests rapides ou une utilisation occasionnelle via l\'interface graphique.  **Fonctionnement :** - Connectez-vous au dashboard - Utilisez les boutons \"Generate Test Token\" ou \"Generate Production Token\" - Fonctionne pour **tous** les utilisateurs (OAuth et email/password), sans nécessiter de mot de passe  **Types de tokens :** - **Token Test** : Validité 24h, quota 1000 appels/jour (gratuit) - **Token Production** : Validité 7 jours, quota selon votre forfait  **Avantages :** - ✅ Rapide pour tester l\'API - ✅ Aucun mot de passe requis - ✅ Interface visuelle simple  **Inconvénients :** - ❌ Nécessite une action manuelle - ❌ Pas de refresh token - ❌ Moins adapté pour l\'automatisation  ### 📚 Documentation complète  Pour plus d\'informations sur l\'authentification et l\'utilisation de l\'API : https://www.factpulse.fr/documentation-api/
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * 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 |
+ */
+export declare const TypeDocument: {
+    /**
+    * Facture commerciale
+    */
+    readonly FACTURE: "380";
+    /**
+    * Avoir
+    */
+    readonly AVOIR: "381";
+    /**
+    * Facture rectificative
+    */
+    readonly FACTURE_RECTIFICATIVE: "384";
+    /**
+    * Facture d'acompte
+    */
+    readonly ACOMPTE: "386";
+    /**
+    * Facture auto-facturée
+    */
+    readonly AUTOFACTURATION: "389";
+};
+export type TypeDocument = typeof TypeDocument[keyof typeof TypeDocument];

package/dist/models/type-document.js

@@ -0,0 +1,41 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * API REST FactPulse
+ *  API REST pour la facturation électronique en France : Factur-X, AFNOR PDP/PA, signatures électroniques.  ## 🎯 Fonctionnalités principales  ### 📄 Génération de factures Factur-X - **Formats** : XML seul ou PDF/A-3 avec XML embarqué - **Profils** : MINIMUM, BASIC, EN16931, EXTENDED - **Normes** : EN 16931 (directive UE 2014/55), ISO 19005-3 (PDF/A-3), CII (UN/CEFACT) - **🆕 Format simplifié** : Génération à partir de SIRET + auto-enrichissement (API Chorus Pro + Recherche Entreprises)  ### ✅ Validation et conformité - **Validation XML** : Schematron (45 à 210+ règles selon profil) - **Validation PDF** : PDF/A-3, métadonnées XMP Factur-X, signatures électroniques - **VeraPDF** : Validation stricte PDF/A (146+ règles ISO 19005-3) - **Traitement asynchrone** : Support Celery pour validations lourdes (VeraPDF)  ### 📡 Intégration AFNOR PDP/PA (XP Z12-013) - **Soumission de flux** : Envoi de factures vers Plateformes de Dématérialisation Partenaires - **Recherche de flux** : Consultation des factures soumises - **Téléchargement** : Récupération des PDF/A-3 avec XML - **Directory Service** : Recherche d\'entreprises (SIREN/SIRET) - **Multi-client** : Support de plusieurs configs PDP par utilisateur (stored credentials ou zero-storage)  ### ✍️ Signature électronique PDF - **Standards** : PAdES-B-B, PAdES-B-T (horodatage RFC 3161), PAdES-B-LT (archivage long terme) - **Niveaux eIDAS** : SES (auto-signé), AdES (CA commerciale), QES (PSCO) - **Validation** : Vérification intégrité cryptographique et certificats - **Génération de certificats** : Certificats X.509 auto-signés pour tests  ### 🔄 Traitement asynchrone - **Celery** : Génération, validation et signature asynchrones - **Polling** : Suivi d\'état via `/taches/{id_tache}/statut` - **Pas de timeout** : Idéal pour gros fichiers ou validations lourdes  ## 🔒 Authentification  Toutes les requêtes nécessitent un **token JWT** dans le header Authorization : ``` Authorization: Bearer YOUR_JWT_TOKEN ```  ### Comment obtenir un token JWT ?  #### 🔑 Méthode 1 : API `/api/token/` (Recommandée)  **URL :** `https://www.factpulse.fr/api/token/`  Cette méthode est **recommandée** pour l\'intégration dans vos applications et workflows CI/CD.  **Prérequis :** Avoir défini un mot de passe sur votre compte  **Pour les utilisateurs inscrits via email/password :** - Vous avez déjà un mot de passe, utilisez-le directement  **Pour les utilisateurs inscrits via OAuth (Google/GitHub) :** - Vous devez d\'abord définir un mot de passe sur : https://www.factpulse.fr/accounts/password/set/ - Une fois le mot de passe créé, vous pourrez utiliser l\'API  **Exemple de requête :** ```bash curl -X POST https://www.factpulse.fr/api/token/ \\   -H \"Content-Type: application/json\" \\   -d \'{     \"username\": \"votre_email@example.com\",     \"password\": \"votre_mot_de_passe\"   }\' ```  **Paramètre optionnel `client_uid` :**  Pour sélectionner les credentials d\'un client spécifique (PA/PDP, Chorus Pro, certificats de signature), ajoutez `client_uid` :  ```bash curl -X POST https://www.factpulse.fr/api/token/ \\   -H \"Content-Type: application/json\" \\   -d \'{     \"username\": \"votre_email@example.com\",     \"password\": \"votre_mot_de_passe\",     \"client_uid\": \"550e8400-e29b-41d4-a716-446655440000\"   }\' ```  Le `client_uid` sera inclus dans le JWT et permettra à l\'API d\'utiliser automatiquement : - Les credentials AFNOR/PDP configurés pour ce client - Les credentials Chorus Pro configurés pour ce client - Les certificats de signature électronique configurés pour ce client  **Réponse :** ```json {   \"access\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\",  // Token d\'accès (validité: 30 min)   \"refresh\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\"  // Token de rafraîchissement (validité: 7 jours) } ```  **Avantages :** - ✅ Automatisation complète (CI/CD, scripts) - ✅ Gestion programmatique des tokens - ✅ Support du refresh token pour renouveler automatiquement l\'accès - ✅ Intégration facile dans n\'importe quel langage/outil  #### 🖥️ Méthode 2 : Génération via Dashboard (Alternative)  **URL :** https://www.factpulse.fr/dashboard/  Cette méthode convient pour des tests rapides ou une utilisation occasionnelle via l\'interface graphique.  **Fonctionnement :** - Connectez-vous au dashboard - Utilisez les boutons \"Generate Test Token\" ou \"Generate Production Token\" - Fonctionne pour **tous** les utilisateurs (OAuth et email/password), sans nécessiter de mot de passe  **Types de tokens :** - **Token Test** : Validité 24h, quota 1000 appels/jour (gratuit) - **Token Production** : Validité 7 jours, quota selon votre forfait  **Avantages :** - ✅ Rapide pour tester l\'API - ✅ Aucun mot de passe requis - ✅ Interface visuelle simple  **Inconvénients :** - ❌ Nécessite une action manuelle - ❌ Pas de refresh token - ❌ Moins adapté pour l\'automatisation  ### 📚 Documentation complète  Pour plus d\'informations sur l\'authentification et l\'utilisation de l\'API : https://www.factpulse.fr/documentation-api/
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeDocument = void 0;
+/**
+ * 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 |
+ */
+exports.TypeDocument = {
+    /**
+    * Facture commerciale
+    */
+    FACTURE: '380',
+    /**
+    * Avoir
+    */
+    AVOIR: '381',
+    /**
+    * Facture rectificative
+    */
+    FACTURE_RECTIFICATIVE: '384',
+    /**
+    * Facture d'acompte
+    */
+    ACOMPTE: '386',
+    /**
+    * Facture auto-facturée
+    */
+    AUTOFACTURATION: '389'
+};

package/dist/models/type-facture.d.ts

@@ -10,10 +10,72 @@
  * Do not edit the class manually.
  */
 /**
- * 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 |
  */
 export declare const TypeFacture: {
-    readonly Facture: "FACTURE";
-    readonly Avoir: "AVOIR";
+    /**
+    * Facture commerciale
+    */
+    readonly FACTURE: "380";
+    /**
+    * Facture auto-facturée
+    */
+    readonly FACTURE_AUTOFACTUREE: "389";
+    /**
+    * Facture affacturée
+    */
+    readonly FACTURE_AFFACTUREE: "393";
+    /**
+    * Facture auto-facturée affacturée
+    */
+    readonly FACTURE_AUTOFACTUREE_AFFACTUREE: "501";
+    /**
+    * Facture d'acompte
+    */
+    readonly FACTURE_ACOMPTE: "386";
+    /**
+    * Facture d'acompte auto-facturée
+    */
+    readonly FACTURE_ACOMPTE_AUTOFACTUREE: "500";
+    /**
+    * Facture rectificative
+    */
+    readonly FACTURE_RECTIFICATIVE: "384";
+    /**
+    * Facture rectificative auto-facturée
+    */
+    readonly FACTURE_RECTIFICATIVE_AUTOFACTUREE: "471";
+    /**
+    * Facture rectificative affacturée
+    */
+    readonly FACTURE_RECTIFICATIVE_AFFACTUREE: "472";
+    /**
+    * Facture rectificative auto-facturée affacturée
+    */
+    readonly FACTURE_RECTIFICATIVE_AUTOFACTUREE_AFFACTUREE: "473";
+    /**
+    * Avoir
+    */
+    readonly AVOIR: "381";
+    /**
+    * Avoir auto-facturé
+    */
+    readonly AVOIR_AUTOFACTURE: "261";
+    /**
+    * Avoir pour remise globale
+    */
+    readonly AVOIR_REMISE_GLOBALE: "262";
+    /**
+    * Avoir affacturé
+    */
+    readonly AVOIR_AFFACTURE: "396";
+    /**
+    * Avoir auto-facturé affacturé
+    */
+    readonly AVOIR_AUTOFACTURE_AFFACTURE: "502";
+    /**
+    * Avoir de facture d'acompte
+    */
+    readonly AVOIR_ACOMPTE: "503";
 };
 export type TypeFacture = typeof TypeFacture[keyof typeof TypeFacture];

package/dist/models/type-facture.js

@@ -15,9 +15,71 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TypeFacture = void 0;
 /**
- * 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 |
  */
 exports.TypeFacture = {
-    Facture: 'FACTURE',
-    Avoir: 'AVOIR'
+    /**
+    * Facture commerciale
+    */
+    FACTURE: '380',
+    /**
+    * Facture auto-facturée
+    */
+    FACTURE_AUTOFACTUREE: '389',
+    /**
+    * Facture affacturée
+    */
+    FACTURE_AFFACTUREE: '393',
+    /**
+    * Facture auto-facturée affacturée
+    */
+    FACTURE_AUTOFACTUREE_AFFACTUREE: '501',
+    /**
+    * Facture d'acompte
+    */
+    FACTURE_ACOMPTE: '386',
+    /**
+    * Facture d'acompte auto-facturée
+    */
+    FACTURE_ACOMPTE_AUTOFACTUREE: '500',
+    /**
+    * Facture rectificative
+    */
+    FACTURE_RECTIFICATIVE: '384',
+    /**
+    * Facture rectificative auto-facturée
+    */
+    FACTURE_RECTIFICATIVE_AUTOFACTUREE: '471',
+    /**
+    * Facture rectificative affacturée
+    */
+    FACTURE_RECTIFICATIVE_AFFACTUREE: '472',
+    /**
+    * Facture rectificative auto-facturée affacturée
+    */
+    FACTURE_RECTIFICATIVE_AUTOFACTUREE_AFFACTUREE: '473',
+    /**
+    * Avoir
+    */
+    AVOIR: '381',
+    /**
+    * Avoir auto-facturé
+    */
+    AVOIR_AUTOFACTURE: '261',
+    /**
+    * Avoir pour remise globale
+    */
+    AVOIR_REMISE_GLOBALE: '262',
+    /**
+    * Avoir affacturé
+    */
+    AVOIR_AFFACTURE: '396',
+    /**
+    * Avoir auto-facturé affacturé
+    */
+    AVOIR_AUTOFACTURE_AFFACTURE: '502',
+    /**
+    * Avoir de facture d'acompte
+    */
+    AVOIR_ACOMPTE: '503'
 };

package/dist/models/type-flux.d.ts

@@ -0,0 +1,22 @@
+/**
+ * API REST FactPulse
+ *  API REST pour la facturation électronique en France : Factur-X, AFNOR PDP/PA, signatures électroniques.  ## 🎯 Fonctionnalités principales  ### 📄 Génération de factures Factur-X - **Formats** : XML seul ou PDF/A-3 avec XML embarqué - **Profils** : MINIMUM, BASIC, EN16931, EXTENDED - **Normes** : EN 16931 (directive UE 2014/55), ISO 19005-3 (PDF/A-3), CII (UN/CEFACT) - **🆕 Format simplifié** : Génération à partir de SIRET + auto-enrichissement (API Chorus Pro + Recherche Entreprises)  ### ✅ Validation et conformité - **Validation XML** : Schematron (45 à 210+ règles selon profil) - **Validation PDF** : PDF/A-3, métadonnées XMP Factur-X, signatures électroniques - **VeraPDF** : Validation stricte PDF/A (146+ règles ISO 19005-3) - **Traitement asynchrone** : Support Celery pour validations lourdes (VeraPDF)  ### 📡 Intégration AFNOR PDP/PA (XP Z12-013) - **Soumission de flux** : Envoi de factures vers Plateformes de Dématérialisation Partenaires - **Recherche de flux** : Consultation des factures soumises - **Téléchargement** : Récupération des PDF/A-3 avec XML - **Directory Service** : Recherche d\'entreprises (SIREN/SIRET) - **Multi-client** : Support de plusieurs configs PDP par utilisateur (stored credentials ou zero-storage)  ### ✍️ Signature électronique PDF - **Standards** : PAdES-B-B, PAdES-B-T (horodatage RFC 3161), PAdES-B-LT (archivage long terme) - **Niveaux eIDAS** : SES (auto-signé), AdES (CA commerciale), QES (PSCO) - **Validation** : Vérification intégrité cryptographique et certificats - **Génération de certificats** : Certificats X.509 auto-signés pour tests  ### 🔄 Traitement asynchrone - **Celery** : Génération, validation et signature asynchrones - **Polling** : Suivi d\'état via `/taches/{id_tache}/statut` - **Pas de timeout** : Idéal pour gros fichiers ou validations lourdes  ## 🔒 Authentification  Toutes les requêtes nécessitent un **token JWT** dans le header Authorization : ``` Authorization: Bearer YOUR_JWT_TOKEN ```  ### Comment obtenir un token JWT ?  #### 🔑 Méthode 1 : API `/api/token/` (Recommandée)  **URL :** `https://www.factpulse.fr/api/token/`  Cette méthode est **recommandée** pour l\'intégration dans vos applications et workflows CI/CD.  **Prérequis :** Avoir défini un mot de passe sur votre compte  **Pour les utilisateurs inscrits via email/password :** - Vous avez déjà un mot de passe, utilisez-le directement  **Pour les utilisateurs inscrits via OAuth (Google/GitHub) :** - Vous devez d\'abord définir un mot de passe sur : https://www.factpulse.fr/accounts/password/set/ - Une fois le mot de passe créé, vous pourrez utiliser l\'API  **Exemple de requête :** ```bash curl -X POST https://www.factpulse.fr/api/token/ \\   -H \"Content-Type: application/json\" \\   -d \'{     \"username\": \"votre_email@example.com\",     \"password\": \"votre_mot_de_passe\"   }\' ```  **Paramètre optionnel `client_uid` :**  Pour sélectionner les credentials d\'un client spécifique (PA/PDP, Chorus Pro, certificats de signature), ajoutez `client_uid` :  ```bash curl -X POST https://www.factpulse.fr/api/token/ \\   -H \"Content-Type: application/json\" \\   -d \'{     \"username\": \"votre_email@example.com\",     \"password\": \"votre_mot_de_passe\",     \"client_uid\": \"550e8400-e29b-41d4-a716-446655440000\"   }\' ```  Le `client_uid` sera inclus dans le JWT et permettra à l\'API d\'utiliser automatiquement : - Les credentials AFNOR/PDP configurés pour ce client - Les credentials Chorus Pro configurés pour ce client - Les certificats de signature électronique configurés pour ce client  **Réponse :** ```json {   \"access\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\",  // Token d\'accès (validité: 30 min)   \"refresh\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\"  // Token de rafraîchissement (validité: 7 jours) } ```  **Avantages :** - ✅ Automatisation complète (CI/CD, scripts) - ✅ Gestion programmatique des tokens - ✅ Support du refresh token pour renouveler automatiquement l\'accès - ✅ Intégration facile dans n\'importe quel langage/outil  #### 🖥️ Méthode 2 : Génération via Dashboard (Alternative)  **URL :** https://www.factpulse.fr/dashboard/  Cette méthode convient pour des tests rapides ou une utilisation occasionnelle via l\'interface graphique.  **Fonctionnement :** - Connectez-vous au dashboard - Utilisez les boutons \"Generate Test Token\" ou \"Generate Production Token\" - Fonctionne pour **tous** les utilisateurs (OAuth et email/password), sans nécessiter de mot de passe  **Types de tokens :** - **Token Test** : Validité 24h, quota 1000 appels/jour (gratuit) - **Token Production** : Validité 7 jours, quota selon votre forfait  **Avantages :** - ✅ Rapide pour tester l\'API - ✅ Aucun mot de passe requis - ✅ Interface visuelle simple  **Inconvénients :** - ❌ Nécessite une action manuelle - ❌ Pas de refresh token - ❌ Moins adapté pour l\'automatisation  ### 📚 Documentation complète  Pour plus d\'informations sur l\'authentification et l\'utilisation de l\'API : https://www.factpulse.fr/documentation-api/
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Types de flux de facturation
+ */
+export declare const TypeFlux: {
+    readonly CustomerInvoice: "CustomerInvoice";
+    readonly SupplierInvoice: "SupplierInvoice";
+    readonly CustomerInvoiceLc: "CustomerInvoiceLC";
+    readonly SupplierInvoiceLc: "SupplierInvoiceLC";
+    readonly EReporting: "eReporting";
+};
+export type TypeFlux = typeof TypeFlux[keyof typeof TypeFlux];

package/dist/models/type-flux.js

@@ -0,0 +1,26 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * API REST FactPulse
+ *  API REST pour la facturation électronique en France : Factur-X, AFNOR PDP/PA, signatures électroniques.  ## 🎯 Fonctionnalités principales  ### 📄 Génération de factures Factur-X - **Formats** : XML seul ou PDF/A-3 avec XML embarqué - **Profils** : MINIMUM, BASIC, EN16931, EXTENDED - **Normes** : EN 16931 (directive UE 2014/55), ISO 19005-3 (PDF/A-3), CII (UN/CEFACT) - **🆕 Format simplifié** : Génération à partir de SIRET + auto-enrichissement (API Chorus Pro + Recherche Entreprises)  ### ✅ Validation et conformité - **Validation XML** : Schematron (45 à 210+ règles selon profil) - **Validation PDF** : PDF/A-3, métadonnées XMP Factur-X, signatures électroniques - **VeraPDF** : Validation stricte PDF/A (146+ règles ISO 19005-3) - **Traitement asynchrone** : Support Celery pour validations lourdes (VeraPDF)  ### 📡 Intégration AFNOR PDP/PA (XP Z12-013) - **Soumission de flux** : Envoi de factures vers Plateformes de Dématérialisation Partenaires - **Recherche de flux** : Consultation des factures soumises - **Téléchargement** : Récupération des PDF/A-3 avec XML - **Directory Service** : Recherche d\'entreprises (SIREN/SIRET) - **Multi-client** : Support de plusieurs configs PDP par utilisateur (stored credentials ou zero-storage)  ### ✍️ Signature électronique PDF - **Standards** : PAdES-B-B, PAdES-B-T (horodatage RFC 3161), PAdES-B-LT (archivage long terme) - **Niveaux eIDAS** : SES (auto-signé), AdES (CA commerciale), QES (PSCO) - **Validation** : Vérification intégrité cryptographique et certificats - **Génération de certificats** : Certificats X.509 auto-signés pour tests  ### 🔄 Traitement asynchrone - **Celery** : Génération, validation et signature asynchrones - **Polling** : Suivi d\'état via `/taches/{id_tache}/statut` - **Pas de timeout** : Idéal pour gros fichiers ou validations lourdes  ## 🔒 Authentification  Toutes les requêtes nécessitent un **token JWT** dans le header Authorization : ``` Authorization: Bearer YOUR_JWT_TOKEN ```  ### Comment obtenir un token JWT ?  #### 🔑 Méthode 1 : API `/api/token/` (Recommandée)  **URL :** `https://www.factpulse.fr/api/token/`  Cette méthode est **recommandée** pour l\'intégration dans vos applications et workflows CI/CD.  **Prérequis :** Avoir défini un mot de passe sur votre compte  **Pour les utilisateurs inscrits via email/password :** - Vous avez déjà un mot de passe, utilisez-le directement  **Pour les utilisateurs inscrits via OAuth (Google/GitHub) :** - Vous devez d\'abord définir un mot de passe sur : https://www.factpulse.fr/accounts/password/set/ - Une fois le mot de passe créé, vous pourrez utiliser l\'API  **Exemple de requête :** ```bash curl -X POST https://www.factpulse.fr/api/token/ \\   -H \"Content-Type: application/json\" \\   -d \'{     \"username\": \"votre_email@example.com\",     \"password\": \"votre_mot_de_passe\"   }\' ```  **Paramètre optionnel `client_uid` :**  Pour sélectionner les credentials d\'un client spécifique (PA/PDP, Chorus Pro, certificats de signature), ajoutez `client_uid` :  ```bash curl -X POST https://www.factpulse.fr/api/token/ \\   -H \"Content-Type: application/json\" \\   -d \'{     \"username\": \"votre_email@example.com\",     \"password\": \"votre_mot_de_passe\",     \"client_uid\": \"550e8400-e29b-41d4-a716-446655440000\"   }\' ```  Le `client_uid` sera inclus dans le JWT et permettra à l\'API d\'utiliser automatiquement : - Les credentials AFNOR/PDP configurés pour ce client - Les credentials Chorus Pro configurés pour ce client - Les certificats de signature électronique configurés pour ce client  **Réponse :** ```json {   \"access\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\",  // Token d\'accès (validité: 30 min)   \"refresh\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\"  // Token de rafraîchissement (validité: 7 jours) } ```  **Avantages :** - ✅ Automatisation complète (CI/CD, scripts) - ✅ Gestion programmatique des tokens - ✅ Support du refresh token pour renouveler automatiquement l\'accès - ✅ Intégration facile dans n\'importe quel langage/outil  #### 🖥️ Méthode 2 : Génération via Dashboard (Alternative)  **URL :** https://www.factpulse.fr/dashboard/  Cette méthode convient pour des tests rapides ou une utilisation occasionnelle via l\'interface graphique.  **Fonctionnement :** - Connectez-vous au dashboard - Utilisez les boutons \"Generate Test Token\" ou \"Generate Production Token\" - Fonctionne pour **tous** les utilisateurs (OAuth et email/password), sans nécessiter de mot de passe  **Types de tokens :** - **Token Test** : Validité 24h, quota 1000 appels/jour (gratuit) - **Token Production** : Validité 7 jours, quota selon votre forfait  **Avantages :** - ✅ Rapide pour tester l\'API - ✅ Aucun mot de passe requis - ✅ Interface visuelle simple  **Inconvénients :** - ❌ Nécessite une action manuelle - ❌ Pas de refresh token - ❌ Moins adapté pour l\'automatisation  ### 📚 Documentation complète  Pour plus d\'informations sur l\'authentification et l\'utilisation de l\'API : https://www.factpulse.fr/documentation-api/
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeFlux = void 0;
+/**
+ * Types de flux de facturation
+ */
+exports.TypeFlux = {
+    CustomerInvoice: 'CustomerInvoice',
+    SupplierInvoice: 'SupplierInvoice',
+    CustomerInvoiceLc: 'CustomerInvoiceLC',
+    SupplierInvoiceLc: 'SupplierInvoiceLC',
+    EReporting: 'eReporting'
+};

package/dist/models/validation-error-detail.d.ts

@@ -0,0 +1,32 @@
+/**
+ * API REST FactPulse
+ *  API REST pour la facturation électronique en France : Factur-X, AFNOR PDP/PA, signatures électroniques.  ## 🎯 Fonctionnalités principales  ### 📄 Génération de factures Factur-X - **Formats** : XML seul ou PDF/A-3 avec XML embarqué - **Profils** : MINIMUM, BASIC, EN16931, EXTENDED - **Normes** : EN 16931 (directive UE 2014/55), ISO 19005-3 (PDF/A-3), CII (UN/CEFACT) - **🆕 Format simplifié** : Génération à partir de SIRET + auto-enrichissement (API Chorus Pro + Recherche Entreprises)  ### ✅ Validation et conformité - **Validation XML** : Schematron (45 à 210+ règles selon profil) - **Validation PDF** : PDF/A-3, métadonnées XMP Factur-X, signatures électroniques - **VeraPDF** : Validation stricte PDF/A (146+ règles ISO 19005-3) - **Traitement asynchrone** : Support Celery pour validations lourdes (VeraPDF)  ### 📡 Intégration AFNOR PDP/PA (XP Z12-013) - **Soumission de flux** : Envoi de factures vers Plateformes de Dématérialisation Partenaires - **Recherche de flux** : Consultation des factures soumises - **Téléchargement** : Récupération des PDF/A-3 avec XML - **Directory Service** : Recherche d\'entreprises (SIREN/SIRET) - **Multi-client** : Support de plusieurs configs PDP par utilisateur (stored credentials ou zero-storage)  ### ✍️ Signature électronique PDF - **Standards** : PAdES-B-B, PAdES-B-T (horodatage RFC 3161), PAdES-B-LT (archivage long terme) - **Niveaux eIDAS** : SES (auto-signé), AdES (CA commerciale), QES (PSCO) - **Validation** : Vérification intégrité cryptographique et certificats - **Génération de certificats** : Certificats X.509 auto-signés pour tests  ### 🔄 Traitement asynchrone - **Celery** : Génération, validation et signature asynchrones - **Polling** : Suivi d\'état via `/taches/{id_tache}/statut` - **Pas de timeout** : Idéal pour gros fichiers ou validations lourdes  ## 🔒 Authentification  Toutes les requêtes nécessitent un **token JWT** dans le header Authorization : ``` Authorization: Bearer YOUR_JWT_TOKEN ```  ### Comment obtenir un token JWT ?  #### 🔑 Méthode 1 : API `/api/token/` (Recommandée)  **URL :** `https://www.factpulse.fr/api/token/`  Cette méthode est **recommandée** pour l\'intégration dans vos applications et workflows CI/CD.  **Prérequis :** Avoir défini un mot de passe sur votre compte  **Pour les utilisateurs inscrits via email/password :** - Vous avez déjà un mot de passe, utilisez-le directement  **Pour les utilisateurs inscrits via OAuth (Google/GitHub) :** - Vous devez d\'abord définir un mot de passe sur : https://www.factpulse.fr/accounts/password/set/ - Une fois le mot de passe créé, vous pourrez utiliser l\'API  **Exemple de requête :** ```bash curl -X POST https://www.factpulse.fr/api/token/ \\   -H \"Content-Type: application/json\" \\   -d \'{     \"username\": \"votre_email@example.com\",     \"password\": \"votre_mot_de_passe\"   }\' ```  **Paramètre optionnel `client_uid` :**  Pour sélectionner les credentials d\'un client spécifique (PA/PDP, Chorus Pro, certificats de signature), ajoutez `client_uid` :  ```bash curl -X POST https://www.factpulse.fr/api/token/ \\   -H \"Content-Type: application/json\" \\   -d \'{     \"username\": \"votre_email@example.com\",     \"password\": \"votre_mot_de_passe\",     \"client_uid\": \"550e8400-e29b-41d4-a716-446655440000\"   }\' ```  Le `client_uid` sera inclus dans le JWT et permettra à l\'API d\'utiliser automatiquement : - Les credentials AFNOR/PDP configurés pour ce client - Les credentials Chorus Pro configurés pour ce client - Les certificats de signature électronique configurés pour ce client  **Réponse :** ```json {   \"access\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\",  // Token d\'accès (validité: 30 min)   \"refresh\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\"  // Token de rafraîchissement (validité: 7 jours) } ```  **Avantages :** - ✅ Automatisation complète (CI/CD, scripts) - ✅ Gestion programmatique des tokens - ✅ Support du refresh token pour renouveler automatiquement l\'accès - ✅ Intégration facile dans n\'importe quel langage/outil  #### 🖥️ Méthode 2 : Génération via Dashboard (Alternative)  **URL :** https://www.factpulse.fr/dashboard/  Cette méthode convient pour des tests rapides ou une utilisation occasionnelle via l\'interface graphique.  **Fonctionnement :** - Connectez-vous au dashboard - Utilisez les boutons \"Generate Test Token\" ou \"Generate Production Token\" - Fonctionne pour **tous** les utilisateurs (OAuth et email/password), sans nécessiter de mot de passe  **Types de tokens :** - **Token Test** : Validité 24h, quota 1000 appels/jour (gratuit) - **Token Production** : Validité 7 jours, quota selon votre forfait  **Avantages :** - ✅ Rapide pour tester l\'API - ✅ Aucun mot de passe requis - ✅ Interface visuelle simple  **Inconvénients :** - ❌ Nécessite une action manuelle - ❌ Pas de refresh token - ❌ Moins adapté pour l\'automatisation  ### 📚 Documentation complète  Pour plus d\'informations sur l\'authentification et l\'utilisation de l\'API : https://www.factpulse.fr/documentation-api/
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { ErrorLevel } from './error-level';
+import type { ErrorSource } from './error-source';
+/**
+ * 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.
+ */
+export interface ValidationErrorDetail {
+    /**
+     * Niveau de gravité : \'Error\' ou \'Warning\'
+     */
+    'level'?: ErrorLevel;
+    /**
+     * Identifiant de l\'élément concerné (XPath, champ, règle BR-FR, etc.)
+     */
+    'item': string;
+    /**
+     * Description de l\'erreur
+     */
+    'reason': string;
+    'source'?: ErrorSource | null;
+    'code'?: string | null;
+}

package/dist/models/validation-error-detail.js

@@ -0,0 +1,15 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * API REST FactPulse
+ *  API REST pour la facturation électronique en France : Factur-X, AFNOR PDP/PA, signatures électroniques.  ## 🎯 Fonctionnalités principales  ### 📄 Génération de factures Factur-X - **Formats** : XML seul ou PDF/A-3 avec XML embarqué - **Profils** : MINIMUM, BASIC, EN16931, EXTENDED - **Normes** : EN 16931 (directive UE 2014/55), ISO 19005-3 (PDF/A-3), CII (UN/CEFACT) - **🆕 Format simplifié** : Génération à partir de SIRET + auto-enrichissement (API Chorus Pro + Recherche Entreprises)  ### ✅ Validation et conformité - **Validation XML** : Schematron (45 à 210+ règles selon profil) - **Validation PDF** : PDF/A-3, métadonnées XMP Factur-X, signatures électroniques - **VeraPDF** : Validation stricte PDF/A (146+ règles ISO 19005-3) - **Traitement asynchrone** : Support Celery pour validations lourdes (VeraPDF)  ### 📡 Intégration AFNOR PDP/PA (XP Z12-013) - **Soumission de flux** : Envoi de factures vers Plateformes de Dématérialisation Partenaires - **Recherche de flux** : Consultation des factures soumises - **Téléchargement** : Récupération des PDF/A-3 avec XML - **Directory Service** : Recherche d\'entreprises (SIREN/SIRET) - **Multi-client** : Support de plusieurs configs PDP par utilisateur (stored credentials ou zero-storage)  ### ✍️ Signature électronique PDF - **Standards** : PAdES-B-B, PAdES-B-T (horodatage RFC 3161), PAdES-B-LT (archivage long terme) - **Niveaux eIDAS** : SES (auto-signé), AdES (CA commerciale), QES (PSCO) - **Validation** : Vérification intégrité cryptographique et certificats - **Génération de certificats** : Certificats X.509 auto-signés pour tests  ### 🔄 Traitement asynchrone - **Celery** : Génération, validation et signature asynchrones - **Polling** : Suivi d\'état via `/taches/{id_tache}/statut` - **Pas de timeout** : Idéal pour gros fichiers ou validations lourdes  ## 🔒 Authentification  Toutes les requêtes nécessitent un **token JWT** dans le header Authorization : ``` Authorization: Bearer YOUR_JWT_TOKEN ```  ### Comment obtenir un token JWT ?  #### 🔑 Méthode 1 : API `/api/token/` (Recommandée)  **URL :** `https://www.factpulse.fr/api/token/`  Cette méthode est **recommandée** pour l\'intégration dans vos applications et workflows CI/CD.  **Prérequis :** Avoir défini un mot de passe sur votre compte  **Pour les utilisateurs inscrits via email/password :** - Vous avez déjà un mot de passe, utilisez-le directement  **Pour les utilisateurs inscrits via OAuth (Google/GitHub) :** - Vous devez d\'abord définir un mot de passe sur : https://www.factpulse.fr/accounts/password/set/ - Une fois le mot de passe créé, vous pourrez utiliser l\'API  **Exemple de requête :** ```bash curl -X POST https://www.factpulse.fr/api/token/ \\   -H \"Content-Type: application/json\" \\   -d \'{     \"username\": \"votre_email@example.com\",     \"password\": \"votre_mot_de_passe\"   }\' ```  **Paramètre optionnel `client_uid` :**  Pour sélectionner les credentials d\'un client spécifique (PA/PDP, Chorus Pro, certificats de signature), ajoutez `client_uid` :  ```bash curl -X POST https://www.factpulse.fr/api/token/ \\   -H \"Content-Type: application/json\" \\   -d \'{     \"username\": \"votre_email@example.com\",     \"password\": \"votre_mot_de_passe\",     \"client_uid\": \"550e8400-e29b-41d4-a716-446655440000\"   }\' ```  Le `client_uid` sera inclus dans le JWT et permettra à l\'API d\'utiliser automatiquement : - Les credentials AFNOR/PDP configurés pour ce client - Les credentials Chorus Pro configurés pour ce client - Les certificats de signature électronique configurés pour ce client  **Réponse :** ```json {   \"access\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\",  // Token d\'accès (validité: 30 min)   \"refresh\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\"  // Token de rafraîchissement (validité: 7 jours) } ```  **Avantages :** - ✅ Automatisation complète (CI/CD, scripts) - ✅ Gestion programmatique des tokens - ✅ Support du refresh token pour renouveler automatiquement l\'accès - ✅ Intégration facile dans n\'importe quel langage/outil  #### 🖥️ Méthode 2 : Génération via Dashboard (Alternative)  **URL :** https://www.factpulse.fr/dashboard/  Cette méthode convient pour des tests rapides ou une utilisation occasionnelle via l\'interface graphique.  **Fonctionnement :** - Connectez-vous au dashboard - Utilisez les boutons \"Generate Test Token\" ou \"Generate Production Token\" - Fonctionne pour **tous** les utilisateurs (OAuth et email/password), sans nécessiter de mot de passe  **Types de tokens :** - **Token Test** : Validité 24h, quota 1000 appels/jour (gratuit) - **Token Production** : Validité 7 jours, quota selon votre forfait  **Avantages :** - ✅ Rapide pour tester l\'API - ✅ Aucun mot de passe requis - ✅ Interface visuelle simple  **Inconvénients :** - ❌ Nécessite une action manuelle - ❌ Pas de refresh token - ❌ Moins adapté pour l\'automatisation  ### 📚 Documentation complète  Pour plus d\'informations sur l\'authentification et l\'utilisation de l\'API : https://www.factpulse.fr/documentation-api/
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/helpers/client.d.ts

@@ -0,0 +1,265 @@
+/** Credentials Chorus Pro pour le mode Zero-Trust. */
+export interface ChorusProCredentials {
+    pisteClientId: string;
+    pisteClientSecret: string;
+    chorusProLogin: string;
+    chorusProPassword: string;
+    sandbox?: boolean;
+}
+/** Credentials AFNOR PDP pour le mode Zero-Trust. L'API FactPulse utilise ces credentials pour s'authentifier auprès de la PDP AFNOR. */
+export interface AFNORCredentials {
+    flowServiceUrl: string;
+    tokenUrl: string;
+    clientId: string;
+    clientSecret: string;
+    directoryServiceUrl?: string;
+}
+export interface FactPulseClientConfig {
+    email: string;
+    password: string;
+    apiUrl?: string;
+    clientUid?: string;
+    chorusCredentials?: ChorusProCredentials;
+    afnorCredentials?: AFNORCredentials;
+    pollingInterval?: number;
+    pollingTimeout?: number;
+    maxRetries?: number;
+}
+type MontantValue = string | number | null | undefined;
+/** Convertit une valeur en string de montant pour l'API. */
+export declare function montant(value: MontantValue): string;
+/** Crée un objet MontantTotal simplifié. */
+export declare function montantTotal(ht: MontantValue, tva: MontantValue, ttc: MontantValue, aPayer: MontantValue, options?: {
+    remiseTtc?: MontantValue;
+    motifRemise?: string;
+    acompte?: MontantValue;
+}): Record<string, unknown>;
+/** Crée une ligne de poste (aligné sur LigneDePoste de models.py).
+ * Pour le taux TVA: soit tauxTva (code ex: "TVA20") soit tauxTvaManuel (valeur ex: 20.00) */
+export declare function ligneDePoste(numero: number, denomination: string, quantite: MontantValue, montantUnitaireHt: MontantValue, montantTotalLigneHt: MontantValue, options?: {
+    tauxTva?: string;
+    tauxTvaManuel?: MontantValue;
+    categorieTva?: string;
+    unite?: string;
+    reference?: string;
+    montantRemiseHt?: MontantValue;
+    codeRaisonReduction?: string;
+    raisonReduction?: string;
+    dateDebutPeriode?: string;
+    dateFinPeriode?: string;
+}): Record<string, unknown>;
+/** Crée une ligne de TVA (aligné sur LigneDeTVA de models.py).
+ * Pour le taux: soit taux (code ex: "TVA20") soit tauxManuel (valeur ex: 20.00) */
+export declare function ligneDeTva(montantBaseHt: MontantValue, montantTva: MontantValue, options?: {
+    taux?: string;
+    tauxManuel?: MontantValue;
+    categorie?: string;
+}): Record<string, unknown>;
+/** Crée une adresse postale pour l'API FactPulse. */
+export declare function adressePostale(ligne1: string, codePostal: string, ville: string, options?: {
+    pays?: string;
+    ligne2?: string;
+    ligne3?: string;
+}): Record<string, unknown>;
+/** Crée une adresse électronique pour l'API FactPulse. schemeId: "0009"=SIREN, "0225"=SIRET */
+export declare function adresseElectronique(identifiant: string, schemeId?: string): Record<string, unknown>;
+/** Crée un fournisseur (émetteur) avec auto-calcul SIREN, TVA intracommunautaire et adresses. */
+export declare function fournisseur(nom: string, siret: string, adresseLigne1: string, codePostal: string, ville: string, options?: {
+    idFournisseur?: number;
+    siren?: string;
+    numeroTvaIntra?: string;
+    iban?: string;
+    pays?: string;
+    adresseLigne2?: string;
+    codeService?: number;
+    codeCoordonnesBancaires?: number;
+}): Record<string, unknown>;
+/** Crée un destinataire (client) avec auto-calcul SIREN et adresses. */
+export declare function destinataire(nom: string, siret: string, adresseLigne1: string, codePostal: string, ville: string, options?: {
+    siren?: string;
+    pays?: string;
+    adresseLigne2?: string;
+    codeServiceExecutant?: string;
+}): Record<string, unknown>;
+/**
+ * Crée un bénéficiaire (factor) pour l'affacturage.
+ *
+ * Le bénéficiaire (BG-10 / PayeeTradeParty) est utilisé lorsque le paiement
+ * doit être effectué à un tiers différent du fournisseur, typiquement un
+ * factor (société d'affacturage).
+ *
+ * Pour les factures affacturées, il faut aussi:
+ * - Utiliser un type de document affacturé (393, 396, 501, 502, 472, 473)
+ * - Ajouter une note ACC avec la mention de subrogation
+ * - L'IBAN du bénéficiaire sera utilisé pour le paiement
+ *
+ * @param nom Raison sociale du factor (BT-59)
+ * @param options Options: siret (BT-60), siren (BT-61), iban, bic
+ * @returns Dict prêt à être utilisé dans une facture affacturée
+ *
+ * @example
+ * const factor = beneficiaire('FACTOR SAS', {
+ *   siret: '30000000700033',
+ *   iban: 'FR76 3000 4000 0500 0012 3456 789',
+ * });
+ */
+export declare function beneficiaire(nom: string, options?: {
+    siret?: string;
+    siren?: string;
+    iban?: string;
+    bic?: string;
+}): Record<string, unknown>;
+export declare class FactPulseClient {
+    private config;
+    private httpClient;
+    private accessToken;
+    private refreshToken;
+    private tokenExpiresAt;
+    readonly chorusCredentials?: ChorusProCredentials;
+    readonly afnorCredentials?: AFNORCredentials;
+    constructor(config: FactPulseClientConfig);
+    getChorusCredentialsForApi(): Record<string, unknown> | undefined;
+    getAfnorCredentialsForApi(): Record<string, unknown> | undefined;
+    getChorusProCredentials(): Record<string, unknown> | undefined;
+    getAfnorCredentials(): Record<string, unknown> | undefined;
+    private obtainToken;
+    ensureAuthenticated(forceRefresh?: boolean): Promise<void>;
+    resetAuth(): void;
+    pollTask(taskId: string, timeout?: number, interval?: number): Promise<Record<string, unknown>>;
+    genererFacturx(factureData: Record<string, unknown> | string, pdfPath: string, profil?: string, formatSortie?: string, sync?: boolean, timeout?: number): Promise<Buffer | string>;
+    static formatMontant(m: unknown): string;
+    /**
+     * Recupere les credentials AFNOR (mode stored ou zero-trust).
+     * Mode zero-trust: Retourne les afnorCredentials fournis au constructeur.
+     * Mode stored: Recupere les credentials via GET /api/v1/afnor/credentials.
+     */
+    private getAfnorCredentialsInternal;
+    /**
+     * Obtient le token OAuth2 AFNOR et l'URL de la PDP.
+     * Cette methode:
+     * 1. Recupere les credentials AFNOR (mode stored ou zero-trust)
+     * 2. Fait l'OAuth AFNOR pour obtenir un token
+     * 3. Retourne le token et l'URL de la PDP
+     */
+    private getAfnorTokenAndUrl;
+    /**
+     * Effectue une requete vers l'API AFNOR avec gestion d'auth et d'erreurs.
+     * IMPORTANT: Cette methode utilise le token OAuth AFNOR, PAS le JWT FactPulse!
+     */
+    private makeAfnorRequest;
+    rechercherSiretAfnor(siret: string): Promise<Record<string, unknown>>;
+    rechercherSirenAfnor(siren: string): Promise<Record<string, unknown>>;
+    listerCodesRoutageAfnor(siren: string): Promise<unknown[]>;
+    /**
+     * Soumet une facture a une PDP via l'API AFNOR.
+     * L'authentification utilise le token OAuth AFNOR (obtenu automatiquement),
+     * soit via les credentials stockes (mode stored), soit via les afnorCredentials
+     * fournis au constructeur (mode zero-trust).
+     *
+     * @param pdfBuffer Buffer du PDF Factur-X a soumettre
+     * @param flowName Nom du flux (ex: "Facture FAC-2025-001")
+     * @param options Options: trackingId, flowSyntax (CII/UBL), flowProfile
+     */
+    soumettreFactureAfnor(pdfBuffer: Buffer, flowName: string, options?: {
+        trackingId?: string;
+        flowSyntax?: string;
+        flowProfile?: string;
+    }): Promise<Record<string, unknown>>;
+    rechercherFluxAfnor(criteria?: {
+        trackingId?: string;
+        status?: string;
+        offset?: number;
+        limit?: number;
+    }): Promise<Record<string, unknown>>;
+    telechargerFluxAfnor(flowId: string): Promise<Buffer>;
+    /**
+     * Récupère les métadonnées JSON d'un flux entrant (facture fournisseur).
+     * Télécharge un flux entrant depuis la PDP AFNOR et extrait les métadonnées
+     * de la facture vers un format JSON unifié. Supporte Factur-X, CII et UBL.
+     *
+     * Note: Cet endpoint utilise l'authentification JWT FactPulse (pas OAuth AFNOR).
+     * Le serveur FactPulse se charge d'appeler la PDP avec les credentials stockés.
+     *
+     * @param flowId Identifiant du flux (UUID)
+     * @param includeDocument Si true, inclut le document original encodé en base64
+     * @returns Métadonnées de la facture (fournisseur, montants, dates, etc.)
+     *
+     * @example
+     * const facture = await client.obtenirFactureEntranteAfnor("550e8400-...");
+     * console.log(`Fournisseur: ${facture.fournisseur.nom}`);
+     * console.log(`Montant TTC: ${facture.montant_ttc} ${facture.devise}`);
+     */
+    obtenirFactureEntranteAfnor(flowId: string, includeDocument?: boolean): Promise<Record<string, unknown>>;
+    healthcheckAfnor(): Promise<Record<string, unknown>>;
+    rechercherStructureChorus(criteria: Record<string, unknown>): Promise<unknown[]>;
+    consulterStructureChorus(idStructureCpp: number): Promise<Record<string, unknown>>;
+    /**
+     * Liste les services d'une structure Chorus Pro.
+     * @param idStructureCpp ID Chorus Pro de la structure
+     * @returns Objet avec listeServices, total, codeRetour, libelle
+     */
+    listerServicesStructureChorus(idStructureCpp: number): Promise<Record<string, unknown>>;
+    obtenirIdChorusDepuisSiret(siret: string): Promise<number | null>;
+    soumettreFactureChorus(factureData: Record<string, unknown>): Promise<Record<string, unknown>>;
+    consulterFactureChorus(identifiantFactureCpp: number): Promise<Record<string, unknown>>;
+    /**
+     * Valide un PDF Factur-X.
+     * @param pdfBuffer - Contenu du PDF en Buffer
+     * @param options - Options de validation
+     * @param options.profil - Profil Factur-X (MINIMUM, BASIC, EN16931, EXTENDED). Si non spécifié, auto-détecté.
+     * @param options.useVerapdf - Active la validation stricte PDF/A avec VeraPDF (défaut: false)
+     */
+    validerPdfFacturx(pdfBuffer: Buffer, options?: {
+        profil?: string;
+        useVerapdf?: boolean;
+    }): Promise<Record<string, unknown>>;
+    validerXmlFacturx(xmlContent: string, profil?: string): Promise<Record<string, unknown>>;
+    validerSignaturePdf(pdfBuffer: Buffer): Promise<Record<string, unknown>>;
+    /**
+     * Signe un PDF avec le certificat configuré côté serveur (via client_uid du JWT).
+     * Le certificat doit être préalablement configuré dans Django Admin.
+     */
+    signerPdf(pdfBuffer: Buffer, options?: {
+        raison?: string;
+        localisation?: string;
+        contact?: string;
+        usePadesLt?: boolean;
+        useTimestamp?: boolean;
+    }): Promise<Buffer>;
+    /**
+     * Génère un certificat de test (NON PRODUCTION).
+     * Le certificat doit ensuite être configuré dans Django Admin.
+     */
+    genererCertificatTest(options?: {
+        cn?: string;
+        organisation?: string;
+        email?: string;
+        dureeJours?: number;
+        tailleClé?: number;
+    }): Promise<Record<string, unknown>>;
+    /**
+     * Workflow complet : génération + validation + signature + soumission AFNOR.
+     * Note: La signature utilise le certificat configuré côté serveur (via client_uid du JWT).
+     * @param factureData Données de la facture
+     * @param pdfPath Chemin vers le PDF source
+     * @param options Options du workflow
+     * @returns Résultat avec pdfBuffer, validation, signature et afnor
+     */
+    genererFacturxComplet(factureData: Record<string, unknown>, pdfPath: string, options?: {
+        profil?: string;
+        valider?: boolean;
+        signer?: boolean;
+        soumettreAfnor?: boolean;
+        afnorFlowName?: string;
+        afnorTrackingId?: string;
+        timeout?: number;
+    }): Promise<{
+        pdfBuffer: Buffer;
+        validation?: Record<string, unknown>;
+        signature?: {
+            signe: boolean;
+        };
+        afnor?: Record<string, unknown>;
+    }>;
+}
+export {};