ruby-experian 0.0.6 → 0.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 041bb49fb2e7d162140687eb325980b61d82e6a9912bdb8133f4597476575e91
-  data.tar.gz: 7acd5b94f54997d5b01930c6ca063b8bd8869c3870311500e675ecb3cd832926
+  metadata.gz: 29b12fedd33ce8b9f2b1686ac1b2256477890e23fd08cd9d85fce514b6fea010
+  data.tar.gz: 496330fae0eb1cca5090dbe68c0759ddfd4b86e0451f0657fde0bb83f308ca11
 SHA512:
-  metadata.gz: dc7aa87e5cdb45bd69c3f190c4b4d407105b8a418ea9509a068e88c09406e50e02eef7ba06ebf6d07dd0361518a98c3aa09b316b627a9c9ea4ed089ff5178680
-  data.tar.gz: 4e3d8b6f4872434bcd30b1205d832751a20b30211f2a5b53c5dd0a463bbd3361bcfdb68cfdf0d3cea515042bae30f074f6d3844c3d3dd59b2f3aae5a5987bd54
+  metadata.gz: 9af32023b8b37a1aac6344e477b6dbc1121835d243bec35e269cb09216c341bdaf62691cfa1ce86ebf49730581ecd15a8ba08d80df33d772327e5583c0e7f9d2
+  data.tar.gz: eef00bbc5b09714183e62edcf4d52a45ad85145f7dcf689f37e0474531ebccc3444672ce8fc49d4fc56efb7993ac7377dbddaa50aeae399694f823827b876c0d

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    ruby-experian (0.0.6)
+    ruby-experian (0.0.8)
       faraday (>= 1)
       multi_xml (>= 0.6.0)
       rexml (>= 3.2)

data/README.md

@@ -132,6 +132,7 @@ The exposed sections for now are:
 - address
 - rating
 - number_of_employees
+- cnae
 
 ```ruby
 report = client.report(cif: "cif goes here")

data/lib/experian/client.rb

@@ -2,6 +2,9 @@ module Experian
   class Client
     include Experian::HTTP
 
+    TRADE_REPORT = 388
+    CREDIT_REPORT = 57
+
     CONFIG_KEYS = %i[
       user_code password request_timeout base_uri extra_headers
     ].freeze
@@ -16,10 +19,29 @@ module Experian
       @faraday_middleware = faraday_middleware
     end
 
-    def report(cif:, format: :xml)
-      response = get(path: "/informe", format:, cif:, cod_servicio: 57)
+    def credit_report(cif:, format: :xml, as_response: false)
+      response = get(
+        path: "/informe",
+        format:,
+        cif:,
+        cod_servicio: CREDIT_REPORT
+      )
+
+      return Experian::CreditReport.new(response) if format == :xml && !as_response
+
+      response
+    end
+
+    def trade_report(cif:, format: :xml, request_update: true, as_response: false)
+      response = get(
+        path: "/informe",
+        format:,
+        cif:,
+        garantizar_bajo_demanda: request_update ? 1 : 0,
+        cod_servicio: TRADE_REPORT,
+      )
 
-      return Experian::Report.new(response) if format == :xml
+      return Experian::TradeReport.new(response) if format == :xml && !as_response
 
       response
     end

data/lib/experian/credit_report.rb

@@ -0,0 +1,57 @@
+require "multi_xml"
+require "rexml"
+
+module Experian
+  class CreditReport < Report
+    def id
+      if (id_xml = data["DatosIdentificativos"])
+        OpenStruct.new(
+          cif: id_xml["Cif"],
+          name: id_xml["Nombre"],
+          infotel_code: id_xml["CodigoInfotel"],
+          incorporation_date: Date.parse(id_xml["FechaFundacion"]),
+          social_form: id_xml["FormaSocial"]["__content__"],
+        )
+      end
+    end
+
+    def address
+      if (address_xml = data["DomicilioComercial"])
+        OpenStruct.new(
+          line: address_xml["Domicilio"],
+          city: address_xml["Poblacion"],
+          province: address_xml["Provincia"],
+          postal_code: address_xml["CodigoPostal"],
+          municipality: address_xml["Municipio"],
+        )
+      end
+    end
+
+    # Number of employees in the last recorded excercise
+    def number_of_employees
+      data.dig("ListaAnualEmpleados", "Empleado")&.first&.dig("EmpleadoFijo")&.to_i
+    end
+
+    def rating
+      if (rating_xml = data["Rating"])
+        return unless rating_xml["RatingAxesorDef"]
+
+        OpenStruct.new(
+          score: rating_xml["RatingAxesorDef"]&.strip&.to_i,
+          default_probability: rating_xml["ProbImpago"]&.to_f,
+          risk: rating_xml["GrupoRiesgo"],
+          size: rating_xml["Tamaño"],
+        )
+      end
+    end
+
+    def cnae
+      data.dig("ActividadComercial", "Cnae")&.first&.dig("Codigo")&.to_i
+    end
+
+    def constitution_date
+      date = data.dig("DatosConstitutivos", "FechaConstitucion")
+      date && Date.parse(date)
+    end
+  end
+end

data/lib/experian/report.rb

@@ -12,55 +12,27 @@ module Experian
       MultiXml.parser = :rexml
       @xml = MultiXml.parse(@raw_xml)
 
-      raise Experian::AuthenticationError if authentication_error?
+      raise error, error_message if error
     end
 
-    def id
-      if (id_xml = data["DatosIdentificativos"])
-        OpenStruct.new(
-          cif: id_xml["Cif"],
-          name: id_xml["Nombre"],
-          infotel_code: id_xml["CodigoInfotel"],
-          incorporation_date: id_xml["FechaFundacion"],
-          social_form: id_xml["FormaSocial"]["__content__"],
-        )
-      end
-    end
-
-    def address
-      if (address_xml = data["DomicilioComercial"])
-        OpenStruct.new(
-          line: address_xml["Domicilio"],
-          city: address_xml["Poblacion"],
-          province: address_xml["Provincia"],
-          postal_code: address_xml["CodigoPostal"],
-          municipality: address_xml["Municipio"],
-        )
-      end
-    end
+    protected
 
-    # Number of employees in the last recorded excercise
-    def number_of_employees
-      data.dig("ListaAnualEmpleados", "Empleado")&.first&.dig("EmpleadoFijo")&.to_i
+    def data
+      xml.dig("ServicioWebAxesor", "ListaPaquetesNegocio")
     end
 
-    def rating
-      if (rating_xml = data["Rating"])
-        return unless rating_xml["RatingAxesorDef"]
+    def error
+      return Experian::AuthenticationError if authentication_error?
 
-        OpenStruct.new(
-          score: rating_xml["RatingAxesorDef"]&.strip&.to_i,
-          default_probability: rating_xml["ProbImpago"]&.to_f,
-          risk: rating_xml["GrupoRiesgo"],
-          size: rating_xml["Tamaño"],
-        )
-      end
+      Experian::Error if any_other_error?
     end
 
-    private
+    def error_message
+      xml.dig("DatosError", "DesError")
+    end
 
-    def data
-      xml.dig("ServicioWebAxesor", "ListaPaquetesNegocio")
+    def any_other_error?
+      xml.dig("DatosError", "CodError")
     end
 
     def authentication_error?

data/lib/experian/trade_report.rb

@@ -0,0 +1,55 @@
+module Experian
+  class TradeReport < Report
+    def model_200(period: last_submitted_year)
+      {
+        # Balance Sheet - Assets
+        "00101" => financial_data("Activo", "11000", period:), # ACTIVO NO CORRIENTE
+        "00102" => financial_data("Activo", "11100", period:), # Inmovilizado intangible
+        "00136" => financial_data("Activo", "12000", period:), # ACTIVO CORRIENTE
+        "00138" => financial_data("Activo", "12200", period:), # Existencias
+        "00149" => financial_data("Activo", "12300", period:), # Deudores comerciales y otras cuentas a cobrar
+        "00177" => financial_data("Activo", "12700", period:), # Efectivo y otros activos líquidos equivalentes
+        "00180" => financial_data("Activo", "10000", period:), # TOTAL ACTIVO
+
+        # Balance Sheet - Liabilities
+        "00185" => financial_data("Pasivo", "20000", period:), # PATRIMONIO NETO
+        "00210" => financial_data("Pasivo", "31000", period:), # PASIVO NO CORRIENTE
+        "00216" => financial_data("Pasivo", "31200", period:), # Deudas a largo plazo
+        "00228" => financial_data("Pasivo", "32000", period:), # PASIVO CORRIENTE
+        "00231" => financial_data("Pasivo", "32300", period:), # Deudas a corto plazo
+        "00239" => financial_data("Pasivo", "32500", period:), # Acreedores comerciales y otras cuentas a pagar
+
+        # P&L
+        "00255" => financial_data("PerdidasGanancias", "40100", period:), # Importe neto de la cifra de negocios
+        "00260" => financial_data("PerdidasGanancias", "40400", period:), # Aprovisionamientos
+        "00265" => financial_data("PerdidasGanancias", "40500", period:), # Otros ingresos de explotación
+        "00284" => financial_data("PerdidasGanancias", "40800", period:), # Amortización del inmovilizado
+        "00285" => financial_data("PerdidasGanancias", "40900", period:), # Imputación de subvenciones de inmovilizado no financiero y otras
+        "00286" => financial_data("PerdidasGanancias", "41000", period:), # Excesos de provisiones
+        "00287" => financial_data("PerdidasGanancias", "41100", period:), # Deterioro y resultado por enajenaciones del inmovilizad
+        "00296" => financial_data("PerdidasGanancias", "49100", period:), # Resultado de explotacion
+        "00305" => financial_data("PerdidasGanancias", "41500", period:), # Gastos Financieros
+        "00326" => financial_data("PerdidasGanancias", "41900", period:), # Impuestos Sobre Beneficios
+        "00327" => financial_data("PerdidasGanancias", "49500", period:), # RESULTADO DEL EJERCICIO PROCEDENTE DE OPERACIONES CONTINUADAS
+      }
+    end
+
+    private
+
+    def last_submitted_year
+      (Date.today << 18).year
+    end
+
+    def financial_data(section_name, value_name, period:)
+      value_section = section(section_name)
+
+      if value_name
+        value_section&.find { |d| d["Tipo"] == value_name }&.dig("ListaValores", "Valor")&.find { |v| v["Periodo"] == period.to_s }&.dig("Individual")&.to_i
+      end
+    end
+
+    def section(section_name)
+      data.dig("InformeEconomicoFinanciero")&.first&.dig("ListaGrupos", "Grupo").find { |d| d["Tipo"][section_name] }&.dig("ListaColumnas", "Columna", "ListaDatos", "Dato")
+    end
+  end
+end

data/lib/experian/version.rb

@@ -1,3 +1,3 @@
 module Experian
-  VERSION = "0.0.6".freeze
+  VERSION = "0.0.8".freeze
 end

data/lib/experian.rb

@@ -4,6 +4,8 @@ require_relative "experian/http"
 require_relative "experian/client"
 require_relative "experian/version"
 require_relative "experian/report"
+require_relative "experian/credit_report"
+require_relative "experian/trade_report"
 
 module Experian
   class Error < StandardError; end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby-experian
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.8
 platform: ruby
 authors:
 - Martin Mochetti
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-03-07 00:00:00.000000000 Z
+date: 2024-04-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -92,8 +92,10 @@ files:
 - bin/setup
 - lib/experian.rb
 - lib/experian/client.rb
+- lib/experian/credit_report.rb
 - lib/experian/http.rb
 - lib/experian/report.rb
+- lib/experian/trade_report.rb
 - lib/experian/version.rb
 - lib/ruby/experian.rb
 - ruby-experian.gemspec