factpulse 3.0.37 → 4.0.0

data/lib/factpulse/helpers/exceptions.rb

@@ -1,21 +1,45 @@
 # frozen_string_literal: true
+
 module FactPulse
-  module Helpers
-    class FactPulseError < StandardError; end
-    class FactPulseAuthError < FactPulseError; end
-    class FactPulsePollingTimeout < FactPulseError
-      attr_reader :task_id, :timeout
-      def initialize(task_id, timeout); @task_id, @timeout = task_id, timeout; super("Timeout (#{timeout}ms) for #{task_id}"); end
+  # Additional error types (base Error class is in client.rb)
+  class AuthError < Error; end
+
+  class PollingTimeout < Error
+    attr_reader :task_id, :timeout
+
+    def initialize(task_id, timeout)
+      @task_id = task_id
+      @timeout = timeout
+      super("Timeout (#{timeout}ms) for #{task_id}")
     end
-    class ValidationErrorDetail
-      attr_accessor :level, :item, :reason, :source, :code
-      def initialize(level: '', item: '', reason: '', source: nil, code: nil); @level, @item, @reason, @source, @code = level, item, reason, source, code; end
-      def to_s; "[#{@item.to_s.empty? ? 'unknown' : @item}] #{@reason.to_s.empty? ? 'Unknown error' : @reason}"; end
-      def self.from_hash(h); new(level: h['level']||'', item: h['item']||'', reason: h['reason']||'', source: h['source'], code: h['code']); end
+  end
+
+  class ValidationErrorDetail
+    attr_accessor :level, :item, :reason, :source, :code
+
+    def initialize(level: '', item: '', reason: '', source: nil, code: nil)
+      @level = level
+      @item = item
+      @reason = reason
+      @source = source
+      @code = code
+    end
+
+    def to_s
+      "[#{@item.to_s.empty? ? 'unknown' : @item}] #{@reason.to_s.empty? ? 'Unknown error' : @reason}"
     end
-    class FactPulseValidationError < FactPulseError
-      attr_reader :errors
-      def initialize(msg, errors = []); @errors = errors; super(errors.empty? ? msg : "#{msg}\n\nDetails:\n#{errors.map{|e| "  - #{e}"}.join("\n")}"); end
+
+    def self.from_hash(h)
+      new(level: h['level'] || '', item: h['item'] || '', reason: h['reason'] || '', source: h['source'], code: h['code'])
+    end
+  end
+
+  class ValidationError < Error
+    attr_reader :errors
+
+    def initialize(msg, errors = [])
+      @errors = errors
+      super(errors.empty? ? msg : "#{msg}\n\nDetails:\n#{errors.map { |e| "  - #{e}" }.join("\n")}")
     end
   end
 end

data/lib/factpulse/helpers/helpers.rb

@@ -1,13 +1,14 @@
 # frozen_string_literal: true
-require_relative 'exceptions'
+
+# Load client first (defines FactPulse::Error base class)
 require_relative 'client'
+# Then load additional exception types
+require_relative 'exceptions'
+
 module FactPulse
   module Helpers
-    def self.create_client(**opts); FactPulseClient.new(**opts); end
-    def self.format_amount(m); AmountHelpers.amount(m); end
-    def self.amount(m); AmountHelpers.amount(m); end
-    def self.invoice_totals(*args, **kwargs); AmountHelpers.invoice_totals(*args, **kwargs); end
-    def self.invoice_line(*args, **kwargs); AmountHelpers.invoice_line(*args, **kwargs); end
-    def self.vat_line(*args, **kwargs); AmountHelpers.vat_line(*args, **kwargs); end
+    def self.create_client(**opts)
+      FactPulse::Client.new(**opts)
+    end
   end
 end

data/lib/factpulse/models/chorus_pro_credentials.rb

@@ -14,27 +14,31 @@ require 'date'
 require 'time'
 
 module FactPulse
-  # Optional Chorus Pro credentials.  **MODE 1 - JWT retrieval (recommended):** Do not provide this `credentials` field in the payload. Credentials will be automatically retrieved via client_uid from JWT (0-trust).  **MODE 2 - Credentials in payload:** Provide all required fields below. Useful for tests or third-party integrations.
+  # Chorus Pro credentials for Zero-Trust mode.  **Zero-Trust Mode**: Credentials are passed in each request and are NEVER stored.  **Security**: - Credentials are never persisted in the database - They are used only for the duration of the request - Secure transmission via HTTPS  **Use cases**: - High-security environments (banks, administrations) - Strict GDPR compliance - Tests with temporary credentials - Users who don't want to store their credentials
   class ChorusProCredentials < ApiModelBase
+    # PISTE Client ID (government API portal)
     attr_accessor :piste_client_id
 
+    # PISTE Client Secret
     attr_accessor :piste_client_secret
 
-    attr_accessor :chorus_login
+    # Chorus Pro login
+    attr_accessor :chorus_pro_login
 
-    attr_accessor :chorus_password
+    # Chorus Pro password
+    attr_accessor :chorus_pro_password
 
-    # [MODE 2] Use sandbox mode (default: True)
-    attr_accessor :sandbox_mode
+    # Use sandbox environment (true) or production (false)
+    attr_accessor :sandbox
 
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'piste_client_id' => :'pisteClientId',
         :'piste_client_secret' => :'pisteClientSecret',
-        :'chorus_login' => :'chorusLogin',
-        :'chorus_password' => :'chorusPassword',
-        :'sandbox_mode' => :'sandboxMode'
+        :'chorus_pro_login' => :'chorusProLogin',
+        :'chorus_pro_password' => :'chorusProPassword',
+        :'sandbox' => :'sandbox'
       }
     end
 
@@ -53,19 +57,15 @@ module FactPulse
       {
         :'piste_client_id' => :'String',
         :'piste_client_secret' => :'String',
-        :'chorus_login' => :'String',
-        :'chorus_password' => :'String',
-        :'sandbox_mode' => :'Boolean'
+        :'chorus_pro_login' => :'String',
+        :'chorus_pro_password' => :'String',
+        :'sandbox' => :'Boolean'
       }
     end
 
     # List of attributes with nullable: true
     def self.openapi_nullable
       Set.new([
-        :'piste_client_id',
-        :'piste_client_secret',
-        :'chorus_login',
-        :'chorus_password',
       ])
     end
 
@@ -87,24 +87,32 @@ module FactPulse
 
       if attributes.key?(:'piste_client_id')
         self.piste_client_id = attributes[:'piste_client_id']
+      else
+        self.piste_client_id = nil
       end
 
       if attributes.key?(:'piste_client_secret')
         self.piste_client_secret = attributes[:'piste_client_secret']
+      else
+        self.piste_client_secret = nil
       end
 
-      if attributes.key?(:'chorus_login')
-        self.chorus_login = attributes[:'chorus_login']
+      if attributes.key?(:'chorus_pro_login')
+        self.chorus_pro_login = attributes[:'chorus_pro_login']
+      else
+        self.chorus_pro_login = nil
       end
 
-      if attributes.key?(:'chorus_password')
-        self.chorus_password = attributes[:'chorus_password']
+      if attributes.key?(:'chorus_pro_password')
+        self.chorus_pro_password = attributes[:'chorus_pro_password']
+      else
+        self.chorus_pro_password = nil
       end
 
-      if attributes.key?(:'sandbox_mode')
-        self.sandbox_mode = attributes[:'sandbox_mode']
+      if attributes.key?(:'sandbox')
+        self.sandbox = attributes[:'sandbox']
       else
-        self.sandbox_mode = true
+        self.sandbox = true
       end
     end
 
@@ -113,6 +121,22 @@ module FactPulse
     def list_invalid_properties
       warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
       invalid_properties = Array.new
+      if @piste_client_id.nil?
+        invalid_properties.push('invalid value for "piste_client_id", piste_client_id cannot be nil.')
+      end
+
+      if @piste_client_secret.nil?
+        invalid_properties.push('invalid value for "piste_client_secret", piste_client_secret cannot be nil.')
+      end
+
+      if @chorus_pro_login.nil?
+        invalid_properties.push('invalid value for "chorus_pro_login", chorus_pro_login cannot be nil.')
+      end
+
+      if @chorus_pro_password.nil?
+        invalid_properties.push('invalid value for "chorus_pro_password", chorus_pro_password cannot be nil.')
+      end
+
       invalid_properties
     end
 
@@ -120,9 +144,53 @@ module FactPulse
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @piste_client_id.nil?
+      return false if @piste_client_secret.nil?
+      return false if @chorus_pro_login.nil?
+      return false if @chorus_pro_password.nil?
       true
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] piste_client_id Value to be assigned
+    def piste_client_id=(piste_client_id)
+      if piste_client_id.nil?
+        fail ArgumentError, 'piste_client_id cannot be nil'
+      end
+
+      @piste_client_id = piste_client_id
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] piste_client_secret Value to be assigned
+    def piste_client_secret=(piste_client_secret)
+      if piste_client_secret.nil?
+        fail ArgumentError, 'piste_client_secret cannot be nil'
+      end
+
+      @piste_client_secret = piste_client_secret
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] chorus_pro_login Value to be assigned
+    def chorus_pro_login=(chorus_pro_login)
+      if chorus_pro_login.nil?
+        fail ArgumentError, 'chorus_pro_login cannot be nil'
+      end
+
+      @chorus_pro_login = chorus_pro_login
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] chorus_pro_password Value to be assigned
+    def chorus_pro_password=(chorus_pro_password)
+      if chorus_pro_password.nil?
+        fail ArgumentError, 'chorus_pro_password cannot be nil'
+      end
+
+      @chorus_pro_password = chorus_pro_password
+    end
+
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)
@@ -130,9 +198,9 @@ module FactPulse
       self.class == o.class &&
           piste_client_id == o.piste_client_id &&
           piste_client_secret == o.piste_client_secret &&
-          chorus_login == o.chorus_login &&
-          chorus_password == o.chorus_password &&
-          sandbox_mode == o.sandbox_mode
+          chorus_pro_login == o.chorus_pro_login &&
+          chorus_pro_password == o.chorus_pro_password &&
+          sandbox == o.sandbox
     end
 
     # @see the `==` method
@@ -144,7 +212,7 @@ module FactPulse
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [piste_client_id, piste_client_secret, chorus_login, chorus_password, sandbox_mode].hash
+      [piste_client_id, piste_client_secret, chorus_pro_login, chorus_pro_password, sandbox].hash
     end
 
     # Builds the object from hash

data/lib/factpulse/models/chorus_pro_destination.rb

@@ -64,7 +64,7 @@ module FactPulse
     def self.openapi_types
       {
         :'type' => :'String',
-        :'credentials' => :'ChorusProCredentials'
+        :'credentials' => :'FactureElectroniqueRestApiSchemasProcessingChorusProCredentials'
       }
     end
 

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/{facture_electronique_rest_api_schemas_validation_validation_error_response.rb → facture_electronique_rest_api_schemas_cdar_validation_error_response.rb}

@@ -14,15 +14,26 @@ require 'date'
 require 'time'
 
 module FactPulse
-  # Response for validation errors.
-  class FactureElectroniqueRestApiSchemasValidationValidationErrorResponse < ApiModelBase
-    # List of detected validation errors.
-    attr_accessor :detail
+  # Erreur de validation.
+  class FactureElectroniqueRestApiSchemasCdarValidationErrorResponse < ApiModelBase
+    # Champ concerné
+    attr_accessor :field
+
+    # Message d'erreur
+    attr_accessor :message
+
+    attr_accessor :rule
+
+    # Sévérité (error/warning)
+    attr_accessor :severity
 
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
-        :'detail' => :'detail'
+        :'field' => :'field',
+        :'message' => :'message',
+        :'rule' => :'rule',
+        :'severity' => :'severity'
       }
     end
 
@@ -39,13 +50,17 @@ module FactPulse
     # Attribute type mapping.
     def self.openapi_types
       {
-        :'detail' => :'Array<String>'
+        :'field' => :'String',
+        :'message' => :'String',
+        :'rule' => :'String',
+        :'severity' => :'String'
       }
     end
 
     # List of attributes with nullable: true
     def self.openapi_nullable
       Set.new([
+        :'rule',
       ])
     end
 
@@ -53,24 +68,38 @@ module FactPulse
     # @param [Hash] attributes Model attributes in the form of hash
     def initialize(attributes = {})
       if (!attributes.is_a?(Hash))
-        fail ArgumentError, "The input argument (attributes) must be a hash in `FactPulse::FactureElectroniqueRestApiSchemasValidationValidationErrorResponse` initialize method"
+        fail ArgumentError, "The input argument (attributes) must be a hash in `FactPulse::FactureElectroniqueRestApiSchemasCdarValidationErrorResponse` initialize method"
       end
 
       # check to see if the attribute exists and convert string to symbol for hash key
       acceptable_attribute_map = self.class.acceptable_attribute_map
       attributes = attributes.each_with_object({}) { |(k, v), h|
         if (!acceptable_attribute_map.key?(k.to_sym))
-          fail ArgumentError, "`#{k}` is not a valid attribute in `FactPulse::FactureElectroniqueRestApiSchemasValidationValidationErrorResponse`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+          fail ArgumentError, "`#{k}` is not a valid attribute in `FactPulse::FactureElectroniqueRestApiSchemasCdarValidationErrorResponse`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
         end
         h[k.to_sym] = v
       }
 
-      if attributes.key?(:'detail')
-        if (value = attributes[:'detail']).is_a?(Array)
-          self.detail = value
-        end
+      if attributes.key?(:'field')
+        self.field = attributes[:'field']
+      else
+        self.field = nil
+      end
+
+      if attributes.key?(:'message')
+        self.message = attributes[:'message']
       else
-        self.detail = nil
+        self.message = nil
+      end
+
+      if attributes.key?(:'rule')
+        self.rule = attributes[:'rule']
+      end
+
+      if attributes.key?(:'severity')
+        self.severity = attributes[:'severity']
+      else
+        self.severity = 'error'
       end
     end
 
@@ -79,8 +108,12 @@ module FactPulse
     def list_invalid_properties
       warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
       invalid_properties = Array.new
-      if @detail.nil?
-        invalid_properties.push('invalid value for "detail", detail cannot be nil.')
+      if @field.nil?
+        invalid_properties.push('invalid value for "field", field cannot be nil.')
+      end
+
+      if @message.nil?
+        invalid_properties.push('invalid value for "message", message cannot be nil.')
       end
 
       invalid_properties
@@ -90,18 +123,29 @@ module FactPulse
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
-      return false if @detail.nil?
+      return false if @field.nil?
+      return false if @message.nil?
       true
     end
 
     # Custom attribute writer method with validation
-    # @param [Object] detail Value to be assigned
-    def detail=(detail)
-      if detail.nil?
-        fail ArgumentError, 'detail cannot be nil'
+    # @param [Object] field Value to be assigned
+    def field=(field)
+      if field.nil?
+        fail ArgumentError, 'field cannot be nil'
+      end
+
+      @field = field
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] message Value to be assigned
+    def message=(message)
+      if message.nil?
+        fail ArgumentError, 'message cannot be nil'
       end
 
-      @detail = detail
+      @message = message
     end
 
     # Checks equality by comparing each attribute.
@@ -109,7 +153,10 @@ module FactPulse
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
-          detail == o.detail
+          field == o.field &&
+          message == o.message &&
+          rule == o.rule &&
+          severity == o.severity
     end
 
     # @see the `==` method
@@ -121,7 +168,7 @@ module FactPulse
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [detail].hash
+      [field, message, rule, severity].hash
     end
 
     # Builds the object from hash