trevol 0.1.0

data/lib/trevol_generado/api/radian_events_api.rb

@@ -0,0 +1,431 @@
+=begin
+#API de Trevol
+
+#Trevol API. Documentación: https://platform.trevol.si/docs
+
+The version of the OpenAPI document: 2026-10-22
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.26.0
+
+=end
+
+require 'cgi'
+
+module TrevolGenerado
+  class RadianEventsApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Emitir un evento RADIAN
+    # Envía un **evento RADIAN** sobre una factura: el acuse de recibo (030), el reclamo (031), el recibo del bien o servicio (032) y la aceptación expresa (033) de una factura RECIBIDA (`invoice`), o la aceptación tácita (034) de una factura PROPIA a crédito: de Trevol (`invoice_id`) o emitida antes con otro software y traída por la sincronización con la DIAN (`invoice: {cufe, number?}`; exactamente uno de los dos). Los eventos 035 a 051 necesitan un participante RADIAN y no están disponibles. El 030 y el 032 necesitan el representante legal de la empresa (lo firma): se configura en la app. **Un rechazo es final**: el siguiente intento es otro evento, con otro número (`POST` nuevo). Un evento vivo del mismo código sobre la misma factura es `409 duplicate_document` con `existing_id`: reintenta ese con `POST …/send`. `already_registered: true` (con `201`) solo significa que la DIAN ya mostraba el CUDE de ESTE evento; si la factura ya tenía ese evento por otro camino es `422 dian_rejected` con `already_registered_elsewhere: true`. La DIAN pide el evento anterior antes del siguiente: en la 2026-10-21 es `409 previous_event_pending`; en la 2026-10-22, `202 processing` y Trevol lo manda cuando aparezca. Si la DIAN contesta 98 («en proceso de validación») es `202 validating`: no reenvíes. Para saber si el 034 procede antes de pedirlo, usa `GET /v1/invoices/{id}/tacit_acceptance` (o, por CUFE, `GET /v1/radian_events/tacit_acceptance?cufe=…`).  **Respuestas.** `201` la DIAN lo validó (`status: accepted`). `202` solo en la versión 2026-10-22: la DIAN no contestó (`processing`), otra petición lo está enviando (`sending`) o, en habilitación, el set de pruebas todavía lo valida (`validating`, en las dos versiones); trae `Location` y `Retry-After`, y el resultado llega por GET y por webhook: **no crees otro documento para la misma operación**. `422` `validation_error` (se revisó a fondo ANTES de reservar: no se gastó el número, y `errors[]` dice el campo), `dian_rejected` (con `document` y las reglas traducidas; un rechazo es final: el siguiente intento es otro `POST`, con otro número), `company_not_enabled` o `numbering_unavailable` (con `reason`). `402` `insufficient_balance` (producción sin saldo: queda `pending` con su número). `409` `external_id_in_use` o `duplicate_document` (con `existing_id`). `503` `dian_unavailable` en la 2026-10-21. Pide `Idempotency-Key`: repetir la misma devuelve lo mismo sin enviar nada.
+    # @param radian_event_input [RadianEventInput] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Obligatoria: 1 a 255 caracteres ASCII visibles, única por pedido (7 días).
+    # @return [RadianEvent]
+    def create_radian_event(radian_event_input, opts = {})
+      data, _status_code, _headers = create_radian_event_with_http_info(radian_event_input, opts)
+      data
+    end
+
+    # Emitir un evento RADIAN
+    # Envía un **evento RADIAN** sobre una factura: el acuse de recibo (030), el reclamo (031), el recibo del bien o servicio (032) y la aceptación expresa (033) de una factura RECIBIDA (`invoice`), o la aceptación tácita (034) de una factura PROPIA a crédito: de Trevol (`invoice_id`) o emitida antes con otro software y traída por la sincronización con la DIAN (`invoice: {cufe, number?}`; exactamente uno de los dos). Los eventos 035 a 051 necesitan un participante RADIAN y no están disponibles. El 030 y el 032 necesitan el representante legal de la empresa (lo firma): se configura en la app. **Un rechazo es final**: el siguiente intento es otro evento, con otro número (`POST` nuevo). Un evento vivo del mismo código sobre la misma factura es `409 duplicate_document` con `existing_id`: reintenta ese con `POST …/send`. `already_registered: true` (con `201`) solo significa que la DIAN ya mostraba el CUDE de ESTE evento; si la factura ya tenía ese evento por otro camino es `422 dian_rejected` con `already_registered_elsewhere: true`. La DIAN pide el evento anterior antes del siguiente: en la 2026-10-21 es `409 previous_event_pending`; en la 2026-10-22, `202 processing` y Trevol lo manda cuando aparezca. Si la DIAN contesta 98 («en proceso de validación») es `202 validating`: no reenvíes. Para saber si el 034 procede antes de pedirlo, usa `GET /v1/invoices/{id}/tacit_acceptance` (o, por CUFE, `GET /v1/radian_events/tacit_acceptance?cufe=…`).  **Respuestas.** `201` la DIAN lo validó (`status: accepted`). `202` solo en la versión 2026-10-22: la DIAN no contestó (`processing`), otra petición lo está enviando (`sending`) o, en habilitación, el set de pruebas todavía lo valida (`validating`, en las dos versiones); trae `Location` y `Retry-After`, y el resultado llega por GET y por webhook: **no crees otro documento para la misma operación**. `422` `validation_error` (se revisó a fondo ANTES de reservar: no se gastó el número, y `errors[]` dice el campo), `dian_rejected` (con `document` y las reglas traducidas; un rechazo es final: el siguiente intento es otro `POST`, con otro número), `company_not_enabled` o `numbering_unavailable` (con `reason`). `402` `insufficient_balance` (producción sin saldo: queda `pending` con su número). `409` `external_id_in_use` o `duplicate_document` (con `existing_id`). `503` `dian_unavailable` en la 2026-10-21. Pide `Idempotency-Key`: repetir la misma devuelve lo mismo sin enviar nada.
+    # @param radian_event_input [RadianEventInput] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key Obligatoria: 1 a 255 caracteres ASCII visibles, única por pedido (7 días).
+    # @return [Array<(RadianEvent, Integer, Hash)>] RadianEvent data, response status code and response headers
+    def create_radian_event_with_http_info(radian_event_input, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: RadianEventsApi.create_radian_event ...'
+      end
+      # verify the required parameter 'radian_event_input' is set
+      if @api_client.config.client_side_validation && radian_event_input.nil?
+        fail ArgumentError, "Missing the required parameter 'radian_event_input' when calling RadianEventsApi.create_radian_event"
+      end
+      # resource path
+      local_var_path = '/radian_events'
+
+      # 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
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(radian_event_input)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'RadianEvent'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['llave']
+
+      new_options = opts.merge(
+        :operation => :"RadianEventsApi.create_radian_event",
+        :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: RadianEventsApi#create_radian_event\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Archivo xml
+    # El ApplicationResponse firmado que se mandó a la DIAN (`application/xml`). Los eventos no tienen PDF, ZIP ni `dian_response`.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [File]
+    def download_radian_event_xml(id, opts = {})
+      data, _status_code, _headers = download_radian_event_xml_with_http_info(id, opts)
+      data
+    end
+
+    # Archivo xml
+    # El ApplicationResponse firmado que se mandó a la DIAN (&#x60;application/xml&#x60;). Los eventos no tienen PDF, ZIP ni &#x60;dian_response&#x60;.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(File, Integer, Hash)>] File data, response status code and response headers
+    def download_radian_event_xml_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: RadianEventsApi.download_radian_event_xml ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling RadianEventsApi.download_radian_event_xml"
+      end
+      # resource path
+      local_var_path = '/radian_events/{id}/xml'.sub('{id}', CGI.escape(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/xml', '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] || 'File'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['llave']
+
+      new_options = opts.merge(
+        :operation => :"RadianEventsApi.download_radian_event_xml",
+        :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: RadianEventsApi#download_radian_event_xml\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Listar (evento RADIAN)
+    # Paginación por cursor y filtros `status`, `external_id`, `created_from`, `created_to`, `event_code` y `invoice_cufe` (el CUFE de la factura).
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit 
+    # @option opts [String] :starting_after 
+    # @option opts [String] :status 
+    # @option opts [String] :external_id 
+    # @option opts [String] :created_from 
+    # @option opts [String] :created_to 
+    # @option opts [String] :event_code 
+    # @option opts [String] :invoice_cufe 
+    # @return [RadianEventList]
+    def list_radian_events(opts = {})
+      data, _status_code, _headers = list_radian_events_with_http_info(opts)
+      data
+    end
+
+    # Listar (evento RADIAN)
+    # Paginación por cursor y filtros &#x60;status&#x60;, &#x60;external_id&#x60;, &#x60;created_from&#x60;, &#x60;created_to&#x60;, &#x60;event_code&#x60; y &#x60;invoice_cufe&#x60; (el CUFE de la factura).
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit 
+    # @option opts [String] :starting_after 
+    # @option opts [String] :status 
+    # @option opts [String] :external_id 
+    # @option opts [String] :created_from 
+    # @option opts [String] :created_to 
+    # @option opts [String] :event_code 
+    # @option opts [String] :invoice_cufe 
+    # @return [Array<(RadianEventList, Integer, Hash)>] RadianEventList data, response status code and response headers
+    def list_radian_events_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: RadianEventsApi.list_radian_events ...'
+      end
+      allowable_values = ["030", "031", "032", "033", "034", "unknown_default_open_api"]
+      if @api_client.config.client_side_validation && opts[:'event_code'] && !allowable_values.include?(opts[:'event_code'])
+        fail ArgumentError, "invalid value for \"event_code\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/radian_events'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'starting_after'] = opts[:'starting_after'] if !opts[:'starting_after'].nil?
+      query_params[:'status'] = opts[:'status'] if !opts[:'status'].nil?
+      query_params[:'external_id'] = opts[:'external_id'] if !opts[:'external_id'].nil?
+      query_params[:'created_from'] = opts[:'created_from'] if !opts[:'created_from'].nil?
+      query_params[:'created_to'] = opts[:'created_to'] if !opts[:'created_to'].nil?
+      query_params[:'event_code'] = opts[:'event_code'] if !opts[:'event_code'].nil?
+      query_params[:'invoice_cufe'] = opts[:'invoice_cufe'] if !opts[:'invoice_cufe'].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] || 'RadianEventList'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['llave']
+
+      new_options = opts.merge(
+        :operation => :"RadianEventsApi.list_radian_events",
+        :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: RadianEventsApi#list_radian_events\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Un evento radian
+    # El evento tal como se envió, con su número, su CUDE, la factura y la respuesta de la DIAN. `already_registered`, `already_registered_elsewhere` y `tacit` se deducen de lo guardado.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [RadianEvent]
+    def retrieve_radian_event(id, opts = {})
+      data, _status_code, _headers = retrieve_radian_event_with_http_info(id, opts)
+      data
+    end
+
+    # Un evento radian
+    # El evento tal como se envió, con su número, su CUDE, la factura y la respuesta de la DIAN. &#x60;already_registered&#x60;, &#x60;already_registered_elsewhere&#x60; y &#x60;tacit&#x60; se deducen de lo guardado.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(RadianEvent, Integer, Hash)>] RadianEvent data, response status code and response headers
+    def retrieve_radian_event_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: RadianEventsApi.retrieve_radian_event ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling RadianEventsApi.retrieve_radian_event"
+      end
+      # resource path
+      local_var_path = '/radian_events/{id}'.sub('{id}', CGI.escape(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/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] || 'RadianEvent'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['llave']
+
+      new_options = opts.merge(
+        :operation => :"RadianEventsApi.retrieve_radian_event",
+        :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: RadianEventsApi#retrieve_radian_event\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # ¿Procede ya la aceptación tácita (034) de esta factura? (por CUFE)
+    # Lo mismo que `GET /v1/invoices/{id}/tacit_acceptance`, pero por el CUFE de la factura propia: sirve también para las facturas que no se emitieron con Trevol (emitidas antes, con otro software, y traídas por la sincronización con la DIAN; la sincronización trae las de producción). Consulta GetStatusEvent y aplica la regla de los 3 días hábiles; no envía nada. `invoice_id` solo sale si la factura es de Trevol. 404 si el CUFE no es de una factura propia de la empresa y el ambiente de la llave; 422 si falta `cufe` o la factura no admite el 034 (de contado, una nota, a consumidor final, sin el XML leído por la sincronización…); 429 con más de 30 consultas por minuto por llave (el mismo límite de la otra consulta); 503 si la DIAN no contesta (reintentable).
+    # @param cufe [String] El CUFE de la factura propia.
+    # @param [Hash] opts the optional parameters
+    # @return [TacitAcceptance]
+    def retrieve_tacit_acceptance_by_cufe(cufe, opts = {})
+      data, _status_code, _headers = retrieve_tacit_acceptance_by_cufe_with_http_info(cufe, opts)
+      data
+    end
+
+    # ¿Procede ya la aceptación tácita (034) de esta factura? (por CUFE)
+    # Lo mismo que &#x60;GET /v1/invoices/{id}/tacit_acceptance&#x60;, pero por el CUFE de la factura propia: sirve también para las facturas que no se emitieron con Trevol (emitidas antes, con otro software, y traídas por la sincronización con la DIAN; la sincronización trae las de producción). Consulta GetStatusEvent y aplica la regla de los 3 días hábiles; no envía nada. &#x60;invoice_id&#x60; solo sale si la factura es de Trevol. 404 si el CUFE no es de una factura propia de la empresa y el ambiente de la llave; 422 si falta &#x60;cufe&#x60; o la factura no admite el 034 (de contado, una nota, a consumidor final, sin el XML leído por la sincronización…); 429 con más de 30 consultas por minuto por llave (el mismo límite de la otra consulta); 503 si la DIAN no contesta (reintentable).
+    # @param cufe [String] El CUFE de la factura propia.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(TacitAcceptance, Integer, Hash)>] TacitAcceptance data, response status code and response headers
+    def retrieve_tacit_acceptance_by_cufe_with_http_info(cufe, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: RadianEventsApi.retrieve_tacit_acceptance_by_cufe ...'
+      end
+      # verify the required parameter 'cufe' is set
+      if @api_client.config.client_side_validation && cufe.nil?
+        fail ArgumentError, "Missing the required parameter 'cufe' when calling RadianEventsApi.retrieve_tacit_acceptance_by_cufe"
+      end
+      # resource path
+      local_var_path = '/radian_events/tacit_acceptance'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'cufe'] = cufe
+
+      # 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] || 'TacitAcceptance'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['llave']
+
+      new_options = opts.merge(
+        :operation => :"RadianEventsApi.retrieve_tacit_acceptance_by_cufe",
+        :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: RadianEventsApi#retrieve_tacit_acceptance_by_cufe\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Reenviar una pendiente o en error
+    # Vuelve a enviar un evento `pending` o `error` con el **mismo número** (por ejemplo, un 034 que todavía no procedía o un 031 que esperaba al evento anterior). Un evento que la DIAN verifica (`validating`) solo consulta; uno `rejected` es final (`409 invalid_state`): crea otro con `POST`.  Sin cuerpo. Con un documento `accepted` responde `200` con el documento tal cual; con uno que la DIAN todavía verifica no reenvía nada (`202`); con uno `rejected` es `409 invalid_state` (se corrige con `PUT`). No pide `Idempotency-Key` (reintentarlo es seguro).
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [RadianEvent]
+    def send_radian_event(id, opts = {})
+      data, _status_code, _headers = send_radian_event_with_http_info(id, opts)
+      data
+    end
+
+    # Reenviar una pendiente o en error
+    # Vuelve a enviar un evento &#x60;pending&#x60; o &#x60;error&#x60; con el **mismo número** (por ejemplo, un 034 que todavía no procedía o un 031 que esperaba al evento anterior). Un evento que la DIAN verifica (&#x60;validating&#x60;) solo consulta; uno &#x60;rejected&#x60; es final (&#x60;409 invalid_state&#x60;): crea otro con &#x60;POST&#x60;.  Sin cuerpo. Con un documento &#x60;accepted&#x60; responde &#x60;200&#x60; con el documento tal cual; con uno que la DIAN todavía verifica no reenvía nada (&#x60;202&#x60;); con uno &#x60;rejected&#x60; es &#x60;409 invalid_state&#x60; (se corrige con &#x60;PUT&#x60;). No pide &#x60;Idempotency-Key&#x60; (reintentarlo es seguro).
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(RadianEvent, Integer, Hash)>] RadianEvent data, response status code and response headers
+    def send_radian_event_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: RadianEventsApi.send_radian_event ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling RadianEventsApi.send_radian_event"
+      end
+      # resource path
+      local_var_path = '/radian_events/{id}/send'.sub('{id}', CGI.escape(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/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] || 'RadianEvent'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['llave']
+
+      new_options = opts.merge(
+        :operation => :"RadianEventsApi.send_radian_event",
+        :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: RadianEventsApi#send_radian_event\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/trevol_generado/api/requests_api.rb

@@ -0,0 +1,97 @@
+=begin
+#API de Trevol
+
+#Trevol API. Documentación: https://platform.trevol.si/docs
+
+The version of the OpenAPI document: 2026-10-22
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.26.0
+
+=end
+
+require 'cgi'
+
+module TrevolGenerado
+  class RequestsApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # El registro de peticiones de la empresa y el ambiente de la llave (30 días)
+    # Cada petición que pasó la autenticación de una llave, aunque terminara en 403, 422 o 429. Sin cuerpos, consultas, IP ni llaves; `path` es la plantilla.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit 
+    # @option opts [String] :starting_after 
+    # @option opts [Integer] :status 
+    # @option opts [String] :key_id 
+    # @option opts [String] :created_from 
+    # @option opts [String] :created_to 
+    # @return [RequestList]
+    def list_requests(opts = {})
+      data, _status_code, _headers = list_requests_with_http_info(opts)
+      data
+    end
+
+    # El registro de peticiones de la empresa y el ambiente de la llave (30 días)
+    # Cada petición que pasó la autenticación de una llave, aunque terminara en 403, 422 o 429. Sin cuerpos, consultas, IP ni llaves; `path` es la plantilla.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit 
+    # @option opts [String] :starting_after 
+    # @option opts [Integer] :status 
+    # @option opts [String] :key_id 
+    # @option opts [String] :created_from 
+    # @option opts [String] :created_to 
+    # @return [Array<(RequestList, Integer, Hash)>] RequestList data, response status code and response headers
+    def list_requests_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: RequestsApi.list_requests ...'
+      end
+      # resource path
+      local_var_path = '/requests'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'starting_after'] = opts[:'starting_after'] if !opts[:'starting_after'].nil?
+      query_params[:'status'] = opts[:'status'] if !opts[:'status'].nil?
+      query_params[:'key_id'] = opts[:'key_id'] if !opts[:'key_id'].nil?
+      query_params[:'created_from'] = opts[:'created_from'] if !opts[:'created_from'].nil?
+      query_params[:'created_to'] = opts[:'created_to'] if !opts[:'created_to'].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] || 'RequestList'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['llave']
+
+      new_options = opts.merge(
+        :operation => :"RequestsApi.list_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: RequestsApi#list_requests\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end