factpulse 3.0.7__py3-none-any.whl → 3.0.23__py3-none-any.whl

factpulse/api/document_conversion_api.py

@@ -3,9 +3,10 @@
 """
     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
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
@@ -20,6 +21,7 @@ from pydantic import Field, StrictBytes, StrictStr
 from typing import Any, Dict, Optional, Tuple, Union
 from typing_extensions import Annotated
 from factpulse.models.convert_resume_request import ConvertResumeRequest
+from factpulse.models.convert_success_response import ConvertSuccessResponse
 
 from factpulse.api_client import ApiClient, RequestSerialized
 from factpulse.api_response import ApiResponse
@@ -39,325 +41,13 @@ class DocumentConversionApi:
         self.api_client = api_client
 
 
-    @validate_call
-    def convert_document_api_v1_convert_post(
-        self,
-        file: Annotated[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]], Field(description="Document à convertir (PDF, DOCX, XLSX, JPG, PNG)")],
-        output: Annotated[Optional[StrictStr], Field(description="Format de sortie: pdf, xml, both")] = None,
-        callback_url: Optional[StrictStr] = None,
-        _request_timeout: Union[
-            None,
-            Annotated[StrictFloat, Field(gt=0)],
-            Tuple[
-                Annotated[StrictFloat, Field(gt=0)],
-                Annotated[StrictFloat, Field(gt=0)]
-            ]
-        ] = None,
-        _request_auth: Optional[Dict[StrictStr, Any]] = None,
-        _content_type: Optional[StrictStr] = None,
-        _headers: Optional[Dict[StrictStr, Any]] = None,
-        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> ConvertSuccessResponse:
-        """Convertir un document en Factur-X
-
-        Convertit un document (PDF, DOCX, XLSX, image) en Factur-X conforme.  ## Workflow  1. **Upload** : Le document est envoyé en multipart/form-data 2. **Extraction OCR + Classification** : Mistral OCR extrait les données et classifie le document en un seul appel 3. **Enrichissement** : Les données sont enrichies via SIRENE (SIRET → raison sociale) 4. **Validation** : Les règles Schematron sont appliquées 5. **Génération** : Le Factur-X PDF/A-3 est généré  ## Réponses possibles  - **200** : Conversion réussie, fichiers disponibles - **202** : Données manquantes, complétion requise - **422** : Validation échouée, corrections nécessaires - **400** : Fichier invalide - **429** : Quota dépassé
-
-        :param file: Document à convertir (PDF, DOCX, XLSX, JPG, PNG) (required)
-        :type file: bytearray
-        :param output: Format de sortie: pdf, xml, both
-        :type output: str
-        :param callback_url:
-        :type callback_url: str
-        :param _request_timeout: timeout setting for this request. If one
-                                 number provided, it will be total request
-                                 timeout. It can also be a pair (tuple) of
-                                 (connection, read) timeouts.
-        :type _request_timeout: int, tuple(int, int), optional
-        :param _request_auth: set to override the auth_settings for an a single
-                              request; this effectively ignores the
-                              authentication in the spec for a single request.
-        :type _request_auth: dict, optional
-        :param _content_type: force content-type for the request.
-        :type _content_type: str, Optional
-        :param _headers: set to override the headers for a single
-                         request; this effectively ignores the headers
-                         in the spec for a single request.
-        :type _headers: dict, optional
-        :param _host_index: set to override the host_index for a single
-                            request; this effectively ignores the host_index
-                            in the spec for a single request.
-        :type _host_index: int, optional
-        :return: Returns the result object.
-        """ # noqa: E501
-
-        _param = self._convert_document_api_v1_convert_post_serialize(
-            file=file,
-            output=output,
-            callback_url=callback_url,
-            _request_auth=_request_auth,
-            _content_type=_content_type,
-            _headers=_headers,
-            _host_index=_host_index
-        )
-
-        _response_types_map: Dict[str, Optional[str]] = {
-            '200': "ConvertSuccessResponse",
-            '202': "ConvertPendingInputResponse",
-            '422': "ConvertValidationFailedResponse",
-            '400': "ConvertErrorResponse",
-        }
-        response_data = self.api_client.call_api(
-            *_param,
-            _request_timeout=_request_timeout
-        )
-        response_data.read()
-        return self.api_client.response_deserialize(
-            response_data=response_data,
-            response_types_map=_response_types_map,
-        ).data
-
-
-    @validate_call
-    def convert_document_api_v1_convert_post_with_http_info(
-        self,
-        file: Annotated[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]], Field(description="Document à convertir (PDF, DOCX, XLSX, JPG, PNG)")],
-        output: Annotated[Optional[StrictStr], Field(description="Format de sortie: pdf, xml, both")] = None,
-        callback_url: Optional[StrictStr] = None,
-        _request_timeout: Union[
-            None,
-            Annotated[StrictFloat, Field(gt=0)],
-            Tuple[
-                Annotated[StrictFloat, Field(gt=0)],
-                Annotated[StrictFloat, Field(gt=0)]
-            ]
-        ] = None,
-        _request_auth: Optional[Dict[StrictStr, Any]] = None,
-        _content_type: Optional[StrictStr] = None,
-        _headers: Optional[Dict[StrictStr, Any]] = None,
-        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> ApiResponse[ConvertSuccessResponse]:
-        """Convertir un document en Factur-X
-
-        Convertit un document (PDF, DOCX, XLSX, image) en Factur-X conforme.  ## Workflow  1. **Upload** : Le document est envoyé en multipart/form-data 2. **Extraction OCR + Classification** : Mistral OCR extrait les données et classifie le document en un seul appel 3. **Enrichissement** : Les données sont enrichies via SIRENE (SIRET → raison sociale) 4. **Validation** : Les règles Schematron sont appliquées 5. **Génération** : Le Factur-X PDF/A-3 est généré  ## Réponses possibles  - **200** : Conversion réussie, fichiers disponibles - **202** : Données manquantes, complétion requise - **422** : Validation échouée, corrections nécessaires - **400** : Fichier invalide - **429** : Quota dépassé
-
-        :param file: Document à convertir (PDF, DOCX, XLSX, JPG, PNG) (required)
-        :type file: bytearray
-        :param output: Format de sortie: pdf, xml, both
-        :type output: str
-        :param callback_url:
-        :type callback_url: str
-        :param _request_timeout: timeout setting for this request. If one
-                                 number provided, it will be total request
-                                 timeout. It can also be a pair (tuple) of
-                                 (connection, read) timeouts.
-        :type _request_timeout: int, tuple(int, int), optional
-        :param _request_auth: set to override the auth_settings for an a single
-                              request; this effectively ignores the
-                              authentication in the spec for a single request.
-        :type _request_auth: dict, optional
-        :param _content_type: force content-type for the request.
-        :type _content_type: str, Optional
-        :param _headers: set to override the headers for a single
-                         request; this effectively ignores the headers
-                         in the spec for a single request.
-        :type _headers: dict, optional
-        :param _host_index: set to override the host_index for a single
-                            request; this effectively ignores the host_index
-                            in the spec for a single request.
-        :type _host_index: int, optional
-        :return: Returns the result object.
-        """ # noqa: E501
-
-        _param = self._convert_document_api_v1_convert_post_serialize(
-            file=file,
-            output=output,
-            callback_url=callback_url,
-            _request_auth=_request_auth,
-            _content_type=_content_type,
-            _headers=_headers,
-            _host_index=_host_index
-        )
-
-        _response_types_map: Dict[str, Optional[str]] = {
-            '200': "ConvertSuccessResponse",
-            '202': "ConvertPendingInputResponse",
-            '422': "ConvertValidationFailedResponse",
-            '400': "ConvertErrorResponse",
-        }
-        response_data = self.api_client.call_api(
-            *_param,
-            _request_timeout=_request_timeout
-        )
-        response_data.read()
-        return self.api_client.response_deserialize(
-            response_data=response_data,
-            response_types_map=_response_types_map,
-        )
-
-
-    @validate_call
-    def convert_document_api_v1_convert_post_without_preload_content(
-        self,
-        file: Annotated[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]], Field(description="Document à convertir (PDF, DOCX, XLSX, JPG, PNG)")],
-        output: Annotated[Optional[StrictStr], Field(description="Format de sortie: pdf, xml, both")] = None,
-        callback_url: Optional[StrictStr] = None,
-        _request_timeout: Union[
-            None,
-            Annotated[StrictFloat, Field(gt=0)],
-            Tuple[
-                Annotated[StrictFloat, Field(gt=0)],
-                Annotated[StrictFloat, Field(gt=0)]
-            ]
-        ] = None,
-        _request_auth: Optional[Dict[StrictStr, Any]] = None,
-        _content_type: Optional[StrictStr] = None,
-        _headers: Optional[Dict[StrictStr, Any]] = None,
-        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> RESTResponseType:
-        """Convertir un document en Factur-X
-
-        Convertit un document (PDF, DOCX, XLSX, image) en Factur-X conforme.  ## Workflow  1. **Upload** : Le document est envoyé en multipart/form-data 2. **Extraction OCR + Classification** : Mistral OCR extrait les données et classifie le document en un seul appel 3. **Enrichissement** : Les données sont enrichies via SIRENE (SIRET → raison sociale) 4. **Validation** : Les règles Schematron sont appliquées 5. **Génération** : Le Factur-X PDF/A-3 est généré  ## Réponses possibles  - **200** : Conversion réussie, fichiers disponibles - **202** : Données manquantes, complétion requise - **422** : Validation échouée, corrections nécessaires - **400** : Fichier invalide - **429** : Quota dépassé
-
-        :param file: Document à convertir (PDF, DOCX, XLSX, JPG, PNG) (required)
-        :type file: bytearray
-        :param output: Format de sortie: pdf, xml, both
-        :type output: str
-        :param callback_url:
-        :type callback_url: str
-        :param _request_timeout: timeout setting for this request. If one
-                                 number provided, it will be total request
-                                 timeout. It can also be a pair (tuple) of
-                                 (connection, read) timeouts.
-        :type _request_timeout: int, tuple(int, int), optional
-        :param _request_auth: set to override the auth_settings for an a single
-                              request; this effectively ignores the
-                              authentication in the spec for a single request.
-        :type _request_auth: dict, optional
-        :param _content_type: force content-type for the request.
-        :type _content_type: str, Optional
-        :param _headers: set to override the headers for a single
-                         request; this effectively ignores the headers
-                         in the spec for a single request.
-        :type _headers: dict, optional
-        :param _host_index: set to override the host_index for a single
-                            request; this effectively ignores the host_index
-                            in the spec for a single request.
-        :type _host_index: int, optional
-        :return: Returns the result object.
-        """ # noqa: E501
-
-        _param = self._convert_document_api_v1_convert_post_serialize(
-            file=file,
-            output=output,
-            callback_url=callback_url,
-            _request_auth=_request_auth,
-            _content_type=_content_type,
-            _headers=_headers,
-            _host_index=_host_index
-        )
-
-        _response_types_map: Dict[str, Optional[str]] = {
-            '200': "ConvertSuccessResponse",
-            '202': "ConvertPendingInputResponse",
-            '422': "ConvertValidationFailedResponse",
-            '400': "ConvertErrorResponse",
-        }
-        response_data = self.api_client.call_api(
-            *_param,
-            _request_timeout=_request_timeout
-        )
-        return response_data.response
-
-
-    def _convert_document_api_v1_convert_post_serialize(
-        self,
-        file,
-        output,
-        callback_url,
-        _request_auth,
-        _content_type,
-        _headers,
-        _host_index,
-    ) -> RequestSerialized:
-
-        _host = None
-
-        _collection_formats: Dict[str, str] = {
-        }
-
-        _path_params: Dict[str, str] = {}
-        _query_params: List[Tuple[str, str]] = []
-        _header_params: Dict[str, Optional[str]] = _headers or {}
-        _form_params: List[Tuple[str, str]] = []
-        _files: Dict[
-            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
-        ] = {}
-        _body_params: Optional[bytes] = None
-
-        # process the path parameters
-        # process the query parameters
-        # process the header parameters
-        # process the form parameters
-        if file is not None:
-            _files['file'] = file
-        if output is not None:
-            _form_params.append(('output', output))
-        if callback_url is not None:
-            _form_params.append(('callback_url', callback_url))
-        # process the body parameter
-
-
-        # set the HTTP header `Accept`
-        if 'Accept' not in _header_params:
-            _header_params['Accept'] = self.api_client.select_header_accept(
-                [
-                    'application/json'
-                ]
-            )
-
-        # set the HTTP header `Content-Type`
-        if _content_type:
-            _header_params['Content-Type'] = _content_type
-        else:
-            _default_content_type = (
-                self.api_client.select_header_content_type(
-                    [
-                        'multipart/form-data'
-                    ]
-                )
-            )
-            if _default_content_type is not None:
-                _header_params['Content-Type'] = _default_content_type
-
-        # authentication setting
-        _auth_settings: List[str] = [
-            'HTTPBearer'
-        ]
-
-        return self.api_client.param_serialize(
-            method='POST',
-            resource_path='/api/v1/convert',
-            path_params=_path_params,
-            query_params=_query_params,
-            header_params=_header_params,
-            body=_body_params,
-            post_params=_form_params,
-            files=_files,
-            auth_settings=_auth_settings,
-            collection_formats=_collection_formats,
-            _host=_host,
-            _request_auth=_request_auth
-        )
-
-
-
-
     @validate_call
     def convert_document_async_api_v1_convert_async_post(
         self,
         file: Annotated[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]], Field(description="Document à convertir (PDF, DOCX, XLSX, JPG, PNG)")],
         output: Annotated[Optional[StrictStr], Field(description="Format de sortie: pdf, xml, both")] = None,
         callback_url: Optional[StrictStr] = None,
+        webhook_mode: Annotated[Optional[StrictStr], Field(description="Mode de livraison du contenu: 'inline' (base64 dans webhook) ou 'download_url' (URL temporaire 1h)")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -381,6 +71,8 @@ class DocumentConversionApi:
         :type output: str
         :param callback_url:
         :type callback_url: str
+        :param webhook_mode: Mode de livraison du contenu: 'inline' (base64 dans webhook) ou 'download_url' (URL temporaire 1h)
+        :type webhook_mode: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -407,6 +99,7 @@ class DocumentConversionApi:
             file=file,
             output=output,
             callback_url=callback_url,
+            webhook_mode=webhook_mode,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -418,6 +111,7 @@ class DocumentConversionApi:
             '202': None,
             '400': None,
             '422': "HTTPValidationError",
+            '401': "APIError",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -436,6 +130,7 @@ class DocumentConversionApi:
         file: Annotated[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]], Field(description="Document à convertir (PDF, DOCX, XLSX, JPG, PNG)")],
         output: Annotated[Optional[StrictStr], Field(description="Format de sortie: pdf, xml, both")] = None,
         callback_url: Optional[StrictStr] = None,
+        webhook_mode: Annotated[Optional[StrictStr], Field(description="Mode de livraison du contenu: 'inline' (base64 dans webhook) ou 'download_url' (URL temporaire 1h)")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -459,6 +154,8 @@ class DocumentConversionApi:
         :type output: str
         :param callback_url:
         :type callback_url: str
+        :param webhook_mode: Mode de livraison du contenu: 'inline' (base64 dans webhook) ou 'download_url' (URL temporaire 1h)
+        :type webhook_mode: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -485,6 +182,7 @@ class DocumentConversionApi:
             file=file,
             output=output,
             callback_url=callback_url,
+            webhook_mode=webhook_mode,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -496,6 +194,7 @@ class DocumentConversionApi:
             '202': None,
             '400': None,
             '422': "HTTPValidationError",
+            '401': "APIError",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -514,6 +213,7 @@ class DocumentConversionApi:
         file: Annotated[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]], Field(description="Document à convertir (PDF, DOCX, XLSX, JPG, PNG)")],
         output: Annotated[Optional[StrictStr], Field(description="Format de sortie: pdf, xml, both")] = None,
         callback_url: Optional[StrictStr] = None,
+        webhook_mode: Annotated[Optional[StrictStr], Field(description="Mode de livraison du contenu: 'inline' (base64 dans webhook) ou 'download_url' (URL temporaire 1h)")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -537,6 +237,8 @@ class DocumentConversionApi:
         :type output: str
         :param callback_url:
         :type callback_url: str
+        :param webhook_mode: Mode de livraison du contenu: 'inline' (base64 dans webhook) ou 'download_url' (URL temporaire 1h)
+        :type webhook_mode: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -563,6 +265,7 @@ class DocumentConversionApi:
             file=file,
             output=output,
             callback_url=callback_url,
+            webhook_mode=webhook_mode,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -574,6 +277,7 @@ class DocumentConversionApi:
             '202': None,
             '400': None,
             '422': "HTTPValidationError",
+            '401': "APIError",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -587,6 +291,7 @@ class DocumentConversionApi:
         file,
         output,
         callback_url,
+        webhook_mode,
         _request_auth,
         _content_type,
         _headers,
@@ -617,6 +322,8 @@ class DocumentConversionApi:
             _form_params.append(('output', output))
         if callback_url is not None:
             _form_params.append(('callback_url', callback_url))
+        if webhook_mode is not None:
+            _form_params.append(('webhook_mode', webhook_mode))
         # process the body parameter
 
 
@@ -668,8 +375,8 @@ class DocumentConversionApi:
     @validate_call
     def download_file_api_v1_convert_conversion_id_download_filename_get(
         self,
-        conversion_id: StrictStr,
-        filename: StrictStr,
+        conversion_id: Annotated[StrictStr, Field(description="Conversion ID returned by POST /convert (UUID format)")],
+        filename: Annotated[StrictStr, Field(description="File to download: 'facturx.pdf' or 'facturx.xml'")],
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -687,9 +394,9 @@ class DocumentConversionApi:
 
         Télécharge le fichier Factur-X PDF ou XML généré.  ## Fichiers disponibles  - `facturx.pdf` : PDF/A-3 avec XML embarqué - `facturx.xml` : XML CII seul (Cross Industry Invoice)  Les fichiers sont disponibles pendant 24 heures après génération.
 
-        :param conversion_id: (required)
+        :param conversion_id: Conversion ID returned by POST /convert (UUID format) (required)
         :type conversion_id: str
-        :param filename: (required)
+        :param filename: File to download: 'facturx.pdf' or 'facturx.xml' (required)
         :type filename: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -726,6 +433,7 @@ class DocumentConversionApi:
             '200': "object",
             '404': None,
             '422': "HTTPValidationError",
+            '401': "APIError",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -741,8 +449,8 @@ class DocumentConversionApi:
     @validate_call
     def download_file_api_v1_convert_conversion_id_download_filename_get_with_http_info(
         self,
-        conversion_id: StrictStr,
-        filename: StrictStr,
+        conversion_id: Annotated[StrictStr, Field(description="Conversion ID returned by POST /convert (UUID format)")],
+        filename: Annotated[StrictStr, Field(description="File to download: 'facturx.pdf' or 'facturx.xml'")],
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -760,9 +468,9 @@ class DocumentConversionApi:
 
         Télécharge le fichier Factur-X PDF ou XML généré.  ## Fichiers disponibles  - `facturx.pdf` : PDF/A-3 avec XML embarqué - `facturx.xml` : XML CII seul (Cross Industry Invoice)  Les fichiers sont disponibles pendant 24 heures après génération.
 
-        :param conversion_id: (required)
+        :param conversion_id: Conversion ID returned by POST /convert (UUID format) (required)
         :type conversion_id: str
-        :param filename: (required)
+        :param filename: File to download: 'facturx.pdf' or 'facturx.xml' (required)
         :type filename: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -799,6 +507,7 @@ class DocumentConversionApi:
             '200': "object",
             '404': None,
             '422': "HTTPValidationError",
+            '401': "APIError",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -814,8 +523,8 @@ class DocumentConversionApi:
     @validate_call
     def download_file_api_v1_convert_conversion_id_download_filename_get_without_preload_content(
         self,
-        conversion_id: StrictStr,
-        filename: StrictStr,
+        conversion_id: Annotated[StrictStr, Field(description="Conversion ID returned by POST /convert (UUID format)")],
+        filename: Annotated[StrictStr, Field(description="File to download: 'facturx.pdf' or 'facturx.xml'")],
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -833,9 +542,9 @@ class DocumentConversionApi:
 
         Télécharge le fichier Factur-X PDF ou XML généré.  ## Fichiers disponibles  - `facturx.pdf` : PDF/A-3 avec XML embarqué - `facturx.xml` : XML CII seul (Cross Industry Invoice)  Les fichiers sont disponibles pendant 24 heures après génération.
 
-        :param conversion_id: (required)
+        :param conversion_id: Conversion ID returned by POST /convert (UUID format) (required)
         :type conversion_id: str
-        :param filename: (required)
+        :param filename: File to download: 'facturx.pdf' or 'facturx.xml' (required)
         :type filename: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -872,6 +581,7 @@ class DocumentConversionApi:
             '200': "object",
             '404': None,
             '422': "HTTPValidationError",
+            '401': "APIError",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -950,7 +660,7 @@ class DocumentConversionApi:
     @validate_call
     def get_conversion_status_api_v1_convert_conversion_id_status_get(
         self,
-        conversion_id: StrictStr,
+        conversion_id: Annotated[StrictStr, Field(description="Conversion ID returned by POST /convert (UUID format)")],
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -968,7 +678,7 @@ class DocumentConversionApi:
 
         Retourne le statut actuel d'une conversion asynchrone.
 
-        :param conversion_id: (required)
+        :param conversion_id: Conversion ID returned by POST /convert (UUID format) (required)
         :type conversion_id: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -1003,6 +713,7 @@ class DocumentConversionApi:
         _response_types_map: Dict[str, Optional[str]] = {
             '200': "Dict[str, object]",
             '422': "HTTPValidationError",
+            '401': "APIError",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -1018,7 +729,7 @@ class DocumentConversionApi:
     @validate_call
     def get_conversion_status_api_v1_convert_conversion_id_status_get_with_http_info(
         self,
-        conversion_id: StrictStr,
+        conversion_id: Annotated[StrictStr, Field(description="Conversion ID returned by POST /convert (UUID format)")],
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -1036,7 +747,7 @@ class DocumentConversionApi:
 
         Retourne le statut actuel d'une conversion asynchrone.
 
-        :param conversion_id: (required)
+        :param conversion_id: Conversion ID returned by POST /convert (UUID format) (required)
         :type conversion_id: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -1071,6 +782,7 @@ class DocumentConversionApi:
         _response_types_map: Dict[str, Optional[str]] = {
             '200': "Dict[str, object]",
             '422': "HTTPValidationError",
+            '401': "APIError",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -1086,7 +798,7 @@ class DocumentConversionApi:
     @validate_call
     def get_conversion_status_api_v1_convert_conversion_id_status_get_without_preload_content(
         self,
-        conversion_id: StrictStr,
+        conversion_id: Annotated[StrictStr, Field(description="Conversion ID returned by POST /convert (UUID format)")],
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -1104,7 +816,7 @@ class DocumentConversionApi:
 
         Retourne le statut actuel d'une conversion asynchrone.
 
-        :param conversion_id: (required)
+        :param conversion_id: Conversion ID returned by POST /convert (UUID format) (required)
         :type conversion_id: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -1139,6 +851,7 @@ class DocumentConversionApi:
         _response_types_map: Dict[str, Optional[str]] = {
             '200': "Dict[str, object]",
             '422': "HTTPValidationError",
+            '401': "APIError",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -1214,7 +927,7 @@ class DocumentConversionApi:
     @validate_call
     def resume_conversion_api_v1_convert_conversion_id_resume_post(
         self,
-        conversion_id: StrictStr,
+        conversion_id: Annotated[StrictStr, Field(description="Conversion ID returned by POST /convert (UUID format)")],
         convert_resume_request: ConvertResumeRequest,
         _request_timeout: Union[
             None,
@@ -1233,7 +946,7 @@ class DocumentConversionApi:
 
         Reprend une conversion après complétion des données manquantes ou correction des erreurs.  L'extraction OCR est conservée, les données sont mises à jour avec les corrections, puis une nouvelle validation Schematron est effectuée.
 
-        :param conversion_id: (required)
+        :param conversion_id: Conversion ID returned by POST /convert (UUID format) (required)
         :type conversion_id: str
         :param convert_resume_request: (required)
         :type convert_resume_request: ConvertResumeRequest
@@ -1272,6 +985,7 @@ class DocumentConversionApi:
             '200': "ConvertSuccessResponse",
             '404': None,
             '422': "ConvertValidationFailedResponse",
+            '401': "APIError",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -1287,7 +1001,7 @@ class DocumentConversionApi:
     @validate_call
     def resume_conversion_api_v1_convert_conversion_id_resume_post_with_http_info(
         self,
-        conversion_id: StrictStr,
+        conversion_id: Annotated[StrictStr, Field(description="Conversion ID returned by POST /convert (UUID format)")],
         convert_resume_request: ConvertResumeRequest,
         _request_timeout: Union[
             None,
@@ -1306,7 +1020,7 @@ class DocumentConversionApi:
 
         Reprend une conversion après complétion des données manquantes ou correction des erreurs.  L'extraction OCR est conservée, les données sont mises à jour avec les corrections, puis une nouvelle validation Schematron est effectuée.
 
-        :param conversion_id: (required)
+        :param conversion_id: Conversion ID returned by POST /convert (UUID format) (required)
         :type conversion_id: str
         :param convert_resume_request: (required)
         :type convert_resume_request: ConvertResumeRequest
@@ -1345,6 +1059,7 @@ class DocumentConversionApi:
             '200': "ConvertSuccessResponse",
             '404': None,
             '422': "ConvertValidationFailedResponse",
+            '401': "APIError",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -1360,7 +1075,7 @@ class DocumentConversionApi:
     @validate_call
     def resume_conversion_api_v1_convert_conversion_id_resume_post_without_preload_content(
         self,
-        conversion_id: StrictStr,
+        conversion_id: Annotated[StrictStr, Field(description="Conversion ID returned by POST /convert (UUID format)")],
         convert_resume_request: ConvertResumeRequest,
         _request_timeout: Union[
             None,
@@ -1379,7 +1094,7 @@ class DocumentConversionApi:
 
         Reprend une conversion après complétion des données manquantes ou correction des erreurs.  L'extraction OCR est conservée, les données sont mises à jour avec les corrections, puis une nouvelle validation Schematron est effectuée.
 
-        :param conversion_id: (required)
+        :param conversion_id: Conversion ID returned by POST /convert (UUID format) (required)
         :type conversion_id: str
         :param convert_resume_request: (required)
         :type convert_resume_request: ConvertResumeRequest
@@ -1418,6 +1133,7 @@ class DocumentConversionApi:
             '200': "ConvertSuccessResponse",
             '404': None,
             '422': "ConvertValidationFailedResponse",
+            '401': "APIError",
         }
         response_data = self.api_client.call_api(
             *_param,