ecf-dgii 1.0.2

data/lib/ecf_dgii/client.rb

@@ -0,0 +1,343 @@
+require "uri"
+
+module EcfDgii
+  class Client
+    ENVIRONMENT_URLS = {
+      test: "https://api.test.ecfx.ssd.com.do",
+      cert: "https://api.cert.ecfx.ssd.com.do",
+      prod: "https://api.prod.ecfx.ssd.com.do"
+    }.freeze
+
+    attr_reader :api_client, :environment
+
+    def initialize(api_key: nil, base_url: nil, environment: :test, timeout: 30)
+      token = api_key || ENV["ECF_API_KEY"]
+      resolved_url = base_url || ENV["ECF_API_URL"] || ENVIRONMENT_URLS[environment.to_sym]
+      raise ArgumentError, "Se requiere un api_key o la variable de entorno ECF_API_KEY" if token.nil? || token.empty?
+      raise ArgumentError, "El entorno especificado o la URL base no son válidos" if resolved_url.nil? || resolved_url.empty?
+
+      config = EcfDgii::Generated::Configuration.new
+      uri = URI.parse(resolved_url)
+      
+      config.scheme = uri.scheme
+      config.host = uri.host
+      config.base_path = uri.path.empty? ? "" : uri.path
+      
+      config.access_token = token
+      config.timeout = timeout
+
+      @api_client = EcfDgii::Generated::ApiClient.new(config)
+      @environment = environment.to_sym
+    end
+
+    # ------------------------------------------------------------------
+    # Base API Clients
+    # ------------------------------------------------------------------
+
+    def ecf_api
+      @ecf_api ||= EcfDgii::Generated::EcfApi.new(api_client)
+    end
+
+    def dgii_api
+      @dgii_api ||= EcfDgii::Generated::DgiiApi.new(api_client)
+    end
+
+    def recepcion_api
+      @recepcion_api ||= EcfDgii::Generated::RecepcionApi.new(api_client)
+    end
+
+    def company_api
+      @company_api ||= EcfDgii::Generated::CompanyApi.new(api_client)
+    end
+
+    def aprobacion_comercial_api
+      @aprobacion_comercial_api ||= EcfDgii::Generated::AprobacionComercialApi.new(api_client)
+    end
+
+    def api_key_api
+      @api_key_api ||= EcfDgii::Generated::ApiKeyApi.new(api_client)
+    end
+
+    # ------------------------------------------------------------------
+    # ECF send operations (per-type)
+    # ------------------------------------------------------------------
+
+    def send_ecf31(ecf)
+      ecf_api.recepcion_ecf_31(ecf)
+    end
+
+    def send_ecf32(ecf)
+      ecf_api.recepcion_ecf_32(ecf)
+    end
+
+    def send_ecf33(ecf)
+      ecf_api.recepcion_ecf_33(ecf)
+    end
+
+    def send_ecf34(ecf)
+      ecf_api.recepcion_ecf_34(ecf)
+    end
+
+    def send_ecf41(ecf)
+      ecf_api.recepcion_ecf_41(ecf)
+    end
+
+    def send_ecf43(ecf)
+      ecf_api.recepcion_ecf_43(ecf)
+    end
+
+    def send_ecf44(ecf)
+      ecf_api.recepcion_ecf_44(ecf)
+    end
+
+    def send_ecf45(ecf)
+      ecf_api.recepcion_ecf_45(ecf)
+    end
+
+    def send_ecf46(ecf)
+      ecf_api.recepcion_ecf_46(ecf)
+    end
+
+    def send_ecf47(ecf)
+      ecf_api.recepcion_ecf_47(ecf)
+    end
+
+    # ------------------------------------------------------------------
+    # Polling send operations
+    # ------------------------------------------------------------------
+
+    def send_ecf31_and_poll(ecf, options = nil)
+      _send_and_poll(send_ecf31(ecf), options)
+    end
+
+    def send_ecf32_and_poll(ecf, options = nil)
+      _send_and_poll(send_ecf32(ecf), options)
+    end
+
+    def send_ecf33_and_poll(ecf, options = nil)
+      _send_and_poll(send_ecf33(ecf), options)
+    end
+
+    def send_ecf34_and_poll(ecf, options = nil)
+      _send_and_poll(send_ecf34(ecf), options)
+    end
+
+    def send_ecf41_and_poll(ecf, options = nil)
+      _send_and_poll(send_ecf41(ecf), options)
+    end
+
+    def send_ecf43_and_poll(ecf, options = nil)
+      _send_and_poll(send_ecf43(ecf), options)
+    end
+
+    def send_ecf44_and_poll(ecf, options = nil)
+      _send_and_poll(send_ecf44(ecf), options)
+    end
+
+    def send_ecf45_and_poll(ecf, options = nil)
+      _send_and_poll(send_ecf45(ecf), options)
+    end
+
+    def send_ecf46_and_poll(ecf, options = nil)
+      _send_and_poll(send_ecf46(ecf), options)
+    end
+
+    def send_ecf47_and_poll(ecf, options = nil)
+      _send_and_poll(send_ecf47(ecf), options)
+    end
+
+    # ------------------------------------------------------------------
+    # Dynamic send_ecf routing (similar to TS sendEcf)
+    # ------------------------------------------------------------------
+
+    ECF_TYPE_ROUTE_MAP = {
+      "FacturaDeCreditoFiscalElectronica" => "31",
+      "FacturaDeConsumoElectronica" => "32",
+      "NotaDeDebitoElectronica" => "33",
+      "NotaDeCreditoElectronica" => "34",
+      "ComprasElectronico" => "41",
+      "GastosMenoresElectronico" => "43",
+      "RegimenesEspecialesElectronico" => "44",
+      "GubernamentalElectronico" => "45",
+      "ComprobanteDeExportacionesElectronico" => "46",
+      "ComprobanteParaPagosAlExteriorElectronico" => "47"
+    }.freeze
+
+    def send_ecf(ecf)
+      tipoe_cf = nil
+      if ecf.respond_to?(:encabezado) && ecf.encabezado.respond_to?(:id_doc)
+        tipoe_cf = ecf.encabezado.id_doc.tipoe_cf
+      elsif ecf.is_a?(Hash)
+        tipoe_cf = ecf.dig(:encabezado, :id_doc, :tipoe_cf) || ecf.dig("encabezado", "idDoc", "tipoeCF")
+      end
+
+      raise ArgumentError, "El objeto ECF debe contener encabezado.id_doc.tipoe_cf" if tipoe_cf.nil? || tipoe_cf.to_s.empty?
+
+      route = ECF_TYPE_ROUTE_MAP[tipoe_cf.to_s]
+      raise ArgumentError, "Tipo de eCF desconocido: #{tipoe_cf}" if route.nil?
+
+      send("send_ecf#{route}", ecf)
+    end
+
+    def send_ecf_and_poll(ecf, options = nil)
+      _send_and_poll(send_ecf(ecf), options)
+    end
+
+    # ------------------------------------------------------------------
+    # ECF query & search operations
+    # ------------------------------------------------------------------
+
+    def query_ecf(rnc, encf, opts = {})
+      ecf_api.query_ecf(rnc, encf, opts)
+    end
+
+    def search_ecfs(rnc, opts = {})
+      ecf_api.search_ecfs(rnc, opts)
+    end
+
+    def search_all_ecfs(opts = {})
+      ecf_api.search_all_ecfs(opts)
+    end
+
+    def get_ecf_by_id(id)
+      ecf_api.get_ecf_by_id(id)
+    end
+
+    def anulacion_rangos(body)
+      ecf_api.anulacion_rangos(body)
+    end
+
+    def list_anulaciones(opts = {})
+      ecf_api.list_anulaciones(opts)
+    end
+
+    def send_aprobacion_comercial(body)
+      recepcion_api.send_aprobacion_comercial(body)
+    end
+
+    def firmar_semilla(body)
+      ecf_api.firmar_semilla(body)
+    end
+
+    # ------------------------------------------------------------------
+    # Company operations
+    # ------------------------------------------------------------------
+
+    def get_companies(opts = {})
+      company_api.get_companies(opts)
+    end
+
+    def get_company_by_rnc(rnc)
+      company_api.get_company_by_rnc(rnc)
+    end
+
+    def upsert_company(body)
+      company_api.upsert_company(body)
+    end
+
+    def delete_company(rnc)
+      company_api.delete_company(rnc)
+    end
+
+    def get_current_certificate(rnc)
+      company_api.get_current_certificate(rnc)
+    end
+
+    def update_certificate_company(rnc, opts = {})
+      company_api.update_certificate_company(rnc, opts)
+    end
+
+    # ------------------------------------------------------------------
+    # Api Key operations
+    # ------------------------------------------------------------------
+
+    def new_company_api_key(body)
+      api_key_api.new_company_api_key(body)
+    end
+
+    # ------------------------------------------------------------------
+    # DGII operations
+    # ------------------------------------------------------------------
+
+    def consulta_estado(rnc, rnc_emisor, ncf_electronico, rnc_comprador, codigo_seguridad)
+      dgii_api.consulta_estado(rnc, rnc_emisor, ncf_electronico, rnc_comprador, codigo_seguridad)
+    end
+
+    def consulta_track_id(rnc, rnc_emisor, encf)
+      dgii_api.consulta_track_id(rnc, rnc_emisor, encf)
+    end
+
+    def consulta_timbre(rnc, rnc_emisor, ncf_electronico, rnc_comprador, codigo_seguridad, fecha_emision, monto_total, uid_timbre)
+      dgii_api.consulta_timbre(rnc, rnc_emisor, ncf_electronico, rnc_comprador, codigo_seguridad, fecha_emision, monto_total, uid_timbre)
+    end
+
+    def consulta_timbre_fc(rnc, rnc_emisor, ncf_electronico, rnc_comprador, fecha_emision, monto_total)
+      dgii_api.consulta_timbre_fc(rnc, rnc_emisor, ncf_electronico, rnc_comprador, fecha_emision, monto_total)
+    end
+
+    def consulta_resultado(rnc, track_id)
+      dgii_api.consulta_resultado(rnc, track_id)
+    end
+
+    def consulta_rfce(rnc, rnc_emisor, ncf_electronico)
+      dgii_api.consulta_rfce(rnc, rnc_emisor, ncf_electronico)
+    end
+
+    def consulta_directorio(rnc)
+      dgii_api.consulta_directorio_listado(rnc)
+    end
+
+    def consulta_directorio_por_rnc(rnc, target_rnc)
+      dgii_api.consulta_directorio_obtener_directorio_por_rnc(rnc, target_rnc)
+    end
+
+    def estatus_servicio(rnc)
+      dgii_api.estatus_servicios_obtener_estatus(rnc)
+    end
+
+    def ventanas_mantenimiento(rnc)
+      dgii_api.estatus_servicios_obtener_ventanas_mantenimiento(rnc)
+    end
+
+    # ------------------------------------------------------------------
+    # Reception operations
+    # ------------------------------------------------------------------
+
+    def get_ecf_reception_request(message_id)
+      recepcion_api.get_ecf_reception_request(message_id)
+    end
+
+    def get_ecf_receptor_by_message_id(message_id)
+      recepcion_api.get_ecf_receptor_by_message_id(message_id)
+    end
+
+    def search_ecf_reception_requests(opts = {})
+      recepcion_api.search_ecf_reception_requests(opts)
+    end
+
+    def search_ecf_reception_requests_by_rnc(rnc, opts = {})
+      recepcion_api.search_ecf_reception_requests_by_rnc(rnc, opts)
+    end
+
+    # ------------------------------------------------------------------
+    # Aprobacion Comercial operations
+    # ------------------------------------------------------------------
+
+    def get_acecf_reception_request(message_id)
+      aprobacion_comercial_api.get_acecf_reception_request(message_id)
+    end
+
+    def search_acecf_reception_requests(opts = {})
+      aprobacion_comercial_api.search_acecf_reception_requests(opts)
+    end
+
+    private
+
+    def _send_and_poll(initial, options)
+      EcfDgii::Polling.poll_until_complete(options) do
+        results = query_ecf(initial.rnc_emisor, initial.encf, include_ecf_content: false)
+        results && !results.empty? ? results.first : initial
+      end
+    end
+  end
+end

data/lib/ecf_dgii/generated/api/api_key_api.rb

@@ -0,0 +1,86 @@
+=begin
+#ECF API
+
+#ECF API (Electronic Fiscal Receipt).
+
+The version of the OpenAPI document: v1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'cgi'
+
+module EcfDgii::Generated
+  class ApiKeyApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # @param new_company_api_key [NewCompanyApiKey] 
+    # @param [Hash] opts the optional parameters
+    # @return [Token]
+    def new_company_api_key(new_company_api_key, opts = {})
+      data, _status_code, _headers = new_company_api_key_with_http_info(new_company_api_key, opts)
+      data
+    end
+
+    # @param new_company_api_key [NewCompanyApiKey] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Token, Integer, Hash)>] Token data, response status code and response headers
+    def new_company_api_key_with_http_info(new_company_api_key, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ApiKeyApi.new_company_api_key ...'
+      end
+      # verify the required parameter 'new_company_api_key' is set
+      if @api_client.config.client_side_validation && new_company_api_key.nil?
+        fail ArgumentError, "Missing the required parameter 'new_company_api_key' when calling ApiKeyApi.new_company_api_key"
+      end
+      # resource path
+      local_var_path = '/apiKey'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'application/problem+json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(new_company_api_key)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Token'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['Bearer']
+
+      new_options = opts.merge(
+        :operation => :"ApiKeyApi.new_company_api_key",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ApiKeyApi#new_company_api_key\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/ecf_dgii/generated/api/aprobacion_comercial_api.rb

@@ -0,0 +1,162 @@
+=begin
+#ECF API
+
+#ECF API (Electronic Fiscal Receipt).
+
+The version of the OpenAPI document: v1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'cgi'
+
+module EcfDgii::Generated
+  class AprobacionComercialApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # @param message_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_acecf_reception_request(message_id, opts = {})
+      get_acecf_reception_request_with_http_info(message_id, opts)
+      nil
+    end
+
+    # @param message_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_acecf_reception_request_with_http_info(message_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AprobacionComercialApi.get_acecf_reception_request ...'
+      end
+      # verify the required parameter 'message_id' is set
+      if @api_client.config.client_side_validation && message_id.nil?
+        fail ArgumentError, "Missing the required parameter 'message_id' when calling AprobacionComercialApi.get_acecf_reception_request"
+      end
+      # resource path
+      local_var_path = '/recepcion/acecf/{messageId}'.sub('{messageId}', CGI.escape(message_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/problem+json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['Bearer']
+
+      new_options = opts.merge(
+        :operation => :"AprobacionComercialApi.get_acecf_reception_request",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AprobacionComercialApi#get_acecf_reception_request\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :message_ids 
+    # @option opts [Array<String>] :encfs 
+    # @option opts [Array<String>] :rncs 
+    # @option opts [Array<SearchEcfReceptionRequestsTiposEcfsParameterInner>] :progresses 
+    # @option opts [GetCompaniesPageParameter] :page  (default to 1)
+    # @option opts [GetCompaniesLimitParameter] :limit  (default to 25)
+    # @return [PaginatedApiResultOfAcecfReceptionRequestDto]
+    def search_acecf_reception_requests(opts = {})
+      data, _status_code, _headers = search_acecf_reception_requests_with_http_info(opts)
+      data
+    end
+
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :message_ids 
+    # @option opts [Array<String>] :encfs 
+    # @option opts [Array<String>] :rncs 
+    # @option opts [Array<SearchEcfReceptionRequestsTiposEcfsParameterInner>] :progresses 
+    # @option opts [GetCompaniesPageParameter] :page  (default to 1)
+    # @option opts [GetCompaniesLimitParameter] :limit  (default to 25)
+    # @return [Array<(PaginatedApiResultOfAcecfReceptionRequestDto, Integer, Hash)>] PaginatedApiResultOfAcecfReceptionRequestDto data, response status code and response headers
+    def search_acecf_reception_requests_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AprobacionComercialApi.search_acecf_reception_requests ...'
+      end
+      pattern = Regexp.new(/^-?(?:0|[1-9]\d*)$/)
+      if @api_client.config.client_side_validation && !opts[:'page'].nil? && opts[:'page'] !~ pattern
+        fail ArgumentError, "invalid value for 'opts[:\"page\"]' when calling AprobacionComercialApi.search_acecf_reception_requests, must conform to the pattern #{pattern}."
+      end
+
+      pattern = Regexp.new(/^-?(?:0|[1-9]\d*)$/)
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] !~ pattern
+        fail ArgumentError, "invalid value for 'opts[:\"limit\"]' when calling AprobacionComercialApi.search_acecf_reception_requests, must conform to the pattern #{pattern}."
+      end
+
+      # resource path
+      local_var_path = '/recepcion/acecf'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'MessageIds'] = @api_client.build_collection_param(opts[:'message_ids'], :multi) if !opts[:'message_ids'].nil?
+      query_params[:'Encfs'] = @api_client.build_collection_param(opts[:'encfs'], :multi) if !opts[:'encfs'].nil?
+      query_params[:'Rncs'] = @api_client.build_collection_param(opts[:'rncs'], :multi) if !opts[:'rncs'].nil?
+      query_params[:'Progresses'] = @api_client.build_collection_param(opts[:'progresses'], :multi) if !opts[:'progresses'].nil?
+      query_params[:'Page'] = opts[:'page'] if !opts[:'page'].nil?
+      query_params[:'Limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'application/problem+json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'PaginatedApiResultOfAcecfReceptionRequestDto'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['Bearer']
+
+      new_options = opts.merge(
+        :operation => :"AprobacionComercialApi.search_acecf_reception_requests",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AprobacionComercialApi#search_acecf_reception_requests\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end