@factpulse/sdk 3.0.9 → 3.0.13

package/api/afnorpdppaflow-service-api.ts

@@ -2,10 +2,10 @@
 /* eslint-disable */
 /**
  * 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/     
+ *  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://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://factpulse.fr/accounts/password/set/ - Once the password is created, you can use the API  **Request example:** ```bash curl -X POST https://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://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://factpulse.fr/api/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://factpulse.fr/documentation-api/     
  *
  * The version of the OpenAPI document: 1.0.0
- * 
+ * Contact: contact@factpulse.fr
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
  * https://openapi-generator.tech
@@ -18,10 +18,24 @@ import type { AxiosPromise, AxiosInstance, RawAxiosRequestConfig } from 'axios';
 import globalAxios from 'axios';
 // Some imports not used depending on template conditions
 // @ts-ignore
-import { DUMMY_BASE_URL, assertParamExists, setApiKeyToObject, setBasicAuthToObject, setBearerAuthToObject, setOAuthToObject, setSearchParams, serializeDataIfNeeded, toPathString, createRequestFunction } from '../common';
+import { DUMMY_BASE_URL, assertParamExists, setApiKeyToObject, setBasicAuthToObject, setBearerAuthToObject, setOAuthToObject, setSearchParams, serializeDataIfNeeded, toPathString, createRequestFunction , replaceWithSerializableTypeIfNeeded } from '../common';
 // @ts-ignore
 import { BASE_PATH, COLLECTION_FORMATS, type RequestArgs, BaseAPI, RequiredError, operationServerMap } from '../base';
 // @ts-ignore
+import type { AFNORError } from '../models';
+// @ts-ignore
+import type { AFNORFlow } from '../models';
+// @ts-ignore
+import type { AFNORFlowInfo } from '../models';
+// @ts-ignore
+import type { AFNORFullFlowInfo } from '../models';
+// @ts-ignore
+import type { AFNORSearchFlowContent } from '../models';
+// @ts-ignore
+import type { AFNORSearchFlowParams } from '../models';
+// @ts-ignore
+import type { DocType } from '../models';
+// @ts-ignore
 import type { HTTPValidationError } from '../models';
 /**
  * AFNORPDPPAFlowServiceApi - axios parameter creator
@@ -29,13 +43,14 @@ import type { HTTPValidationError } from '../models';
 export const AFNORPDPPAFlowServiceApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
         /**
-         * Download the PDF/A-3 file of an invoicing flow (uses JWT client_uid)
+         * Download a file related to a given flow (AFNOR XP Z12-013 compliant): - Metadata [Default]: provides the flow metadata as JSON - Original: the document initially sent by the emitter - Converted: the document optionally converted by the system - ReadableView: the document optionally generated as readable file
          * @summary Download a flow
-         * @param {string} flowId 
+         * @param {string} flowId AFNOR flow identifier (UUID)
+         * @param {DocType} [docType] Type of file to download: Metadata (default, JSON), Original, Converted, or ReadableView
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        downloadFlowProxyApiV1AfnorFlowV1FlowsFlowIdGet: async (flowId: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+        downloadFlowProxyApiV1AfnorFlowV1FlowsFlowIdGet: async (flowId: string, docType?: DocType, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
             // verify required parameter 'flowId' is not null or undefined
             assertParamExists('downloadFlowProxyApiV1AfnorFlowV1FlowsFlowIdGet', 'flowId', flowId)
             const localVarPath = `/api/v1/afnor/flow/v1/flows/{flowId}`
@@ -51,7 +66,11 @@ export const AFNORPDPPAFlowServiceApiAxiosParamCreator = function (configuration
             const localVarHeaderParameter = {} as any;
             const localVarQueryParameter = {} as any;
 
-            localVarHeaderParameter['Accept'] = 'application/json,application/pdf';
+            if (docType !== undefined) {
+                localVarQueryParameter['docType'] = docType;
+            }
+
+            localVarHeaderParameter['Accept'] = 'application/json,application/pdf,application/xml';
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
@@ -63,7 +82,7 @@ export const AFNORPDPPAFlowServiceApiAxiosParamCreator = function (configuration
             };
         },
         /**
-         * Check Flow Service availability
+         * Check Flow Service availability (AFNOR XP Z12-013 compliant)
          * @summary Healthcheck Flow Service
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -93,12 +112,15 @@ export const AFNORPDPPAFlowServiceApiAxiosParamCreator = function (configuration
             };
         },
         /**
-         * Search invoicing flows by criteria (uses JWT client_uid)
+         * Search invoicing flows by criteria (AFNOR XP Z12-013 compliant)
          * @summary Search flows
+         * @param {AFNORSearchFlowParams} aFNORSearchFlowParams 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        searchFlowsProxyApiV1AfnorFlowV1FlowsSearchPost: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+        searchFlowsProxyApiV1AfnorFlowV1FlowsSearchPost: async (aFNORSearchFlowParams: AFNORSearchFlowParams, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'aFNORSearchFlowParams' is not null or undefined
+            assertParamExists('searchFlowsProxyApiV1AfnorFlowV1FlowsSearchPost', 'aFNORSearchFlowParams', aFNORSearchFlowParams)
             const localVarPath = `/api/v1/afnor/flow/v1/flows/search`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
@@ -111,11 +133,13 @@ export const AFNORPDPPAFlowServiceApiAxiosParamCreator = function (configuration
             const localVarHeaderParameter = {} as any;
             const localVarQueryParameter = {} as any;
 
+            localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json';
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(aFNORSearchFlowParams, localVarRequestOptions, configuration)
 
             return {
                 url: toPathString(localVarUrlObj),
@@ -125,10 +149,16 @@ export const AFNORPDPPAFlowServiceApiAxiosParamCreator = function (configuration
         /**
          * Submits an electronic invoice to a Partner Dematerialization Platform (PDP) in compliance with the AFNOR XP Z12-013 standard
          * @summary Submit an invoicing flow
+         * @param {AFNORFlowInfo} flowInfo 
+         * @param {File} file Flow file (PDF/A-3 with embedded XML or XML)
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        submitFlowProxyApiV1AfnorFlowV1FlowsPost: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+        submitFlowProxyApiV1AfnorFlowV1FlowsPost: async (flowInfo: AFNORFlowInfo, file: File, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'flowInfo' is not null or undefined
+            assertParamExists('submitFlowProxyApiV1AfnorFlowV1FlowsPost', 'flowInfo', flowInfo)
+            // verify required parameter 'file' is not null or undefined
+            assertParamExists('submitFlowProxyApiV1AfnorFlowV1FlowsPost', 'file', file)
             const localVarPath = `/api/v1/afnor/flow/v1/flows`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
@@ -140,12 +170,23 @@ export const AFNORPDPPAFlowServiceApiAxiosParamCreator = function (configuration
             const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
             const localVarHeaderParameter = {} as any;
             const localVarQueryParameter = {} as any;
+            const localVarFormParams = new ((configuration && configuration.formDataCtor) || FormData)();
+
 
+            if (flowInfo !== undefined) { 
+                localVarFormParams.append('flowInfo', new Blob([JSON.stringify(flowInfo, replaceWithSerializableTypeIfNeeded)], { type: "application/json", }));
+            }
+
+            if (file !== undefined) { 
+                localVarFormParams.append('file', file as any);
+            }
+            localVarHeaderParameter['Content-Type'] = 'multipart/form-data';
             localVarHeaderParameter['Accept'] = 'application/json';
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = localVarFormParams;
 
             return {
                 url: toPathString(localVarUrlObj),
@@ -162,38 +203,40 @@ export const AFNORPDPPAFlowServiceApiFp = function(configuration?: Configuration
     const localVarAxiosParamCreator = AFNORPDPPAFlowServiceApiAxiosParamCreator(configuration)
     return {
         /**
-         * Download the PDF/A-3 file of an invoicing flow (uses JWT client_uid)
+         * Download a file related to a given flow (AFNOR XP Z12-013 compliant): - Metadata [Default]: provides the flow metadata as JSON - Original: the document initially sent by the emitter - Converted: the document optionally converted by the system - ReadableView: the document optionally generated as readable file
          * @summary Download a flow
-         * @param {string} flowId 
+         * @param {string} flowId AFNOR flow identifier (UUID)
+         * @param {DocType} [docType] Type of file to download: Metadata (default, JSON), Original, Converted, or ReadableView
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async downloadFlowProxyApiV1AfnorFlowV1FlowsFlowIdGet(flowId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<any>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.downloadFlowProxyApiV1AfnorFlowV1FlowsFlowIdGet(flowId, options);
+        async downloadFlowProxyApiV1AfnorFlowV1FlowsFlowIdGet(flowId: string, docType?: DocType, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AFNORFlow>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.downloadFlowProxyApiV1AfnorFlowV1FlowsFlowIdGet(flowId, docType, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['AFNORPDPPAFlowServiceApi.downloadFlowProxyApiV1AfnorFlowV1FlowsFlowIdGet']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * Check Flow Service availability
+         * Check Flow Service availability (AFNOR XP Z12-013 compliant)
          * @summary Healthcheck Flow Service
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async flowHealthcheckProxyApiV1AfnorFlowV1HealthcheckGet(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<any>> {
+        async flowHealthcheckProxyApiV1AfnorFlowV1HealthcheckGet(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<object>> {
             const localVarAxiosArgs = await localVarAxiosParamCreator.flowHealthcheckProxyApiV1AfnorFlowV1HealthcheckGet(options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['AFNORPDPPAFlowServiceApi.flowHealthcheckProxyApiV1AfnorFlowV1HealthcheckGet']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * Search invoicing flows by criteria (uses JWT client_uid)
+         * Search invoicing flows by criteria (AFNOR XP Z12-013 compliant)
          * @summary Search flows
+         * @param {AFNORSearchFlowParams} aFNORSearchFlowParams 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async searchFlowsProxyApiV1AfnorFlowV1FlowsSearchPost(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<any>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.searchFlowsProxyApiV1AfnorFlowV1FlowsSearchPost(options);
+        async searchFlowsProxyApiV1AfnorFlowV1FlowsSearchPost(aFNORSearchFlowParams: AFNORSearchFlowParams, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AFNORSearchFlowContent>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.searchFlowsProxyApiV1AfnorFlowV1FlowsSearchPost(aFNORSearchFlowParams, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['AFNORPDPPAFlowServiceApi.searchFlowsProxyApiV1AfnorFlowV1FlowsSearchPost']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -201,11 +244,13 @@ export const AFNORPDPPAFlowServiceApiFp = function(configuration?: Configuration
         /**
          * Submits an electronic invoice to a Partner Dematerialization Platform (PDP) in compliance with the AFNOR XP Z12-013 standard
          * @summary Submit an invoicing flow
+         * @param {AFNORFlowInfo} flowInfo 
+         * @param {File} file Flow file (PDF/A-3 with embedded XML or XML)
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async submitFlowProxyApiV1AfnorFlowV1FlowsPost(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<any>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.submitFlowProxyApiV1AfnorFlowV1FlowsPost(options);
+        async submitFlowProxyApiV1AfnorFlowV1FlowsPost(flowInfo: AFNORFlowInfo, file: File, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<any>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.submitFlowProxyApiV1AfnorFlowV1FlowsPost(flowInfo, file, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['AFNORPDPPAFlowServiceApi.submitFlowProxyApiV1AfnorFlowV1FlowsPost']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -220,41 +265,45 @@ export const AFNORPDPPAFlowServiceApiFactory = function (configuration?: Configu
     const localVarFp = AFNORPDPPAFlowServiceApiFp(configuration)
     return {
         /**
-         * Download the PDF/A-3 file of an invoicing flow (uses JWT client_uid)
+         * Download a file related to a given flow (AFNOR XP Z12-013 compliant): - Metadata [Default]: provides the flow metadata as JSON - Original: the document initially sent by the emitter - Converted: the document optionally converted by the system - ReadableView: the document optionally generated as readable file
          * @summary Download a flow
-         * @param {string} flowId 
+         * @param {string} flowId AFNOR flow identifier (UUID)
+         * @param {DocType} [docType] Type of file to download: Metadata (default, JSON), Original, Converted, or ReadableView
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        downloadFlowProxyApiV1AfnorFlowV1FlowsFlowIdGet(flowId: string, options?: RawAxiosRequestConfig): AxiosPromise<any> {
-            return localVarFp.downloadFlowProxyApiV1AfnorFlowV1FlowsFlowIdGet(flowId, options).then((request) => request(axios, basePath));
+        downloadFlowProxyApiV1AfnorFlowV1FlowsFlowIdGet(flowId: string, docType?: DocType, options?: RawAxiosRequestConfig): AxiosPromise<AFNORFlow> {
+            return localVarFp.downloadFlowProxyApiV1AfnorFlowV1FlowsFlowIdGet(flowId, docType, options).then((request) => request(axios, basePath));
         },
         /**
-         * Check Flow Service availability
+         * Check Flow Service availability (AFNOR XP Z12-013 compliant)
          * @summary Healthcheck Flow Service
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        flowHealthcheckProxyApiV1AfnorFlowV1HealthcheckGet(options?: RawAxiosRequestConfig): AxiosPromise<any> {
+        flowHealthcheckProxyApiV1AfnorFlowV1HealthcheckGet(options?: RawAxiosRequestConfig): AxiosPromise<object> {
             return localVarFp.flowHealthcheckProxyApiV1AfnorFlowV1HealthcheckGet(options).then((request) => request(axios, basePath));
         },
         /**
-         * Search invoicing flows by criteria (uses JWT client_uid)
+         * Search invoicing flows by criteria (AFNOR XP Z12-013 compliant)
          * @summary Search flows
+         * @param {AFNORSearchFlowParams} aFNORSearchFlowParams 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        searchFlowsProxyApiV1AfnorFlowV1FlowsSearchPost(options?: RawAxiosRequestConfig): AxiosPromise<any> {
-            return localVarFp.searchFlowsProxyApiV1AfnorFlowV1FlowsSearchPost(options).then((request) => request(axios, basePath));
+        searchFlowsProxyApiV1AfnorFlowV1FlowsSearchPost(aFNORSearchFlowParams: AFNORSearchFlowParams, options?: RawAxiosRequestConfig): AxiosPromise<AFNORSearchFlowContent> {
+            return localVarFp.searchFlowsProxyApiV1AfnorFlowV1FlowsSearchPost(aFNORSearchFlowParams, options).then((request) => request(axios, basePath));
         },
         /**
          * Submits an electronic invoice to a Partner Dematerialization Platform (PDP) in compliance with the AFNOR XP Z12-013 standard
          * @summary Submit an invoicing flow
+         * @param {AFNORFlowInfo} flowInfo 
+         * @param {File} file Flow file (PDF/A-3 with embedded XML or XML)
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        submitFlowProxyApiV1AfnorFlowV1FlowsPost(options?: RawAxiosRequestConfig): AxiosPromise<any> {
-            return localVarFp.submitFlowProxyApiV1AfnorFlowV1FlowsPost(options).then((request) => request(axios, basePath));
+        submitFlowProxyApiV1AfnorFlowV1FlowsPost(flowInfo: AFNORFlowInfo, file: File, options?: RawAxiosRequestConfig): AxiosPromise<any> {
+            return localVarFp.submitFlowProxyApiV1AfnorFlowV1FlowsPost(flowInfo, file, options).then((request) => request(axios, basePath));
         },
     };
 };
@@ -264,18 +313,19 @@ export const AFNORPDPPAFlowServiceApiFactory = function (configuration?: Configu
  */
 export class AFNORPDPPAFlowServiceApi extends BaseAPI {
     /**
-     * Download the PDF/A-3 file of an invoicing flow (uses JWT client_uid)
+     * Download a file related to a given flow (AFNOR XP Z12-013 compliant): - Metadata [Default]: provides the flow metadata as JSON - Original: the document initially sent by the emitter - Converted: the document optionally converted by the system - ReadableView: the document optionally generated as readable file
      * @summary Download a flow
-     * @param {string} flowId 
+     * @param {string} flowId AFNOR flow identifier (UUID)
+     * @param {DocType} [docType] Type of file to download: Metadata (default, JSON), Original, Converted, or ReadableView
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    public downloadFlowProxyApiV1AfnorFlowV1FlowsFlowIdGet(flowId: string, options?: RawAxiosRequestConfig) {
-        return AFNORPDPPAFlowServiceApiFp(this.configuration).downloadFlowProxyApiV1AfnorFlowV1FlowsFlowIdGet(flowId, options).then((request) => request(this.axios, this.basePath));
+    public downloadFlowProxyApiV1AfnorFlowV1FlowsFlowIdGet(flowId: string, docType?: DocType, options?: RawAxiosRequestConfig) {
+        return AFNORPDPPAFlowServiceApiFp(this.configuration).downloadFlowProxyApiV1AfnorFlowV1FlowsFlowIdGet(flowId, docType, options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
-     * Check Flow Service availability
+     * Check Flow Service availability (AFNOR XP Z12-013 compliant)
      * @summary Healthcheck Flow Service
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -285,23 +335,26 @@ export class AFNORPDPPAFlowServiceApi extends BaseAPI {
     }
 
     /**
-     * Search invoicing flows by criteria (uses JWT client_uid)
+     * Search invoicing flows by criteria (AFNOR XP Z12-013 compliant)
      * @summary Search flows
+     * @param {AFNORSearchFlowParams} aFNORSearchFlowParams 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    public searchFlowsProxyApiV1AfnorFlowV1FlowsSearchPost(options?: RawAxiosRequestConfig) {
-        return AFNORPDPPAFlowServiceApiFp(this.configuration).searchFlowsProxyApiV1AfnorFlowV1FlowsSearchPost(options).then((request) => request(this.axios, this.basePath));
+    public searchFlowsProxyApiV1AfnorFlowV1FlowsSearchPost(aFNORSearchFlowParams: AFNORSearchFlowParams, options?: RawAxiosRequestConfig) {
+        return AFNORPDPPAFlowServiceApiFp(this.configuration).searchFlowsProxyApiV1AfnorFlowV1FlowsSearchPost(aFNORSearchFlowParams, options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
      * Submits an electronic invoice to a Partner Dematerialization Platform (PDP) in compliance with the AFNOR XP Z12-013 standard
      * @summary Submit an invoicing flow
+     * @param {AFNORFlowInfo} flowInfo 
+     * @param {File} file Flow file (PDF/A-3 with embedded XML or XML)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    public submitFlowProxyApiV1AfnorFlowV1FlowsPost(options?: RawAxiosRequestConfig) {
-        return AFNORPDPPAFlowServiceApiFp(this.configuration).submitFlowProxyApiV1AfnorFlowV1FlowsPost(options).then((request) => request(this.axios, this.basePath));
+    public submitFlowProxyApiV1AfnorFlowV1FlowsPost(flowInfo: AFNORFlowInfo, file: File, options?: RawAxiosRequestConfig) {
+        return AFNORPDPPAFlowServiceApiFp(this.configuration).submitFlowProxyApiV1AfnorFlowV1FlowsPost(flowInfo, file, options).then((request) => request(this.axios, this.basePath));
     }
 }
 

package/api/chorus-pro-api.ts

@@ -2,10 +2,10 @@
 /* eslint-disable */
 /**
  * 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/     
+ *  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://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://factpulse.fr/accounts/password/set/ - Once the password is created, you can use the API  **Request example:** ```bash curl -X POST https://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://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://factpulse.fr/api/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://factpulse.fr/documentation-api/     
  *
  * The version of the OpenAPI document: 1.0.0
- * 
+ * Contact: contact@factpulse.fr
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
  * https://openapi-generator.tech
@@ -22,6 +22,8 @@ import { DUMMY_BASE_URL, assertParamExists, setApiKeyToObject, setBasicAuthToObj
 // @ts-ignore
 import { BASE_PATH, COLLECTION_FORMATS, type RequestArgs, BaseAPI, RequiredError, operationServerMap } from '../base';
 // @ts-ignore
+import type { APIError } from '../models';
+// @ts-ignore
 import type { GetChorusProIdRequest } from '../models';
 // @ts-ignore
 import type { GetChorusProIdResponse } from '../models';
@@ -209,7 +211,7 @@ export const ChorusProApiAxiosParamCreator = function (configuration?: Configura
         /**
          * Retrieves the list of active services for a public structure.      **Use cases**:     - List available services for an administration     - Verify that a service code exists before submitting an invoice      **Returns**:     - List of services with their code, label, and status (active/inactive)
          * @summary List structure services
-         * @param {number} idStructureCpp 
+         * @param {number} idStructureCpp Chorus Pro structure ID (idStructureCPP)
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -557,7 +559,7 @@ export const ChorusProApiAxiosParamCreator = function (configuration?: Configura
             };
         },
         /**
-         * 
+         * Retrieves detailed information about an invoice for validators.  **Use case**: Called by validators (public sector) to consult invoice details before approving or rejecting it.  **Required payload**: ```json {   \"idFacture\": 123456789 } ```  **Returns**: Complete invoice details including amounts, dates, attachments, and current status.
          * @summary Consult an invoice (Validator)
          * @param {{ [key: string]: any; }} requestBody 
          * @param {*} [options] Override http request option.
@@ -737,7 +739,7 @@ export const ChorusProApiFp = function(configuration?: Configuration) {
         /**
          * Retrieves the list of active services for a public structure.      **Use cases**:     - List available services for an administration     - Verify that a service code exists before submitting an invoice      **Returns**:     - List of services with their code, label, and status (active/inactive)
          * @summary List structure services
-         * @param {number} idStructureCpp 
+         * @param {number} idStructureCpp Chorus Pro structure ID (idStructureCPP)
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -852,7 +854,7 @@ export const ChorusProApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * 
+         * Retrieves detailed information about an invoice for validators.  **Use case**: Called by validators (public sector) to consult invoice details before approving or rejecting it.  **Required payload**: ```json {   \"idFacture\": 123456789 } ```  **Returns**: Complete invoice details including amounts, dates, attachments, and current status.
          * @summary Consult an invoice (Validator)
          * @param {{ [key: string]: any; }} requestBody 
          * @param {*} [options] Override http request option.
@@ -942,7 +944,7 @@ export const ChorusProApiFactory = function (configuration?: Configuration, base
         /**
          * Retrieves the list of active services for a public structure.      **Use cases**:     - List available services for an administration     - Verify that a service code exists before submitting an invoice      **Returns**:     - List of services with their code, label, and status (active/inactive)
          * @summary List structure services
-         * @param {number} idStructureCpp 
+         * @param {number} idStructureCpp Chorus Pro structure ID (idStructureCPP)
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -1030,7 +1032,7 @@ export const ChorusProApiFactory = function (configuration?: Configuration, base
             return localVarFp.traiterFactureRecueApiV1ChorusProFacturesTraiterFactureRecuePost(requestBody, options).then((request) => request(axios, basePath));
         },
         /**
-         * 
+         * Retrieves detailed information about an invoice for validators.  **Use case**: Called by validators (public sector) to consult invoice details before approving or rejecting it.  **Required payload**: ```json {   \"idFacture\": 123456789 } ```  **Returns**: Complete invoice details including amounts, dates, attachments, and current status.
          * @summary Consult an invoice (Validator)
          * @param {{ [key: string]: any; }} requestBody 
          * @param {*} [options] Override http request option.
@@ -1113,7 +1115,7 @@ export class ChorusProApi extends BaseAPI {
     /**
      * Retrieves the list of active services for a public structure.      **Use cases**:     - List available services for an administration     - Verify that a service code exists before submitting an invoice      **Returns**:     - List of services with their code, label, and status (active/inactive)
      * @summary List structure services
-     * @param {number} idStructureCpp 
+     * @param {number} idStructureCpp Chorus Pro structure ID (idStructureCPP)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -1210,7 +1212,7 @@ export class ChorusProApi extends BaseAPI {
     }
 
     /**
-     * 
+     * Retrieves detailed information about an invoice for validators.  **Use case**: Called by validators (public sector) to consult invoice details before approving or rejecting it.  **Required payload**: ```json {   \"idFacture\": 123456789 } ```  **Returns**: Complete invoice details including amounts, dates, attachments, and current status.
      * @summary Consult an invoice (Validator)
      * @param {{ [key: string]: any; }} requestBody 
      * @param {*} [options] Override http request option.