factpulse 2.0.13 → 2.0.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 13f4495a8ee788cb3614bbbeb3c6b65c744f877b9abd114090c003b0230768f5
-  data.tar.gz: 437f910edd71aec05f4a5429c129607b9062639833f80df08200d6eccbcc68e9
+  metadata.gz: d90e8924df4d27436352163dd3853a74d4c1bad90e590dd630cf630badf9ffb0
+  data.tar.gz: 6665e587c4be3a018c39e8ea4cd15c0e7f9c8dd854394503f6674218b63cf815
 SHA512:
-  metadata.gz: 376bf0dd3b86dba80279206b3551167e78e1144244fa702799eb0b99f84e9c55b48d7c50d70cba10a7edf5bc9b8181470a95fe04b665f13e2b78640d52b63281
-  data.tar.gz: 194e1316ca40a8e14ebab4998e2dd54a5e2157aeb040260e898d8cfe3d604ca5d728f644c1370179cd480a96801ceffafb761bd89f09d42f0a9233ed1829aedf
+  metadata.gz: 9aea5a50e588d5a0e09c4c1ee9dcb9eb54a4ec540f83478eb44351b39f58259effed82a748baf9cc608779ae3a2561d55a165f6fac1ad2a75698559377f33537
+  data.tar.gz: 481ddb35c466d369263b95452e6a868fd8771cbbb1400d7a19cfae50186fc12ddd11ee1f8d0cc13c9c0e5bb79fef8b18e393f6b2fd356397b67b0a2287e15588

data/CHANGELOG.md

@@ -7,7 +7,7 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
-## [2.0.13] - 2025-11-26
+## [2.0.14] - 2025-11-26
 
 ### 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/v2.0.13...HEAD
-[2.0.13]: https://github.com/factpulse/sdk-ruby/releases/tag/v2.0.13
+[Unreleased]: https://github.com/factpulse/sdk-ruby/compare/v2.0.14...HEAD
+[2.0.14]: https://github.com/factpulse/sdk-ruby/releases/tag/v2.0.14

data/Gemfile.lock

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

data/lib/factpulse/helpers/client.rb

@@ -3,13 +3,90 @@ require 'net/http'; require 'json'; require 'base64'; require 'uri'; require 'se
 
 module FactPulse
   module Helpers
+    # Credentials Chorus Pro pour le mode Zero-Trust.
+    # Ces credentials sont passés dans chaque requête et ne sont jamais stockés côté serveur.
+    class ChorusProCredentials
+      attr_reader :piste_client_id, :piste_client_secret, :chorus_pro_login, :chorus_pro_password, :sandbox
+      def initialize(piste_client_id:, piste_client_secret:, chorus_pro_login:, chorus_pro_password:, sandbox: true)
+        @piste_client_id, @piste_client_secret = piste_client_id, piste_client_secret
+        @chorus_pro_login, @chorus_pro_password, @sandbox = chorus_pro_login, chorus_pro_password, sandbox
+      end
+      def to_h
+        { 'piste_client_id' => @piste_client_id, 'piste_client_secret' => @piste_client_secret,
+          'chorus_pro_login' => @chorus_pro_login, 'chorus_pro_password' => @chorus_pro_password, 'sandbox' => @sandbox }
+      end
+    end
+
+    # Credentials AFNOR PDP pour le mode Zero-Trust.
+    # Ces credentials sont passés dans chaque requête et ne sont jamais stockés côté serveur.
+    class AFNORCredentials
+      attr_reader :client_id, :client_secret, :flow_service_url
+      def initialize(client_id:, client_secret:, flow_service_url:)
+        @client_id, @client_secret, @flow_service_url = client_id, client_secret, flow_service_url
+      end
+      def to_h
+        { 'client_id' => @client_id, 'client_secret' => @client_secret, 'flow_service_url' => @flow_service_url }
+      end
+    end
+
+    # Helpers pour créer des montants totaux simplifiés.
+    module MontantHelpers
+      def self.montant(value)
+        return '0.00' if value.nil?
+        return format('%.2f', value) if value.is_a?(Numeric)
+        value.is_a?(String) ? value : '0.00'
+      end
+
+      def self.montant_total(ht, tva, ttc, a_payer, remise_ttc: nil, motif_remise: nil, acompte: nil)
+        result = {
+          'montantHtTotal' => montant(ht), 'montantTva' => montant(tva),
+          'montantTtcTotal' => montant(ttc), 'montantAPayer' => montant(a_payer)
+        }
+        result['montantRemiseGlobaleTtc'] = montant(remise_ttc) if remise_ttc
+        result['motifRemiseGlobaleTtc'] = motif_remise if motif_remise
+        result['acompte'] = montant(acompte) if acompte
+        result
+      end
+
+      def self.ligne_de_poste(numero, denomination, quantite, montant_unitaire_ht, montant_ligne_ht,
+                              taux_tva: '20.00', unite: 'C62', **options)
+        result = {
+          'numero' => numero, 'denomination' => denomination,
+          'quantite' => montant(quantite), 'montantUnitaireHt' => montant(montant_unitaire_ht),
+          'montantTotalLigneHt' => montant(montant_ligne_ht), 'tauxTva' => montant(taux_tva), 'unite' => unite
+        }
+        result['montantTvaLigne'] = montant(options[:montant_tva_ligne]) if options[:montant_tva_ligne]
+        result['montantRemiseHt'] = montant(options[:montant_remise_ht]) if options[:montant_remise_ht]
+        result['codeRaisonReduction'] = options[:code_raison_remise] if options[:code_raison_remise]
+        result['motifRemise'] = options[:motif_remise] if options[:motif_remise]
+        result['description'] = options[:description] if options[:description]
+        result
+      end
+
+      def self.ligne_de_tva(taux, base_ht, montant_tva, categorie: 'S', motif_exoneration: nil)
+        result = {
+          'tauxTva' => montant(taux), 'montantBaseHt' => montant(base_ht),
+          'montantTva' => montant(montant_tva), 'categorieTva' => categorie
+        }
+        result['motifExoneration'] = motif_exoneration if motif_exoneration
+        result
+      end
+    end
+
     class FactPulseClient
-      def initialize(email:, password:, api_url: nil, client_uid: nil, polling_interval: nil, polling_timeout: nil, max_retries: nil)
+      attr_reader :chorus_credentials, :afnor_credentials
+
+      def initialize(email:, password:, api_url: nil, client_uid: nil, chorus_credentials: nil, afnor_credentials: nil,
+                     polling_interval: nil, polling_timeout: nil, max_retries: nil)
         @email, @password = email, password; @api_url = (api_url || 'https://factpulse.fr').chomp('/')
         @client_uid, @polling_interval, @polling_timeout, @max_retries = client_uid, polling_interval || 2000, polling_timeout || 120000, max_retries || 1
+        @chorus_credentials, @afnor_credentials = chorus_credentials, afnor_credentials
         @access_token = @refresh_token = @token_expires_at = nil
       end
 
+      def chorus_credentials_for_api; @chorus_credentials&.to_h; end
+      def afnor_credentials_for_api; @afnor_credentials&.to_h; end
+
       def ensure_authenticated(force_refresh: false)
         now = (Time.now.to_f * 1000).to_i
         if force_refresh || @access_token.nil? || (@token_expires_at && now >= @token_expires_at)
@@ -40,7 +117,7 @@ module FactPulse
         end
       end
 
-      def self.format_montant(m); m.nil? ? '0.00' : (m.is_a?(Numeric) ? format('%.2f', m) : (m.is_a?(String) ? m : '0.00')); end
+      def self.format_montant(m); MontantHelpers.montant(m); end
 
       private
       def http_post(uri, payload)

data/lib/factpulse/helpers.rb

@@ -4,6 +4,10 @@ require_relative 'helpers/client'
 module FactPulse
   module Helpers
     def self.create_client(**opts); FactPulseClient.new(**opts); end
-    def self.format_montant(m); FactPulseClient.format_montant(m); end
+    def self.format_montant(m); MontantHelpers.montant(m); end
+    def self.montant(m); MontantHelpers.montant(m); end
+    def self.montant_total(*args, **kwargs); MontantHelpers.montant_total(*args, **kwargs); end
+    def self.ligne_de_poste(*args, **kwargs); MontantHelpers.ligne_de_poste(*args, **kwargs); end
+    def self.ligne_de_tva(*args, **kwargs); MontantHelpers.ligne_de_tva(*args, **kwargs); end
   end
 end

data/lib/factpulse/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.18.0-SNAPSHOT
 =end
 
 module FactPulse
-  VERSION = '2.0.13'
+  VERSION = '2.0.14'
 end

metadata

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