friendly_shipping 0.8.1 → 0.10.0

data/lib/friendly_shipping/services/ups_freight/generate_commodity_information.rb

@@ -4,26 +4,72 @@ module FriendlyShipping
   module Services
     class UpsFreight
       class GenerateCommodityInformation
-        def self.call(shipment:, options:)
-          shipment.packages.flat_map do |package|
-            package_options = options.options_for_package(package)
-            package.items.map do |item|
-              item_options = package_options.options_for_item(item)
-              {
-                # This is a required field
-                Description: item.description || 'Commodities',
-                Weight: {
-                  UnitOfMeasurement: {
-                    Code: 'LBS' # Only Pounds are supported
+        class << self
+          # @param shipment [Physical::Shipment]
+          # @param options [#options_for_package, #options_for_structure]
+          # @return [Array<Hash>]
+          def call(shipment:, options:)
+            if shipment.packages.any?
+              warn "[DEPRECATION] `packages` is deprecated.  Please use `structures` instead."
+              serialize_packages(shipment.packages, options)
+            else
+              serialize_structures(shipment.structures, options)
+            end
+          end
+
+          private
+
+          # @param packages [Array<Physical::Package>]
+          # @param options [#options_for_package]
+          # @return [Array<Hash>]
+          def serialize_packages(packages, options)
+            packages.flat_map do |package|
+              package_options = options.options_for_package(package)
+              package.items.map do |item|
+                item_options = package_options.options_for_item(item)
+                {
+                  # This is a required field
+                  Description: item.description || 'Commodities',
+                  Weight: {
+                    UnitOfMeasurement: {
+                      Code: 'LBS' # Only Pounds are supported
+                    },
+                    Value: item.weight.convert_to(:pounds).value.to_f.round(2).to_s
+                  },
+                  NumberOfPieces: '1', # We won't support this yet.
+                  PackagingType: {
+                    Code: item_options.packaging_code
+                  },
+                  FreightClass: item_options.freight_class
+                }
+              end
+            end
+          end
+
+          # @param structures [Array<Physical::Structure>]
+          # @param options [#options_for_structure]
+          # @return [Array<Hash>]
+          def serialize_structures(structures, options)
+            structures.flat_map do |structure|
+              structure_options = options.options_for_structure(structure)
+              structure.packages.map do |package|
+                package_options = structure_options.options_for_package(package)
+                {
+                  # This is a required field
+                  Description: package.description || 'Commodities',
+                  Weight: {
+                    UnitOfMeasurement: {
+                      Code: 'LBS' # Only Pounds are supported
+                    },
+                    Value: package.weight.convert_to(:pounds).value.to_f.round(2).to_s
+                  },
+                  NumberOfPieces: '1', # We won't support this yet.
+                  PackagingType: {
+                    Code: package_options.packaging_code
                   },
-                  Value: item.weight.convert_to(:pounds).value.to_f.round(2).to_s
-                },
-                NumberOfPieces: '1', # We won't support this yet.
-                PackagingType: {
-                  Code: item_options.packaging_code
-                },
-                FreightClass: item_options.freight_class
-              }
+                  FreightClass: package_options.freight_class
+                }
+              end
             end
           end
         end

data/lib/friendly_shipping/services/ups_freight/generate_freight_rate_request_hash.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require 'friendly_shipping/services/ups_freight/generate_location_hash'
-require 'friendly_shipping/services/ups_freight/generate_pickup_request_hash'
-
 module FriendlyShipping
   module Services
     class UpsFreight
@@ -22,31 +19,13 @@ module FriendlyShipping
                 Commodity: options.commodity_information_generator.call(shipment: shipment, options: options),
                 TimeInTransitIndicator: 'true',
                 PickupRequest: GeneratePickupRequestHash.call(pickup_request_options: options.pickup_request_options),
-              }.compact.merge(handling_units(shipment, options).reduce(&:merge).to_h)
+              }.compact.
+                merge(GenerateHandlingUnitsHash.call(shipment: shipment, options: options))
             }
           end
 
           private
 
-          def handling_units(shipment, options)
-            all_package_options = shipment.packages.map { |package| options.options_for_package(package) }
-            all_package_options.group_by(&:handling_unit_code).map do |_handling_unit_code, options_group|
-              [options_group.first, options_group.length]
-            end.map { |package_options, quantity| handling_unit_hash(package_options, quantity) }
-          end
-
-          def handling_unit_hash(package_options, quantity)
-            {
-              package_options.handling_unit_tag => {
-                Quantity: quantity.to_s,
-                Type: {
-                  Code: package_options.handling_unit_code,
-                  Description: package_options.handling_unit_description
-                }
-              }
-            }
-          end
-
           def request_options(customer_context)
             return {} unless customer_context
 

data/lib/friendly_shipping/services/ups_freight/generate_freight_ship_request_hash.rb

@@ -1,12 +1,5 @@
 # frozen_string_literal: true
 
-require 'friendly_shipping/services/ups_freight/generate_location_hash'
-require 'friendly_shipping/services/ups_freight/generate_reference_hash'
-require 'friendly_shipping/services/ups_freight/generate_document_options_hash'
-require 'friendly_shipping/services/ups_freight/generate_email_options_hash'
-require 'friendly_shipping/services/ups_freight/generate_pickup_options_hash'
-require 'friendly_shipping/services/ups_freight/generate_delivery_options_hash'
-
 module FriendlyShipping
   module Services
     class UpsFreight
@@ -33,7 +26,7 @@ module FriendlyShipping
                   DeliveryInstructions: options.delivery_instructions,
                   PickupRequest: GeneratePickupRequestHash.call(pickup_request_options: options.pickup_request_options),
                 }.compact.
-                  merge(handling_units(shipment, options).reduce(&:merge).to_h).
+                  merge(GenerateHandlingUnitsHash.call(shipment: shipment, options: options)).
                   merge(GenerateReferenceHash.call(reference_numbers: options.reference_numbers))
               }
             }
@@ -48,25 +41,6 @@ module FriendlyShipping
             [email_options, pickup_options, delivery_options].compact.presence
           end
 
-          def handling_units(shipment, options)
-            all_package_options = shipment.packages.map { |package| options.options_for_package(package) }
-            all_package_options.group_by(&:handling_unit_code).map do |_handling_unit_code, options_group|
-              [options_group.first, options_group.length]
-            end.map { |package_options, quantity| handling_unit_hash(package_options, quantity) }
-          end
-
-          def handling_unit_hash(package_options, quantity)
-            {
-              package_options.handling_unit_tag => {
-                Quantity: quantity.to_s,
-                Type: {
-                  Code: package_options.handling_unit_code,
-                  Description: package_options.handling_unit_description
-                }
-              }
-            }
-          end
-
           def payment_information(options)
             payer_address = GenerateLocationHash.call(location: options.billing_address).
                             merge(ShipperNumber: options.shipper_number)

data/lib/friendly_shipping/services/ups_freight/generate_handling_units_hash.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module FriendlyShipping
+  module Services
+    class UpsFreight
+      # Generates a handling units hash for JSON serialization.
+      class GenerateHandlingUnitsHash
+        class << self
+          # @param shipment [Physical::Shipment]
+          # @param options [ShipmentOptions]
+          # @return [Hash]
+          def call(shipment:, options:)
+            handling_units(shipment, options).reduce(&:merge)
+          end
+
+          private
+
+          # @param shipment [Physical::Shipment]
+          # @param options [ShipmentOptions]
+          # @return [Array<Hash>]
+          def handling_units(shipment, options)
+            if shipment.packages.any?
+              warn "[DEPRECATION] `packages` is deprecated.  Please use `structures` instead."
+              all_package_options = shipment.packages.map { |package| options.options_for_package(package) }
+              all_package_options.group_by(&:handling_unit_code).map do |_handling_unit_code, options_group|
+                [options_group.first, options_group.length]
+              end.map { |package_options, quantity| handling_unit_hash(package_options, quantity) }
+            else
+              all_structure_options = shipment.structures.map { |structure| options.options_for_structure(structure) }
+              all_structure_options.group_by(&:handling_unit_code).map do |_handling_unit_code, options_group|
+                [options_group.first, options_group.length]
+              end.map { |structure_options, quantity| handling_unit_hash(structure_options, quantity) }
+            end
+          end
+
+          # @param options [PackageOptions, StructureOptions]
+          # @param quantity [Integer]
+          # @return [Hash]
+          def handling_unit_hash(options, quantity)
+            {
+              options.handling_unit_tag.to_sym => {
+                Quantity: quantity.to_s,
+                Type: {
+                  Code: options.handling_unit_code,
+                  Description: options.handling_unit_description
+                }
+              }
+            }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/friendly_shipping/services/ups_freight/label_options.rb

@@ -3,7 +3,9 @@
 module FriendlyShipping
   module Services
     class UpsFreight
+      # Options for generating UPS Freight labels for a shipment.
       class LabelOptions < RatesOptions
+        # Maps friendly names to reference number codes.
         REFERENCE_NUMBER_CODES = {
           bill_of_lading_number: "57",
           purchase_order_number: "28",
@@ -18,16 +20,38 @@ module FriendlyShipping
           other: "OTHER"
         }.freeze
 
-        attr_reader :document_options,
-                    :email_options,
-                    :pickup_options,
-                    :delivery_options,
-                    :pickup_instructions,
-                    :delivery_instructions,
-                    :handling_instructions,
-                    :reference_numbers
+        # @return [Array<LabelDocumentOptions>]
+        attr_reader :document_options
 
-        # @param [Array] reference_numbers Reference numbers for the Bill of Lading
+        # @return [Array<LabelEmailOptions>]
+        attr_reader :email_options
+
+        # @return [LabelPickupOptions]
+        attr_reader :pickup_options
+
+        # @return [LabelDeliveryOptions]
+        attr_reader :delivery_options
+
+        # @return [String]
+        attr_reader :pickup_instructions
+
+        # @return [String]
+        attr_reader :delivery_instructions
+
+        # @return [String]
+        attr_reader :handling_instructions
+
+        # @return [Array<Hash>]
+        attr_reader :reference_numbers
+
+        # @param document_options [Array<LabelDocumentOptions>]
+        # @param email_options [Array<LabelEmailOptions>]
+        # @param pickup_options [LabelPickupOptions]
+        # @param delivery_options [LabelDeliveryOptions]
+        # @param pickup_instructions [String]
+        # @param delivery_instructions [String]
+        # @param handling_instructions [String]
+        # @param reference_numbers [Array<Hash>] reference numbers for the Bill of Lading
         def initialize(
           document_options: [],
           email_options: [],
@@ -47,11 +71,13 @@ module FriendlyShipping
           @delivery_instructions = delivery_instructions
           @handling_instructions = handling_instructions
           @reference_numbers = fill_codes(reference_numbers)
-          super(**kwargs)
+          super(**kwargs.reverse_merge(package_options_class: LabelPackageOptions))
         end
 
         private
 
+        # @param reference_numbers [Array<Hash>] reference numbers for the Bill of Lading
+        # @return [Array<Hash>] reference numbers with codes filled
         def fill_codes(reference_numbers)
           reference_numbers.each do |reference_number|
             reference_number[:code] = REFERENCE_NUMBER_CODES.fetch(reference_number[:code])

data/lib/friendly_shipping/services/ups_freight/label_structure_options.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module FriendlyShipping
+  module Services
+    class UpsFreight
+      class LabelStructureOptions < RatesStructureOptions
+        def initialize(**kwargs)
+          super(**kwargs.reverse_merge(package_options_class: LabelPackageOptions))
+        end
+      end
+    end
+  end
+end

data/lib/friendly_shipping/services/ups_freight/parse_freight_label_response.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require 'friendly_shipping/services/ups_freight/parse_shipment_document'
-require 'friendly_shipping/services/ups_freight/shipment_information'
-
 module FriendlyShipping
   module Services
     class UpsFreight
@@ -33,7 +30,7 @@ module FriendlyShipping
             images_data = Array.wrap(shipment_results.dig("Documents", "Image"))
 
             bol_id = shipment_results["BOLID"]
-            shipment_number = shipment_results["ShipmentNumber"]
+            pro_number = shipment_results["ShipmentNumber"]
             pickup_request_number = shipment_results["PickupRequestConfirmationNumber"]
 
             documents = images_data.map { |image_data| ParseShipmentDocument.call(image_data: image_data) }
@@ -44,7 +41,7 @@ module FriendlyShipping
               ShipmentInformation.new(
                 total: total_money,
                 bol_id: bol_id,
-                number: shipment_number,
+                pro_number: pro_number,
                 pickup_request_number: pickup_request_number,
                 shipping_method: shipping_method,
                 warnings: warnings,

data/lib/friendly_shipping/services/ups_freight/parse_freight_rate_response.rb

@@ -1,9 +1,5 @@
 # frozen_string_literal: true
 
-require 'friendly_shipping/rate'
-require 'friendly_shipping/api_result'
-require 'friendly_shipping/services/ups_freight/shipping_methods'
-
 module FriendlyShipping
   module Services
     class UpsFreight

data/lib/friendly_shipping/services/ups_freight/parse_shipment_document.rb

@@ -1,12 +1,10 @@
 # frozen_string_literal: true
 
-require 'friendly_shipping/services/ups_freight/shipment_document'
-
 module FriendlyShipping
   module Services
     class UpsFreight
       class ParseShipmentDocument
-        REVERSE_DOCUMENT_TYPES = LabelDocumentOptions::DOCUMENT_TYPES.map(&:reverse_each).map(&:to_a).to_h
+        REVERSE_DOCUMENT_TYPES = LabelDocumentOptions::DOCUMENT_TYPES.map(&:reverse_each).to_h(&:to_a)
 
         def self.call(image_data:)
           format_code = image_data.dig("Type", "Code")

data/lib/friendly_shipping/services/ups_freight/rates_item_options.rb

@@ -3,12 +3,9 @@
 module FriendlyShipping
   module Services
     class UpsFreight
-      # Options for Items in a UPS Freight shipment
-      #
-      # @attribute [Symbol] packaging How the item is packaged, one of the keys of `PACKAGING_TYPES`
-      # @attribute [String] freight_class The freight class of this item, for example '55' or '92.5'
-      # @attribute [String] nmfc_code The national motor freight corporation code for this item. Something like '13050 sub 4'
+      # Options for Items in a UPS Freight shipment.
       class RatesItemOptions < FriendlyShipping::ItemOptions
+        # Maps friendly names to packaging types.
         PACKAGING_TYPES = {
           bag: { code: "BAG", description: "Bag" },
           bale: { code: "BAL", description: "Bale" },
@@ -49,11 +46,23 @@ module FriendlyShipping
           wrapped: { code: "WRP", description: "Wrapped" }
         }.freeze
 
-        attr_reader :packaging_code,
-                    :packaging_description,
-                    :freight_class,
-                    :nmfc_code
+        # @return [String]
+        attr_reader :packaging_code
 
+        # @return [String]
+        attr_reader :packaging_description
+
+        # @return [String]
+        attr_reader :freight_class
+
+        # @return [String]
+        attr_reader :nmfc_code
+
+        # @param packaging [Symbol] how the item is packaged (see {PACKAGING_TYPES})
+        # @param freight_class [String] the freight class of this item, for example '55' or '92.5'
+        # @param nmfc_code [String] the national motor freight corporation code for this item, for example '13050 sub 4'
+        # @param kwargs [Hash]
+        # @options kwargs [String] :item_id the ID for the item that belongs to these options
         def initialize(
           packaging: :carton,
           freight_class: nil,

data/lib/friendly_shipping/services/ups_freight/rates_options.rb

@@ -1,39 +1,45 @@
 # frozen_string_literal: true
 
-require 'friendly_shipping/services/ups_freight/rates_package_options'
-require 'friendly_shipping/services/ups_freight/generate_commodity_information'
-
 module FriendlyShipping
   module Services
     class UpsFreight
       # Options for generating UPS Freight rates for a shipment
-      #
-      # @attribute [Physical::Location] billing_address The billing address
-      # @attribute [String] shipper_number The shipper number associated with the shipper
-      # @attribute [String] customer_context A reference to match this request with an order or shipment
-      # @attribute [FriendlyShipping::ShippingMethod] shipping_method The shipping method to use
-      # @attribute [Callable] commodity_information_generator A callable that takes a shipment
-      #     and an options object to create an Array of commodity fields as per the UPS docs.
-      # @attribute [Symbol] billing One of the keys in the `BILLING_CODES` constant. How the shipment
-      #     would be billed.
-      # @attribute [Date] pickup_date Date of the Pickup
-      # @attribute [String] pickup_comments Additional pickup instructions
-      # @attribute [RatesPackageOptions] package_options Options for each of the packages/pallets in this shipment
-      class RatesOptions < FriendlyShipping::ShipmentOptions
+      class RatesOptions < ShipmentOptions
         BILLING_CODES = {
           prepaid: '10',
           third_party: '30',
           freight_collect: '40'
         }.freeze
 
-        attr_reader :shipper_number,
-                    :billing_address,
-                    :billing_code,
-                    :customer_context,
-                    :shipping_method,
-                    :pickup_request_options,
-                    :commodity_information_generator
+        # @return [String]
+        attr_reader :shipper_number
+
+        # @return [Physical::Location]
+        attr_reader :billing_address
+
+        # @return [Symbol]
+        attr_reader :billing_code
+
+        # @return [String]
+        attr_reader :customer_context
+
+        # @return [FriendlyShipping::ShippingMethod]
+        attr_reader :shipping_method
+
+        # @return [PickupRequestOptions]
+        attr_reader :pickup_request_options
+
+        # @return [Callable]
+        attr_reader :commodity_information_generator
 
+        # @param shipper_number [String] the shipper number associated with the shipper
+        # @param billing_address [Physical::Location] the billing address
+        # @param shipping_method [FriendlyShipping::ShippingMethod] the shipping method to use
+        # @param billing [Symbol] how the shipment is billed (see {BILLING_CODES})
+        # @param customer_context [String] a reference to match this request with an order or shipment
+        # @param pickup_request_options [PickupRequestOptions] options for the pickup request
+        # @param commodity_information_generator [Callable] a callable that takes a shipment
+        #     and an options object to create an Array of commodity fields as per the UPS docs
         def initialize(
           shipper_number:,
           billing_address:,
@@ -51,7 +57,7 @@ module FriendlyShipping
           @customer_context = customer_context
           @pickup_request_options = pickup_request_options
           @commodity_information_generator = commodity_information_generator
-          super(**kwargs.merge(package_options_class: RatesPackageOptions))
+          super(**kwargs.reverse_merge(package_options_class: RatesPackageOptions))
         end
       end
     end

data/lib/friendly_shipping/services/ups_freight/rates_package_options.rb

@@ -1,15 +1,52 @@
 # frozen_string_literal: true
 
-require 'friendly_shipping/services/ups_freight/rates_item_options'
-
 module FriendlyShipping
   module Services
     class UpsFreight
-      # Options for packages/pallets within a UPS Freight shipment
-      #
-      # @attribute [Symbol] handling _unit How this shipment is divided. Any of the keys in `HANDLING_UNIT_TYPES`
-      # @attribute [RatesItemOptions] item_options Options for each of the items on the pallet/in the carboy/etc.
+      # Options for packages/pallets within a UPS Freight shipment.
       class RatesPackageOptions < FriendlyShipping::PackageOptions
+        # Maps friendly names to packaging types.
+        PACKAGING_TYPES = {
+          bag: { code: "BAG", description: "Bag" },
+          bale: { code: "BAL", description: "Bale" },
+          barrel: { code: "BAR", description: "Barrel" },
+          bundle: { code: "BDL", description: "Bundle" },
+          bin: { code: "BIN", description: "Bin" },
+          box: { code: "BOX", description: "Box" },
+          basket: { code: "BSK", description: "Basket" },
+          bunch: { code: "BUN", description: "Bunch" },
+          cabinet: { code: "CAB", description: "Cabinet" },
+          can: { code: "CAN", description: "Can" },
+          carrier: { code: "CAR", description: "Carrier" },
+          case: { code: "CAS", description: "Case" },
+          carboy: { code: "CBY", description: "Carboy" },
+          container: { code: "CON", description: "Container" },
+          crate: { code: "CRT", description: "Crate" },
+          cask: { code: "CSK", description: "Cask" },
+          carton: { code: "CTN", description: "Carton" },
+          cylinder: { code: "CYL", description: "Cylinder" },
+          drum: { code: "DRM", description: "Drum" },
+          loose: { code: "LOO", description: "Loose" },
+          other: { code: "OTH", description: "Other" },
+          pail: { code: "PAL", description: "Pail" },
+          pieces: { code: "PCS", description: "Pieces" },
+          package: { code: "PKG", description: "Package" },
+          pipe_line: { code: "PLN", description: "Pipe Line" },
+          pallet: { code: "PLT", description: "Pallet" },
+          rack: { code: "RCK", description: "Rack" },
+          reel: { code: "REL", description: "Reel" },
+          roll: { code: "ROL", description: "Roll" },
+          skid: { code: "SKD", description: "Skid" },
+          spool: { code: "SPL", description: "Spool" },
+          tube: { code: "TBE", description: "Tube" },
+          tank: { code: "TNK", description: "Tank" },
+          totes: { code: "TOT", description: "Totes" },
+          unit: { code: "UNT", description: "Unit" },
+          van_pack: { code: "VPK", description: "Van Pack" },
+          wrapped: { code: "WRP", description: "Wrapped" }
+        }.freeze
+
+        # Maps friendly names to handling unit types.
         HANDLING_UNIT_TYPES = {
           pallet: { code: "PLT", description: "Pallet", handling_unit_tag: 'One' },
           skid: { code: "SKD", description: "Skid", handling_unit_tag: 'One' },
@@ -19,18 +56,50 @@ module FriendlyShipping
           loose: { code: "LOO", description: "Loose", handling_unit_tag: 'Two' }
         }.freeze
 
-        attr_reader :handling_unit_description,
-                    :handling_unit_tag,
-                    :handling_unit_code
+        # @return [String]
+        attr_reader :packaging_code
+
+        # @return [String]
+        attr_reader :packaging_description
+
+        # @return [String]
+        attr_reader :freight_class
+
+        # @return [String]
+        attr_reader :nmfc_code
+
+        # @return [String]
+        attr_reader :handling_unit_description
+
+        # @return [String]
+        attr_reader :handling_unit_tag
+
+        # @return [String]
+        attr_reader :handling_unit_code
 
+        # @param packaging [Symbol] how this shipment is packaged (see {PACKAGING_TYPES})
+        # @param freight_class [String] the freight class
+        # @param nmfc_code [String] the NMFC code
+        # @param handling_unit [Symbol] how this shipment is divided (see {HANDLING_UNIT_TYPES})
+        # @param kwargs [Hash]
+        # @option kwargs [String] :package_id the ID for the package  that belongs to these options
+        # @option kwargs [Array<ItemOptions>] :item_options the options for items in this package
+        # @option kwargs [Class] :item_options_class the class to use for item options when none are provided
         def initialize(
+          packaging: :carton,
+          freight_class: nil,
+          nmfc_code: nil,
           handling_unit: :pallet,
           **kwargs
         )
+          @packaging_code = PACKAGING_TYPES.fetch(packaging).fetch(:code)
+          @packaging_description = PACKAGING_TYPES.fetch(packaging).fetch(:description)
+          @freight_class = freight_class
+          @nmfc_code = nmfc_code
           @handling_unit_code = HANDLING_UNIT_TYPES.fetch(handling_unit).fetch(:code)
           @handling_unit_description = HANDLING_UNIT_TYPES.fetch(handling_unit).fetch(:description)
           @handling_unit_tag = "HandlingUnit#{HANDLING_UNIT_TYPES.fetch(handling_unit).fetch(:handling_unit_tag)}"
-          super(**kwargs.merge(item_options_class: RatesItemOptions))
+          super(**kwargs.reverse_merge(item_options_class: RatesItemOptions))
         end
       end
     end

data/lib/friendly_shipping/services/ups_freight/rates_structure_options.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module FriendlyShipping
+  module Services
+    class UpsFreight
+      # Options for structures/pallets within a UPS Freight shipment.
+      class RatesStructureOptions < FriendlyShipping::StructureOptions
+        # Maps friendly names to handling unit types.
+        HANDLING_UNIT_TYPES = {
+          pallet: { code: "PLT", description: "Pallet", handling_unit_tag: 'One' },
+          skid: { code: "SKD", description: "Skid", handling_unit_tag: 'One' },
+          carboy: { code: "CBY", description: "Carboy", handling_unit_tag: 'One' },
+          totes: { code: "TOT", description: "Totes", handling_unit_tag: 'One' },
+          other: { code: "OTH", description: "Other", handling_unit_tag: 'Two' },
+          loose: { code: "LOO", description: "Loose", handling_unit_tag: 'Two' }
+        }.freeze
+
+        # @return [String]
+        attr_reader :handling_unit_description
+
+        # @return [String]
+        attr_reader :handling_unit_tag
+
+        # @return [String]
+        attr_reader :handling_unit_code
+
+        # @param handling_unit [Symbol] how this shipment is divided (see {HANDLING_UNIT_TYPES})
+        # @param kwargs [Hash]
+        # @options kwargs [Object] :structure_id unique identifier for this set of options
+        # @options kwargs [Array<PackageOptions>] :package_options the options for packages in this structure
+        # @options kwargs [Class] :package_options_class the class to use for package options when none are provided
+        def initialize(
+          handling_unit: :pallet,
+          **kwargs
+        )
+          @handling_unit_code = HANDLING_UNIT_TYPES.fetch(handling_unit).fetch(:code)
+          @handling_unit_description = HANDLING_UNIT_TYPES.fetch(handling_unit).fetch(:description)
+          @handling_unit_tag = "HandlingUnit#{HANDLING_UNIT_TYPES.fetch(handling_unit).fetch(:handling_unit_tag)}"
+          super(**kwargs.reverse_merge(package_options_class: RatesPackageOptions))
+        end
+      end
+    end
+  end
+end