hermes_api 0.5.0 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b071e3f67cee6a1475d31ef398886a256a6caa74af59f57a4cd94b35982298e0
-  data.tar.gz: 0501c14dc98e8de9e9c1d3bdb703e19f69d41f55a048249ade0ab1cb102793ed
+  metadata.gz: 7aa250e5a2fa57e788533a66c8814dc29a11e49ec736ebdb26b15beeb12f5191
+  data.tar.gz: b89100fb5266030c4d6b414fe0a95804e70a81cc4c33b452bf1cbadb2166b265
 SHA512:
-  metadata.gz: 7dd454207d4bcb9eea759890d4243b9486fbf704c29117614e51d1654621bbcde2c458916a0e89e6b1bd884cc65d40f41d113dcbe460c0f654b7a445e114a1bc
-  data.tar.gz: c6f727e2435134d77e00b856c61bd08467c374dd6cb95a58b9c517871fe325d50f2e468aad228a5f09b78958e507cff404216a32c206670763c18215138548b5
+  metadata.gz: 625023756875e69f1d2d04e880c597d75e4d31d331f0e68c2eca95c79bd3c8ef480a934a087374eddbf4db957cb95216bf2614729c4bc30856a756b44a7274b2
+  data.tar.gz: 5bd9cebf512cfdfc7e1bf3aa1c28eaa8e0bbde3bcde8a1f93a440eaf1dc27bf28d646fedf0b4dd21b78b90b4874510ecf70b4957789218071e4af08159e5afab

data/Gemfile.lock

@@ -1,14 +1,15 @@
 PATH
   remote: .
   specs:
-    hermes_api (0.4.1)
+    hermes_api (0.7.0)
       activeresource (>= 4.1.0, < 6.0.0)
+      rexml (~> 3.2, >= 3.2.4)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activemodel (6.1.4)
-      activesupport (= 6.1.4)
+    activemodel (6.1.4.4)
+      activesupport (= 6.1.4.4)
     activemodel-serializers-xml (1.0.2)
       activemodel (> 5.x)
       activesupport (> 5.x)
@@ -17,7 +18,7 @@ GEM
       activemodel (>= 5.0, < 7)
       activemodel-serializers-xml (~> 1.0)
       activesupport (>= 5.0, < 7)
-    activesupport (6.1.4)
+    activesupport (6.1.4.4)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 1.6, < 2)
       minitest (>= 5.1)
@@ -47,14 +48,14 @@ GEM
       guard (~> 2.1)
       guard-compat (~> 1.1)
       rspec (>= 2.99.0, < 4.0)
-    i18n (1.8.10)
+    i18n (1.8.11)
       concurrent-ruby (~> 1.0)
     listen (3.5.1)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
     lumberjack (1.2.8)
     method_source (1.0.0)
-    minitest (5.14.4)
+    minitest (5.15.0)
     nenv (0.3.0)
     notiffany (0.1.3)
       nenv (~> 0.1)
@@ -111,9 +112,10 @@ GEM
     tzinfo (2.0.4)
       concurrent-ruby (~> 1.0)
     unicode-display_width (2.0.0)
-    zeitwerk (2.4.2)
+    zeitwerk (2.5.3)
 
 PLATFORMS
+  arm64-darwin-21
   x86_64-darwin-19
 
 DEPENDENCIES
@@ -129,4 +131,4 @@ DEPENDENCIES
   standard
 
 BUNDLED WITH
-   2.2.24
+   2.3.4

data/bin/console

@@ -1,6 +1,7 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
+require "pry"
 require "bundler/setup"
 require "dotenv/load"
 require "dev/zeitwerk_loader"
@@ -11,5 +12,4 @@ require "hermes_api"
 set_config
 
 # (If you use this, don't forget to add pry to your Gemfile!)
-require "pry"
 Pry.start

data/hermes_api.gemspec

@@ -30,6 +30,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency "activeresource", ">= 4.1.0", "< 6.0.0"
+  spec.add_dependency "rexml", "~> 3.2", ">= 3.2.4"
 
   spec.add_development_dependency "rspec", "~> 3.2"
   spec.add_development_dependency "dotenv"

data/lib/dev/config.rb

@@ -3,6 +3,8 @@ require "dotenv/load"
 def set_config
   HermesAPI.configure do |config|
     config.env = :test
+    # Set to production when testing HermesAPI::TrackingEvent resource
+    # config.env = :production
     config.proxy = ENV["HERMES_API_PROXY"]
   end
 end

data/lib/hermes_api/bearer_auth.rb

@@ -1,11 +1,13 @@
 module HermesAPI
   module BearerAuth
     def with_oauth_session(api_key, client_id, client_secret)
+      existing_apikey = headers["apikey"]
+      existing_bearer_token = connection.bearer_token
       headers["apikey"] = api_key
       connection.bearer_token = fetch_token(client_id, client_secret)
       response = yield
-      connection.bearer_token = nil
-      headers["apikey"] = nil
+      headers["apikey"] = existing_apikey
+      connection.bearer_token = existing_bearer_token
       response
     rescue ActiveResource::UnauthorizedAccess => e
       clear_token_cache(client_id, client_secret)

data/lib/hermes_api/cache.rb

@@ -1,10 +1,5 @@
 module HermesAPI
   mattr_accessor :cache
 
-  self.cache = if defined?(Rails) && Rails.respond_to?(:cache) &&
-                  Rails.cache.is_a?(ActiveSupport::Cache::Store)
-    Rails.cache
-  else
-    ActiveSupport::Cache::MemoryStore.new
-  end
-end
+  self.cache = ActiveSupport::Cache::MemoryStore.new
+end

data/lib/hermes_api/configuration.rb

@@ -25,6 +25,10 @@ module HermesAPI
 
       HermesAPI::JsonBase.site = config.env.to_s == "production" ? JSON_PRODUCTION_SITE : JSON_TESTING_SITE
       HermesAPI::OAuth.site = config.env.to_s == "production" ? OAUTH_PRODUCTION_SITE : OAUTH_TESTING_SITE
+
+      if defined?(Rails) && Rails.respond_to?(:cache) && Rails.cache.is_a?(ActiveSupport::Cache::Store)
+        HermesAPI.cache = Rails.cache
+      end
     end
 
     def configure

data/lib/hermes_api/creation_error.rb

@@ -4,18 +4,50 @@ module HermesAPI
       ActiveResource::Formats::XmlFormat.decode(@response.body)
     end
 
-    def to_s
-      response = ActiveResource::Formats::XmlFormat.decode(@response.body)
-      entries = response.dig("routingResponseEntries", "routingResponseEntry")
+    def code
+      if entries.is_a? Array
+        entries.map do |entry|
+          entry.dig("errorMessages", "errorCode")
+        end
+      else
+        entries.dig("errorMessages", "errorCode")
+      end
+    end
+
+    alias_method :codes, :code
+
+    def description
+      unless entries.is_a? Array
+        entries.dig("errorMessages", "errorDescription")
+      end
+    end
+
+    def code_with_descriptions
       if entries.is_a? Array
         entries.map do |entry|
-          error = entry.dig("errorMessages")
-          "Something went wrong, Error Code: #{error["errorCode"]}, Error Description: #{error["errorDescription"]}."
-        end.to_s
+          code = entry.dig("errorMessages", "errorCode")
+          description = entry.dig("errorMessages", "errorDescription")
+          "#{code}: #{description}"
+        end
+      end
+    end
+
+    def to_s
+      if entries.is_a? Array
+        "#{code_with_descriptions.join(", ")}."
       else
-        error = entries.dig("errorMessages")
-        "Something went wrong. Error Code: #{error["errorCode"]} Error Description: #{error["errorDescription"]}"
+        "#{code}: #{description}."
       end
     end
+
+    private
+
+    def decoded_response
+      ActiveResource::Formats::XmlFormat.decode(@response.body)
+    end
+
+    def entries
+      decoded_response.dig("routingResponseEntries", "routingResponseEntry")
+    end
   end
 end

data/lib/hermes_api/resources/base.rb

@@ -29,8 +29,13 @@ module HermesAPI
       super
     end
 
+    def load(attributes, remove_root = false, persisted = false)
+      attributes.deep_transform_keys! { |k| k.to_s.underscore }
+      super
+    end
+
     def to_xml(options = {})
-      super({root: self.class.root}.merge(options))
+      super({root: self.class.root, camelize: :lower}.merge(options))
     end
   end
 end

data/lib/hermes_api/resources/drop_off_return_label.rb

@@ -0,0 +1,166 @@
+module HermesAPI
+  class DropOffReturnLabel < Base
+        # Create return label(s) wheredrop off at ParcelShops.
+    # HermesUK doc: https://drive.google.com/file/d/1lVuHd2o4nDWrGkacG0GrvNm7LYVL_bFd/view?usp=sharing
+    # You can choose to create a batch of return labels by passing in multiple collectionRoutingRequestEntry.
+    # Example:
+    # HermesAPI::Base.with_session("username", "password") do
+    # request_body = {client_id: "1234",
+    #                 client_name: "Leggings",
+    #                 child_client_id: "",
+    #                 child_client_name: "",
+    #                 source_of_request: "CLIENTWS",
+    #                 collection_routing_request_entries: [{ # collectionRoutingRequestEntry
+    #                   customer: {
+    #                     address: {
+    #                       first_name: "Leonie", lastame: "E", houseName: "2", streetName: "Street",
+    #                       addressLine1: "2 Street", addressLine2: "Fulham", postCode: "SW6 6EL",
+    #                       city: "London", region: "", countryCode: "GB"
+    #                     },
+    #                     mobilePhoneNo: "+447884571522",
+    #                     email: "leonie@london.com",
+    #                     customerReference1: "8284"
+    #                   },
+    #                   countryOfOrigin: "GB"
+    #                 }]}
+    # @order = HermesAPI::DropOffReturnLabel.new(request_body)
+    # @order.save
+
+    #   # Request for a single print in store QR code by wrapping in an oauth session block, only work with 1 label.
+    #   # To request a batch of QR codes, use the HermesAPI::PrintInStoreQrCode#create directly.
+
+    #   HermesAPI::PrintInStoreQrCode.with_oauth_session("api_key", "client_id/auth_id", "client_secret/auth_secret") do
+    #     @order.request_print_in_store_qr_code(
+    #       delivery_address: {
+    #         name: "Andy",
+    #         address_line1: "7 Street",
+    #         address_line2: "Fulham",
+    #         country_code: "GB",
+    #         postcode: "SW6 6EL"
+    #       },
+    #       dimensions: {
+    #         depth: 15,
+    #         length: 20,
+    #         width: 15,
+    #         weight: 1
+    #       },
+    #       value: {
+    #         currency: "GBP",
+    #         amount: 10
+    #       }
+    #     )
+    #   end
+    # end
+
+    include ReturnLabelHelper
+
+    self.prefix = "/routing/service/rest/v4/createReturnBarcodeAndLabel"
+    self.element_name = ""
+
+    DEFAULT_ATTRS = {
+      client_id: "",
+      client_name: "",
+      child_client_id: "",
+      child_client_name: "",
+      source_of_request: "",
+      collection_routing_request_entries: [{
+        customer: {
+          address: {
+            first_name: "",
+            last_name: "",
+            house_name: "",
+            street_name: "",
+            address_line1: "",
+            post_code: "",
+            city: "",
+            region: "",
+            country_code: ""
+          },
+          mobile_phone_no: "",
+          email: "",
+          customer_reference1: ""
+        },
+        country_of_origin: ""
+      }]
+    }
+
+    def request_print_in_store_qr_code(**attrs)
+      if missing_required_qr_code_attributes?(attrs)
+        raise ArgumentError, request_print_in_store_qr_code_error_message
+      end
+
+      return nil if attributes["routing_response_entries"].blank?
+
+      entries = routing_response_entries.routing_response_entry
+      entry = entries.is_a?(Array) ? entries[0] : entries
+      carrier = entry.inbound_carriers.carrier1
+      barcode = carrier.barcode1
+      customer = collection_routing_request_entries[0].customer
+      address = customer.address
+
+      self.print_in_store_qr_code = PrintInStoreQrCode.create(
+        customer: {
+          customer_reference1: customer.customer_reference1
+        },
+        label_type: "RETURN",
+        barcode: {
+          barcode: barcode.barcode_number,
+          barcode_display: barcode.barcode_display
+        },
+        client: {
+          client_id: client_id,
+          client_name: client_name
+        },
+        routing: {
+          delivery_method: {
+            delivery_method_id: carrier.delivery_method_code,
+            delivery_method_description: carrier.delivery_method_desc
+          },
+          sort_levels: {
+            sort_level1: carrier.sort_level1.strip,
+            sort_level2: carrier.sort_level2
+          }
+        },
+        service_offers: [],
+        **attrs
+      )
+    end
+
+    private
+
+    def missing_required_qr_code_attributes?(attrs)
+      ([:dimensions, :value, :delivery_address] - attrs.keys).length > 0
+    end
+
+    def request_print_in_store_qr_code_error_message
+      <<~ERR_MESSAGE
+        Missing required attributes
+        Example:
+
+        label = HermesAPI::DropOffReturnLabel.new(...)
+
+        if label.save
+          label.request_print_in_store_qr_code(
+            dimensions: {
+              depth: 15,
+              length: 20,
+              width: 15,
+              weight: 1
+            },
+            value: {
+              currency: 'GBP',
+              amount: 10
+            },
+            delivery_address: {
+              name: 'Don Joe',
+              address_line1: 'Real Logic',
+              address_line2: '4-4 Ridings Park, Eastern Way',
+              country_code: 'GB',
+              postcode: 'WS117FJ'
+            }
+          )
+        end
+      ERR_MESSAGE
+    end
+  end
+end

data/lib/hermes_api/resources/json_base.rb

@@ -6,5 +6,15 @@ module HermesAPI
     def self.inherited(subclass)
       subclass.extend(BearerAuth)
     end
+
+    def load(attributes, remove_root = false, persisted = false)
+      attributes.deep_transform_keys! { |k| k.to_s.underscore }
+      super
+    end
+
+    def to_json(options = {})
+      attributes.as_json.deep_transform_keys { |k| k.to_s.camelize(:lower) }
+        .to_json(include_root_in_json ? {root: self.class.element_name}.merge(options) : options)
+    end
   end
 end

data/lib/hermes_api/resources/pickup_return_label.rb

@@ -0,0 +1,85 @@
+module HermesAPI
+  class PickupReturnLabel < Base
+    # Create return label(s) with courier pickup request.
+    # HermesUK doc: https://drive.google.com/file/d/1lVuHd2o4nDWrGkacG0GrvNm7LYVL_bFd/view?usp=sharing
+    # You can choose to create a batch of return labels by passing in multiple collectionRoutingRequestEntry.
+    # Example:
+    # HermesAPI::Base.with_session("username", "password") do
+    #   request_body = {clientId: "249",
+    #                   clientName: "Leggings",
+    #                   childClientId: "",
+    #                   childClientName: "",
+    #                   sourceOfRequest: "CLIENTWS",
+    #                   routingStartDate: Time.now.tomorrow.strftime("%Y-%m-%dT%H:%M:%S"),
+    #                   collectionRoutingRequestEntries: [{ # collectionRoutingRequestEntry
+    #                     customer: {
+    #                       address: {
+    #                         firstName: "Leonie", lastName: "E", houseName: "2", streetName: "Street",
+    #                         addressLine1: "2 Street", addressLine2: "Fulham", postCode: "SW6 6EL",
+    #                         city: "London", region: "", countryCode: "GB"
+    #                       },
+    #                       mobilePhoneNo: "+447884571522",
+    #                       email: "leonie@london.com",
+    #                       customerReference1: "8284"
+    #                     },
+    #                     parcel: {
+    #                       weight: 1,
+    #                       length: 10,
+    #                       width: 10,
+    #                       depth: 10,
+    #                       girth: 0,
+    #                       combinedDimension: 0,
+    #                       volume: 0,
+    #                       value: 10,
+    #                       description: "Parcel"
+    #                     },
+    #                     countryOfOrigin: "GB"
+    #                   }]}
+    #   @order = HermesAPI::PickupReturnLabel.new(request_body)
+    #   @order.save
+    # end
+
+    include ReturnLabelHelper
+
+    self.prefix = "/routing/service/rest/v4/routeCollectionCreatePreadviceReturnBarcodeAndLabel"
+    self.element_name = ""
+
+    DEFAULT_ATTRS = {
+      client_id: "",
+      client_name: "",
+      child_client_id: "",
+      child_client_name: "",
+      source_of_request: "",
+      collection_routing_request_entries: [{
+        customer: {
+          address: {
+            first_name: "",
+            last_name: "",
+            house_name: "",
+            street_name: "",
+            address_line1: "",
+            post_code: "",
+            city: "",
+            region: "",
+            country_code: ""
+          },
+          parcel: {
+            weight: 1,
+            length: 10,
+            width: 10,
+            depth: 10,
+            girth: 0,
+            combined_dimension: 0,
+            volume: 0,
+            value: 10,
+            description: "Parcel"
+          },
+          mobile_phone_no: "",
+          email: "",
+          customer_reference1: ""
+        },
+        country_of_origin: ""
+      }]
+    }
+  end
+end

data/lib/hermes_api/resources/print_in_store_qr_code.rb

@@ -9,8 +9,8 @@ module HermesAPI
       super
     end
 
-    def qr_code
-      base64_data = as_json.dig("qrCode", "base64EncodedBytes")
+    def qr_code_image
+      base64_data = as_json.dig("qr_code", "base64_encoded_bytes")
       Base64.decode64(base64_data) if base64_data
     end
   end

data/lib/hermes_api/resources/tracking_event.rb

@@ -1,11 +1,11 @@
 module HermesAPI
   class TrackingEvent < JsonBase
-    #   # Retrieve TrackingEvents by wrapping in an oauth session block
+    # # Retrieve TrackingEvents by wrapping in an oauth session block
+    #
+    # HermesAPI::TrackingEvent.with_oauth_session("api_key", "client_id/auth_id", "client_secret/auth_secret") do
+    #   HermesAPI::TrackingEvent.where(barcode: "123456789")
+    # end
     #
-    #   HermesAPI::TrackingEvent.with_oauth_session("api_key", "client_id/auth_id", "client_secret/auth_secret") do
-    #     HermesAPI::TrackingEvent.where(barcode: "123456789")
-    #   end
-
     self.element_name = ""
     self.prefix = "/client-tracking-api/v1/events"
 

data/lib/hermes_api/resources/web_tracking.rb

@@ -1,5 +1,9 @@
 module HermesAPI
   class WebTracking < ActiveResource::Base
+    # # Retrieve TrackingEvents from web site: https://www.myhermes.co.uk/track
+  
+    # HermesAPI::WebTracking.find("1234512345")
+    
     self.element_name = ""
     self.site = "https://api.hermesworld.co.uk"
     self.prefix = "/enterprise-tracking-api/v1/parcels"
@@ -18,11 +22,14 @@ module HermesAPI
 
     def load(attributes, remove_root = false, persisted = false)
       attributes = attributes.dig("results", 0)
-      super(attributes)
+      attributes.deep_transform_keys! { |k| k.to_s.underscore }
+      super
     end
 
     def self.find(barcode)
       uniqueId = format.decode(connection.get("#{prefix}/search/#{barcode}", headers).body).first
+      return nil if uniqueId.nil?
+
       find_single("", params: {uniqueIds: uniqueId})
     end
   end

data/lib/hermes_api/shared/return_label_helper.rb

@@ -0,0 +1,41 @@
+module HermesAPI
+  module ReturnLabelHelper
+    module ClassMethods
+      def root
+        :collectionRoutingRequest
+      end
+    end
+
+    def self.included(base_klass)
+      base_klass.extend(ClassMethods)
+    end
+
+    def labels
+      entries = routing_response_entries.routing_response_entry
+      if entries.is_a?(Array)
+        entries.map do |entry|
+          Base64.decode64(entry.inbound_carriers.label_image)
+        end
+      else
+        Base64.decode64(entries.inbound_carriers.label_image)
+      end
+    rescue NameError
+    end
+
+    alias_method :label, :labels
+
+    def tracking_numbers
+      entries = routing_response_entries.routing_response_entry
+      if entries.is_a?(Array)
+        entries.map do |entry|
+          entry.inbound_carriers.carrier1.barcode1.barcode_number
+        end
+      else
+        entries.inbound_carriers.carrier1.barcode1.barcode_number
+      end
+    rescue NameError
+    end
+
+    alias_method :tracking_number, :tracking_numbers
+  end
+end

data/lib/hermes_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module HermesAPI
-  VERSION = "0.5.0"
+  VERSION = "0.7.1"
 end

data/lib/hermes_api.rb

@@ -4,17 +4,19 @@ require_relative "hermes_api/version"
 require "active_resource"
 
 module HermesAPI
-  require "hermes_api/cache"
   require "hermes_api/bearer_auth"
+  require "hermes_api/cache"
   require "hermes_api/configuration"
-  require "hermes_api/creation_error"
   require "hermes_api/connection"
+  require "hermes_api/creation_error"
 
-  require "hermes_api/resources/base"
-  require "hermes_api/resources/return_label"
+  require "hermes_api/shared/return_label_helper"
 
-  require "hermes_api/resources/o_auth"
+  require "hermes_api/resources/base"
+  require "hermes_api/resources/drop_off_return_label"
   require "hermes_api/resources/json_base"
+  require "hermes_api/resources/o_auth"
+  require "hermes_api/resources/pickup_return_label"
   require "hermes_api/resources/print_in_store_qr_code"
   require "hermes_api/resources/tracking_event"
   require "hermes_api/resources/web_tracking"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hermes_api
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.7.1
 platform: ruby
 authors:
 - Andy Chong
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-08-27 00:00:00.000000000 Z
+date: 2022-01-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activeresource
@@ -30,6 +30,26 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: 6.0.0
+- !ruby/object:Gem::Dependency
+  name: rexml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.2.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.2.4
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -157,12 +177,14 @@ files:
 - lib/hermes_api/connection.rb
 - lib/hermes_api/creation_error.rb
 - lib/hermes_api/resources/base.rb
+- lib/hermes_api/resources/drop_off_return_label.rb
 - lib/hermes_api/resources/json_base.rb
 - lib/hermes_api/resources/o_auth.rb
+- lib/hermes_api/resources/pickup_return_label.rb
 - lib/hermes_api/resources/print_in_store_qr_code.rb
-- lib/hermes_api/resources/return_label.rb
 - lib/hermes_api/resources/tracking_event.rb
 - lib/hermes_api/resources/web_tracking.rb
+- lib/hermes_api/shared/return_label_helper.rb
 - lib/hermes_api/version.rb
 homepage: https://github.com/PostCo/hermes_api
 licenses:
@@ -187,7 +209,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.22
+rubygems_version: 3.2.32
 signing_key:
 specification_version: 4
 summary: Unofficial Ruby object based Hermes UK API wrapper.

data/lib/hermes_api/resources/return_label.rb

@@ -1,185 +0,0 @@
-module HermesAPI
-  class ReturnLabel < Base
-    # Create return label(s).
-    # You can choose to create a batch of return labels by passing in multiple collectionRoutingRequestEntry.
-    # Example:
-    # HermesAPI::Base.with_session("username", "password") do
-    #   request_body = {clientId: "1234",
-    #                   clientName: "Life",
-    #                   childClientId: "",
-    #                   childClientName: "",
-    #                   sourceOfRequest: "CLIENTWS",
-    #                   collectionRoutingRequestEntries: [{ #collectionRoutingRequestEntry
-    #                     customer: {
-    #                       address: {
-    #                         firstName: "Leonie", lastName: "E", houseName: "2", streetName: "Street",
-    #                         addressLine1: "2 Street", addressLine2: "Fulham", postCode: "SW6 6EL",
-    #                         city: "London", region: "", countryCode: "GB"
-    #                       },
-    #                       mobilePhoneNo: "+447884571522",
-    #                       email: "leonie@london.com",
-    #                       customerReference1: "8284"
-    #                     },
-    #                     countryOfOrigin: "GB"
-    #                   }]}
-    #   @order = HermesAPI::ReturnLabel.new(request_body)
-    #   @order.save
-    #
-    #   # Request for a single print in store QR code by wrapping in an oauth session block, only work with 1 label.
-    #   # To request a batch of QR codes, use the HermesAPI::PrintInStoreQrCode#create directly.
-    #
-    #   HermesAPI::PrintInStoreQrCode.with_oauth_session("api_key", "client_id/auth_id", "client_secret/auth_secret") do
-    #     @order.request_print_in_store_qr_code(
-    #       deliveryAddress: {
-    #         name: "Andy",
-    #         addressLine1: "7 Street",
-    #         addressLine2: "Fulham",
-    #         countryCode: "GB",
-    #         postcode: "SW6 6EL"
-    #       },
-    #       dimensions: {
-    #         depth: 15,
-    #         length: 20,
-    #         width: 15,
-    #         weight: 1
-    #       },
-    #       value: {
-    #         currency: "GBP",
-    #         amount: 10
-    #       }
-    #     )
-    #   end
-    # end
-    #
-    self.prefix = "/routing/service/rest/v4/createReturnBarcodeAndLabel"
-    self.element_name = ""
-
-    DEFAULT_ATTRS = {
-      clientId: "",
-      clientName: "",
-      childClientId: "",
-      childClientName: "",
-      sourceOfRequest: "",
-      collectionRoutingRequestEntries: [{
-        customer: {
-          address: {
-            firstName: "",
-            lastName: "",
-            houseName: "",
-            streetName: "",
-            addressLine1: "",
-            postCode: "",
-            city: "",
-            region: "",
-            countryCode: ""
-          },
-          mobilePhoneNo: "",
-          email: "",
-          customerReference1: ""
-        },
-        countryOfOrigin: ""
-      }]
-    }
-
-    def self.root
-      :collectionRoutingRequest
-    end
-
-    def labels
-      entries = routingResponseEntries.routingResponseEntry
-      if entries.is_a?(Array)
-        entries.map do |entry|
-          Base64.decode64(entry.inboundCarriers.labelImage)
-        end
-      else
-        Base64.decode64(entries.inboundCarriers.labelImage)
-      end
-    rescue NameError
-    end
-
-    alias_method :label, :labels
-
-    def tracking_numbers
-      entries = routingResponseEntries.routingResponseEntry
-      if entries.is_a?(Array)
-        entries.map do |entry|
-          entry.inboundCarriers.carrier1.barcode1.barcodeNumber
-        end
-      else
-        entries.inboundCarriers.carrier1.barcode1.barcodeNumber
-      end
-    rescue NameError
-    end
-
-    alias_method :tracking_number, :tracking_numbers
-
-    def request_print_in_store_qr_code(**attrs)
-      if ([:dimensions, :value, :deliveryAddress] - attrs.keys).length > 0
-        raise ArgumentError, request_print_in_store_qr_code_error_message
-      end
-
-      return nil if attributes["routingResponseEntries"].blank?
-
-      entries = routingResponseEntries.routingResponseEntry
-      entry = entries.is_a?(Array) ? entries[0] : entries
-      carrier = entry.inboundCarriers.carrier1
-      barcode = carrier.barcode1
-      customer = collectionRoutingRequestEntries[0].customer
-      address = customer.address
-      self.print_in_store_qr_code = PrintInStoreQrCode.create(
-        customer: {
-          customerReference1: customer.customerReference1
-        },
-        labelType: "RETURN",
-        barcode: {
-          barcode: barcode.barcodeNumber,
-          barcodeDisplay: barcode.barcodeDisplay
-        },
-        client: {
-          clientId: clientId,
-          clientName: clientName
-        },
-        routing: {
-          deliveryMethod: {
-            deliveryMethodId: carrier.deliveryMethodCode,
-            deliveryMethodDescription: carrier.deliveryMethodDesc
-          },
-          sortLevels: {
-            sortLevel1: carrier.sortLevel1.strip,
-            sortLevel2: carrier.sortLevel2
-          }
-        },
-        serviceOffers: [],
-        **attrs
-      )
-    end
-
-    private
-
-    def request_print_in_store_qr_code_error_message
-      <<~HEREDOC
-        Missing attributes
-        Example:
-        HermesAPI::ReturnLabel#request_print_in_store_qr_code(
-          dimensions: {
-            depth: 15,
-            length: 20,
-            width: 15,
-            weight: 1
-          },
-          value: {
-            currency: 'GBP',
-            amount: 10
-          },
-          deliveryAddress: {
-            name: 'Don Joe',
-            addressLine1: 'Real Logic',
-            addressLine2: '4-4 Ridings Park, Eastern Way',
-            countryCode: 'GB',
-            postcode: 'WS117FJ'
-          }
-        )
-      HEREDOC
-    end
-  end
-end