factpulse 0.1.0

data/docs/TransactionCategory.md

@@ -0,0 +1,15 @@
+# FactPulse::TransactionCategory
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::TransactionCategory.new()
+```
+

data/docs/TransmissionTypeCode.md

@@ -0,0 +1,15 @@
+# FactPulse::TransmissionTypeCode
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::TransmissionTypeCode.new()
+```
+

data/docs/UnitNetPrice.md

@@ -0,0 +1,15 @@
+# FactPulse::UnitNetPrice
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::UnitNetPrice.new()
+```
+

data/docs/UnitOfMeasure.md

@@ -0,0 +1,15 @@
+# FactPulse::UnitOfMeasure
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::UnitOfMeasure.new()
+```
+

data/docs/VATAccountingCode.md

@@ -0,0 +1,15 @@
+# FactPulse::VATAccountingCode
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::VATAccountingCode.new()
+```
+

data/docs/VATAmount.md

@@ -0,0 +1,15 @@
+# FactPulse::VATAmount
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::VATAmount.new()
+```
+

data/docs/VATCategory.md

@@ -0,0 +1,15 @@
+# FactPulse::VATCategory
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::VATCategory.new()
+```
+

data/docs/VATLine.md

@@ -0,0 +1,32 @@
+# FactPulse::VATLine
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **taxable_amount** | [**TaxableAmount**](TaxableAmount.md) |  |  |
+| **vat_amount** | [**VATAmount**](VATAmount.md) |  |  |
+| **rate** | **String** |  | [optional] |
+| **manual_rate** | [**ManualRate**](ManualRate.md) |  | [optional] |
+| **category** | [**VATCategory**](VATCategory.md) |  | [optional] |
+| **due_date_type_code** | [**VATPointDateCode**](VATPointDateCode.md) |  | [optional] |
+| **exemption_reason** | **String** |  | [optional] |
+| **vatex_code** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::VATLine.new(
+  taxable_amount: null,
+  vat_amount: null,
+  rate: null,
+  manual_rate: null,
+  category: null,
+  due_date_type_code: null,
+  exemption_reason: null,
+  vatex_code: null
+)
+```
+

data/docs/VATPointDateCode.md

@@ -0,0 +1,15 @@
+# FactPulse::VATPointDateCode
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::VATPointDateCode.new()
+```
+

data/docs/ValidateCDARRequest.md

@@ -0,0 +1,32 @@
+# FactPulse::ValidateCDARRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **document_id** | **String** |  | [optional] |
+| **sender_siren** | **String** |  | [optional] |
+| **sender_role** | **String** |  | [optional] |
+| **invoice_id** | **String** |  | [optional] |
+| **invoice_issue_date** | **Date** |  | [optional] |
+| **status** | **String** |  | [optional] |
+| **reason_code** | **String** |  | [optional] |
+| **encaisse_amount** | [**Encaisseamount1**](Encaisseamount1.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::ValidateCDARRequest.new(
+  document_id: null,
+  sender_siren: null,
+  sender_role: null,
+  invoice_id: null,
+  invoice_issue_date: null,
+  status: null,
+  reason_code: null,
+  encaisse_amount: null
+)
+```
+

data/docs/ValidateCDARResponse.md

@@ -0,0 +1,22 @@
+# FactPulse::ValidateCDARResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **valid** | **Boolean** | Résultat de validation |  |
+| **errors** | [**Array<ValidationErrorResponse>**](ValidationErrorResponse.md) | Liste des erreurs | [optional] |
+| **warnings** | [**Array<ValidationErrorResponse>**](ValidationErrorResponse.md) | Liste des avertissements | [optional] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::ValidateCDARResponse.new(
+  valid: null,
+  errors: null,
+  warnings: null
+)
+```
+

data/docs/ValidateEReportingRequest.md

@@ -0,0 +1,18 @@
+# FactPulse::ValidateEReportingRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**CreateEReportingRequest**](CreateEReportingRequest.md) | E-Reporting data to validate |  |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::ValidateEReportingRequest.new(
+  data: null
+)
+```
+

data/docs/ValidateEReportingResponse.md

@@ -0,0 +1,28 @@
+# FactPulse::ValidateEReportingResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **valid** | **Boolean** | Whether the data is valid |  |
+| **report_id** | **String** | Report identifier |  |
+| **flow_type** | **String** | Flux type |  |
+| **errors** | [**Array<EReportingValidationError>**](EReportingValidationError.md) | List of validation errors (if any) | [optional] |
+| **warnings** | [**Array<EReportingValidationError>**](EReportingValidationError.md) | List of validation warnings (if any) | [optional] |
+| **message** | **String** | Status message |  |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::ValidateEReportingResponse.new(
+  valid: null,
+  report_id: null,
+  flow_type: null,
+  errors: null,
+  warnings: null,
+  message: null
+)
+```
+

data/docs/ValidationError.md

@@ -0,0 +1,22 @@
+# FactPulse::ValidationError
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **loc** | [**Array<LocationInner>**](LocationInner.md) |  |  |
+| **msg** | **String** |  |  |
+| **type** | **String** |  |  |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::ValidationError.new(
+  loc: null,
+  msg: null,
+  type: null
+)
+```
+

data/docs/ValidationErrorDetail.md

@@ -0,0 +1,26 @@
+# FactPulse::ValidationErrorDetail
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **level** | [**ErrorLevel**](ErrorLevel.md) | Severity level: 'Error' or 'Warning' | [optional] |
+| **item** | **String** | Identifier of the concerned element (XPath, field, BR-FR rule, etc.) |  |
+| **reason** | **String** | Error description |  |
+| **source** | [**ErrorSource**](ErrorSource.md) |  | [optional] |
+| **code** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::ValidationErrorDetail.new(
+  level: null,
+  item: null,
+  reason: null,
+  source: null,
+  code: null
+)
+```
+

data/docs/ValidationErrorResponse.md

@@ -0,0 +1,24 @@
+# FactPulse::ValidationErrorResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **field** | **String** | Champ concerné |  |
+| **message** | **String** | Message d'erreur |  |
+| **rule** | **String** |  | [optional] |
+| **severity** | **String** | Sévérité (error/warning) | [optional][default to 'error'] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::ValidationErrorResponse.new(
+  field: null,
+  message: null,
+  rule: null,
+  severity: null
+)
+```
+

data/docs/ValidationInfo.md

@@ -0,0 +1,28 @@
+# FactPulse::ValidationInfo
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **profile** | **String** | Profil Factur-X utilise |  |
+| **schematron_rules_passed** | **Integer** | Regles passees |  |
+| **schematron_rules_total** | **Integer** | Total regles |  |
+| **pdfa_compliant** | **Boolean** | PDF/A-3 conforme | [optional][default to true] |
+| **xml_embedded** | **Boolean** | XML embarque dans PDF | [optional][default to true] |
+| **errors** | [**Array<SchematronValidationError>**](SchematronValidationError.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::ValidationInfo.new(
+  profile: null,
+  schematron_rules_passed: null,
+  schematron_rules_total: null,
+  pdfa_compliant: null,
+  xml_embedded: null,
+  errors: null
+)
+```
+

data/docs/ValidationSuccessResponse.md

@@ -0,0 +1,18 @@
+# FactPulse::ValidationSuccessResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **message** | **String** | Message confirming XML compliance. |  |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::ValidationSuccessResponse.new(
+  message: null
+)
+```
+

data/docs/VatRate.md

@@ -0,0 +1,15 @@
+# FactPulse::VatRate
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::VatRate.new()
+```
+

data/docs/VerificationSuccessResponse.md

@@ -0,0 +1,36 @@
+# FactPulse::VerificationSuccessResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **is_compliant** | **Boolean** | True if no critical discrepancy |  |
+| **compliance_score** | **Float** | Compliance score (0-100%) |  |
+| **verified_fields_count** | **Integer** | Number of verified fields | [optional][default to 0] |
+| **compliant_fields_count** | **Integer** | Number of compliant fields | [optional][default to 0] |
+| **is_facturx** | **Boolean** | True if PDF contains Factur-X XML | [optional][default to false] |
+| **facturx_profile** | **String** |  | [optional] |
+| **fields** | [**Array<VerifiedFieldSchema>**](VerifiedFieldSchema.md) | List of verified fields with values, statuses and PDF coordinates | [optional] |
+| **mandatory_notes** | [**Array<MandatoryNoteSchema>**](MandatoryNoteSchema.md) | Mandatory notes (PMT, PMD, AAB) with PDF location | [optional] |
+| **page_dimensions** | [**Array<PageDimensionsSchema>**](PageDimensionsSchema.md) | Dimensions of each PDF page (width, height) | [optional] |
+| **warnings** | **Array<String>** | Non-blocking warnings | [optional] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::VerificationSuccessResponse.new(
+  is_compliant: null,
+  compliance_score: null,
+  verified_fields_count: null,
+  compliant_fields_count: null,
+  is_facturx: null,
+  facturx_profile: null,
+  fields: null,
+  mandatory_notes: null,
+  page_dimensions: null,
+  warnings: null
+)
+```
+

data/docs/VerifiedFieldSchema.md

@@ -0,0 +1,34 @@
+# FactPulse::VerifiedFieldSchema
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **business_term** | **String** | EN16931 Business Term (e.g., BT-1) |  |
+| **label** | **String** | Field label (e.g., Invoice Number) |  |
+| **pdf_value** | **String** |  | [optional] |
+| **xml_value** | **String** |  | [optional] |
+| **status** | [**FieldStatus**](FieldStatus.md) | Compliance status |  |
+| **message** | **String** |  | [optional] |
+| **confidence** | **Float** | Confidence score (0-1) | [optional][default to 1.0] |
+| **source** | **String** | Extraction source | [optional][default to 'native_pdf'] |
+| **bbox** | [**BoundingBoxSchema**](BoundingBoxSchema.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::VerifiedFieldSchema.new(
+  business_term: null,
+  label: null,
+  pdf_value: null,
+  xml_value: null,
+  status: null,
+  message: null,
+  confidence: null,
+  source: null,
+  bbox: null
+)
+```
+

data/docs/WebhookSecretDeleteResponse.md

@@ -0,0 +1,20 @@
+# FactPulse::WebhookSecretDeleteResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **success** | **Boolean** | Whether the secret was deleted successfully |  |
+| **message** | **String** | Result message |  |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::WebhookSecretDeleteResponse.new(
+  success: null,
+  message: null
+)
+```
+

data/docs/WebhookSecretGenerateResponse.md

@@ -0,0 +1,24 @@
+# FactPulse::WebhookSecretGenerateResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **success** | **Boolean** | Whether the secret was generated successfully |  |
+| **webhook_secret** | **String** | The generated webhook secret (save it, it will never be shown again) |  |
+| **message** | **String** | Result message |  |
+| **created_at** | **Time** | When the secret was created |  |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::WebhookSecretGenerateResponse.new(
+  success: null,
+  webhook_secret: null,
+  message: null,
+  created_at: null
+)
+```
+

data/docs/WebhookSecretStatusResponse.md

@@ -0,0 +1,20 @@
+# FactPulse::WebhookSecretStatusResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **has_secret** | **Boolean** | Whether a webhook secret is configured |  |
+| **created_at** | **Time** |  | [optional] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::WebhookSecretStatusResponse.new(
+  has_secret: null,
+  created_at: null
+)
+```
+

data/factpulse.gemspec

@@ -0,0 +1,39 @@
+# -*- encoding: utf-8 -*-
+
+=begin
+#FactPulse REST API
+
+# REST API for electronic invoicing in France: Factur-X, AFNOR PDP/PA, electronic signatures.  ## 🎯 Main Features  ### 📄 Factur-X - 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)  ### ✅ Factur-X - Validation - **XML Validation**: Schematron (45 to 210+ rules depending on profile) - **PDF Validation**: PDF/A-3, Factur-X XMP metadata - **VeraPDF**: Strict PDF/A validation (146+ ISO 19005-3 rules)  ### ✍️ 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  ### 📋 Flux 6 - Invoice Lifecycle (CDAR) - **CDAR Messages**: Acknowledgements, invoice statuses - **PPF Statuses**: REFUSED (210), PAID (212)  ### 📊 Flux 10 - E-Reporting - **Tax Declarations**: International B2B, B2C - **Flow Types**: 10.1 (B2B transactions), 10.2 (B2B payments), 10.3 (B2C transactions), 10.4 (B2C payments)  ### 📡 AFNOR PDP/PA (XP Z12-013) - **Flow Service**: Submit and search flows to PDPs - **Directory Service**: Company search (SIREN/SIRET) - **Multi-client**: Support for multiple PDP configs per user  ### 🏛️ Chorus Pro - **Public Sector Invoicing**: Complete API for Chorus Pro  ### ⏳ Async Tasks - **Celery**: Asynchronous generation, validation and signing - **Polling**: Status tracking via `/tasks/{task_id}/status` - **Webhooks**: Automatic notifications when tasks complete  ## 🔒 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: https://openapi-generator.tech
+Generator version: 7.20.0-SNAPSHOT
+
+=end
+
+$:.push File.expand_path("../lib", __FILE__)
+require "factpulse/version"
+
+Gem::Specification.new do |s|
+  s.name        = "factpulse"
+  s.version     = FactPulse::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["OpenAPI-Generator"]
+  s.email       = ["contact@factpulse.fr"]
+  s.homepage    = "https://openapi-generator.tech"
+  s.summary     = "FactPulse REST API Ruby Gem"
+  s.description = " REST API for electronic invoicing in France: Factur-X, AFNOR PDP/PA, electronic signatures.  ## 🎯 Main Features  ### 📄 Factur-X - 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)  ### ✅ Factur-X - Validation - **XML Validation**: Schematron (45 to 210+ rules depending on profile) - **PDF Validation**: PDF/A-3, Factur-X XMP metadata - **VeraPDF**: Strict PDF/A validation (146+ ISO 19005-3 rules)  ### ✍️ 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  ### 📋 Flux 6 - Invoice Lifecycle (CDAR) - **CDAR Messages**: Acknowledgements, invoice statuses - **PPF Statuses**: REFUSED (210), PAID (212)  ### 📊 Flux 10 - E-Reporting - **Tax Declarations**: International B2B, B2C - **Flow Types**: 10.1 (B2B transactions), 10.2 (B2B payments), 10.3 (B2C transactions), 10.4 (B2C payments)  ### 📡 AFNOR PDP/PA (XP Z12-013) - **Flow Service**: Submit and search flows to PDPs - **Directory Service**: Company search (SIREN/SIRET) - **Multi-client**: Support for multiple PDP configs per user  ### 🏛️ Chorus Pro - **Public Sector Invoicing**: Complete API for Chorus Pro  ### ⏳ Async Tasks - **Celery**: Asynchronous generation, validation and signing - **Polling**: Status tracking via `/tasks/{task_id}/status` - **Webhooks**: Automatic notifications when tasks complete  ## 🔒 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/     "
+  s.license     = "Unlicense"
+  s.required_ruby_version = ">= 2.7"
+  s.metadata    = {}
+
+  s.add_runtime_dependency 'typhoeus', '~> 1.0', '>= 1.0.1'
+
+  s.add_development_dependency 'rspec', '~> 3.6', '>= 3.6.0'
+
+  s.files         = `find *`.split("\n").uniq.sort.select { |f| !f.empty? }
+  s.test_files    = `find spec/*`.split("\n")
+  s.executables   = []
+  s.require_paths = ["lib"]
+end

data/git_push.sh

@@ -0,0 +1,57 @@
+#!/bin/sh
+# ref: https://help.github.com/articles/adding-an-existing-project-to-github-using-the-command-line/
+#
+# Usage example: /bin/sh ./git_push.sh wing328 openapi-petstore-perl "minor update" "gitlab.com"
+
+git_user_id=$1
+git_repo_id=$2
+release_note=$3
+git_host=$4
+
+if [ "$git_host" = "" ]; then
+    git_host="github.com"
+    echo "[INFO] No command line input provided. Set \$git_host to $git_host"
+fi
+
+if [ "$git_user_id" = "" ]; then
+    git_user_id="GIT_USER_ID"
+    echo "[INFO] No command line input provided. Set \$git_user_id to $git_user_id"
+fi
+
+if [ "$git_repo_id" = "" ]; then
+    git_repo_id="GIT_REPO_ID"
+    echo "[INFO] No command line input provided. Set \$git_repo_id to $git_repo_id"
+fi
+
+if [ "$release_note" = "" ]; then
+    release_note="Minor update"
+    echo "[INFO] No command line input provided. Set \$release_note to $release_note"
+fi
+
+# Initialize the local directory as a Git repository
+git init
+
+# Adds the files in the local repository and stages them for commit.
+git add .
+
+# Commits the tracked changes and prepares them to be pushed to a remote repository.
+git commit -m "$release_note"
+
+# Sets the new remote
+git_remote=$(git remote)
+if [ "$git_remote" = "" ]; then # git remote not defined
+
+    if [ "$GIT_TOKEN" = "" ]; then
+        echo "[INFO] \$GIT_TOKEN (environment variable) is not set. Using the git credential in your environment."
+        git remote add origin https://${git_host}/${git_user_id}/${git_repo_id}.git
+    else
+        git remote add origin https://${git_user_id}:"${GIT_TOKEN}"@${git_host}/${git_user_id}/${git_repo_id}.git
+    fi
+
+fi
+
+git pull origin master
+
+# Pushes (Forces) the changes in the local repository up to the remote repository
+echo "Git pushing to https://${git_host}/${git_user_id}/${git_repo_id}.git"
+git push origin master 2>&1 | grep -v 'To https'