factpulse 4.0.2 → 4.1.2

data/docs/GenerationTaskStatusResult.md

@@ -0,0 +1,79 @@
+# FactPulse::GenerationTaskStatusResult
+
+## Class instance methods
+
+### `openapi_one_of`
+
+Returns the list of classes defined in oneOf.
+
+#### Example
+
+```ruby
+require 'factpulse'
+
+FactPulse::GenerationTaskStatusResult.openapi_one_of
+# =>
+# [
+#   :'GenerationSuccessResult',
+#   :'TaskErrorResult'
+# ]
+```
+
+### `openapi_discriminator_name`
+
+Returns the discriminator's property name.
+
+#### Example
+
+```ruby
+require 'factpulse'
+
+FactPulse::GenerationTaskStatusResult.openapi_discriminator_name
+# => :'status'
+```
+
+### `openapi_discriminator_name`
+
+Returns the discriminator's mapping.
+
+#### Example
+
+```ruby
+require 'factpulse'
+
+FactPulse::GenerationTaskStatusResult.openapi_discriminator_mapping
+# =>
+# {
+#   :'ERROR' => :'TaskErrorResult',
+#   :'SUCCESS' => :'GenerationSuccessResult'
+# }
+```
+
+### build
+
+Find the appropriate object from the `openapi_one_of` list and casts the data into it.
+
+#### Example
+
+```ruby
+require 'factpulse'
+
+FactPulse::GenerationTaskStatusResult.build(data)
+# => #<GenerationSuccessResult:0x00007fdd4aab02a0>
+
+FactPulse::GenerationTaskStatusResult.build(data_that_doesnt_match)
+# => nil
+```
+
+#### Parameters
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| **data** | **Mixed** | data to be matched against the list of oneOf items |
+
+#### Return type
+
+- `GenerationSuccessResult`
+- `TaskErrorResult`
+- `nil` (if no type matches)
+

data/docs/HealthApi.md

@@ -5,8 +5,6 @@ All URIs are relative to *https://factpulse.fr*
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
 | [**get_user_info_api_v1_me_get**](HealthApi.md#get_user_info_api_v1_me_get) | **GET** /api/v1/me | Get current user information |
-| [**healthcheck_healthcheck_get**](HealthApi.md#healthcheck_healthcheck_get) | **GET** /healthcheck | Docker healthcheck endpoint |
-| [**root_get**](HealthApi.md#root_get) | **GET** / | Check API status |
 
 
 ## get_user_info_api_v1_me_get
@@ -24,6 +22,11 @@ require 'time'
 require 'factpulse'
 # setup authorization
 FactPulse.configure do |config|
+  # Configure API key authorization: APIKeyHeader
+  config.api_key['X-API-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-API-Key'] = 'Bearer'
+
   # Configure Bearer authorization: HTTPBearer
   config.access_token = 'YOUR_BEARER_TOKEN'
 end
@@ -67,129 +70,7 @@ This endpoint does not need any parameter.
 
 ### Authorization
 
-[HTTPBearer](../README.md#HTTPBearer)
-
-### HTTP request headers
-
-- **Content-Type**: Not defined
-- **Accept**: application/json
-
-
-## healthcheck_healthcheck_get
-
-> Object healthcheck_healthcheck_get
-
-Docker healthcheck endpoint
-
-Healthcheck endpoint for Docker and load balancers.  Useful for: - Docker healthcheck - Kubernetes liveness/readiness probes - Load balancers (Nginx, HAProxy) - Availability monitoring - Zero downtime deployment  Returns a 200 code if the API is operational.
-
-### Examples
-
-```ruby
-require 'time'
-require 'factpulse'
-
-api_instance = FactPulse::HealthApi.new
-
-begin
-  # Docker healthcheck endpoint
-  result = api_instance.healthcheck_healthcheck_get
-  p result
-rescue FactPulse::ApiError => e
-  puts "Error when calling HealthApi->healthcheck_healthcheck_get: #{e}"
-end
-```
-
-#### Using the healthcheck_healthcheck_get_with_http_info variant
-
-This returns an Array which contains the response data, status code and headers.
-
-> <Array(Object, Integer, Hash)> healthcheck_healthcheck_get_with_http_info
-
-```ruby
-begin
-  # Docker healthcheck endpoint
-  data, status_code, headers = api_instance.healthcheck_healthcheck_get_with_http_info
-  p status_code # => 2xx
-  p headers # => { ... }
-  p data # => Object
-rescue FactPulse::ApiError => e
-  puts "Error when calling HealthApi->healthcheck_healthcheck_get_with_http_info: #{e}"
-end
-```
-
-### Parameters
-
-This endpoint does not need any parameter.
-
-### Return type
-
-**Object**
-
-### Authorization
-
-No authorization required
-
-### HTTP request headers
-
-- **Content-Type**: Not defined
-- **Accept**: application/json
-
-
-## root_get
-
-> Object root_get
-
-Check API status
-
-Health check endpoint to verify the API is responding.  Useful for: - Availability monitoring - Integration tests - Load balancers
-
-### Examples
-
-```ruby
-require 'time'
-require 'factpulse'
-
-api_instance = FactPulse::HealthApi.new
-
-begin
-  # Check API status
-  result = api_instance.root_get
-  p result
-rescue FactPulse::ApiError => e
-  puts "Error when calling HealthApi->root_get: #{e}"
-end
-```
-
-#### Using the root_get_with_http_info variant
-
-This returns an Array which contains the response data, status code and headers.
-
-> <Array(Object, Integer, Hash)> root_get_with_http_info
-
-```ruby
-begin
-  # Check API status
-  data, status_code, headers = api_instance.root_get_with_http_info
-  p status_code # => 2xx
-  p headers # => { ... }
-  p data # => Object
-rescue FactPulse::ApiError => e
-  puts "Error when calling HealthApi->root_get_with_http_info: #{e}"
-end
-```
-
-### Parameters
-
-This endpoint does not need any parameter.
-
-### Return type
-
-**Object**
-
-### Authorization
-
-No authorization required
+[APIKeyHeader](../README.md#APIKeyHeader), [HTTPBearer](../README.md#HTTPBearer)
 
 ### HTTP request headers
 

data/docs/{FacturXGenerationApi.md → InvoiceGenerationApi.md}

@@ -1,21 +1,21 @@
-# FactPulse::FacturXGenerationApi
+# FactPulse::InvoiceGenerationApi
 
 All URIs are relative to *https://factpulse.fr*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
-| [**generate_invoice_api_v1_processing_generate_invoice_post**](FacturXGenerationApi.md#generate_invoice_api_v1_processing_generate_invoice_post) | **POST** /api/v1/processing/generate-invoice | Generate a Factur-X invoice |
-| [**submit_complete_invoice_api_v1_processing_invoices_submit_complete_post**](FacturXGenerationApi.md#submit_complete_invoice_api_v1_processing_invoices_submit_complete_post) | **POST** /api/v1/processing/invoices/submit-complete | Submit a complete invoice (generation + signature + submission) |
-| [**submit_complete_invoice_async_api_v1_processing_invoices_submit_complete_async_post**](FacturXGenerationApi.md#submit_complete_invoice_async_api_v1_processing_invoices_submit_complete_async_post) | **POST** /api/v1/processing/invoices/submit-complete-async | Submit a complete invoice (asynchronous with Celery) |
+| [**generate_invoice_api_v1_processing_generate_invoice_post**](InvoiceGenerationApi.md#generate_invoice_api_v1_processing_generate_invoice_post) | **POST** /api/v1/processing/generate-invoice | Generate an electronic invoice (CII / UBL / Factur-X PDF) |
+| [**submit_complete_invoice_api_v1_processing_invoices_submit_complete_post**](InvoiceGenerationApi.md#submit_complete_invoice_api_v1_processing_invoices_submit_complete_post) | **POST** /api/v1/processing/invoices/submit-complete | Submit a complete invoice (generation + signature + submission) |
+| [**submit_complete_invoice_async_api_v1_processing_invoices_submit_complete_async_post**](InvoiceGenerationApi.md#submit_complete_invoice_async_api_v1_processing_invoices_submit_complete_async_post) | **POST** /api/v1/processing/invoices/submit-complete-async | Submit a complete invoice (asynchronous with Celery) |
 
 
 ## generate_invoice_api_v1_processing_generate_invoice_post
 
 > <TaskResponse> generate_invoice_api_v1_processing_generate_invoice_post(invoice_data, opts)
 
-Generate a Factur-X invoice
+Generate an electronic invoice (CII / UBL / Factur-X PDF)
 
-Generates an electronic invoice in Factur-X format compliant with European standards.  ## Applied Standards  - **Factur-X** (France): FNFE-MPE standard (Forum National de la Facture Électronique) - **ZUGFeRD** (Germany): German format compatible with Factur-X - **EN 16931**: European semantic standard for electronic invoicing - **ISO 19005-3** (PDF/A-3): Long-term electronic archiving - **Cross Industry Invoice (CII)**: UN/CEFACT XML syntax  ## 🆕 New: Simplified format with auto-enrichment (P0.1)  You can now create an invoice by providing only: - An invoice number - A supplier SIRET + **IBAN** (required) - A recipient SIRET - Invoice lines (description, quantity, net price)  **Simplified format example**: ```json {   \"number\": \"FACT-2025-001\",   \"supplier\": {     \"siret\": \"92019522900017\",     \"iban\": \"FR7630001007941234567890185\"   },   \"recipient\": {\"siret\": \"35600000000048\"},   \"lines\": [     {\"description\": \"Service\", \"quantity\": 10, \"unitPrice\": 100.00, \"vatRate\": 20.0}   ] } ```  **⚠️ Required fields (simplified format)**: - `number`: Unique invoice number - `supplier.siret`: Supplier's SIRET (14 digits) - `supplier.iban`: Bank account IBAN (no public API to retrieve it) - `recipient.siret`: Recipient's SIRET - `lines[]`: At least one invoice line  **What happens automatically with `auto_enrich=True`**: - ✅ Name enrichment from Chorus Pro API - ✅ Address enrichment from Business Search API (free, public) - ✅ Automatic intra-EU VAT calculation (FR + key + SIREN) - ✅ Chorus Pro ID retrieval for electronic invoicing - ✅ Net/VAT/Gross totals calculation - ✅ Date generation (today + 30-day due date) - ✅ Multi-rate VAT handling  **Supported identifiers**: - SIRET (14 digits): Specific establishment ⭐ Recommended - SIREN (9 digits): Company (auto-selection of headquarters) - Special types: UE_HORS_FRANCE, RIDET, TAHITI, etc.  ## Checks performed during generation  ### 1. Data validation (Pydantic) - Data types (amounts as Decimal, ISO 8601 dates) - Formats (14-digit SIRET, 9-digit SIREN, IBAN) - Required fields per profile - Amount consistency (Net + VAT = Gross)  ### 2. CII-compliant XML generation - Serialization according to Cross Industry Invoice XSD schema - Correct UN/CEFACT namespaces - Hierarchical structure respected - UTF-8 encoding without BOM  ### 3. Schematron validation - Business rules for selected profile (MINIMUM, BASIC, EN16931, EXTENDED) - Element cardinality (required, optional, repeatable) - Calculation rules (totals, VAT, discounts) - European EN 16931 compliance  ### 4. PDF/A-3 conversion (if output_format='pdf') - Source PDF conversion to PDF/A-3 via Ghostscript - Factur-X XML embedding in PDF - Compliant XMP metadata - ICC sRGB color profile - Removal of forbidden elements (JavaScript, forms)  ## How it works  1. **Submission**: Invoice is queued in Celery for asynchronous processing 2. **Immediate return**: You receive a `task_id` (HTTP 202 Accepted) 3. **Tracking**: Use the `/tasks/{task_id}/status` endpoint to track progress  ## Webhook notification (recommended)  Instead of polling, you can receive a webhook notification when the task completes:  ``` callback_url=https://your-server.com/webhook ```  The webhook will POST a JSON payload with: - `event_type`: `generation.completed` or `generation.failed` - `data.task_id`: The Celery task ID - `data.content_b64` or `data.xml_content`: The generated content - `X-Webhook-Signature` header for HMAC verification  See `/docs/WEBHOOKS.md` for full documentation.  ## Output formats  - **xml**: Generates only Factur-X XML (recommended for testing) - **pdf**: Generates PDF/A-3 with embedded XML (requires `source_pdf`)  ## Factur-X profiles  - **MINIMUM**: Minimal data (simplified invoice) - **BASIC**: Basic information (SMEs) - **EN16931**: European standard (recommended, compliant with directive 2014/55/EU) - **EXTENDED**: All available data (large accounts)  ## What you get  After successful processing (status `completed`): - **XML only**: Base64-encoded Factur-X compliant XML file - **PDF/A-3**: PDF with embedded XML, ready for sending/archiving - **Metadata**: Profile, Factur-X version, file size - **Validation**: Schematron compliance confirmation  ## Validation  Data is automatically validated according to detected format. On error, a 422 status is returned with invalid field details.
+Generates an electronic invoice compliant with European standards.  Supports **two XML syntaxes** defined by EN 16931: - **CII** (Cross-Industry Invoice, UN/CEFACT) — the Factur-X / ZUGFeRD syntax - **UBL 2.1** (Universal Business Language, OASIS) — the Peppol BIS Billing syntax  ## Applied Standards  - **EN 16931**: European semantic standard for electronic invoicing - **Factur-X / ZUGFeRD** (CII syntax): Franco-German standard - **UBL 2.1** (OASIS): International standard, used by Peppol - **ISO 19005-3** (PDF/A-3): Long-term electronic archiving (PDF output only) - **Schematron**: Business rules validation (EN16931-CII, EN16931-UBL, BR-FR)  ## 🆕 New: Simplified format with auto-enrichment (P0.1)  You can now create an invoice by providing only: - An invoice number - A supplier SIRET + **IBAN** (required) - A recipient SIRET - Invoice lines (description, quantity, net price)  **Simplified format example**: ```json {   \"number\": \"FACT-2025-001\",   \"supplier\": {     \"siret\": \"92019522900017\",     \"iban\": \"FR7630001007941234567890185\"   },   \"recipient\": {\"siret\": \"35600000000048\"},   \"lines\": [     {\"description\": \"Service\", \"quantity\": 10, \"unitPrice\": 100.00, \"vatRate\": 20.0}   ] } ```  **⚠️ Required fields (simplified format)**: - `number`: Unique invoice number - `supplier.siret`: Supplier's SIRET (14 digits) - `supplier.iban`: Bank account IBAN (no public API to retrieve it) - `recipient.siret`: Recipient's SIRET - `lines[]`: At least one invoice line  **What happens automatically with `auto_enrich=True`**: - ✅ Name enrichment from Chorus Pro API - ✅ Address enrichment from Business Search API (free, public) - ✅ Automatic intra-EU VAT calculation (FR + key + SIREN) - ✅ Chorus Pro ID retrieval for electronic invoicing - ✅ Net/VAT/Gross totals calculation - ✅ Date generation (today + 30-day due date) - ✅ Multi-rate VAT handling  **Supported identifiers**: - SIRET (14 digits): Specific establishment ⭐ Recommended - SIREN (9 digits): Company (auto-selection of headquarters) - Special types: UE_HORS_FRANCE, RIDET, TAHITI, etc.  ## Checks performed during generation  ### 1. Data validation (Pydantic) - Data types (amounts as Decimal, ISO 8601 dates) - Formats (14-digit SIRET, 9-digit SIREN, IBAN) - Required fields per profile - Amount consistency (Net + VAT = Gross)  ### 2. CII-compliant XML generation - Serialization according to Cross Industry Invoice XSD schema - Correct UN/CEFACT namespaces - Hierarchical structure respected - UTF-8 encoding without BOM  ### 3. Schematron validation - Business rules for selected profile (MINIMUM, BASIC, EN16931, EXTENDED) - Element cardinality (required, optional, repeatable) - Calculation rules (totals, VAT, discounts) - European EN 16931 compliance  ### 4. PDF/A-3 conversion (if output_format='pdf') - Source PDF conversion to PDF/A-3 via Ghostscript - Factur-X XML embedding in PDF - Compliant XMP metadata - ICC sRGB color profile - Removal of forbidden elements (JavaScript, forms)  ## How it works  1. **Submission**: Invoice is queued in Celery for asynchronous processing 2. **Immediate return**: You receive a `task_id` (HTTP 202 Accepted) 3. **Tracking**: Use the `/tasks/{task_id}/status` endpoint to track progress  ## Webhook notification (recommended)  Instead of polling, you can receive a webhook notification when the task completes:  ``` callback_url=https://your-server.com/webhook ```  The webhook will POST a JSON payload with: - `event_type`: `generation.completed` or `generation.failed` - `data.task_id`: The Celery task ID - `data.content_b64` or `data.xml_content`: The generated content - `X-Webhook-Signature` header for HMAC verification  See `/docs/WEBHOOKS.md` for full documentation.  ## Output formats  - **xml** / **cii**: CII XML (Factur-X syntax, UN/CEFACT) - **ubl**: UBL 2.1 XML (OASIS, Peppol BIS Billing 3.0) - **pdf**: Factur-X PDF/A-3 with embedded CII XML (requires `source_pdf`)  ## Factur-X profiles (CII only)  - **MINIMUM**: Minimal data (simplified invoice) - **BASIC**: Basic information (SMEs) - **EN16931**: European standard (recommended, compliant with directive 2014/55/EU) - **EXTENDED**: All available data (large accounts)  When `output_format=ubl`, the profile parameter is ignored (UBL always uses EN16931).  ## What you get  After successful processing (status `completed`): - **XML only**: Base64-encoded Factur-X compliant XML file - **PDF/A-3**: PDF with embedded XML, ready for sending/archiving - **Metadata**: Profile, Factur-X version, file size - **Validation**: Schematron compliance confirmation  ## Validation  Data is automatically validated according to detected format. On error, a 422 status is returned with invalid field details.
 
 ### Examples
 
@@ -24,15 +24,20 @@ require 'time'
 require 'factpulse'
 # setup authorization
 FactPulse.configure do |config|
+  # Configure API key authorization: APIKeyHeader
+  config.api_key['X-API-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-API-Key'] = 'Bearer'
+
   # Configure Bearer authorization: HTTPBearer
   config.access_token = 'YOUR_BEARER_TOKEN'
 end
 
-api_instance = FactPulse::FacturXGenerationApi.new
+api_instance = FactPulse::InvoiceGenerationApi.new
 invoice_data = 'invoice_data_example' # String | Invoice data in JSON format.              Two formats accepted:             1. **Classic format**: Complete FacturXInvoice structure (all fields)             2. **Simplified format** (🆕 P0.1): Minimal structure with auto-enrichment              Format is detected automatically!             
 opts = {
-  profile: FactPulse::APIProfile::MINIMUM, # APIProfile | Factur-X profile: MINIMUM, BASIC, EN16931 or EXTENDED.
-  output_format: FactPulse::OutputFormat::XML, # OutputFormat | Output format: 'xml' (XML only) or 'pdf' (Factur-X PDF with embedded XML).
+  profile: FactPulse::APIProfile::MINIMUM, # APIProfile | Factur-X/CII profile: MINIMUM, BASIC, EN16931 or EXTENDED. Ignored when output_format='ubl' (always EN16931).
+  output_format: FactPulse::OutputFormat::XML, # OutputFormat | Output format: 'xml' or 'cii' (CII/Factur-X XML), 'ubl' (UBL 2.1 XML), 'pdf' (Factur-X PDF/A-3).
   auto_enrich: true, # Boolean | 🆕 Enable auto-enrichment from SIRET/SIREN (simplified format only)
   source_pdf: File.new('/path/to/some/file'), # File | 
   callback_url: 'callback_url_example', # String | 
@@ -41,11 +46,11 @@ opts = {
 }
 
 begin
-  # Generate a Factur-X invoice
+  # Generate an electronic invoice (CII / UBL / Factur-X PDF)
   result = api_instance.generate_invoice_api_v1_processing_generate_invoice_post(invoice_data, opts)
   p result
 rescue FactPulse::ApiError => e
-  puts "Error when calling FacturXGenerationApi->generate_invoice_api_v1_processing_generate_invoice_post: #{e}"
+  puts "Error when calling InvoiceGenerationApi->generate_invoice_api_v1_processing_generate_invoice_post: #{e}"
 end
 ```
 
@@ -57,13 +62,13 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Generate a Factur-X invoice
+  # Generate an electronic invoice (CII / UBL / Factur-X PDF)
   data, status_code, headers = api_instance.generate_invoice_api_v1_processing_generate_invoice_post_with_http_info(invoice_data, opts)
   p status_code # => 2xx
   p headers # => { ... }
   p data # => <TaskResponse>
 rescue FactPulse::ApiError => e
-  puts "Error when calling FacturXGenerationApi->generate_invoice_api_v1_processing_generate_invoice_post_with_http_info: #{e}"
+  puts "Error when calling InvoiceGenerationApi->generate_invoice_api_v1_processing_generate_invoice_post_with_http_info: #{e}"
 end
 ```
 
@@ -72,8 +77,8 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **invoice_data** | **String** | Invoice data in JSON format.              Two formats accepted:             1. **Classic format**: Complete FacturXInvoice structure (all fields)             2. **Simplified format** (🆕 P0.1): Minimal structure with auto-enrichment              Format is detected automatically!              |  |
-| **profile** | [**APIProfile**](APIProfile.md) | Factur-X profile: MINIMUM, BASIC, EN16931 or EXTENDED. | [optional] |
-| **output_format** | [**OutputFormat**](OutputFormat.md) | Output format: &#39;xml&#39; (XML only) or &#39;pdf&#39; (Factur-X PDF with embedded XML). | [optional] |
+| **profile** | [**APIProfile**](APIProfile.md) | Factur-X/CII profile: MINIMUM, BASIC, EN16931 or EXTENDED. Ignored when output_format&#x3D;&#39;ubl&#39; (always EN16931). | [optional] |
+| **output_format** | [**OutputFormat**](OutputFormat.md) | Output format: &#39;xml&#39; or &#39;cii&#39; (CII/Factur-X XML), &#39;ubl&#39; (UBL 2.1 XML), &#39;pdf&#39; (Factur-X PDF/A-3). | [optional] |
 | **auto_enrich** | **Boolean** | 🆕 Enable auto-enrichment from SIRET/SIREN (simplified format only) | [optional][default to true] |
 | **source_pdf** | **File** |  | [optional] |
 | **callback_url** | **String** |  | [optional] |
@@ -86,7 +91,7 @@ end
 
 ### Authorization
 
-[HTTPBearer](../README.md#HTTPBearer)
+[APIKeyHeader](../README.md#APIKeyHeader), [HTTPBearer](../README.md#HTTPBearer)
 
 ### HTTP request headers
 
@@ -109,11 +114,16 @@ require 'time'
 require 'factpulse'
 # setup authorization
 FactPulse.configure do |config|
+  # Configure API key authorization: APIKeyHeader
+  config.api_key['X-API-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-API-Key'] = 'Bearer'
+
   # Configure Bearer authorization: HTTPBearer
   config.access_token = 'YOUR_BEARER_TOKEN'
 end
 
-api_instance = FactPulse::FacturXGenerationApi.new
+api_instance = FactPulse::InvoiceGenerationApi.new
 submit_complete_invoice_request = FactPulse::SubmitCompleteInvoiceRequest.new({invoice_data: FactPulse::SimplifiedInvoiceData.new({number: 'number_example', supplier: { key: 3.56}, recipient: { key: 3.56}, lines: [{ key: 3.56}]}), source_pdf: 'source_pdf_example', destination: FactPulse::AFNORDestination.new}) # SubmitCompleteInvoiceRequest | 
 
 begin
@@ -121,7 +131,7 @@ begin
   result = api_instance.submit_complete_invoice_api_v1_processing_invoices_submit_complete_post(submit_complete_invoice_request)
   p result
 rescue FactPulse::ApiError => e
-  puts "Error when calling FacturXGenerationApi->submit_complete_invoice_api_v1_processing_invoices_submit_complete_post: #{e}"
+  puts "Error when calling InvoiceGenerationApi->submit_complete_invoice_api_v1_processing_invoices_submit_complete_post: #{e}"
 end
 ```
 
@@ -139,7 +149,7 @@ begin
   p headers # => { ... }
   p data # => <SubmitCompleteInvoiceResponse>
 rescue FactPulse::ApiError => e
-  puts "Error when calling FacturXGenerationApi->submit_complete_invoice_api_v1_processing_invoices_submit_complete_post_with_http_info: #{e}"
+  puts "Error when calling InvoiceGenerationApi->submit_complete_invoice_api_v1_processing_invoices_submit_complete_post_with_http_info: #{e}"
 end
 ```
 
@@ -155,7 +165,7 @@ end
 
 ### Authorization
 
-[HTTPBearer](../README.md#HTTPBearer)
+[APIKeyHeader](../README.md#APIKeyHeader), [HTTPBearer](../README.md#HTTPBearer)
 
 ### HTTP request headers
 
@@ -178,11 +188,16 @@ require 'time'
 require 'factpulse'
 # setup authorization
 FactPulse.configure do |config|
+  # Configure API key authorization: APIKeyHeader
+  config.api_key['X-API-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-API-Key'] = 'Bearer'
+
   # Configure Bearer authorization: HTTPBearer
   config.access_token = 'YOUR_BEARER_TOKEN'
 end
 
-api_instance = FactPulse::FacturXGenerationApi.new
+api_instance = FactPulse::InvoiceGenerationApi.new
 submit_complete_invoice_request = FactPulse::SubmitCompleteInvoiceRequest.new({invoice_data: FactPulse::SimplifiedInvoiceData.new({number: 'number_example', supplier: { key: 3.56}, recipient: { key: 3.56}, lines: [{ key: 3.56}]}), source_pdf: 'source_pdf_example', destination: FactPulse::AFNORDestination.new}) # SubmitCompleteInvoiceRequest | 
 opts = {
   callback_url: 'callback_url_example', # String | Webhook URL for async notification when submission completes.
@@ -194,7 +209,7 @@ begin
   result = api_instance.submit_complete_invoice_async_api_v1_processing_invoices_submit_complete_async_post(submit_complete_invoice_request, opts)
   p result
 rescue FactPulse::ApiError => e
-  puts "Error when calling FacturXGenerationApi->submit_complete_invoice_async_api_v1_processing_invoices_submit_complete_async_post: #{e}"
+  puts "Error when calling InvoiceGenerationApi->submit_complete_invoice_async_api_v1_processing_invoices_submit_complete_async_post: #{e}"
 end
 ```
 
@@ -212,7 +227,7 @@ begin
   p headers # => { ... }
   p data # => <TaskResponse>
 rescue FactPulse::ApiError => e
-  puts "Error when calling FacturXGenerationApi->submit_complete_invoice_async_api_v1_processing_invoices_submit_complete_async_post_with_http_info: #{e}"
+  puts "Error when calling InvoiceGenerationApi->submit_complete_invoice_async_api_v1_processing_invoices_submit_complete_async_post_with_http_info: #{e}"
 end
 ```
 
@@ -230,7 +245,7 @@ end
 
 ### Authorization
 
-[HTTPBearer](../README.md#HTTPBearer)
+[APIKeyHeader](../README.md#APIKeyHeader), [HTTPBearer](../README.md#HTTPBearer)
 
 ### HTTP request headers
 

data/docs/InvoiceInput.md

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **invoice_id** | **String** | Invoice identifier |  |
 | **issue_date** | **Date** | Invoice issue date |  |
-| **type_code** | [**FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode**](FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode.md) | Invoice type code | [optional] |
+| **type_code** | [**InvoiceTypeCode**](InvoiceTypeCode.md) | Invoice type code | [optional] |
 | **currency** | [**Currency**](Currency.md) |  | [optional] |
 | **due_date** | **Date** |  | [optional] |
 | **seller_id** | **String** |  | [optional] |

data/docs/InvoiceLifecycle.md

@@ -0,0 +1,24 @@
+# FactPulse::InvoiceLifecycle
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **seller_id** | **String** |  | [optional] |
+| **invoice_id** | **String** | Reference de la facture (IssuerAssignedID du CDAR) |  |
+| **events** | [**Array<LifecycleEvent>**](LifecycleEvent.md) | Evenements de cycle de vie tries chronologiquement | [optional] |
+| **total_events** | **Integer** | Nombre total d'evenements |  |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::InvoiceLifecycle.new(
+  seller_id: null,
+  invoice_id: null,
+  events: null,
+  total_events: null
+)
+```
+

data/docs/InvoicingFramework.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **invoicing_framework_code** | [**InvoicingFrameworkCode**](InvoicingFrameworkCode.md) | Chorus Pro framework code (A1, A2, A9, A12) |  |
+| **invoicing_framework_code** | [**InvoicingFrameworkCode**](InvoicingFrameworkCode.md) |  | [optional] |
 | **operation_nature** | [**OperationNature**](OperationNature.md) |  | [optional] |
 | **approver_service_code** | **String** |  | [optional] |
 | **approver_structure_code** | **String** |  | [optional] |

data/docs/KeyRotationRequest.md

@@ -0,0 +1,20 @@
+# FactPulse::KeyRotationRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **old_key** | **String** | Current encryption key (base64-encoded AES-256) |  |
+| **new_key** | **String** | New encryption key (base64-encoded AES-256) |  |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::KeyRotationRequest.new(
+  old_key: null,
+  new_key: null
+)
+```
+

data/docs/KeyRotationResponse.md

@@ -0,0 +1,24 @@
+# FactPulse::KeyRotationResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **success** | **Boolean** | Whether rotation was successful |  |
+| **message** | **String** | Result message |  |
+| **rotated_count** | **Integer** | Number of secrets that were rotated |  |
+| **partial_errors** | **Array<String>** |  | [optional] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::KeyRotationResponse.new(
+  success: null,
+  message: null,
+  rotated_count: null,
+  partial_errors: null
+)
+```
+

data/docs/LifecycleEvent.md

@@ -0,0 +1,38 @@
+# FactPulse::LifecycleEvent
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **flow_id** | **String** | ID du flux lifecycle |  |
+| **status_code** | **String** | Code statut (200-601) |  |
+| **status_description** | **String** |  | [optional] |
+| **ack_status** | **String** |  | [optional] |
+| **at** | **String** |  | [optional] |
+| **document_id** | **String** |  | [optional] |
+| **amount** | **String** |  | [optional] |
+| **currency** | **String** |  | [optional] |
+| **issuer_siren** | **String** |  | [optional] |
+| **issuer_role** | **String** |  | [optional] |
+| **reason_code** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::LifecycleEvent.new(
+  flow_id: null,
+  status_code: null,
+  status_description: null,
+  ack_status: null,
+  at: null,
+  document_id: null,
+  amount: null,
+  currency: null,
+  issuer_siren: null,
+  issuer_role: null,
+  reason_code: null
+)
+```
+

data/docs/LifecycleResponse.md

@@ -0,0 +1,22 @@
+# FactPulse::LifecycleResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **invoices** | [**Array<InvoiceLifecycle>**](InvoiceLifecycle.md) | Cycles de vie par facture | [optional] |
+| **total_invoices** | **Integer** | Nombre de factures |  |
+| **cutoff_days** | **Integer** | Nombre de jours de la fenetre de recherche |  |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::LifecycleResponse.new(
+  invoices: null,
+  total_invoices: null,
+  cutoff_days: null
+)
+```
+

data/docs/PDPConfigResponse.md

@@ -11,6 +11,7 @@
 | **flow_service_url** | **String** |  | [optional] |
 | **token_url** | **String** |  | [optional] |
 | **oauth_client_id** | **String** |  | [optional] |
+| **encryption_mode** | **String** |  | [optional] |
 | **secret_status** | [**SecretStatus**](SecretStatus.md) |  | [optional] |
 | **last_test_at** | **Time** |  | [optional] |
 | **last_test_success** | **Boolean** |  | [optional] |
@@ -32,6 +33,7 @@ instance = FactPulse::PDPConfigResponse.new(
   flow_service_url: null,
   token_url: null,
   oauth_client_id: null,
+  encryption_mode: null,
   secret_status: null,
   last_test_at: null,
   last_test_success: null,

data/docs/PDPConfigUpdateRequest.md

@@ -10,6 +10,7 @@
 | **token_url** | **String** | PDP OAuth token URL |  |
 | **oauth_client_id** | **String** | OAuth Client ID |  |
 | **client_secret** | **String** | OAuth Client Secret (sent but never returned) |  |
+| **encryption_mode** | **String** |  | [optional] |
 
 ## Example
 
@@ -22,7 +23,8 @@ instance = FactPulse::PDPConfigUpdateRequest.new(
   flow_service_url: null,
   token_url: null,
   oauth_client_id: null,
-  client_secret: null
+  client_secret: null,
+  encryption_mode: null
 )
 ```