Class: ActiveShipping::RateEstimate
- Inherits:
-
Object
- Object
- ActiveShipping::RateEstimate
- Defined in:
- lib/active_shipping/rate_estimate.rb
Overview
Class representing a shipping option with estimated price.
Direct Known Subclasses
Instance Attribute Summary collapse
-
#carrier ⇒ String
The name of the carrier (i.e. , e.g. 'USPS', 'FedEx').
-
#compare_price ⇒ Integer
The comparable price in cents.
-
#currency ⇒ String
ISO4217 currency code of the quoted rate estimates, e.g.
-
#delivery_date ⇒ Date
The date on which the shipment will be delivered.
-
#delivery_range ⇒ Array<Date>
The minimum and maximum date of when the shipment is expected to be delivered.
-
#desination ⇒ ActiveShipping::Location
The desination of the shipment.
-
#destination ⇒ Object
Returns the value of attribute destination.
-
#estimate_reference ⇒ Object
Returns the value of attribute estimate_reference.
-
#expires_at ⇒ Object
Returns the value of attribute expires_at.
-
#insurance_price ⇒ Integer
The price of insurance in cents.
-
#negotiated_rate ⇒ Integer
The negotiated rate in cents.
-
#origin ⇒ ActiveShipping::Location
The origin of the shipment.
-
#package_rates ⇒ Array<{:rate => Integer, :package => ActiveShipping::Package}>
A list of rates for all the packages in the shipment.
-
#phone_required ⇒ Boolean
Specifies if a phone number is required for the shipping rate.
-
#pickup_time ⇒ Object
Returns the value of attribute pickup_time.
-
#service_code ⇒ String
The code of the shipping service.
-
#service_name ⇒ String
The name of the shipping service (e.g.
"First Class Ground"
). -
#shipping_date ⇒ Date
The date on which the shipment will be expected.
Instance Method Summary collapse
-
#add(package, rate = nil) ⇒ self
Adds a package to this rate estimate.
-
#initialize(origin, destination, carrier, service_name, options = {}) ⇒ RateEstimate
constructor
A new instance of RateEstimate.
-
#package_count ⇒ Integer
The number of packages for which rate estimates are given.
-
#packages ⇒ Array<ActiveShipping::Package>
The list of packages for which rate estimates are given.
-
#total_price ⇒ Integer
(also: #price)
The total price of the shipments in cents.
- #total_price=(total_price) ⇒ Object protected
Constructor Details
#initialize(origin, destination, carrier, service_name, options = {}) ⇒ RateEstimate
Returns a new instance of RateEstimate.
73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 |
# File 'lib/active_shipping/rate_estimate.rb', line 73 def initialize(origin, destination, carrier, service_name, = {}) self.origin, self.destination, self.carrier, self.service_name = origin, destination, carrier, service_name self.service_code = [:service_code] self.estimate_reference = [:estimate_reference] self.pickup_time = [:pickup_time] self.expires_at = [:expires_at] if [:package_rates] self.package_rates = [:package_rates].map { |p| p.update(:rate => Package.cents_from(p[:rate])) } else self.package_rates = Array([:packages]).map { |p| {:package => p} } end self.total_price = [:total_price] self.negotiated_rate = [:negotiated_rate] self.compare_price = [:compare_price] self.phone_required = [:phone_required] self.currency = [:currency] self.delivery_range = [:delivery_range] self.shipping_date = [:shipping_date] self.delivery_date = @delivery_range.last self.insurance_price = [:insurance_price] end |
Instance Attribute Details
#carrier ⇒ String
The name of the carrier (i.e. , e.g. 'USPS', 'FedEx')
65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 |
# File 'lib/active_shipping/rate_estimate.rb', line 65 class RateEstimate attr_accessor :origin, :destination, :package_rates, :carrier, :service_name, :service_code, :shipping_date, :delivery_date, :delivery_range, :currency, :negotiated_rate, :insurance_price, :estimate_reference, :expires_at, :pickup_time, :compare_price, :phone_required def initialize(origin, destination, carrier, service_name, = {}) self.origin, self.destination, self.carrier, self.service_name = origin, destination, carrier, service_name self.service_code = [:service_code] self.estimate_reference = [:estimate_reference] self.pickup_time = [:pickup_time] self.expires_at = [:expires_at] if [:package_rates] self.package_rates = [:package_rates].map { |p| p.update(:rate => Package.cents_from(p[:rate])) } else self.package_rates = Array([:packages]).map { |p| {:package => p} } end self.total_price = [:total_price] self.negotiated_rate = [:negotiated_rate] self.compare_price = [:compare_price] self.phone_required = [:phone_required] self.currency = [:currency] self.delivery_range = [:delivery_range] self.shipping_date = [:shipping_date] self.delivery_date = @delivery_range.last self.insurance_price = [:insurance_price] end # The total price of the shipments in cents. # @return [Integer] def total_price @total_price || @package_rates.sum { |pr| pr[:rate] } rescue NoMethodError raise ArgumentError.new("RateEstimate must have a total_price set, or have a full set of valid package rates.") end alias_method :price, :total_price # Adds a package to this rate estimate # @param package [ActiveShipping::Package] The package to add. # @param rate [#cents, Float, String, nil] The rate for this package. This is only required if # there is no total price for this shipment # @return [self] def add(package, rate = nil) cents = Package.cents_from(rate) raise ArgumentError.new("New packages must have valid rate information since this RateEstimate has no total_price set.") if cents.nil? and total_price.nil? @package_rates << {:package => package, :rate => cents} self end # The list of packages for which rate estimates are given. # @return [Array<ActiveShipping::Package>] def packages package_rates.map { |p| p[:package] } end # The number of packages for which rate estimates are given. # @return [Integer] def package_count package_rates.length end protected def delivery_range=(delivery_range) @delivery_range = delivery_range ? delivery_range.map { |date| date_for(date) }.compact : [] end def total_price=(total_price) @total_price = Package.cents_from(total_price) end def negotiated_rate=(negotiated_rate) @negotiated_rate = negotiated_rate ? Package.cents_from(negotiated_rate) : nil end def compare_price=(compare_price) @compare_price = compare_price ? Package.cents_from(compare_price) : nil end def currency=(currency) @currency = ActiveUtils::CurrencyCode.standardize(currency) end def phone_required=(phone_required) @phone_required = !!phone_required end def shipping_date=(shipping_date) @shipping_date = date_for(shipping_date) end def insurance_price=(insurance_price) @insurance_price = Package.cents_from(insurance_price) end private # Returns a Date object for a given input # @param [String, Date, Time, DateTime, ...] The object to infer a date from. # @return [Date, nil] The Date object absed on the input, or `nil` if no date # could be determined. def date_for(date) date && DateTime.strptime(date.to_s, "%Y-%m-%d") rescue ArgumentError nil end end |
#compare_price ⇒ Integer
The comparable price in cents
65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 |
# File 'lib/active_shipping/rate_estimate.rb', line 65 class RateEstimate attr_accessor :origin, :destination, :package_rates, :carrier, :service_name, :service_code, :shipping_date, :delivery_date, :delivery_range, :currency, :negotiated_rate, :insurance_price, :estimate_reference, :expires_at, :pickup_time, :compare_price, :phone_required def initialize(origin, destination, carrier, service_name, = {}) self.origin, self.destination, self.carrier, self.service_name = origin, destination, carrier, service_name self.service_code = [:service_code] self.estimate_reference = [:estimate_reference] self.pickup_time = [:pickup_time] self.expires_at = [:expires_at] if [:package_rates] self.package_rates = [:package_rates].map { |p| p.update(:rate => Package.cents_from(p[:rate])) } else self.package_rates = Array([:packages]).map { |p| {:package => p} } end self.total_price = [:total_price] self.negotiated_rate = [:negotiated_rate] self.compare_price = [:compare_price] self.phone_required = [:phone_required] self.currency = [:currency] self.delivery_range = [:delivery_range] self.shipping_date = [:shipping_date] self.delivery_date = @delivery_range.last self.insurance_price = [:insurance_price] end # The total price of the shipments in cents. # @return [Integer] def total_price @total_price || @package_rates.sum { |pr| pr[:rate] } rescue NoMethodError raise ArgumentError.new("RateEstimate must have a total_price set, or have a full set of valid package rates.") end alias_method :price, :total_price # Adds a package to this rate estimate # @param package [ActiveShipping::Package] The package to add. # @param rate [#cents, Float, String, nil] The rate for this package. This is only required if # there is no total price for this shipment # @return [self] def add(package, rate = nil) cents = Package.cents_from(rate) raise ArgumentError.new("New packages must have valid rate information since this RateEstimate has no total_price set.") if cents.nil? and total_price.nil? @package_rates << {:package => package, :rate => cents} self end # The list of packages for which rate estimates are given. # @return [Array<ActiveShipping::Package>] def packages package_rates.map { |p| p[:package] } end # The number of packages for which rate estimates are given. # @return [Integer] def package_count package_rates.length end protected def delivery_range=(delivery_range) @delivery_range = delivery_range ? delivery_range.map { |date| date_for(date) }.compact : [] end def total_price=(total_price) @total_price = Package.cents_from(total_price) end def negotiated_rate=(negotiated_rate) @negotiated_rate = negotiated_rate ? Package.cents_from(negotiated_rate) : nil end def compare_price=(compare_price) @compare_price = compare_price ? Package.cents_from(compare_price) : nil end def currency=(currency) @currency = ActiveUtils::CurrencyCode.standardize(currency) end def phone_required=(phone_required) @phone_required = !!phone_required end def shipping_date=(shipping_date) @shipping_date = date_for(shipping_date) end def insurance_price=(insurance_price) @insurance_price = Package.cents_from(insurance_price) end private # Returns a Date object for a given input # @param [String, Date, Time, DateTime, ...] The object to infer a date from. # @return [Date, nil] The Date object absed on the input, or `nil` if no date # could be determined. def date_for(date) date && DateTime.strptime(date.to_s, "%Y-%m-%d") rescue ArgumentError nil end end |
#currency ⇒ String
ISO4217 currency code of the quoted rate estimates, e.g. CAD
, EUR
, or USD
.
65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 |
# File 'lib/active_shipping/rate_estimate.rb', line 65 class RateEstimate attr_accessor :origin, :destination, :package_rates, :carrier, :service_name, :service_code, :shipping_date, :delivery_date, :delivery_range, :currency, :negotiated_rate, :insurance_price, :estimate_reference, :expires_at, :pickup_time, :compare_price, :phone_required def initialize(origin, destination, carrier, service_name, = {}) self.origin, self.destination, self.carrier, self.service_name = origin, destination, carrier, service_name self.service_code = [:service_code] self.estimate_reference = [:estimate_reference] self.pickup_time = [:pickup_time] self.expires_at = [:expires_at] if [:package_rates] self.package_rates = [:package_rates].map { |p| p.update(:rate => Package.cents_from(p[:rate])) } else self.package_rates = Array([:packages]).map { |p| {:package => p} } end self.total_price = [:total_price] self.negotiated_rate = [:negotiated_rate] self.compare_price = [:compare_price] self.phone_required = [:phone_required] self.currency = [:currency] self.delivery_range = [:delivery_range] self.shipping_date = [:shipping_date] self.delivery_date = @delivery_range.last self.insurance_price = [:insurance_price] end # The total price of the shipments in cents. # @return [Integer] def total_price @total_price || @package_rates.sum { |pr| pr[:rate] } rescue NoMethodError raise ArgumentError.new("RateEstimate must have a total_price set, or have a full set of valid package rates.") end alias_method :price, :total_price # Adds a package to this rate estimate # @param package [ActiveShipping::Package] The package to add. # @param rate [#cents, Float, String, nil] The rate for this package. This is only required if # there is no total price for this shipment # @return [self] def add(package, rate = nil) cents = Package.cents_from(rate) raise ArgumentError.new("New packages must have valid rate information since this RateEstimate has no total_price set.") if cents.nil? and total_price.nil? @package_rates << {:package => package, :rate => cents} self end # The list of packages for which rate estimates are given. # @return [Array<ActiveShipping::Package>] def packages package_rates.map { |p| p[:package] } end # The number of packages for which rate estimates are given. # @return [Integer] def package_count package_rates.length end protected def delivery_range=(delivery_range) @delivery_range = delivery_range ? delivery_range.map { |date| date_for(date) }.compact : [] end def total_price=(total_price) @total_price = Package.cents_from(total_price) end def negotiated_rate=(negotiated_rate) @negotiated_rate = negotiated_rate ? Package.cents_from(negotiated_rate) : nil end def compare_price=(compare_price) @compare_price = compare_price ? Package.cents_from(compare_price) : nil end def currency=(currency) @currency = ActiveUtils::CurrencyCode.standardize(currency) end def phone_required=(phone_required) @phone_required = !!phone_required end def shipping_date=(shipping_date) @shipping_date = date_for(shipping_date) end def insurance_price=(insurance_price) @insurance_price = Package.cents_from(insurance_price) end private # Returns a Date object for a given input # @param [String, Date, Time, DateTime, ...] The object to infer a date from. # @return [Date, nil] The Date object absed on the input, or `nil` if no date # could be determined. def date_for(date) date && DateTime.strptime(date.to_s, "%Y-%m-%d") rescue ArgumentError nil end end |
#delivery_date ⇒ Date
The date on which the shipment will be delivered. This is usually only availablee for express shipments; in order cases a #delivery_range is given instead.
65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 |
# File 'lib/active_shipping/rate_estimate.rb', line 65 class RateEstimate attr_accessor :origin, :destination, :package_rates, :carrier, :service_name, :service_code, :shipping_date, :delivery_date, :delivery_range, :currency, :negotiated_rate, :insurance_price, :estimate_reference, :expires_at, :pickup_time, :compare_price, :phone_required def initialize(origin, destination, carrier, service_name, = {}) self.origin, self.destination, self.carrier, self.service_name = origin, destination, carrier, service_name self.service_code = [:service_code] self.estimate_reference = [:estimate_reference] self.pickup_time = [:pickup_time] self.expires_at = [:expires_at] if [:package_rates] self.package_rates = [:package_rates].map { |p| p.update(:rate => Package.cents_from(p[:rate])) } else self.package_rates = Array([:packages]).map { |p| {:package => p} } end self.total_price = [:total_price] self.negotiated_rate = [:negotiated_rate] self.compare_price = [:compare_price] self.phone_required = [:phone_required] self.currency = [:currency] self.delivery_range = [:delivery_range] self.shipping_date = [:shipping_date] self.delivery_date = @delivery_range.last self.insurance_price = [:insurance_price] end # The total price of the shipments in cents. # @return [Integer] def total_price @total_price || @package_rates.sum { |pr| pr[:rate] } rescue NoMethodError raise ArgumentError.new("RateEstimate must have a total_price set, or have a full set of valid package rates.") end alias_method :price, :total_price # Adds a package to this rate estimate # @param package [ActiveShipping::Package] The package to add. # @param rate [#cents, Float, String, nil] The rate for this package. This is only required if # there is no total price for this shipment # @return [self] def add(package, rate = nil) cents = Package.cents_from(rate) raise ArgumentError.new("New packages must have valid rate information since this RateEstimate has no total_price set.") if cents.nil? and total_price.nil? @package_rates << {:package => package, :rate => cents} self end # The list of packages for which rate estimates are given. # @return [Array<ActiveShipping::Package>] def packages package_rates.map { |p| p[:package] } end # The number of packages for which rate estimates are given. # @return [Integer] def package_count package_rates.length end protected def delivery_range=(delivery_range) @delivery_range = delivery_range ? delivery_range.map { |date| date_for(date) }.compact : [] end def total_price=(total_price) @total_price = Package.cents_from(total_price) end def negotiated_rate=(negotiated_rate) @negotiated_rate = negotiated_rate ? Package.cents_from(negotiated_rate) : nil end def compare_price=(compare_price) @compare_price = compare_price ? Package.cents_from(compare_price) : nil end def currency=(currency) @currency = ActiveUtils::CurrencyCode.standardize(currency) end def phone_required=(phone_required) @phone_required = !!phone_required end def shipping_date=(shipping_date) @shipping_date = date_for(shipping_date) end def insurance_price=(insurance_price) @insurance_price = Package.cents_from(insurance_price) end private # Returns a Date object for a given input # @param [String, Date, Time, DateTime, ...] The object to infer a date from. # @return [Date, nil] The Date object absed on the input, or `nil` if no date # could be determined. def date_for(date) date && DateTime.strptime(date.to_s, "%Y-%m-%d") rescue ArgumentError nil end end |
#delivery_range ⇒ Array<Date>
The minimum and maximum date of when the shipment is expected to be delivered.
65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 |
# File 'lib/active_shipping/rate_estimate.rb', line 65 class RateEstimate attr_accessor :origin, :destination, :package_rates, :carrier, :service_name, :service_code, :shipping_date, :delivery_date, :delivery_range, :currency, :negotiated_rate, :insurance_price, :estimate_reference, :expires_at, :pickup_time, :compare_price, :phone_required def initialize(origin, destination, carrier, service_name, = {}) self.origin, self.destination, self.carrier, self.service_name = origin, destination, carrier, service_name self.service_code = [:service_code] self.estimate_reference = [:estimate_reference] self.pickup_time = [:pickup_time] self.expires_at = [:expires_at] if [:package_rates] self.package_rates = [:package_rates].map { |p| p.update(:rate => Package.cents_from(p[:rate])) } else self.package_rates = Array([:packages]).map { |p| {:package => p} } end self.total_price = [:total_price] self.negotiated_rate = [:negotiated_rate] self.compare_price = [:compare_price] self.phone_required = [:phone_required] self.currency = [:currency] self.delivery_range = [:delivery_range] self.shipping_date = [:shipping_date] self.delivery_date = @delivery_range.last self.insurance_price = [:insurance_price] end # The total price of the shipments in cents. # @return [Integer] def total_price @total_price || @package_rates.sum { |pr| pr[:rate] } rescue NoMethodError raise ArgumentError.new("RateEstimate must have a total_price set, or have a full set of valid package rates.") end alias_method :price, :total_price # Adds a package to this rate estimate # @param package [ActiveShipping::Package] The package to add. # @param rate [#cents, Float, String, nil] The rate for this package. This is only required if # there is no total price for this shipment # @return [self] def add(package, rate = nil) cents = Package.cents_from(rate) raise ArgumentError.new("New packages must have valid rate information since this RateEstimate has no total_price set.") if cents.nil? and total_price.nil? @package_rates << {:package => package, :rate => cents} self end # The list of packages for which rate estimates are given. # @return [Array<ActiveShipping::Package>] def packages package_rates.map { |p| p[:package] } end # The number of packages for which rate estimates are given. # @return [Integer] def package_count package_rates.length end protected def delivery_range=(delivery_range) @delivery_range = delivery_range ? delivery_range.map { |date| date_for(date) }.compact : [] end def total_price=(total_price) @total_price = Package.cents_from(total_price) end def negotiated_rate=(negotiated_rate) @negotiated_rate = negotiated_rate ? Package.cents_from(negotiated_rate) : nil end def compare_price=(compare_price) @compare_price = compare_price ? Package.cents_from(compare_price) : nil end def currency=(currency) @currency = ActiveUtils::CurrencyCode.standardize(currency) end def phone_required=(phone_required) @phone_required = !!phone_required end def shipping_date=(shipping_date) @shipping_date = date_for(shipping_date) end def insurance_price=(insurance_price) @insurance_price = Package.cents_from(insurance_price) end private # Returns a Date object for a given input # @param [String, Date, Time, DateTime, ...] The object to infer a date from. # @return [Date, nil] The Date object absed on the input, or `nil` if no date # could be determined. def date_for(date) date && DateTime.strptime(date.to_s, "%Y-%m-%d") rescue ArgumentError nil end end |
#desination ⇒ ActiveShipping::Location
The desination of the shipment
65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 |
# File 'lib/active_shipping/rate_estimate.rb', line 65 class RateEstimate attr_accessor :origin, :destination, :package_rates, :carrier, :service_name, :service_code, :shipping_date, :delivery_date, :delivery_range, :currency, :negotiated_rate, :insurance_price, :estimate_reference, :expires_at, :pickup_time, :compare_price, :phone_required def initialize(origin, destination, carrier, service_name, = {}) self.origin, self.destination, self.carrier, self.service_name = origin, destination, carrier, service_name self.service_code = [:service_code] self.estimate_reference = [:estimate_reference] self.pickup_time = [:pickup_time] self.expires_at = [:expires_at] if [:package_rates] self.package_rates = [:package_rates].map { |p| p.update(:rate => Package.cents_from(p[:rate])) } else self.package_rates = Array([:packages]).map { |p| {:package => p} } end self.total_price = [:total_price] self.negotiated_rate = [:negotiated_rate] self.compare_price = [:compare_price] self.phone_required = [:phone_required] self.currency = [:currency] self.delivery_range = [:delivery_range] self.shipping_date = [:shipping_date] self.delivery_date = @delivery_range.last self.insurance_price = [:insurance_price] end # The total price of the shipments in cents. # @return [Integer] def total_price @total_price || @package_rates.sum { |pr| pr[:rate] } rescue NoMethodError raise ArgumentError.new("RateEstimate must have a total_price set, or have a full set of valid package rates.") end alias_method :price, :total_price # Adds a package to this rate estimate # @param package [ActiveShipping::Package] The package to add. # @param rate [#cents, Float, String, nil] The rate for this package. This is only required if # there is no total price for this shipment # @return [self] def add(package, rate = nil) cents = Package.cents_from(rate) raise ArgumentError.new("New packages must have valid rate information since this RateEstimate has no total_price set.") if cents.nil? and total_price.nil? @package_rates << {:package => package, :rate => cents} self end # The list of packages for which rate estimates are given. # @return [Array<ActiveShipping::Package>] def packages package_rates.map { |p| p[:package] } end # The number of packages for which rate estimates are given. # @return [Integer] def package_count package_rates.length end protected def delivery_range=(delivery_range) @delivery_range = delivery_range ? delivery_range.map { |date| date_for(date) }.compact : [] end def total_price=(total_price) @total_price = Package.cents_from(total_price) end def negotiated_rate=(negotiated_rate) @negotiated_rate = negotiated_rate ? Package.cents_from(negotiated_rate) : nil end def compare_price=(compare_price) @compare_price = compare_price ? Package.cents_from(compare_price) : nil end def currency=(currency) @currency = ActiveUtils::CurrencyCode.standardize(currency) end def phone_required=(phone_required) @phone_required = !!phone_required end def shipping_date=(shipping_date) @shipping_date = date_for(shipping_date) end def insurance_price=(insurance_price) @insurance_price = Package.cents_from(insurance_price) end private # Returns a Date object for a given input # @param [String, Date, Time, DateTime, ...] The object to infer a date from. # @return [Date, nil] The Date object absed on the input, or `nil` if no date # could be determined. def date_for(date) date && DateTime.strptime(date.to_s, "%Y-%m-%d") rescue ArgumentError nil end end |
#destination ⇒ Object
Returns the value of attribute destination.
66 67 68 |
# File 'lib/active_shipping/rate_estimate.rb', line 66 def destination @destination end |
#estimate_reference ⇒ Object
Returns the value of attribute estimate_reference.
66 67 68 |
# File 'lib/active_shipping/rate_estimate.rb', line 66 def estimate_reference @estimate_reference end |
#expires_at ⇒ Object
Returns the value of attribute expires_at.
66 67 68 |
# File 'lib/active_shipping/rate_estimate.rb', line 66 def expires_at @expires_at end |
#insurance_price ⇒ Integer
The price of insurance in cents.
65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 |
# File 'lib/active_shipping/rate_estimate.rb', line 65 class RateEstimate attr_accessor :origin, :destination, :package_rates, :carrier, :service_name, :service_code, :shipping_date, :delivery_date, :delivery_range, :currency, :negotiated_rate, :insurance_price, :estimate_reference, :expires_at, :pickup_time, :compare_price, :phone_required def initialize(origin, destination, carrier, service_name, = {}) self.origin, self.destination, self.carrier, self.service_name = origin, destination, carrier, service_name self.service_code = [:service_code] self.estimate_reference = [:estimate_reference] self.pickup_time = [:pickup_time] self.expires_at = [:expires_at] if [:package_rates] self.package_rates = [:package_rates].map { |p| p.update(:rate => Package.cents_from(p[:rate])) } else self.package_rates = Array([:packages]).map { |p| {:package => p} } end self.total_price = [:total_price] self.negotiated_rate = [:negotiated_rate] self.compare_price = [:compare_price] self.phone_required = [:phone_required] self.currency = [:currency] self.delivery_range = [:delivery_range] self.shipping_date = [:shipping_date] self.delivery_date = @delivery_range.last self.insurance_price = [:insurance_price] end # The total price of the shipments in cents. # @return [Integer] def total_price @total_price || @package_rates.sum { |pr| pr[:rate] } rescue NoMethodError raise ArgumentError.new("RateEstimate must have a total_price set, or have a full set of valid package rates.") end alias_method :price, :total_price # Adds a package to this rate estimate # @param package [ActiveShipping::Package] The package to add. # @param rate [#cents, Float, String, nil] The rate for this package. This is only required if # there is no total price for this shipment # @return [self] def add(package, rate = nil) cents = Package.cents_from(rate) raise ArgumentError.new("New packages must have valid rate information since this RateEstimate has no total_price set.") if cents.nil? and total_price.nil? @package_rates << {:package => package, :rate => cents} self end # The list of packages for which rate estimates are given. # @return [Array<ActiveShipping::Package>] def packages package_rates.map { |p| p[:package] } end # The number of packages for which rate estimates are given. # @return [Integer] def package_count package_rates.length end protected def delivery_range=(delivery_range) @delivery_range = delivery_range ? delivery_range.map { |date| date_for(date) }.compact : [] end def total_price=(total_price) @total_price = Package.cents_from(total_price) end def negotiated_rate=(negotiated_rate) @negotiated_rate = negotiated_rate ? Package.cents_from(negotiated_rate) : nil end def compare_price=(compare_price) @compare_price = compare_price ? Package.cents_from(compare_price) : nil end def currency=(currency) @currency = ActiveUtils::CurrencyCode.standardize(currency) end def phone_required=(phone_required) @phone_required = !!phone_required end def shipping_date=(shipping_date) @shipping_date = date_for(shipping_date) end def insurance_price=(insurance_price) @insurance_price = Package.cents_from(insurance_price) end private # Returns a Date object for a given input # @param [String, Date, Time, DateTime, ...] The object to infer a date from. # @return [Date, nil] The Date object absed on the input, or `nil` if no date # could be determined. def date_for(date) date && DateTime.strptime(date.to_s, "%Y-%m-%d") rescue ArgumentError nil end end |
#negotiated_rate ⇒ Integer
The negotiated rate in cents
65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 |
# File 'lib/active_shipping/rate_estimate.rb', line 65 class RateEstimate attr_accessor :origin, :destination, :package_rates, :carrier, :service_name, :service_code, :shipping_date, :delivery_date, :delivery_range, :currency, :negotiated_rate, :insurance_price, :estimate_reference, :expires_at, :pickup_time, :compare_price, :phone_required def initialize(origin, destination, carrier, service_name, = {}) self.origin, self.destination, self.carrier, self.service_name = origin, destination, carrier, service_name self.service_code = [:service_code] self.estimate_reference = [:estimate_reference] self.pickup_time = [:pickup_time] self.expires_at = [:expires_at] if [:package_rates] self.package_rates = [:package_rates].map { |p| p.update(:rate => Package.cents_from(p[:rate])) } else self.package_rates = Array([:packages]).map { |p| {:package => p} } end self.total_price = [:total_price] self.negotiated_rate = [:negotiated_rate] self.compare_price = [:compare_price] self.phone_required = [:phone_required] self.currency = [:currency] self.delivery_range = [:delivery_range] self.shipping_date = [:shipping_date] self.delivery_date = @delivery_range.last self.insurance_price = [:insurance_price] end # The total price of the shipments in cents. # @return [Integer] def total_price @total_price || @package_rates.sum { |pr| pr[:rate] } rescue NoMethodError raise ArgumentError.new("RateEstimate must have a total_price set, or have a full set of valid package rates.") end alias_method :price, :total_price # Adds a package to this rate estimate # @param package [ActiveShipping::Package] The package to add. # @param rate [#cents, Float, String, nil] The rate for this package. This is only required if # there is no total price for this shipment # @return [self] def add(package, rate = nil) cents = Package.cents_from(rate) raise ArgumentError.new("New packages must have valid rate information since this RateEstimate has no total_price set.") if cents.nil? and total_price.nil? @package_rates << {:package => package, :rate => cents} self end # The list of packages for which rate estimates are given. # @return [Array<ActiveShipping::Package>] def packages package_rates.map { |p| p[:package] } end # The number of packages for which rate estimates are given. # @return [Integer] def package_count package_rates.length end protected def delivery_range=(delivery_range) @delivery_range = delivery_range ? delivery_range.map { |date| date_for(date) }.compact : [] end def total_price=(total_price) @total_price = Package.cents_from(total_price) end def negotiated_rate=(negotiated_rate) @negotiated_rate = negotiated_rate ? Package.cents_from(negotiated_rate) : nil end def compare_price=(compare_price) @compare_price = compare_price ? Package.cents_from(compare_price) : nil end def currency=(currency) @currency = ActiveUtils::CurrencyCode.standardize(currency) end def phone_required=(phone_required) @phone_required = !!phone_required end def shipping_date=(shipping_date) @shipping_date = date_for(shipping_date) end def insurance_price=(insurance_price) @insurance_price = Package.cents_from(insurance_price) end private # Returns a Date object for a given input # @param [String, Date, Time, DateTime, ...] The object to infer a date from. # @return [Date, nil] The Date object absed on the input, or `nil` if no date # could be determined. def date_for(date) date && DateTime.strptime(date.to_s, "%Y-%m-%d") rescue ArgumentError nil end end |
#origin ⇒ ActiveShipping::Location
The origin of the shipment
65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 |
# File 'lib/active_shipping/rate_estimate.rb', line 65 class RateEstimate attr_accessor :origin, :destination, :package_rates, :carrier, :service_name, :service_code, :shipping_date, :delivery_date, :delivery_range, :currency, :negotiated_rate, :insurance_price, :estimate_reference, :expires_at, :pickup_time, :compare_price, :phone_required def initialize(origin, destination, carrier, service_name, = {}) self.origin, self.destination, self.carrier, self.service_name = origin, destination, carrier, service_name self.service_code = [:service_code] self.estimate_reference = [:estimate_reference] self.pickup_time = [:pickup_time] self.expires_at = [:expires_at] if [:package_rates] self.package_rates = [:package_rates].map { |p| p.update(:rate => Package.cents_from(p[:rate])) } else self.package_rates = Array([:packages]).map { |p| {:package => p} } end self.total_price = [:total_price] self.negotiated_rate = [:negotiated_rate] self.compare_price = [:compare_price] self.phone_required = [:phone_required] self.currency = [:currency] self.delivery_range = [:delivery_range] self.shipping_date = [:shipping_date] self.delivery_date = @delivery_range.last self.insurance_price = [:insurance_price] end # The total price of the shipments in cents. # @return [Integer] def total_price @total_price || @package_rates.sum { |pr| pr[:rate] } rescue NoMethodError raise ArgumentError.new("RateEstimate must have a total_price set, or have a full set of valid package rates.") end alias_method :price, :total_price # Adds a package to this rate estimate # @param package [ActiveShipping::Package] The package to add. # @param rate [#cents, Float, String, nil] The rate for this package. This is only required if # there is no total price for this shipment # @return [self] def add(package, rate = nil) cents = Package.cents_from(rate) raise ArgumentError.new("New packages must have valid rate information since this RateEstimate has no total_price set.") if cents.nil? and total_price.nil? @package_rates << {:package => package, :rate => cents} self end # The list of packages for which rate estimates are given. # @return [Array<ActiveShipping::Package>] def packages package_rates.map { |p| p[:package] } end # The number of packages for which rate estimates are given. # @return [Integer] def package_count package_rates.length end protected def delivery_range=(delivery_range) @delivery_range = delivery_range ? delivery_range.map { |date| date_for(date) }.compact : [] end def total_price=(total_price) @total_price = Package.cents_from(total_price) end def negotiated_rate=(negotiated_rate) @negotiated_rate = negotiated_rate ? Package.cents_from(negotiated_rate) : nil end def compare_price=(compare_price) @compare_price = compare_price ? Package.cents_from(compare_price) : nil end def currency=(currency) @currency = ActiveUtils::CurrencyCode.standardize(currency) end def phone_required=(phone_required) @phone_required = !!phone_required end def shipping_date=(shipping_date) @shipping_date = date_for(shipping_date) end def insurance_price=(insurance_price) @insurance_price = Package.cents_from(insurance_price) end private # Returns a Date object for a given input # @param [String, Date, Time, DateTime, ...] The object to infer a date from. # @return [Date, nil] The Date object absed on the input, or `nil` if no date # could be determined. def date_for(date) date && DateTime.strptime(date.to_s, "%Y-%m-%d") rescue ArgumentError nil end end |
#package_rates ⇒ Array<{:rate => Integer, :package => ActiveShipping::Package}>
A list of rates for all the packages in the shipment.
65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 |
# File 'lib/active_shipping/rate_estimate.rb', line 65 class RateEstimate attr_accessor :origin, :destination, :package_rates, :carrier, :service_name, :service_code, :shipping_date, :delivery_date, :delivery_range, :currency, :negotiated_rate, :insurance_price, :estimate_reference, :expires_at, :pickup_time, :compare_price, :phone_required def initialize(origin, destination, carrier, service_name, = {}) self.origin, self.destination, self.carrier, self.service_name = origin, destination, carrier, service_name self.service_code = [:service_code] self.estimate_reference = [:estimate_reference] self.pickup_time = [:pickup_time] self.expires_at = [:expires_at] if [:package_rates] self.package_rates = [:package_rates].map { |p| p.update(:rate => Package.cents_from(p[:rate])) } else self.package_rates = Array([:packages]).map { |p| {:package => p} } end self.total_price = [:total_price] self.negotiated_rate = [:negotiated_rate] self.compare_price = [:compare_price] self.phone_required = [:phone_required] self.currency = [:currency] self.delivery_range = [:delivery_range] self.shipping_date = [:shipping_date] self.delivery_date = @delivery_range.last self.insurance_price = [:insurance_price] end # The total price of the shipments in cents. # @return [Integer] def total_price @total_price || @package_rates.sum { |pr| pr[:rate] } rescue NoMethodError raise ArgumentError.new("RateEstimate must have a total_price set, or have a full set of valid package rates.") end alias_method :price, :total_price # Adds a package to this rate estimate # @param package [ActiveShipping::Package] The package to add. # @param rate [#cents, Float, String, nil] The rate for this package. This is only required if # there is no total price for this shipment # @return [self] def add(package, rate = nil) cents = Package.cents_from(rate) raise ArgumentError.new("New packages must have valid rate information since this RateEstimate has no total_price set.") if cents.nil? and total_price.nil? @package_rates << {:package => package, :rate => cents} self end # The list of packages for which rate estimates are given. # @return [Array<ActiveShipping::Package>] def packages package_rates.map { |p| p[:package] } end # The number of packages for which rate estimates are given. # @return [Integer] def package_count package_rates.length end protected def delivery_range=(delivery_range) @delivery_range = delivery_range ? delivery_range.map { |date| date_for(date) }.compact : [] end def total_price=(total_price) @total_price = Package.cents_from(total_price) end def negotiated_rate=(negotiated_rate) @negotiated_rate = negotiated_rate ? Package.cents_from(negotiated_rate) : nil end def compare_price=(compare_price) @compare_price = compare_price ? Package.cents_from(compare_price) : nil end def currency=(currency) @currency = ActiveUtils::CurrencyCode.standardize(currency) end def phone_required=(phone_required) @phone_required = !!phone_required end def shipping_date=(shipping_date) @shipping_date = date_for(shipping_date) end def insurance_price=(insurance_price) @insurance_price = Package.cents_from(insurance_price) end private # Returns a Date object for a given input # @param [String, Date, Time, DateTime, ...] The object to infer a date from. # @return [Date, nil] The Date object absed on the input, or `nil` if no date # could be determined. def date_for(date) date && DateTime.strptime(date.to_s, "%Y-%m-%d") rescue ArgumentError nil end end |
#phone_required ⇒ Boolean
Specifies if a phone number is required for the shipping rate.
65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 |
# File 'lib/active_shipping/rate_estimate.rb', line 65 class RateEstimate attr_accessor :origin, :destination, :package_rates, :carrier, :service_name, :service_code, :shipping_date, :delivery_date, :delivery_range, :currency, :negotiated_rate, :insurance_price, :estimate_reference, :expires_at, :pickup_time, :compare_price, :phone_required def initialize(origin, destination, carrier, service_name, = {}) self.origin, self.destination, self.carrier, self.service_name = origin, destination, carrier, service_name self.service_code = [:service_code] self.estimate_reference = [:estimate_reference] self.pickup_time = [:pickup_time] self.expires_at = [:expires_at] if [:package_rates] self.package_rates = [:package_rates].map { |p| p.update(:rate => Package.cents_from(p[:rate])) } else self.package_rates = Array([:packages]).map { |p| {:package => p} } end self.total_price = [:total_price] self.negotiated_rate = [:negotiated_rate] self.compare_price = [:compare_price] self.phone_required = [:phone_required] self.currency = [:currency] self.delivery_range = [:delivery_range] self.shipping_date = [:shipping_date] self.delivery_date = @delivery_range.last self.insurance_price = [:insurance_price] end # The total price of the shipments in cents. # @return [Integer] def total_price @total_price || @package_rates.sum { |pr| pr[:rate] } rescue NoMethodError raise ArgumentError.new("RateEstimate must have a total_price set, or have a full set of valid package rates.") end alias_method :price, :total_price # Adds a package to this rate estimate # @param package [ActiveShipping::Package] The package to add. # @param rate [#cents, Float, String, nil] The rate for this package. This is only required if # there is no total price for this shipment # @return [self] def add(package, rate = nil) cents = Package.cents_from(rate) raise ArgumentError.new("New packages must have valid rate information since this RateEstimate has no total_price set.") if cents.nil? and total_price.nil? @package_rates << {:package => package, :rate => cents} self end # The list of packages for which rate estimates are given. # @return [Array<ActiveShipping::Package>] def packages package_rates.map { |p| p[:package] } end # The number of packages for which rate estimates are given. # @return [Integer] def package_count package_rates.length end protected def delivery_range=(delivery_range) @delivery_range = delivery_range ? delivery_range.map { |date| date_for(date) }.compact : [] end def total_price=(total_price) @total_price = Package.cents_from(total_price) end def negotiated_rate=(negotiated_rate) @negotiated_rate = negotiated_rate ? Package.cents_from(negotiated_rate) : nil end def compare_price=(compare_price) @compare_price = compare_price ? Package.cents_from(compare_price) : nil end def currency=(currency) @currency = ActiveUtils::CurrencyCode.standardize(currency) end def phone_required=(phone_required) @phone_required = !!phone_required end def shipping_date=(shipping_date) @shipping_date = date_for(shipping_date) end def insurance_price=(insurance_price) @insurance_price = Package.cents_from(insurance_price) end private # Returns a Date object for a given input # @param [String, Date, Time, DateTime, ...] The object to infer a date from. # @return [Date, nil] The Date object absed on the input, or `nil` if no date # could be determined. def date_for(date) date && DateTime.strptime(date.to_s, "%Y-%m-%d") rescue ArgumentError nil end end |
#pickup_time ⇒ Object
Returns the value of attribute pickup_time.
66 67 68 |
# File 'lib/active_shipping/rate_estimate.rb', line 66 def pickup_time @pickup_time end |
#service_code ⇒ String
The code of the shipping service
65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 |
# File 'lib/active_shipping/rate_estimate.rb', line 65 class RateEstimate attr_accessor :origin, :destination, :package_rates, :carrier, :service_name, :service_code, :shipping_date, :delivery_date, :delivery_range, :currency, :negotiated_rate, :insurance_price, :estimate_reference, :expires_at, :pickup_time, :compare_price, :phone_required def initialize(origin, destination, carrier, service_name, = {}) self.origin, self.destination, self.carrier, self.service_name = origin, destination, carrier, service_name self.service_code = [:service_code] self.estimate_reference = [:estimate_reference] self.pickup_time = [:pickup_time] self.expires_at = [:expires_at] if [:package_rates] self.package_rates = [:package_rates].map { |p| p.update(:rate => Package.cents_from(p[:rate])) } else self.package_rates = Array([:packages]).map { |p| {:package => p} } end self.total_price = [:total_price] self.negotiated_rate = [:negotiated_rate] self.compare_price = [:compare_price] self.phone_required = [:phone_required] self.currency = [:currency] self.delivery_range = [:delivery_range] self.shipping_date = [:shipping_date] self.delivery_date = @delivery_range.last self.insurance_price = [:insurance_price] end # The total price of the shipments in cents. # @return [Integer] def total_price @total_price || @package_rates.sum { |pr| pr[:rate] } rescue NoMethodError raise ArgumentError.new("RateEstimate must have a total_price set, or have a full set of valid package rates.") end alias_method :price, :total_price # Adds a package to this rate estimate # @param package [ActiveShipping::Package] The package to add. # @param rate [#cents, Float, String, nil] The rate for this package. This is only required if # there is no total price for this shipment # @return [self] def add(package, rate = nil) cents = Package.cents_from(rate) raise ArgumentError.new("New packages must have valid rate information since this RateEstimate has no total_price set.") if cents.nil? and total_price.nil? @package_rates << {:package => package, :rate => cents} self end # The list of packages for which rate estimates are given. # @return [Array<ActiveShipping::Package>] def packages package_rates.map { |p| p[:package] } end # The number of packages for which rate estimates are given. # @return [Integer] def package_count package_rates.length end protected def delivery_range=(delivery_range) @delivery_range = delivery_range ? delivery_range.map { |date| date_for(date) }.compact : [] end def total_price=(total_price) @total_price = Package.cents_from(total_price) end def negotiated_rate=(negotiated_rate) @negotiated_rate = negotiated_rate ? Package.cents_from(negotiated_rate) : nil end def compare_price=(compare_price) @compare_price = compare_price ? Package.cents_from(compare_price) : nil end def currency=(currency) @currency = ActiveUtils::CurrencyCode.standardize(currency) end def phone_required=(phone_required) @phone_required = !!phone_required end def shipping_date=(shipping_date) @shipping_date = date_for(shipping_date) end def insurance_price=(insurance_price) @insurance_price = Package.cents_from(insurance_price) end private # Returns a Date object for a given input # @param [String, Date, Time, DateTime, ...] The object to infer a date from. # @return [Date, nil] The Date object absed on the input, or `nil` if no date # could be determined. def date_for(date) date && DateTime.strptime(date.to_s, "%Y-%m-%d") rescue ArgumentError nil end end |
#service_name ⇒ String
The name of the shipping service (e.g. "First Class Ground"
)
65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 |
# File 'lib/active_shipping/rate_estimate.rb', line 65 class RateEstimate attr_accessor :origin, :destination, :package_rates, :carrier, :service_name, :service_code, :shipping_date, :delivery_date, :delivery_range, :currency, :negotiated_rate, :insurance_price, :estimate_reference, :expires_at, :pickup_time, :compare_price, :phone_required def initialize(origin, destination, carrier, service_name, = {}) self.origin, self.destination, self.carrier, self.service_name = origin, destination, carrier, service_name self.service_code = [:service_code] self.estimate_reference = [:estimate_reference] self.pickup_time = [:pickup_time] self.expires_at = [:expires_at] if [:package_rates] self.package_rates = [:package_rates].map { |p| p.update(:rate => Package.cents_from(p[:rate])) } else self.package_rates = Array([:packages]).map { |p| {:package => p} } end self.total_price = [:total_price] self.negotiated_rate = [:negotiated_rate] self.compare_price = [:compare_price] self.phone_required = [:phone_required] self.currency = [:currency] self.delivery_range = [:delivery_range] self.shipping_date = [:shipping_date] self.delivery_date = @delivery_range.last self.insurance_price = [:insurance_price] end # The total price of the shipments in cents. # @return [Integer] def total_price @total_price || @package_rates.sum { |pr| pr[:rate] } rescue NoMethodError raise ArgumentError.new("RateEstimate must have a total_price set, or have a full set of valid package rates.") end alias_method :price, :total_price # Adds a package to this rate estimate # @param package [ActiveShipping::Package] The package to add. # @param rate [#cents, Float, String, nil] The rate for this package. This is only required if # there is no total price for this shipment # @return [self] def add(package, rate = nil) cents = Package.cents_from(rate) raise ArgumentError.new("New packages must have valid rate information since this RateEstimate has no total_price set.") if cents.nil? and total_price.nil? @package_rates << {:package => package, :rate => cents} self end # The list of packages for which rate estimates are given. # @return [Array<ActiveShipping::Package>] def packages package_rates.map { |p| p[:package] } end # The number of packages for which rate estimates are given. # @return [Integer] def package_count package_rates.length end protected def delivery_range=(delivery_range) @delivery_range = delivery_range ? delivery_range.map { |date| date_for(date) }.compact : [] end def total_price=(total_price) @total_price = Package.cents_from(total_price) end def negotiated_rate=(negotiated_rate) @negotiated_rate = negotiated_rate ? Package.cents_from(negotiated_rate) : nil end def compare_price=(compare_price) @compare_price = compare_price ? Package.cents_from(compare_price) : nil end def currency=(currency) @currency = ActiveUtils::CurrencyCode.standardize(currency) end def phone_required=(phone_required) @phone_required = !!phone_required end def shipping_date=(shipping_date) @shipping_date = date_for(shipping_date) end def insurance_price=(insurance_price) @insurance_price = Package.cents_from(insurance_price) end private # Returns a Date object for a given input # @param [String, Date, Time, DateTime, ...] The object to infer a date from. # @return [Date, nil] The Date object absed on the input, or `nil` if no date # could be determined. def date_for(date) date && DateTime.strptime(date.to_s, "%Y-%m-%d") rescue ArgumentError nil end end |
#shipping_date ⇒ Date
The date on which the shipment will be expected. Normally, this means that the delivery date range can only pe prmoised if the shipment is handed over on or before this date.
65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 |
# File 'lib/active_shipping/rate_estimate.rb', line 65 class RateEstimate attr_accessor :origin, :destination, :package_rates, :carrier, :service_name, :service_code, :shipping_date, :delivery_date, :delivery_range, :currency, :negotiated_rate, :insurance_price, :estimate_reference, :expires_at, :pickup_time, :compare_price, :phone_required def initialize(origin, destination, carrier, service_name, = {}) self.origin, self.destination, self.carrier, self.service_name = origin, destination, carrier, service_name self.service_code = [:service_code] self.estimate_reference = [:estimate_reference] self.pickup_time = [:pickup_time] self.expires_at = [:expires_at] if [:package_rates] self.package_rates = [:package_rates].map { |p| p.update(:rate => Package.cents_from(p[:rate])) } else self.package_rates = Array([:packages]).map { |p| {:package => p} } end self.total_price = [:total_price] self.negotiated_rate = [:negotiated_rate] self.compare_price = [:compare_price] self.phone_required = [:phone_required] self.currency = [:currency] self.delivery_range = [:delivery_range] self.shipping_date = [:shipping_date] self.delivery_date = @delivery_range.last self.insurance_price = [:insurance_price] end # The total price of the shipments in cents. # @return [Integer] def total_price @total_price || @package_rates.sum { |pr| pr[:rate] } rescue NoMethodError raise ArgumentError.new("RateEstimate must have a total_price set, or have a full set of valid package rates.") end alias_method :price, :total_price # Adds a package to this rate estimate # @param package [ActiveShipping::Package] The package to add. # @param rate [#cents, Float, String, nil] The rate for this package. This is only required if # there is no total price for this shipment # @return [self] def add(package, rate = nil) cents = Package.cents_from(rate) raise ArgumentError.new("New packages must have valid rate information since this RateEstimate has no total_price set.") if cents.nil? and total_price.nil? @package_rates << {:package => package, :rate => cents} self end # The list of packages for which rate estimates are given. # @return [Array<ActiveShipping::Package>] def packages package_rates.map { |p| p[:package] } end # The number of packages for which rate estimates are given. # @return [Integer] def package_count package_rates.length end protected def delivery_range=(delivery_range) @delivery_range = delivery_range ? delivery_range.map { |date| date_for(date) }.compact : [] end def total_price=(total_price) @total_price = Package.cents_from(total_price) end def negotiated_rate=(negotiated_rate) @negotiated_rate = negotiated_rate ? Package.cents_from(negotiated_rate) : nil end def compare_price=(compare_price) @compare_price = compare_price ? Package.cents_from(compare_price) : nil end def currency=(currency) @currency = ActiveUtils::CurrencyCode.standardize(currency) end def phone_required=(phone_required) @phone_required = !!phone_required end def shipping_date=(shipping_date) @shipping_date = date_for(shipping_date) end def insurance_price=(insurance_price) @insurance_price = Package.cents_from(insurance_price) end private # Returns a Date object for a given input # @param [String, Date, Time, DateTime, ...] The object to infer a date from. # @return [Date, nil] The Date object absed on the input, or `nil` if no date # could be determined. def date_for(date) date && DateTime.strptime(date.to_s, "%Y-%m-%d") rescue ArgumentError nil end end |
Instance Method Details
#add(package, rate = nil) ⇒ self
Adds a package to this rate estimate
109 110 111 112 113 114 |
# File 'lib/active_shipping/rate_estimate.rb', line 109 def add(package, rate = nil) cents = Package.cents_from(rate) raise ArgumentError.new("New packages must have valid rate information since this RateEstimate has no total_price set.") if cents.nil? and total_price.nil? @package_rates << {:package => package, :rate => cents} self end |
#package_count ⇒ Integer
The number of packages for which rate estimates are given.
124 125 126 |
# File 'lib/active_shipping/rate_estimate.rb', line 124 def package_count package_rates.length end |
#packages ⇒ Array<ActiveShipping::Package>
The list of packages for which rate estimates are given.
118 119 120 |
# File 'lib/active_shipping/rate_estimate.rb', line 118 def packages package_rates.map { |p| p[:package] } end |
#total_price ⇒ Integer Also known as: price
The total price of the shipments in cents.
97 98 99 100 101 |
# File 'lib/active_shipping/rate_estimate.rb', line 97 def total_price @total_price || @package_rates.sum { |pr| pr[:rate] } rescue NoMethodError raise ArgumentError.new("RateEstimate must have a total_price set, or have a full set of valid package rates.") end |
#total_price=(total_price) ⇒ Object (protected)
134 135 136 |
# File 'lib/active_shipping/rate_estimate.rb', line 134 def total_price=(total_price) @total_price = Package.cents_from(total_price) end |