ev-recharge-sdk 1.4.0 → 2.1.0

data/lib/shell_ev/controllers/locations_controller.rb

@@ -1,17 +1,18 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # LocationsController
   class LocationsController < BaseController
-    # This API provides the list of all Shell Recharge locations. The list
-    # includes all Shell Recharge network and all locations available through
-    # our roaming partners. The end point provides flexible search criteria in
-    # order to get the list of Shell Recharge Network. The end point provides
-    # the details such as the exact location/address of the site along with the
-    # up-to-date status information of all the charging units in the site.
+    # This API Product provides the list of all public Shell Recharge locations.
+    # The list includes Shell Recharge network and locations available publicly
+    # through our roaming partners. The end point provides flexible search
+    # criteria in order to get the list of Shell Recharge Network. The end point
+    # provides the details such as the exact location/address of the site along
+    # with the up-to-date status information of all the charging units in the
+    # site.
     # Supported Search Options
     # * Based on status of the Charging units. Eg : Available or Occupied
     # * Based on available connector types.
@@ -24,16 +25,15 @@ module ShellEv
     # digits, displayed in five groups separated by hyphens, in the form
     # 8-4-4-4-12 for a total of 36 characters (32 hexadecimal characters and 4
     # hyphens) <br>
-    # @param [GetEVLocationsEvseStatusEnum] evse_status Optional parameter:
-    # Filter by Locations that have the given status
-    # @param [GetEVLocationsConnectorTypesEnum] connector_types Optional
-    # parameter: Filter by Locations that have Connectors with the set of
-    # Connector Types
+    # @param [EvseStatusEnum] evse_status Optional parameter: Filter by
+    # Locations that have the given status
+    # @param [ConnectorTypesEnum] connector_types Optional parameter: Filter by
+    # Locations that have Connectors with the set of Connector Types
     # @param [Float] connector_min_power Optional parameter: Filter by Locations
     # that have a Connector with at least this power output (in kW)
-    # @param [GetEVLocationsAuthorizationMethodsEnum] authorization_methods
-    # Optional parameter: Filter by Locations that support the given
-    # Authorization Methods
+    # @param [SingleLocationMarkerAuthorizationMethodsItemsEnum]
+    # authorization_methods Optional parameter: Filter by Locations that support
+    # the given Authorization Methods
     # @param [TrueClass | FalseClass] with_operator_name Optional parameter:
     # Return operator name in marker response object
     # @param [String] evse_id Optional parameter: optional Standard EVSE
@@ -57,7 +57,7 @@ module ShellEv
     # @param [Array[String]] exclude_country Optional parameter: Filter by
     # Locations that are not in one of the given countries (specified using ISO
     # 3166-1 alpha-3 codes)
-    # @return [Response] response from the API call.
+    # @return [ResponseV2] Response from the API call.
     def get_ev_locations(request_id,
                          evse_status: nil,
                          connector_types: nil,
@@ -72,9 +72,9 @@ module ShellEv
                          updated_since: nil,
                          country: nil,
                          exclude_country: nil)
-      new_api_call_builder
+      @api_call
         .request(new_request_builder(HttpMethodEnum::GET,
-                                     '/locations',
+                                     '/v2/locations',
                                      Server::DEFAULT)
                    .header_param(new_parameter(request_id, key: 'RequestId'))
                    .query_param(new_parameter(evse_status, key: 'evseStatus'))
@@ -94,7 +94,7 @@ module ShellEv
                    .auth(Single.new('BearerAuth')))
         .response(new_response_handler
                     .deserializer(APIHelper.method(:custom_type_deserializer))
-                    .deserialize_into(Response.method(:from_hash))
+                    .deserialize_into(ResponseV2.method(:from_hash))
                     .local_error('400',
                                  'The server cannot or will not process the request due to'\
                                   ' something that is perceived to be a client error (e.g.,'\
@@ -133,18 +133,18 @@ module ShellEv
     # hyphens) <br>
     # @param [String] id Required parameter: Unique Uid of the location from
     # List of locations API
-    # @param [String] provider_id Optional parameter: The provider id that you
-    # wish to see locations and tariffs for
+    # @param [String] provider_id Optional parameter: ProviderId is mandatory in
+    # order to get the tariff information as part of API response.
     # @param [String] since Optional parameter: to get the locations modified
     # after a date
-    # @return [Response] response from the API call.
+    # @return [SearchByIdResponse] Response from the API call.
     def ev_locations_by_id(request_id,
                            id,
                            provider_id: nil,
                            since: nil)
-      new_api_call_builder
+      @api_call
         .request(new_request_builder(HttpMethodEnum::GET,
-                                     '/locations/{id}',
+                                     '/v2/locations/{id}',
                                      Server::DEFAULT)
                    .header_param(new_parameter(request_id, key: 'RequestId'))
                    .template_param(new_parameter(id, key: 'id')
@@ -155,7 +155,7 @@ module ShellEv
                    .auth(Single.new('BearerAuth')))
         .response(new_response_handler
                     .deserializer(APIHelper.method(:custom_type_deserializer))
-                    .deserialize_into(Response.method(:from_hash))
+                    .deserialize_into(SearchByIdResponse.method(:from_hash))
                     .local_error('400',
                                  'The server cannot or will not process the request due to'\
                                   ' something that is perceived to be a client error (e.g.,'\
@@ -216,16 +216,15 @@ module ShellEv
     # given by the Operator, unique for that Operator
     # @param [String] operator_name Optional parameter: Filter by Locations that
     # have the given operator
-    # @param [GetEVLocationsEvseStatusEnum] evse_status Optional parameter:
-    # Filter by Locations that have the given status
-    # @param [NearbyLocationsConnectorTypesEnum] connector_types Optional
-    # parameter: Filter by Locations that have Connectors with these Connector
-    # Types
+    # @param [EvseStatusEnum] evse_status Optional parameter: Filter by
+    # Locations that have the given status
+    # @param [ConnectorTypesEnum] connector_types Optional parameter: Filter by
+    # Locations that have Connectors with these Connector Types
     # @param [Float] connector_min_power Optional parameter: Filter by Locations
     # that have a Connector with at least this power output (in kW)
-    # @param [GetEVLocationsAuthorizationMethodsEnum] authorization_methods
-    # Optional parameter: Filter by Locations that support the given
-    # Authorization Methods
+    # @param [SingleLocationMarkerAuthorizationMethodsItemsEnum]
+    # authorization_methods Optional parameter: Filter by Locations that support
+    # the given Authorization Methods
     # @param [TrueClass | FalseClass] with_operator_name Optional parameter:
     # Return operator name in marker object (only for marker type Single
     # ChargePoint)
@@ -238,7 +237,7 @@ module ShellEv
     # @param [Array[String]] exclude_country Optional parameter: Filter by
     # Locations that are not in one of the given countries (specified using ISO
     # 3166-1 alpha-3 codes)
-    # @return [Response] response from the API call.
+    # @return [ResponseV2] Response from the API call.
     def nearby_locations(request_id,
                          latitude,
                          longitude,
@@ -255,9 +254,9 @@ module ShellEv
                          with_max_power: nil,
                          country: nil,
                          exclude_country: nil)
-      new_api_call_builder
+      @api_call
         .request(new_request_builder(HttpMethodEnum::GET,
-                                     '/locations/nearby',
+                                     '/v2/locations/nearby',
                                      Server::DEFAULT)
                    .header_param(new_parameter(request_id, key: 'RequestId'))
                    .query_param(new_parameter(latitude, key: 'latitude'))
@@ -279,7 +278,7 @@ module ShellEv
                    .auth(Single.new('BearerAuth')))
         .response(new_response_handler
                     .deserializer(APIHelper.method(:custom_type_deserializer))
-                    .deserialize_into(Response.method(:from_hash))
+                    .deserialize_into(ResponseV2.method(:from_hash))
                     .local_error('400',
                                  'The server cannot or will not process the request due to'\
                                   ' something that is perceived to be a client error (e.g.,'\
@@ -330,16 +329,15 @@ module ShellEv
     # get the Shell Recharge Locations
     # @param [String] zoom Required parameter: Zoom level to show ex: (1: World,
     # 5: Landmass/continent, 10: City, 15: Streets, 20: Buildings)
-    # @param [GetEVLocationsEvseStatusEnum] evse_status Optional parameter:
-    # Filter by Locations that have the given status
-    # @param [GetEVLocationsConnectorTypesEnum] connector_types Optional
-    # parameter: Filter by Locations that have Connectors with the set of
-    # Connector Types
+    # @param [EvseStatusEnum] evse_status Optional parameter: Filter by
+    # Locations that have the given status
+    # @param [ConnectorTypesEnum] connector_types Optional parameter: Filter by
+    # Locations that have Connectors with the set of Connector Types
     # @param [Float] connector_min_power Optional parameter: Filter by Locations
     # that have a Connector with at least this power output (in kW)
-    # @param [GetEVLocationsAuthorizationMethodsEnum] authorization_methods
-    # Optional parameter: Filter by Locations that support the given
-    # Authorization Methods
+    # @param [SingleLocationMarkerAuthorizationMethodsItemsEnum]
+    # authorization_methods Optional parameter: Filter by Locations that support
+    # the given Authorization Methods
     # @param [TrueClass | FalseClass] with_operator_name Optional parameter:
     # Return operator name in marker object (only for marker type
     # SingleChargePoint)
@@ -362,7 +360,7 @@ module ShellEv
     # @param [Array[String]] exclude_country Optional parameter: Filter by
     # Locations that are not in one of the given countries (specified using ISO
     # 3166-1 alpha-3 codes)
-    # @return [SingleLocationMarkerResponse] response from the API call.
+    # @return [SingleLocationMarkerResponseV2] Response from the API call.
     def locations_markers(request_id,
                           west,
                           south,
@@ -381,9 +379,9 @@ module ShellEv
                           operator_name: nil,
                           country: nil,
                           exclude_country: nil)
-      new_api_call_builder
+      @api_call
         .request(new_request_builder(HttpMethodEnum::GET,
-                                     '/locations/markers',
+                                     '/v2/locations/markers',
                                      Server::DEFAULT)
                    .header_param(new_parameter(request_id, key: 'RequestId'))
                    .query_param(new_parameter(west, key: 'west'))
@@ -407,7 +405,7 @@ module ShellEv
                    .auth(Single.new('BearerAuth')))
         .response(new_response_handler
                     .deserializer(APIHelper.method(:custom_type_deserializer))
-                    .deserialize_into(SingleLocationMarkerResponse.method(:from_hash))
+                    .deserialize_into(SingleLocationMarkerResponseV2.method(:from_hash))
                     .local_error('400',
                                  'The server cannot or will not process the request due to'\
                                   ' something that is perceived to be a client error (e.g.,'\

data/lib/shell_ev/controllers/o_auth_authorization_controller.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # OAuthAuthorizationController
@@ -13,11 +13,11 @@ module ShellEv
     # space-delimited list.
     # @param [Hash] _field_parameters Additional optional form parameters are
     # supported by this endpoint.
-    # @return [OAuthToken] response from the API call.
+    # @return [OAuthToken] Response from the API call.
     def request_token(authorization,
                       scope: nil,
                       _field_parameters: nil)
-      new_api_call_builder
+      @api_call
         .request(new_request_builder(HttpMethodEnum::POST,
                                      '/token',
                                      Server::ACCESS_TOKEN_SERVER)

data/lib/shell_ev/exceptions/api_exception.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # Class for exceptions when there is a network error, status code error, etc.

data/lib/shell_ev/exceptions/bad_request_exception.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # BadRequest class.
@@ -23,8 +23,8 @@ module ShellEv
     attr_accessor :errors
 
     # The constructor.
-    # @param [String] The reason for raising an exception.
-    # @param [HttpResponse] The HttpReponse of the API call.
+    # @param [String] reason The reason for raising an exception.
+    # @param [HttpResponse] response The HttpReponse of the API call.
     def initialize(reason, response)
       super(reason, response)
       hash = APIHelper.json_deserialize(@response.raw_body)
@@ -32,9 +32,11 @@ module ShellEv
     end
 
     # Populates this object by extracting properties from a hash.
-    # @param [Hash] The deserialized response sent by the server in the
+    # @param [Hash] hash The deserialized response sent by the server in the
     # response body.
     def unbox(hash)
+      return nil unless hash
+
       @request_id = hash.key?('requestId') ? hash['requestId'] : SKIP
       @status = hash.key?('status') ? hash['status'] : SKIP
       # Parameter is an array, so we need to iterate through it

data/lib/shell_ev/exceptions/internal_server_error_exception.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # InternalServerError class.
@@ -27,8 +27,8 @@ module ShellEv
     attr_accessor :details
 
     # The constructor.
-    # @param [String] The reason for raising an exception.
-    # @param [HttpResponse] The HttpReponse of the API call.
+    # @param [String] reason The reason for raising an exception.
+    # @param [HttpResponse] response The HttpReponse of the API call.
     def initialize(reason, response)
       super(reason, response)
       hash = APIHelper.json_deserialize(@response.raw_body)
@@ -36,9 +36,11 @@ module ShellEv
     end
 
     # Populates this object by extracting properties from a hash.
-    # @param [Hash] The deserialized response sent by the server in the
+    # @param [Hash] hash The deserialized response sent by the server in the
     # response body.
     def unbox(hash)
+      return nil unless hash
+
       @request_id = hash.key?('requestId') ? hash['requestId'] : SKIP
       @status = hash.key?('status') ? hash['status'] : SKIP
       # Parameter is an array, so we need to iterate through it

data/lib/shell_ev/exceptions/not_found_exception.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # Requested resource path not available it will provides the error in OpenAPI
@@ -25,8 +25,8 @@ module ShellEv
     attr_accessor :errors
 
     # The constructor.
-    # @param [String] The reason for raising an exception.
-    # @param [HttpResponse] The HttpReponse of the API call.
+    # @param [String] reason The reason for raising an exception.
+    # @param [HttpResponse] response The HttpReponse of the API call.
     def initialize(reason, response)
       super(reason, response)
       hash = APIHelper.json_deserialize(@response.raw_body)
@@ -34,9 +34,11 @@ module ShellEv
     end
 
     # Populates this object by extracting properties from a hash.
-    # @param [Hash] The deserialized response sent by the server in the
+    # @param [Hash] hash The deserialized response sent by the server in the
     # response body.
     def unbox(hash)
+      return nil unless hash
+
       @request_id = hash.key?('requestId') ? hash['requestId'] : SKIP
       @status = hash.key?('status') ? hash['status'] : SKIP
       # Parameter is an array, so we need to iterate through it

data/lib/shell_ev/exceptions/o_auth_provider_exception.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # OAuth 2 Authorization endpoint exception.
@@ -27,8 +27,8 @@ module ShellEv
     attr_accessor :error_uri
 
     # The constructor.
-    # @param [String] The reason for raising an exception.
-    # @param [HttpResponse] The HttpReponse of the API call.
+    # @param [String] reason The reason for raising an exception.
+    # @param [HttpResponse] response The HttpReponse of the API call.
     def initialize(reason, response)
       super(reason, response)
       hash = APIHelper.json_deserialize(@response.raw_body)
@@ -36,9 +36,11 @@ module ShellEv
     end
 
     # Populates this object by extracting properties from a hash.
-    # @param [Hash] The deserialized response sent by the server in the
+    # @param [Hash] hash The deserialized response sent by the server in the
     # response body.
     def unbox(hash)
+      return nil unless hash
+
       @error = hash.key?('error') ? hash['error'] : nil
       @error_description =
         hash.key?('error_description') ? hash['error_description'] : SKIP

data/lib/shell_ev/exceptions/serviceunavailable_exception.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # Serviceunavailable class.
@@ -23,8 +23,8 @@ module ShellEv
     attr_accessor :errors
 
     # The constructor.
-    # @param [String] The reason for raising an exception.
-    # @param [HttpResponse] The HttpReponse of the API call.
+    # @param [String] reason The reason for raising an exception.
+    # @param [HttpResponse] response The HttpReponse of the API call.
     def initialize(reason, response)
       super(reason, response)
       hash = APIHelper.json_deserialize(@response.raw_body)
@@ -32,9 +32,11 @@ module ShellEv
     end
 
     # Populates this object by extracting properties from a hash.
-    # @param [Hash] The deserialized response sent by the server in the
+    # @param [Hash] hash The deserialized response sent by the server in the
     # response body.
     def unbox(hash)
+      return nil unless hash
+
       @request_id = hash.key?('requestId') ? hash['requestId'] : SKIP
       @status = hash.key?('status') ? hash['status'] : SKIP
       # Parameter is an array, so we need to iterate through it

data/lib/shell_ev/exceptions/too_many_requests_exception.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # TooManyRequests class.
@@ -23,8 +23,8 @@ module ShellEv
     attr_accessor :errors
 
     # The constructor.
-    # @param [String] The reason for raising an exception.
-    # @param [HttpResponse] The HttpReponse of the API call.
+    # @param [String] reason The reason for raising an exception.
+    # @param [HttpResponse] response The HttpReponse of the API call.
     def initialize(reason, response)
       super(reason, response)
       hash = APIHelper.json_deserialize(@response.raw_body)
@@ -32,9 +32,11 @@ module ShellEv
     end
 
     # Populates this object by extracting properties from a hash.
-    # @param [Hash] The deserialized response sent by the server in the
+    # @param [Hash] hash The deserialized response sent by the server in the
     # response body.
     def unbox(hash)
+      return nil unless hash
+
       @request_id = hash.key?('requestId') ? hash['requestId'] : SKIP
       @status = hash.key?('status') ? hash['status'] : SKIP
       # Parameter is an array, so we need to iterate through it

data/lib/shell_ev/exceptions/unauthorized_exception.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # Unauthorized class.
@@ -22,8 +22,8 @@ module ShellEv
     attr_accessor :errors
 
     # The constructor.
-    # @param [String] The reason for raising an exception.
-    # @param [HttpResponse] The HttpReponse of the API call.
+    # @param [String] reason The reason for raising an exception.
+    # @param [HttpResponse] response The HttpReponse of the API call.
     def initialize(reason, response)
       super(reason, response)
       hash = APIHelper.json_deserialize(@response.raw_body)
@@ -31,9 +31,11 @@ module ShellEv
     end
 
     # Populates this object by extracting properties from a hash.
-    # @param [Hash] The deserialized response sent by the server in the
+    # @param [Hash] hash The deserialized response sent by the server in the
     # response body.
     def unbox(hash)
+      return nil unless hash
+
       @request_id = hash.key?('requestId') ? hash['requestId'] : SKIP
       @status = hash.key?('status') ? hash['status'] : SKIP
       # Parameter is an array, so we need to iterate through it

data/lib/shell_ev/exceptions/v2_charge_session_retrieve404_error_exception.rb

@@ -0,0 +1,67 @@
+# shell_ev
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module ShellEv
+  # V2 Charge Session Retrieve 404 Error class.
+  class V2ChargeSessionRetrieve404ErrorException < APIException
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # requestId is unique identifier value that is attached to requests and
+    # messages that allow reference to a particular transaction or event chain.
+    # @return [String]
+    attr_accessor :request_id
+
+    # Status of the request
+    # @return [String]
+    attr_accessor :status
+
+    # Exception details of the error
+    # @return [Array[NotFoundErrMsg]]
+    attr_accessor :errors
+
+    # The constructor.
+    # @param [String] reason The reason for raising an exception.
+    # @param [HttpResponse] response The HttpReponse of the API call.
+    def initialize(reason, response)
+      super(reason, response)
+      hash = APIHelper.json_deserialize(@response.raw_body)
+      unbox(hash)
+    end
+
+    # Populates this object by extracting properties from a hash.
+    # @param [Hash] hash The deserialized response sent by the server in the
+    # response body.
+    def unbox(hash)
+      return nil unless hash
+
+      @request_id = hash.key?('requestId') ? hash['requestId'] : SKIP
+      @status = hash.key?('status') ? hash['status'] : SKIP
+      # Parameter is an array, so we need to iterate through it
+      @errors = nil
+      unless hash['errors'].nil?
+        @errors = []
+        hash['errors'].each do |structure|
+          @errors << (NotFoundErrMsg.from_hash(structure) if structure)
+        end
+      end
+
+      @errors = SKIP unless hash.key?('errors')
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id}, status: #{@status}, errors: #{@errors}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id.inspect}, status: #{@status.inspect}, errors:"\
+      " #{@errors.inspect}>"
+    end
+  end
+end

data/lib/shell_ev/exceptions/v2_charge_session_start404_error_exception.rb

@@ -0,0 +1,67 @@
+# shell_ev
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module ShellEv
+  # V2 Charge Session Start 404 Error class.
+  class V2ChargeSessionStart404ErrorException < APIException
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # requestId is unique identifier value that is attached to requests and
+    # messages that allow reference to a particular transaction or event chain.
+    # @return [String]
+    attr_accessor :request_id
+
+    # Status of the request
+    # @return [String]
+    attr_accessor :status
+
+    # Exception details of the error
+    # @return [Array[NotFoundErrMsg]]
+    attr_accessor :errors
+
+    # The constructor.
+    # @param [String] reason The reason for raising an exception.
+    # @param [HttpResponse] response The HttpReponse of the API call.
+    def initialize(reason, response)
+      super(reason, response)
+      hash = APIHelper.json_deserialize(@response.raw_body)
+      unbox(hash)
+    end
+
+    # Populates this object by extracting properties from a hash.
+    # @param [Hash] hash The deserialized response sent by the server in the
+    # response body.
+    def unbox(hash)
+      return nil unless hash
+
+      @request_id = hash.key?('requestId') ? hash['requestId'] : SKIP
+      @status = hash.key?('status') ? hash['status'] : SKIP
+      # Parameter is an array, so we need to iterate through it
+      @errors = nil
+      unless hash['errors'].nil?
+        @errors = []
+        hash['errors'].each do |structure|
+          @errors << (NotFoundErrMsg.from_hash(structure) if structure)
+        end
+      end
+
+      @errors = SKIP unless hash.key?('errors')
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id}, status: #{@status}, errors: #{@errors}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id.inspect}, status: #{@status.inspect}, errors:"\
+      " #{@errors.inspect}>"
+    end
+  end
+end