@factpulse/sdk 2.0.12 → 3.0.1

package/README.md

@@ -1,192 +1,241 @@
 # FactPulse SDK TypeScript
 
-Client TypeScript/JavaScript officiel pour l'API FactPulse - Facturation électronique française.
+Official TypeScript/JavaScript client for the FactPulse API - French electronic invoicing.
 
-## 🎯 Fonctionnalités
+## Features
 
-- **Factur-X** : Génération et validation de factures électroniques (profils MINIMUM, BASIC, EN16931, EXTENDED)
-- **Chorus Pro** : Intégration avec la plateforme de facturation publique française
-- **AFNOR PDP/PA** : Soumission de flux conformes à la norme XP Z12-013
-- **Signature électronique** : Signature PDF (PAdES-B-B, PAdES-B-T, PAdES-B-LT)
-- **Client simplifié** : Authentification JWT et polling intégrés via `helpers`
-- **TypeScript** : Support complet avec types générés automatiquement
+- **Factur-X**: Generation and validation of electronic invoices (MINIMUM, BASIC, EN16931, EXTENDED profiles)
+- **Chorus Pro**: Integration with the French public invoicing platform
+- **AFNOR PDP/PA**: Submission of flows compliant with XP Z12-013 standard
+- **Electronic signature**: PDF signing (PAdES-B-B, PAdES-B-T, PAdES-B-LT)
+- **Simplified client**: JWT authentication and polling integrated via `helpers`
 
-## 🚀 Installation
+## Installation
 
 ```bash
 npm install @factpulse/sdk
-# ou
+# or
 yarn add @factpulse/sdk
 ```
 
-## 📖 Démarrage rapide
+## Quick Start
 
-### Méthode recommandée : Client simplifié avec helpers
-
-Le module `helpers` offre une API simplifiée avec authentification et polling automatiques :
+The `helpers` module provides a simplified API with automatic authentication and polling:
 
 ```typescript
-import { FactPulseClient } from '@factpulse/sdk/helpers';
+import {
+  FactPulseClient,
+  amount,
+  totalAmount,
+  invoiceLine,
+  vatLine,
+  supplier,
+  recipient,
+} from '@factpulse/sdk/helpers';
 import * as fs from 'fs';
 
-// Créer le client (authentification automatique)
+// Create the client
 const client = new FactPulseClient({
-  email: 'votre_email@example.com',
-  password: 'votre_mot_de_passe'
+  email: 'your_email@example.com',
+  password: 'your_password'
 });
 
-// Données de la facture
-const factureData = {
-  numero_facture: 'FAC-2025-001',
-  date_facture: '2025-01-15',
-  fournisseur: {
-    nom: 'Mon Entreprise SAS',
-    siret: '12345678901234',
-    adresse_postale: {
-      ligne_un: '123 Rue Example',
-      code_postal: '75001',
-      nom_ville: 'Paris',
-      pays_code_iso: 'FR'
-    }
-  },
-  destinataire: {
-    nom: 'Client SARL',
-    siret: '98765432109876',
-    adresse_postale: {
-      ligne_un: '456 Avenue Test',
-      code_postal: '69001',
-      nom_ville: 'Lyon',
-      pays_code_iso: 'FR'
-    }
-  },
-  montant_total: {
-    montant_ht_total: '1000.00',
-    montant_tva: '200.00',
-    montant_ttc_total: '1200.00',
-    montant_a_payer: '1200.00'
-  },
-  lignes_de_poste: [{
-    numero: 1,
-    denomination: 'Prestation de conseil',
-    quantite: '10.00',
-    unite: 'PIECE',
-    montant_unitaire_ht: '100.00'
-  }]
+// Build the invoice with helpers
+const invoiceData = {
+  number: 'INV-2025-001',
+  date: '2025-01-15',
+  supplier: supplier(
+    'My Company SAS',
+    '12345678901234',
+    '123 Example Street',
+    '75001',
+    'Paris'
+  ),
+  recipient: recipient(
+    'Client SARL',
+    '98765432109876',
+    '456 Test Avenue',
+    '69001',
+    'Lyon'
+  ),
+  totalAmount: totalAmount(1000.00, 200.00, 1200.00, 1200.00),
+  lines: [
+    invoiceLine(1, 'Consulting services', 10, 100.00, 1000.00)
+  ],
+  vatLines: [
+    vatLine(1000.00, 200.00, { manualRate: '20.00' })
+  ],
 };
 
-// Lire le PDF source
-const pdfSource = fs.readFileSync('facture_source.pdf');
-
-// Générer le PDF Factur-X (polling automatique)
-const pdfBytes = await client.genererFacturx(
-  factureData,
-  pdfSource,
-  'EN16931',  // profil
-  'pdf',      // format
-  true        // sync (attend le résultat)
+// Generate the Factur-X PDF
+const pdfBytes = await client.generateFacturx(
+  invoiceData,
+  'source_invoice.pdf',
+  'EN16931'
 );
 
-// Sauvegarder
-fs.writeFileSync('facture_facturx.pdf', pdfBytes);
+fs.writeFileSync('facturx_invoice.pdf', pdfBytes);
 ```
 
-### Méthode alternative : SDK brut
+## Available Helpers
+
+### amount(value)
 
-Pour un contrôle total, utilisez le SDK généré directement :
+Converts a value to a formatted string for monetary amounts.
 
 ```typescript
-import { Configuration, TraitementFactureApi } from '@factpulse/sdk';
-import axios from 'axios';
+import { amount } from '@factpulse/sdk/helpers';
 
-// 1. Obtenir le token JWT
-const tokenResponse = await axios.post('https://factpulse.fr/api/token/', {
-  username: 'votre_email@example.com',
-  password: 'votre_mot_de_passe'
-});
-const token = tokenResponse.data.access;
+amount(1234.5);      // "1234.50"
+amount("1234.56");   // "1234.56"
+amount(null);        // "0.00"
+```
 
-// 2. Configurer le client
-const config = new Configuration({
-  basePath: 'https://factpulse.fr/api/facturation',
-  accessToken: token
-});
+### totalAmount(excludingTax, vat, includingTax, due, options?)
 
-// 3. Appeler l'API
-const api = new TraitementFactureApi(config);
-const response = await api.genererFactureApiV1TraitementGenererFacturePost(
-  JSON.stringify(factureData),
-  'EN16931',
-  'pdf',
-  new Blob([pdfSource])
-);
+Creates a complete TotalAmount object.
 
-// 4. Polling manuel pour récupérer le résultat
-const taskId = response.data.id_tache;
-// ... (implémenter le polling)
+```typescript
+import { totalAmount } from '@factpulse/sdk/helpers';
+
+const total = totalAmount(1000.00, 200.00, 1200.00, 1200.00, {
+  discountIncludingTax: 50.00,  // Optional
+  discountReason: 'Loyalty',    // Optional
+  prepayment: 100.00,           // Optional
+});
 ```
 
-## 🔧 Avantages des helpers
+### invoiceLine(number, description, quantity, unitPrice, lineTotal, options?)
 
-| Fonctionnalité | SDK brut | helpers |
-|----------------|----------|---------|
-| Authentification | Manuelle | Automatique |
-| Refresh token | Manuel | Automatique |
-| Polling tâches async | Manuel | Automatique (backoff) |
-| Retry sur 401 | Manuel | Automatique |
-| Types TypeScript | ✓ | ✓ |
+Creates an invoice line.
 
-## 🔑 Options d'authentification
+```typescript
+import { invoiceLine } from '@factpulse/sdk/helpers';
+
+const line = invoiceLine(
+  1,
+  'Consulting services',
+  5,
+  200.00,
+  1000.00,  // lineTotal required
+  {
+    vatRate: 'VAT20',        // Or manualVatRate: '20.00'
+    vatCategory: 'S',        // S, Z, E, AE, K
+    unit: 'HOUR',            // PACKAGE, PIECE, HOUR, DAY...
+    reference: 'REF-001',    // Optional
+  }
+);
+```
 
-### Client UID (multi-clients)
+### vatLine(baseAmount, vatAmount, options?)
 
-Si vous gérez plusieurs clients :
+Creates a VAT breakdown line.
 
 ```typescript
-const client = new FactPulseClient({
-  email: 'votre_email@example.com',
-  password: 'votre_mot_de_passe',
-  clientUid: 'identifiant_client'  // UID du client cible
+import { vatLine } from '@factpulse/sdk/helpers';
+
+const vat = vatLine(1000.00, 200.00, {
+  rate: 'VAT20',       // Or manualRate: '20.00'
+  category: 'S',       // S, Z, E, AE, K
 });
 ```
 
-### Configuration avancée
+### postalAddress(line1, postalCode, city, options?)
+
+Creates a structured postal address.
 
 ```typescript
-const client = new FactPulseClient({
-  email: 'votre_email@example.com',
-  password: 'votre_mot_de_passe',
-  apiUrl: 'https://factpulse.fr',  // URL personnalisée
-  pollingInterval: 2000,  // Intervalle de polling initial (ms)
-  pollingTimeout: 120000,  // Timeout de polling (ms)
-  maxRetries: 2  // Tentatives en cas de 401
+import { postalAddress } from '@factpulse/sdk/helpers';
+
+const address = postalAddress('123 Republic Street', '75001', 'Paris', {
+  country: 'FR',       // Default: 'FR'
+  line2: 'Building A'  // Optional
 });
 ```
 
-## 💡 Formats de montants acceptés
+### electronicAddress(identifier, schemeId?)
 
-L'API accepte plusieurs formats pour les montants :
+Creates an electronic address (digital identifier).
 
 ```typescript
-// String (recommandé pour la précision)
-const montant = "1234.56";
+import { electronicAddress } from '@factpulse/sdk/helpers';
 
-// Number
-const montant = 1234.56;
+// SIRET (schemeId="0225")
+const address = electronicAddress('12345678901234', '0225');
 
-// Integer
-const montant = 1234;
+// SIREN (schemeId="0009", default)
+const address = electronicAddress('123456789');
+```
+
+### supplier(name, siret, addressLine1, postalCode, city, options?)
+
+Creates a complete supplier with automatic SIREN and intra-EU VAT calculation.
 
-// Helper de formatage
-const montantFormate = FactPulseClient.formatMontant(1234.5);  // "1234.50"
+```typescript
+import { supplier } from '@factpulse/sdk/helpers';
+
+const s = supplier(
+  'My Company SAS',
+  '12345678901234',
+  '123 Example Street',
+  '75001',
+  'Paris',
+  { iban: 'FR7630006000011234567890189' }
+);
+// SIREN and intra-EU VAT number calculated automatically
+```
+
+### recipient(name, siret, addressLine1, postalCode, city, options?)
+
+Creates a recipient (customer) with automatic SIREN calculation.
+
+```typescript
+import { recipient } from '@factpulse/sdk/helpers';
+
+const r = recipient(
+  'Client SARL',
+  '98765432109876',
+  '456 Test Avenue',
+  '69001',
+  'Lyon'
+);
+```
+
+## Zero-Trust Mode (Chorus Pro / AFNOR)
+
+To pass your own credentials without server-side storage:
+
+```typescript
+import {
+  FactPulseClient,
+  ChorusProCredentials,
+  AFNORCredentials,
+} from '@factpulse/sdk/helpers';
+
+const client = new FactPulseClient({
+  email: 'your_email@example.com',
+  password: 'your_password',
+  chorusCredentials: {
+    pisteClientId: 'your_client_id',
+    pisteClientSecret: 'your_client_secret',
+    chorusProLogin: 'your_login',
+    chorusProPassword: 'your_password',
+    sandbox: true,
+  },
+  afnorCredentials: {
+    flowServiceUrl: 'https://api.pdp.fr/flow/v1',
+    tokenUrl: 'https://auth.pdp.fr/oauth/token',
+    clientId: 'your_client_id',
+    clientSecret: 'your_client_secret',
+  },
+});
 ```
 
-## 📚 Ressources
+## Resources
 
-- **Documentation API** : https://factpulse.fr/api/facturation/documentation
-- **Code source** : https://github.com/factpulse/sdk-typescript
-- **Issues** : https://github.com/factpulse/sdk-typescript/issues
-- **Support** : contact@factpulse.fr
+- **API Documentation**: https://factpulse.fr/api/facturation/documentation
+- **Support**: contact@factpulse.fr
 
-## 📄 Licence
+## License
 
 MIT License - Copyright (c) 2025 FactPulse

package/api/afnorpdppaapi.ts

@@ -1,8 +1,8 @@
 /* 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/     
+ * FactPulse REST API
+ *  REST API for electronic invoicing in France: Factur-X, AFNOR PDP/PA, electronic signatures.  ## 🎯 Main Features  ### 📄 Factur-X Invoice Generation - **Formats**: XML only or PDF/A-3 with embedded XML - **Profiles**: MINIMUM, BASIC, EN16931, EXTENDED - **Standards**: EN 16931 (EU directive 2014/55), ISO 19005-3 (PDF/A-3), CII (UN/CEFACT) - **🆕 Simplified Format**: Generation from SIRET + auto-enrichment (Chorus Pro API + Business Search)  ### ✅ Validation and Compliance - **XML Validation**: Schematron (45 to 210+ rules depending on profile) - **PDF Validation**: PDF/A-3, Factur-X XMP metadata, electronic signatures - **VeraPDF**: Strict PDF/A validation (146+ ISO 19005-3 rules) - **Asynchronous Processing**: Celery support for heavy validations (VeraPDF)  ### 📡 AFNOR PDP/PA Integration (XP Z12-013) - **Flow Submission**: Send invoices to Partner Dematerialization Platforms - **Flow Search**: View submitted invoices - **Download**: Retrieve PDF/A-3 with XML - **Directory Service**: Company search (SIREN/SIRET) - **Multi-client**: Support for multiple PDP configs per user (stored credentials or zero-storage)  ### ✍️ PDF Electronic Signature - **Standards**: PAdES-B-B, PAdES-B-T (RFC 3161 timestamping), PAdES-B-LT (long-term archival) - **eIDAS Levels**: SES (self-signed), AdES (commercial CA), QES (QTSP) - **Validation**: Cryptographic integrity and certificate verification - **Certificate Generation**: Self-signed X.509 certificates for testing  ### 🔄 Asynchronous Processing - **Celery**: Asynchronous generation, validation and signing - **Polling**: Status tracking via `/tasks/{task_id}/status` - **No timeout**: Ideal for large files or heavy validations  ## 🔒 Authentication  All requests require a **JWT token** in the Authorization header: ``` Authorization: Bearer YOUR_JWT_TOKEN ```  ### How to obtain a JWT token?  #### 🔑 Method 1: `/api/token/` API (Recommended)  **URL:** `https://www.factpulse.fr/api/token/`  This method is **recommended** for integration in your applications and CI/CD workflows.  **Prerequisites:** Having set a password on your account  **For users registered via email/password:** - You already have a password, use it directly  **For users registered via OAuth (Google/GitHub):** - You must first set a password at: https://www.factpulse.fr/accounts/password/set/ - Once the password is created, you can use the API  **Request example:** ```bash curl -X POST https://www.factpulse.fr/api/token/ \\   -H \"Content-Type: application/json\" \\   -d \'{     \"username\": \"your_email@example.com\",     \"password\": \"your_password\"   }\' ```  **Optional `client_uid` parameter:**  To select credentials for a specific client (PA/PDP, Chorus Pro, signing certificates), add `client_uid`:  ```bash curl -X POST https://www.factpulse.fr/api/token/ \\   -H \"Content-Type: application/json\" \\   -d \'{     \"username\": \"your_email@example.com\",     \"password\": \"your_password\",     \"client_uid\": \"550e8400-e29b-41d4-a716-446655440000\"   }\' ```  The `client_uid` will be included in the JWT and allow the API to automatically use: - AFNOR/PDP credentials configured for this client - Chorus Pro credentials configured for this client - Electronic signature certificates configured for this client  **Response:** ```json {   \"access\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\",  // Access token (validity: 30 min)   \"refresh\": \"eyJ0eXAiOiJKV1QiLCJhbGc...\"  // Refresh token (validity: 7 days) } ```  **Advantages:** - ✅ Full automation (CI/CD, scripts) - ✅ Programmatic token management - ✅ Refresh token support for automatic access renewal - ✅ Easy integration in any language/tool  #### 🖥️ Method 2: Dashboard Generation (Alternative)  **URL:** https://www.factpulse.fr/dashboard/  This method is suitable for quick tests or occasional use via the graphical interface.  **How it works:** - Log in to the dashboard - Use the \"Generate Test Token\" or \"Generate Production Token\" buttons - Works for **all** users (OAuth and email/password), without requiring a password  **Token types:** - **Test Token**: 24h validity, 1000 calls/day quota (free) - **Production Token**: 7 days validity, quota based on your plan  **Advantages:** - ✅ Quick for API testing - ✅ No password required - ✅ Simple visual interface  **Disadvantages:** - ❌ Requires manual action - ❌ No refresh token - ❌ Less suited for automation  ### 📚 Full Documentation  For more information on authentication and API usage: https://www.factpulse.fr/documentation-api/     
  *
  * The version of the OpenAPI document: 1.0.0
  * 
@@ -21,14 +21,95 @@ import globalAxios from 'axios';
 import { DUMMY_BASE_URL, assertParamExists, setApiKeyToObject, setBasicAuthToObject, setBearerAuthToObject, setOAuthToObject, setSearchParams, serializeDataIfNeeded, toPathString, createRequestFunction } from '../common';
 // @ts-ignore
 import { BASE_PATH, COLLECTION_FORMATS, type RequestArgs, BaseAPI, RequiredError, operationServerMap } from '../base';
+// @ts-ignore
+import type { HTTPValidationError } from '../models';
+// @ts-ignore
+import type { IncomingInvoice } from '../models';
 /**
  * AFNORPDPPAApi - axios parameter creator
  */
 export const AFNORPDPPAApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
         /**
-         * Endpoint proxy OAuth2 pour obtenir un token d\'accès AFNOR. Fait proxy vers le mock AFNOR (sandbox) ou la vraie PDP selon MOCK_AFNOR_BASE_URL. Cet endpoint est public (pas d\'auth Django requise) car il est appelé par le SDK AFNOR.
-         * @summary Endpoint OAuth2 pour authentification AFNOR
+         * Retrieves stored AFNOR/PDP credentials for the JWT\'s client_uid. This endpoint is used by the SDK in \'stored\' mode to retrieve credentials before performing AFNOR OAuth itself.
+         * @summary Retrieve stored AFNOR credentials
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getAfnorCredentialsApiV1AfnorCredentialsGet: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/api/v1/afnor/credentials`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication HTTPBearer required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * Downloads an incoming flow from the AFNOR PDP and extracts invoice metadata into a unified JSON format. Supports Factur-X, CII, and UBL formats.
+         * @summary Retrieve and extract an incoming invoice
+         * @param {string} flowId 
+         * @param {boolean} [includeDocument] 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getFluxEntrantApiV1AfnorIncomingFlowsFlowIdGet: async (flowId: string, includeDocument?: boolean, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'flowId' is not null or undefined
+            assertParamExists('getFluxEntrantApiV1AfnorIncomingFlowsFlowIdGet', 'flowId', flowId)
+            const localVarPath = `/api/v1/afnor/incoming-flows/{flow_id}`
+                .replace(`{${"flow_id"}}`, encodeURIComponent(String(flowId)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication HTTPBearer required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            if (includeDocument !== undefined) {
+                localVarQueryParameter['include_document'] = includeDocument;
+            }
+
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * OAuth2 proxy endpoint to obtain an AFNOR access token. Proxies to AFNOR mock (sandbox) or real PDP depending on MOCK_AFNOR_BASE_URL. This endpoint is public (no Django auth required) as it is called by the AFNOR SDK.
+         * @summary OAuth2 endpoint for AFNOR authentication
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -66,8 +147,34 @@ export const AFNORPDPPAApiFp = function(configuration?: Configuration) {
     const localVarAxiosParamCreator = AFNORPDPPAApiAxiosParamCreator(configuration)
     return {
         /**
-         * Endpoint proxy OAuth2 pour obtenir un token d\'accès AFNOR. Fait proxy vers le mock AFNOR (sandbox) ou la vraie PDP selon MOCK_AFNOR_BASE_URL. Cet endpoint est public (pas d\'auth Django requise) car il est appelé par le SDK AFNOR.
-         * @summary Endpoint OAuth2 pour authentification AFNOR
+         * Retrieves stored AFNOR/PDP credentials for the JWT\'s client_uid. This endpoint is used by the SDK in \'stored\' mode to retrieve credentials before performing AFNOR OAuth itself.
+         * @summary Retrieve stored AFNOR credentials
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async getAfnorCredentialsApiV1AfnorCredentialsGet(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<any>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.getAfnorCredentialsApiV1AfnorCredentialsGet(options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AFNORPDPPAApi.getAfnorCredentialsApiV1AfnorCredentialsGet']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Downloads an incoming flow from the AFNOR PDP and extracts invoice metadata into a unified JSON format. Supports Factur-X, CII, and UBL formats.
+         * @summary Retrieve and extract an incoming invoice
+         * @param {string} flowId 
+         * @param {boolean} [includeDocument] 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async getFluxEntrantApiV1AfnorIncomingFlowsFlowIdGet(flowId: string, includeDocument?: boolean, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<IncomingInvoice>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.getFluxEntrantApiV1AfnorIncomingFlowsFlowIdGet(flowId, includeDocument, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AFNORPDPPAApi.getFluxEntrantApiV1AfnorIncomingFlowsFlowIdGet']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * OAuth2 proxy endpoint to obtain an AFNOR access token. Proxies to AFNOR mock (sandbox) or real PDP depending on MOCK_AFNOR_BASE_URL. This endpoint is public (no Django auth required) as it is called by the AFNOR SDK.
+         * @summary OAuth2 endpoint for AFNOR authentication
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -87,8 +194,28 @@ export const AFNORPDPPAApiFactory = function (configuration?: Configuration, bas
     const localVarFp = AFNORPDPPAApiFp(configuration)
     return {
         /**
-         * Endpoint proxy OAuth2 pour obtenir un token d\'accès AFNOR. Fait proxy vers le mock AFNOR (sandbox) ou la vraie PDP selon MOCK_AFNOR_BASE_URL. Cet endpoint est public (pas d\'auth Django requise) car il est appelé par le SDK AFNOR.
-         * @summary Endpoint OAuth2 pour authentification AFNOR
+         * Retrieves stored AFNOR/PDP credentials for the JWT\'s client_uid. This endpoint is used by the SDK in \'stored\' mode to retrieve credentials before performing AFNOR OAuth itself.
+         * @summary Retrieve stored AFNOR credentials
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getAfnorCredentialsApiV1AfnorCredentialsGet(options?: RawAxiosRequestConfig): AxiosPromise<any> {
+            return localVarFp.getAfnorCredentialsApiV1AfnorCredentialsGet(options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Downloads an incoming flow from the AFNOR PDP and extracts invoice metadata into a unified JSON format. Supports Factur-X, CII, and UBL formats.
+         * @summary Retrieve and extract an incoming invoice
+         * @param {string} flowId 
+         * @param {boolean} [includeDocument] 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getFluxEntrantApiV1AfnorIncomingFlowsFlowIdGet(flowId: string, includeDocument?: boolean, options?: RawAxiosRequestConfig): AxiosPromise<IncomingInvoice> {
+            return localVarFp.getFluxEntrantApiV1AfnorIncomingFlowsFlowIdGet(flowId, includeDocument, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * OAuth2 proxy endpoint to obtain an AFNOR access token. Proxies to AFNOR mock (sandbox) or real PDP depending on MOCK_AFNOR_BASE_URL. This endpoint is public (no Django auth required) as it is called by the AFNOR SDK.
+         * @summary OAuth2 endpoint for AFNOR authentication
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -103,8 +230,30 @@ export const AFNORPDPPAApiFactory = function (configuration?: Configuration, bas
  */
 export class AFNORPDPPAApi extends BaseAPI {
     /**
-     * Endpoint proxy OAuth2 pour obtenir un token d\'accès AFNOR. Fait proxy vers le mock AFNOR (sandbox) ou la vraie PDP selon MOCK_AFNOR_BASE_URL. Cet endpoint est public (pas d\'auth Django requise) car il est appelé par le SDK AFNOR.
-     * @summary Endpoint OAuth2 pour authentification AFNOR
+     * Retrieves stored AFNOR/PDP credentials for the JWT\'s client_uid. This endpoint is used by the SDK in \'stored\' mode to retrieve credentials before performing AFNOR OAuth itself.
+     * @summary Retrieve stored AFNOR credentials
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public getAfnorCredentialsApiV1AfnorCredentialsGet(options?: RawAxiosRequestConfig) {
+        return AFNORPDPPAApiFp(this.configuration).getAfnorCredentialsApiV1AfnorCredentialsGet(options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Downloads an incoming flow from the AFNOR PDP and extracts invoice metadata into a unified JSON format. Supports Factur-X, CII, and UBL formats.
+     * @summary Retrieve and extract an incoming invoice
+     * @param {string} flowId 
+     * @param {boolean} [includeDocument] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public getFluxEntrantApiV1AfnorIncomingFlowsFlowIdGet(flowId: string, includeDocument?: boolean, options?: RawAxiosRequestConfig) {
+        return AFNORPDPPAApiFp(this.configuration).getFluxEntrantApiV1AfnorIncomingFlowsFlowIdGet(flowId, includeDocument, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * OAuth2 proxy endpoint to obtain an AFNOR access token. Proxies to AFNOR mock (sandbox) or real PDP depending on MOCK_AFNOR_BASE_URL. This endpoint is public (no Django auth required) as it is called by the AFNOR SDK.
+     * @summary OAuth2 endpoint for AFNOR authentication
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */