factpulse 3.0.29 → 3.0.30

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 04a881e701ac9a5e0b5a83bae874c425a06ce0f8bc42e2747141c6cc910dbe83
-  data.tar.gz: 57418b7ace370be58d37f6afb118d878c25a0f219562ad53d1a3d25d9029c5ef
+  metadata.gz: 673983cc0c0d989607d88a25c76e8a81c87acf975a6869d8b985ba3a352535b6
+  data.tar.gz: f1e84bb17377cf6bf4ccbf5e3d963ccd43c10d3c3be2a3e18640d286c3e53e61
 SHA512:
-  metadata.gz: e02ea82aa7555b6ea823ccb440d766a91250150405a77e0d6cfd448644cb52629fddba76304dede6b868625f930dac8d21fdcc4ed2c301581dd3646274792ba7
-  data.tar.gz: b48ac47c664ef5f1ba7060cb2f54bf33ab4bdd35a6ca779cf3157f0ce33629d9d3270b0bd16c4119ce70aaa7f16eee1c47d3c3bbf87d259dc288f0a6beb0d5e2
+  metadata.gz: 3b47cda21454ea34e0230e977577aae143df27843d31706a6042ae57bfe875a19a730de22eb45afbe7b8f6463e9ff1f09a9a15368e79ef42f1f6d26884aa2ff8
+  data.tar.gz: 57f37e3b73c29d95c087cabf36e2b2e16c191b9af5cfb73cf800f867f94aae82e887dc6ad793a9023fe0188e8e9248ec089fb87833b77700fbc6931d033510ae

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.30] - 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.30...HEAD
+[3.0.30]: https://github.com/factpulse/sdk-ruby/releases/tag/v3.0.30

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    factpulse (3.0.29)
+    factpulse (3.0.30)
       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/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/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: factpulse
 version: !ruby/object:Gem::Version
-  version: 3.0.29
+  version: 3.0.30
 platform: ruby
 authors:
 - OpenAPI-Generator