factpulse 3.0.29 → 3.0.31

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 04a881e701ac9a5e0b5a83bae874c425a06ce0f8bc42e2747141c6cc910dbe83
-  data.tar.gz: 57418b7ace370be58d37f6afb118d878c25a0f219562ad53d1a3d25d9029c5ef
+  metadata.gz: 94db622879964ed7a06ca11f0bba2ae74bbf8c0bb8ae6ab7f37726340a59578a
+  data.tar.gz: a711cb72138be7537ee68eaa62f86235eadcb6c24cab3e126027b807f971b47a
 SHA512:
-  metadata.gz: e02ea82aa7555b6ea823ccb440d766a91250150405a77e0d6cfd448644cb52629fddba76304dede6b868625f930dac8d21fdcc4ed2c301581dd3646274792ba7
-  data.tar.gz: b48ac47c664ef5f1ba7060cb2f54bf33ab4bdd35a6ca779cf3157f0ce33629d9d3270b0bd16c4119ce70aaa7f16eee1c47d3c3bbf87d259dc288f0a6beb0d5e2
+  metadata.gz: 34d8698d5e106f9cba5b5d2e05ab6385de8d6688d6bb903fc4033174d9ce438e079e7708bc8504d33d36a7e1758efbd7e655e021a303bdfa1116b8f95fc1d483
+  data.tar.gz: 401039a27b602c5364a8a1677a41a3dde46228f57ea02f239ab6af99e9674e7e9feb4607519db7c69cd0206479443a2872a1e4327752be18f90e753ce0ecff56

data/CHANGELOG.md

@@ -7,7 +7,7 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
-## [3.0.29] - 2026-01-16
+## [3.0.31] - 2026-01-16
 
 ### Added
 - Version initiale du SDK ruby
@@ -24,5 +24,5 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 - Guide d'authentification JWT
 - Configuration avancée (timeout, proxy, debug)
 
-[Unreleased]: https://github.com/factpulse/sdk-ruby/compare/v3.0.29...HEAD
-[3.0.29]: https://github.com/factpulse/sdk-ruby/releases/tag/v3.0.29
+[Unreleased]: https://github.com/factpulse/sdk-ruby/compare/v3.0.31...HEAD
+[3.0.31]: https://github.com/factpulse/sdk-ruby/releases/tag/v3.0.31

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    factpulse (3.0.29)
+    factpulse (3.0.31)
       typhoeus (~> 1.0, >= 1.0.1)
 
 GEM

data/README.md

@@ -24,18 +24,17 @@ gem 'factpulse'
 
 ## Quick Start
 
-The `helpers` module provides a simplified API with automatic authentication and polling:
+The `FactPulse::Helpers` module provides a simplified API with automatic authentication and polling:
 
 ```ruby
 require 'factpulse'
-require 'factpulse/helpers'
 
-include Factpulse::Helpers
+include FactPulse::Helpers
 
 # Create the client
 client = FactPulseClient.new(
-  'your_email@example.com',
-  'your_password'
+  email: 'your_email@example.com',
+  password: 'your_password'
 )
 
 # Build the invoice using simplified format (auto-calculates totals)
@@ -66,18 +65,18 @@ pdf_bytes = client.generate_facturx(invoice_data, 'source_invoice.pdf')
 File.binwrite('invoice_facturx.pdf', pdf_bytes)
 ```
 
-## Available Helpers (Factpulse::Helpers module)
+## Available Helpers (FactPulse::Helpers::AmountHelpers module)
 
 ### amount(value)
 
 Converts a value to a formatted string for monetary amounts.
 
 ```ruby
-include Factpulse::Helpers
+include FactPulse::Helpers
 
-amount(1234.5)      # "1234.50"
-amount('1234.56')   # "1234.56"
-amount(nil)         # "0.00"
+AmountHelpers.amount(1234.5)      # "1234.50"
+AmountHelpers.amount('1234.56')   # "1234.56"
+AmountHelpers.amount(nil)         # "0.00"
 ```
 
 ### invoice_totals(excl_tax, vat, incl_tax, amount_due, ...)
@@ -85,7 +84,7 @@ amount(nil)         # "0.00"
 Creates a complete invoice totals object.
 
 ```ruby
-totals = invoice_totals(
+totals = AmountHelpers.invoice_totals(
   1000.00,                  # excl_tax
   200.00,                   # vat
   1200.00,                  # incl_tax
@@ -96,36 +95,34 @@ totals = invoice_totals(
 )
 ```
 
-### invoice_line(line_number, item_name, quantity, unit_net_price, line_net_amount, ...)
+### invoice_line(number, description, quantity, unit_price_excl_tax, line_total_excl_tax, ...)
 
 Creates an invoice line.
 
 ```ruby
-line = invoice_line(
+line = AmountHelpers.invoice_line(
   1,
   'Consulting services',
   5,
   200.00,
   1000.00,
-  'S',      # vat_category: S, Z, E, AE, K
-  'HOUR',   # unit: LUMP_SUM, PIECE, HOUR, DAY...
-  {
-    vat_rate: 'TVA20',        # Or manual_vat_rate: '20.00'
-    reference: 'REF-001'
-  }
+  vat_rate: '20.00',    # vatRateManual
+  vat_category: 'S',    # S, Z, E, AE, K
+  unit: 'LUMP_SUM',     # LUMP_SUM, PIECE, HOUR, DAY...
+  reference: 'REF-001'  # optional
 )
 ```
 
-### vat_line(taxable_amount, vat_amount, ...)
+### vat_line(rate_manual, base_amount_excl_tax, vat_amount, category)
 
 Creates a VAT breakdown line.
 
 ```ruby
-vat = vat_line(
-  1000.00,    # taxable_amount
+vat = AmountHelpers.vat_line(
+  '20.00',    # rate_manual
+  1000.00,    # base_amount_excl_tax
   200.00,     # vat_amount
-  'S',        # category: S, Z, E, AE, K
-  { rate: 'TVA20' }  # Or manual_rate: '20.00'
+  category: 'S'  # S, Z, E, AE, K
 )
 ```
 
@@ -134,12 +131,12 @@ vat = vat_line(
 Creates a structured postal address.
 
 ```ruby
-address = postal_address(
+address = AmountHelpers.postal_address(
   '123 Republic Street',
   '75001',
   'Paris',
-  'FR',           # country (default: 'FR')
-  'Building A'    # line2 (optional)
+  country: 'FR',        # default: 'FR'
+  line2: 'Building A'   # optional
 )
 ```
 
@@ -148,13 +145,13 @@ address = postal_address(
 Creates a complete supplier with automatic calculation of SIREN and intra-community VAT.
 
 ```ruby
-s = supplier(
+s = AmountHelpers.supplier(
   'My Company SAS',
   '12345678901234',
   '123 Example Street',
   '75001',
   'Paris',
-  { iban: 'FR7630006000011234567890189' }
+  iban: 'FR7630006000011234567890189'
 )
 # SIREN and intra-community VAT automatically calculated
 ```
@@ -164,7 +161,7 @@ s = supplier(
 Creates a recipient (customer) with automatic calculation of SIREN.
 
 ```ruby
-r = recipient(
+r = AmountHelpers.recipient(
   'Client SARL',
   '98765432109876',
   '456 Test Avenue',
@@ -178,30 +175,28 @@ r = recipient(
 To pass your own credentials without server-side storage:
 
 ```ruby
-include Factpulse::Helpers
+include FactPulse::Helpers
 
 chorus_creds = ChorusProCredentials.new(
-  'your_client_id',
-  'your_client_secret',
-  'your_login',
-  'your_password',
-  true  # sandbox
+  piste_client_id: 'your_client_id',
+  piste_client_secret: 'your_client_secret',
+  chorus_pro_login: 'your_login',
+  chorus_pro_password: 'your_password',
+  sandbox: true
 )
 
 afnor_creds = AFNORCredentials.new(
-  'https://api.pdp.fr/flow/v1',
-  'https://auth.pdp.fr/oauth/token',
-  'your_client_id',
-  'your_client_secret'
+  flow_service_url: 'https://api.pdp.fr/flow/v1',
+  token_url: 'https://auth.pdp.fr/oauth/token',
+  client_id: 'your_client_id',
+  client_secret: 'your_client_secret'
 )
 
 client = FactPulseClient.new(
-  'your_email@example.com',
-  'your_password',
-  nil,  # api_url
-  nil,  # client_uid
-  chorus_creds,
-  afnor_creds
+  email: 'your_email@example.com',
+  password: 'your_password',
+  chorus_credentials: chorus_creds,
+  afnor_credentials: afnor_creds
 )
 ```
 

data/docs/FactureElectroniqueModelsInvoiceTypeCode.md

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

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_siren** | **String** | Seller SIREN/SIRET |  |

data/docs/SimplifiedInvoiceData.md

@@ -13,7 +13,7 @@
 | **comment** | **String** |  | [optional] |
 | **purchase_order_reference** | **String** |  | [optional] |
 | **contract_reference** | **String** |  | [optional] |
-| **invoice_type** | [**InvoiceTypeCode**](InvoiceTypeCode.md) | Document type (UNTDID 1001). Default: 380 (Invoice). | [optional] |
+| **invoice_type** | [**FactureElectroniqueModelsInvoiceTypeCode**](FactureElectroniqueModelsInvoiceTypeCode.md) | Document type (UNTDID 1001). Default: 380 (Invoice). | [optional] |
 | **preceding_invoice_reference** | **String** |  | [optional] |
 | **operation_nature** | [**OperationNature**](OperationNature.md) |  | [optional] |
 | **invoicing_framework** | [**InvoicingFrameworkCode**](InvoicingFrameworkCode.md) |  | [optional] |

data/lib/factpulse/helpers/client.rb

@@ -561,14 +561,21 @@ module FactPulse
       end
 
       # Submits an invoice to Chorus Pro.
-      def soumettre_facture_chorus(facture_data)
-        make_chorus_request('POST', '/factures/soumettre', facture_data)
+      # @param invoice_data [Hash] Invoice data with keys: numero_facture, date_facture, date_echeance_paiement,
+      #   id_structure_cpp, montant_ht_total, montant_tva, montant_ttc_total, etc.
+      # @return [Hash] Response with identifiant_facture_cpp, numero_flux_depot, code_retour, libelle
+      def submit_invoice_chorus(invoice_data)
+        make_chorus_request('POST', '/factures/soumettre', invoice_data)
       end
+      alias soumettre_facture_chorus submit_invoice_chorus
 
       # Gets the status of a Chorus Pro invoice.
-      def consulter_facture_chorus(identifiant_facture_cpp)
-        make_chorus_request('POST', '/factures/consulter', { 'identifiant_facture_cpp' => identifiant_facture_cpp })
+      # @param invoice_cpp_id [Integer] Chorus Pro invoice ID
+      # @return [Hash] Invoice status with statut_courant, numero_facture, date_facture, etc.
+      def get_invoice_status_chorus(invoice_cpp_id)
+        make_chorus_request('POST', '/factures/consulter', { 'identifiant_facture_cpp' => invoice_cpp_id })
       end
+      alias consulter_facture_chorus get_invoice_status_chorus
 
       # =========================================================================
       # Validation

data/lib/factpulse/models/{facture_electronique_rest_api_schemas_ereporting_invoice_type_code.rb → facture_electronique_models_invoice_type_code.rb}

@@ -14,15 +14,26 @@ require 'date'
 require 'time'
 
 module FactPulse
-  class FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode
-    N380 = "380".freeze
-    N381 = "381".freeze
-    N384 = "384".freeze
-    N389 = "389".freeze
-    N386 = "386".freeze
+  class FactureElectroniqueModelsInvoiceTypeCode
+    INVOICE = "380".freeze
+    SELF_BILLED_INVOICE = "389".freeze
+    FACTORED_INVOICE = "393".freeze
+    SELF_BILLED_FACTORED_INVOICE = "501".freeze
+    PREPAYMENT_INVOICE = "386".freeze
+    SELF_BILLED_PREPAYMENT_INVOICE = "500".freeze
+    CORRECTIVE_INVOICE = "384".freeze
+    SELF_BILLED_CORRECTIVE_INVOICE = "471".freeze
+    FACTORED_CORRECTIVE_INVOICE = "472".freeze
+    SELF_BILLED_FACTORED_CORRECTIVE_INVOICE = "473".freeze
+    CREDIT_NOTE = "381".freeze
+    SELF_BILLED_CREDIT_NOTE = "261".freeze
+    GLOBAL_ALLOWANCE_CREDIT_NOTE = "262".freeze
+    FACTORED_CREDIT_NOTE = "396".freeze
+    SELF_BILLED_FACTORED_CREDIT_NOTE = "502".freeze
+    PREPAYMENT_CREDIT_NOTE = "503".freeze
 
     def self.all_vars
-      @all_vars ||= [N380, N381, N384, N389, N386].freeze
+      @all_vars ||= [INVOICE, SELF_BILLED_INVOICE, FACTORED_INVOICE, SELF_BILLED_FACTORED_INVOICE, PREPAYMENT_INVOICE, SELF_BILLED_PREPAYMENT_INVOICE, CORRECTIVE_INVOICE, SELF_BILLED_CORRECTIVE_INVOICE, FACTORED_CORRECTIVE_INVOICE, SELF_BILLED_FACTORED_CORRECTIVE_INVOICE, CREDIT_NOTE, SELF_BILLED_CREDIT_NOTE, GLOBAL_ALLOWANCE_CREDIT_NOTE, FACTORED_CREDIT_NOTE, SELF_BILLED_FACTORED_CREDIT_NOTE, PREPAYMENT_CREDIT_NOTE].freeze
     end
 
     # Builds the enum from string
@@ -36,8 +47,8 @@ module FactPulse
     # @param [String] The enum value in the form of the string
     # @return [String] The enum value
     def build_from_hash(value)
-      return value if FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode.all_vars.include?(value)
-      raise "Invalid ENUM value #{value} for class #FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode"
+      return value if FactureElectroniqueModelsInvoiceTypeCode.all_vars.include?(value)
+      raise "Invalid ENUM value #{value} for class #FactureElectroniqueModelsInvoiceTypeCode"
     end
   end
 end

data/lib/factpulse/models/invoice_input.rb

@@ -112,7 +112,7 @@ module FactPulse
       {
         :'invoice_id' => :'String',
         :'issue_date' => :'Date',
-        :'type_code' => :'FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode',
+        :'type_code' => :'InvoiceTypeCode',
         :'currency' => :'Currency',
         :'due_date' => :'Date',
         :'seller_siren' => :'String',

data/lib/factpulse/models/invoice_type_code.rb

@@ -15,25 +15,14 @@ require 'time'
 
 module FactPulse
   class InvoiceTypeCode
-    INVOICE = "380".freeze
-    SELF_BILLED_INVOICE = "389".freeze
-    FACTORED_INVOICE = "393".freeze
-    SELF_BILLED_FACTORED_INVOICE = "501".freeze
-    PREPAYMENT_INVOICE = "386".freeze
-    SELF_BILLED_PREPAYMENT_INVOICE = "500".freeze
-    CORRECTIVE_INVOICE = "384".freeze
-    SELF_BILLED_CORRECTIVE_INVOICE = "471".freeze
-    FACTORED_CORRECTIVE_INVOICE = "472".freeze
-    SELF_BILLED_FACTORED_CORRECTIVE_INVOICE = "473".freeze
-    CREDIT_NOTE = "381".freeze
-    SELF_BILLED_CREDIT_NOTE = "261".freeze
-    GLOBAL_ALLOWANCE_CREDIT_NOTE = "262".freeze
-    FACTORED_CREDIT_NOTE = "396".freeze
-    SELF_BILLED_FACTORED_CREDIT_NOTE = "502".freeze
-    PREPAYMENT_CREDIT_NOTE = "503".freeze
+    N380 = "380".freeze
+    N381 = "381".freeze
+    N384 = "384".freeze
+    N389 = "389".freeze
+    N386 = "386".freeze
 
     def self.all_vars
-      @all_vars ||= [INVOICE, SELF_BILLED_INVOICE, FACTORED_INVOICE, SELF_BILLED_FACTORED_INVOICE, PREPAYMENT_INVOICE, SELF_BILLED_PREPAYMENT_INVOICE, CORRECTIVE_INVOICE, SELF_BILLED_CORRECTIVE_INVOICE, FACTORED_CORRECTIVE_INVOICE, SELF_BILLED_FACTORED_CORRECTIVE_INVOICE, CREDIT_NOTE, SELF_BILLED_CREDIT_NOTE, GLOBAL_ALLOWANCE_CREDIT_NOTE, FACTORED_CREDIT_NOTE, SELF_BILLED_FACTORED_CREDIT_NOTE, PREPAYMENT_CREDIT_NOTE].freeze
+      @all_vars ||= [N380, N381, N384, N389, N386].freeze
     end
 
     # Builds the enum from string

data/lib/factpulse/models/simplified_invoice_data.rb

@@ -111,7 +111,7 @@ module FactPulse
         :'comment' => :'String',
         :'purchase_order_reference' => :'String',
         :'contract_reference' => :'String',
-        :'invoice_type' => :'InvoiceTypeCode',
+        :'invoice_type' => :'FactureElectroniqueModelsInvoiceTypeCode',
         :'preceding_invoice_reference' => :'String',
         :'operation_nature' => :'OperationNature',
         :'invoicing_framework' => :'InvoicingFrameworkCode'

data/lib/factpulse/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.19.0-SNAPSHOT
 =end
 
 module FactPulse
-  VERSION = '3.0.29'
+  VERSION = '3.0.31'
 end

data/lib/factpulse.rb

@@ -158,7 +158,7 @@ require 'factpulse/models/error_source'
 require 'factpulse/models/extraction_info'
 require 'factpulse/models/factur_x_invoice'
 require 'factpulse/models/factur_xpdf_info'
-require 'factpulse/models/facture_electronique_rest_api_schemas_ereporting_invoice_type_code'
+require 'factpulse/models/facture_electronique_models_invoice_type_code'
 require 'factpulse/models/facture_electronique_rest_api_schemas_processing_chorus_pro_credentials'
 require 'factpulse/models/field_status'
 require 'factpulse/models/file_info'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: factpulse
 version: !ruby/object:Gem::Version
-  version: 3.0.29
+  version: 3.0.31
 platform: ruby
 authors:
 - OpenAPI-Generator
@@ -263,7 +263,7 @@ files:
 - docs/ExtractionInfo.md
 - docs/FacturXInvoice.md
 - docs/FacturXPDFInfo.md
-- docs/FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode.md
+- docs/FactureElectroniqueModelsInvoiceTypeCode.md
 - docs/FactureElectroniqueRestApiSchemasProcessingChorusProCredentials.md
 - docs/FieldStatus.md
 - docs/FileInfo.md
@@ -562,7 +562,7 @@ files:
 - lib/factpulse/models/extraction_info.rb
 - lib/factpulse/models/factur_x_invoice.rb
 - lib/factpulse/models/factur_xpdf_info.rb
-- lib/factpulse/models/facture_electronique_rest_api_schemas_ereporting_invoice_type_code.rb
+- lib/factpulse/models/facture_electronique_models_invoice_type_code.rb
 - lib/factpulse/models/facture_electronique_rest_api_schemas_processing_chorus_pro_credentials.rb
 - lib/factpulse/models/field_status.rb
 - lib/factpulse/models/file_info.rb

data/docs/FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode.md

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