usps-ruby-client 0.1.0

data/lib/usps/api/endpoints/e_vsi_cancel.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+# This file was auto-generated by lib/tasks/api.rake
+
+module Usps
+	module Api
+		module Endpoints
+			module EVSICancel
+				#
+				# eVS International Cancel API
+				#
+				# The eVS
+				# International Cancel request allows an eVS label to be removed from processing
+				# if the request is made prior to 11:59 PM Central Time on the day of label creation.This functionality is available only if the eVS International
+				# label has been held for manifest (i.e. <HoldForManifest>=”Y”
+				# is included in eVS International label XML request) and the Shipping Services
+				# File v2.0 has not yet been created. Depending on customer profile setup, this
+				# transmission could occur for created labels every 15 minutes, at the end of the
+				# shipping day, or when a SCAN Form is manually triggered by the customer.
+				#
+				# @option option [(Alias)] :eVSICancelRequest (Required)
+				#   @option option [] :BarcodeNumber (Required)
+				#   - BarcodeNumber of original label. Length of 22, 30 or 34 numbers.
+				#   @option option [] :eVSICancelRequest (Required)
+
+				#
+				# @see 
+				def e_vsi_cancel(options = {})
+					throw ArgumentError.new('Required arguments :e_vsi_cancel_request missing') if options[:e_vsi_cancel_request].nil?
+					throw ArgumentError.new('Required arguments :e_vsi_cancel_request, :barcode_number missing') if options[:e_vsi_cancel_request][:barcode_number].nil?
+					throw ArgumentError.new('Required arguments :e_vsi_cancel_request, :e_vsi_cancel_request missing') if options[:e_vsi_cancel_request][:e_vsi_cancel_request].nil?
+
+					request = build_request(:e_vsi_cancel, options)
+					get('https://secure.shippingapis.com/ShippingAPI.dll', {
+						API: 'eVSICancel',
+						XML: request,
+					})
+				end
+
+				private
+
+				def tag_unless_blank(xml, tag_name, data)
+					xml.tag!(tag_name, data) unless data.blank? || data.nil?
+				end
+
+				def build_e_vsi_cancel_request(xml, options = {})
+					xml.tag!('BarcodeNumber', options[:e_vsi_cancel_request][:barcode_number])
+					xml.tag!('eVSICancelRequest', options[:e_vsi_cancel_request][:e_vsi_cancel_request])
+					xml.target!
+				end
+
+			end
+		end
+	end
+end

data/lib/usps/api/endpoints/hfp_facility_info.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+# This file was auto-generated by lib/tasks/api.rake
+
+module Usps
+	module Api
+		module Endpoints
+			module HFPFacilityInfo
+				#
+				# Hold for Pickup Facility Information API
+				#
+				# Hold For
+				# Pickup service is available at approximately 31,000 USPS locations. This API
+				# will list US Postal Service Facilities where Hold-For-Pickup service is
+				# available. The response includes facilities based on ZIP code (five or nine
+				# digit) or City/State up to a maximum number of locations. Shipments are
+				# available for pickup by the recipient or a designee at the designated Hold For Pickup location by either 10 a.m., noon, or 3 p.m.,
+				# based on the service standard associated with the mail class. Hold For Pickup shipments are sent to a designated Hold For
+				# Pickup location, such as a Post Office, where the shipment can be picked up
+				# within five calendar days. Hold For Pickup service
+				# lets customers pick up shipments when it is convenient for them, with the
+				# assurance that their shipments are held safely and securely.
+				#
+				# @option option [(Alias)] :HFPFacilityInfoRequest (Required)
+				# - API=HFPFacilityInfo
+				#   @option option [String] :PickupCity (Required)
+				#   - Either City/State or ZIP code must be specified. When only city and state are provided, all pickup facilities with addresses within that city and state will be returned. For example: <PickupCity>Boston</PickupCity>
+				#   @option option [String] :PickupState (Required)
+				#   - Either City/State or ZIP code must be specified. For example: <PickupState>MA</PickupState>
+				#   @option option [String] :PickupZIP (Required)
+				#   - Either City/State or ZIP code must be specified. When PickupZIP provided without PickupZIP4, all pickup facilities that service that ZIP code are returned. For example: <PickupZIP>02111</PickupZIP>
+				#   @option option [String] :PickupZIP4 (Required)
+				#   - If PickupZIP is specified, then PickupZIP4 may also be specified. This will match to a single pickup facility with the given nine-digit ZIP code. For example: <PickupZIP4>9998</PickupZIP4>
+				#   @option option [String] :Service (Optional)
+				#   - For future use. May be omitted.
+
+				#
+				# @see 
+				def hfp_facility_info(options = {})
+					throw ArgumentError.new('Required arguments :hfp_facility_info_request missing') if options[:hfp_facility_info_request].nil?
+					throw ArgumentError.new('Required arguments :hfp_facility_info_request, :pickup_city missing') if options[:hfp_facility_info_request][:pickup_city].nil?
+					throw ArgumentError.new('Required arguments :hfp_facility_info_request, :pickup_state missing') if options[:hfp_facility_info_request][:pickup_state].nil?
+					throw ArgumentError.new('Required arguments :hfp_facility_info_request, :pickup_zip missing') if options[:hfp_facility_info_request][:pickup_zip].nil?
+					throw ArgumentError.new('Required arguments :hfp_facility_info_request, :pickup_zip4 missing') if options[:hfp_facility_info_request][:pickup_zip4].nil?
+
+					request = build_request(:hfp_facility_info, options)
+					get('https://secure.shippingapis.com/ShippingAPI.dll', {
+						API: 'HFPFacilityInfo',
+						XML: request,
+					})
+				end
+
+				private
+
+				def tag_unless_blank(xml, tag_name, data)
+					xml.tag!(tag_name, data) unless data.blank? || data.nil?
+				end
+
+				def build_hfp_facility_info_request(xml, options = {})
+					xml.tag!('PickupCity', options[:hfp_facility_info_request][:pickup_city])
+					xml.tag!('PickupState', options[:hfp_facility_info_request][:pickup_state])
+					xml.tag!('PickupZIP', options[:hfp_facility_info_request][:pickup_zip])
+					xml.tag!('PickupZIP4', options[:hfp_facility_info_request][:pickup_zip4])
+					tag_unless_blank(xml, 'Service', options[:hfp_facility_info_request][:service])
+					xml.target!
+				end
+
+			end
+		end
+	end
+end

data/lib/usps/api/endpoints/intl_rate_v2.rb

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+# This file was auto-generated by lib/tasks/api.rake
+
+module Usps
+	module Api
+		module Endpoints
+			module IntlRateV2
+				#
+				# International Rates API
+				#
+				# The
+				# IntlRateV2 API lets customers calculate the rate for international packages and
+				# envelopes given the weight and dimensions of the item. The IntlRateV2 API
+				# limits the data requested to twenty-five (25) packages per transaction. For
+				# specifications such as package dimensions, delivery information, etc, please refer to the International Mail Manual (IMM) at
+				# http://pe.usps.com/.
+				#
+				# @option option [(Alias)] :IntlRateV2Request (Required)
+				# - API=IntlRateV2 This API returns the current international USPS postage corresponding to the parameters given.
+				#   @option option [String] :Revision (Optional)
+				#   - Set this value to “2” to return all currently documented response fields. For example: <Revision>2</Revsion>
+				#   @option option [(Group)] :Package (Optional)
+				#   - Opening Package tag.
+				#     @option option [NMTOKEN] :ID (Required)
+				#     - No restriction on number or type of characters provided valid XML syntax and unique to request. For example: <Package ID="0">...</Package>
+				#     @option option [Integer] :Pounds (Required)
+				#     - Value must be numeric. Package weight generally cannot exceed 70 pounds. Maximum Decimal places are 8. Refer to the International Mail Manual (IMM) for weight requirements per country and mail service. The IMM can be found at the Postal Explorer web site. For example: <Pounds>2</Pounds> <Pounds>2.12345678</Pounds>
+				#     @option option [Decimal] :Ounces (Required)
+				#     - Value must be numeric. Package weight generally cannot exceed 70 pounds. Maximum Decimal places are 8. Refer to the International Mail Manual (IMM) for weight requirements per country and mail service. The IMM can be found at the Postal Explorer web site. For example: <Ounces>4</Ounces> <Ounces>4.12345678</Ounces>
+				#     @option option [Boolean] :Machinable (Optional)
+				#     - Indicates whether or not the item is machinable. A surcharge is applied to a First-Class Mail International item if it has one or more non-machinable characteristics. See International Mail Manual (IMM) Section 241.217 for more information. For example: <Machinable>True</Machinable>
+				#     @option option [String] :MailType (Required)
+				#     - Package type being shipped. For example: <MailType>Package</MailType>
+				#     @option option [(Group)] :GXG (Optional)
+				#     - If GXG rate is desired, then this group must be specified. Note that if this data precludes delivery, due to size or availability of service at the destination, then GXG rates simply will not be returned (not an error condition.)
+				#       @option option [String] :POBoxFlag (Required)
+				#       - Specify as "Y" if the destination is a post office box. For example: <POBoxFlag>Y</POBoxFlag>
+				#       @option option [String] :GiftFlag (Required)
+				#       - Specify as "Y" if the package contains a gift. For example: <GiftFlag>Y</GiftFlag>
+				#       @option option [String] :ValueOfContents (Required)
+				#       - If specified, used to compute Insurance fee (if insurance is available for service and destination). For example: <ValueOfContents>103.00</ValueOfContents>
+				#       @option option [String] :Country (Required)
+				#       - Entries must be from the USPS list of valid countries from the International Country Listings. To access the International Country Listings, go to the Index of Countries and Localities. For example: <Country>Albania</Country>
+				#       @option option [String] :Container (Optional)
+				#       - Note: This tag has been deprecated. <Container> tag and any values within the <Container> tag will not result in an error response and will not impact rates that are returned.
+				#       @option option [String] :Size (Optional)
+				#       - Note: This tag has been deprecated <Size> tag and any values within the <Size> tag will not result in an error response and will not impact rates that are returned.
+				#       @option option [Integer] :Width (Optional)
+				#       - Value must be numeric. Units are inches. If partial dimensions are provided, an error response will return. Length, Width, Height are required for accurate pricing of a rectangular package when any dimension of the item exceeds 12 inches. In addition, Girth is required only for a non-rectangular package in addition to Length, Width, Height when any dimension of the package exceeds 12 inches. For rectangular packages, the Girth dimension must be left blank as this dimension is to only be used for non-rectangular packages. For more details on dimensional weight pricing, please reference the Domestic Mail Manual Section 123.1.4 for Retail Mail and Section 223.1.6 for Commercial Mail. https://pe.usps.com/text/dmm300/index.htm
+				#       @option option [Integer] :Length (Optional)
+				#       - Value must be numeric. Units are inches. If partial dimensions are provided, an error response will return. Length, Width, Height are required for accurate pricing of a rectangular package when any dimension of the item exceeds 12 inches. In addition, Girth is required only for a non-rectangular package in addition to Length, Width, Height when any dimension of the package exceeds 12 inches. For rectangular packages, the Girth dimension must be left blank as this dimension is to only be used for non-rectangular packages. For more details on dimensional weight pricing, please reference the Domestic Mail Manual Section 123.1.4 for Retail Mail and Section 223.1.6 for Commercial Mail. https://pe.usps.com/text/dmm300/index.htm
+				#       @option option [Integer] :Height (Optional)
+				#       - Value must be numeric. Units are inches. If partial dimensions are provided, an error response will return. Length, Width, Height are required for accurate pricing of a rectangular package when any dimension of the item exceeds 12 inches. In addition, Girth is required only for a non-rectangular package in addition to Length, Width, Height when any dimension of the package exceeds 12 inches. For rectangular packages, the Girth dimension must be left blank as this dimension is to only be used for non-rectangular packages. For more details on dimensional weight pricing, please reference the Domestic Mail Manual Section 123.1.4 for Retail Mail and Section 223.1.6 for Commercial Mail. https://pe.usps.com/text/dmm300/index.htm
+				#       @option option [Integer] :Girth (Optional)
+				#       - Value must be numeric. Units are inches. If partial dimensions are provided, an error response will return. Length, Width, Height are required for accurate pricing of a rectangular package when any dimension of the item exceeds 12 inches. In addition, Girth is required only for a non-rectangular package in addition to Length, Width, Height when any dimension of the package exceeds 12 inches. For rectangular packages, the Girth dimension must be left blank as this dimension is to only be used for non-rectangular packages. For more details on dimensional weight pricing, please reference the Domestic Mail Manual Section 123.1.4 for Retail Mail and Section 223.1.6 for Commercial Mail. https://pe.usps.com/text/dmm300/index.htm
+				#       @option option [String] :OriginZip (Optional)
+				#       - Available when IntlRateV2Request [Revision='2']. Origin ZIP Code is required to determine Priority Mail International price to Canadian destinations and is used to determine mail-ability of Global Express Guaranteed. When provided, the response will return a list of Post Office locations where GXG is accepted. The Origin ZIP Code must be valid. For example: <OriginZip>20770</OriginZip>
+				#       @option option [String] :CommercialFlag (Optional)
+				#       - Returns commercial base postage. For example: <CommercialFlag>Y<CommercialFlag>
+				#       @option option [String] :CommercialPlusFlag (Optional)
+				#       - Returns commercial plus postage. For example: <CommercialPlusFlag>Y<CommercialPlusFlag>
+				#       @option option [(Group)] :ExtraServices (Optional)
+				#       - Available when IntlRateV2Request[Revision='2']. Groups the ExtraService elements.
+				#         @option option [Extra Service Name] :ExtraService (Optional)
+				#         - [{"Extra Service Name"=>"Registered Mail", "ServiceID"=>"103"}, {"Extra Service Name"=>"Insurance – Global Express Guaranteed", "ServiceID"=>"106"}, {"Extra Service Name"=>"Insurance – Priority Mail International", "ServiceID"=>"108"}, {"Extra Service Name"=>"Return Receipt", "ServiceID"=>"105"}, {"Extra Service Name"=>"Certificate of Mailing", "ServiceID"=>"100"}, {"Extra Service Name"=>"Electronic USPS Delivery Confirmation International", "ServiceID"=>"109"}]
+				#         @option option [DateTime] :AcceptanceDateTime (Optional)
+				#         - Available when IntlRateV2Request[Revision='2']. Date and Time the package is accepted by USPS. The AcceptanceDateTime tag along with the DestinationPostalCode and OriginZip is used to calculate the GuaranteeAvailability and also GuaranteeAvailability response tag for PMEI services in Kahala countries. ISO 8601 formatted date. YYYY-MM-DDThh:mm:ss+/-hh:mm For example, 2014-01-22T14:30:51-06:00
+				#         @option option [String] :DestinationPostalCode (Optional)
+				#         - Available when IntlRateV2Request[Revision='2']. Destination Postal Code The AcceptanceDateTime tag along with the DestinationPostalCode and OriginZip is used to calculate the GuaranteeAvailability and also GuaranteeAvailability response tag for PMEI services in Kahala countries.
+				#         @option option [(Group)] :Content (Optional)
+				#         - Used to describe the contents of the package.
+				#           @option option [String] :ContentType (Optional)
+				#           - Contains the enumerated description of the items in the package. “NonnegotiableDocument” and “Documents” both signify mailable non-negotiable documents and are insured automatically for up to $100, though Insurance will not be returned as an extra service. Additional Insurance cannot be purchased. Any non-document ContentType values are insured automatically for up to $200 and Insurance will be returned as an explicit extra service in the response. Additional Insurance can be purchased for values $200 and greater.
+				#           @option option [String] :ContentDescription (Optional)
+				#           - For future use
+
+				#
+				# @see 
+				def intl_rate_v2(options = {})
+					throw ArgumentError.new('Required arguments :intl_rate_v2_request missing') if options[:intl_rate_v2_request].nil?
+
+					request = build_request(:intl_rate_v2, options)
+					get('https://secure.shippingapis.com/ShippingAPI.dll', {
+						API: 'IntlRateV2',
+						XML: request,
+					})
+				end
+
+				private
+
+				def tag_unless_blank(xml, tag_name, data)
+					xml.tag!(tag_name, data) unless data.blank? || data.nil?
+				end
+
+				def build_intl_rate_v2_request(xml, options = {})
+					tag_unless_blank(xml, 'Revision', options[:intl_rate_v2_request][:revision])
+					xml.tag!('Package') do
+						xml.tag!('ID', options[:intl_rate_v2_request][:package][:id])
+						xml.tag!('Pounds', options[:intl_rate_v2_request][:package][:pounds])
+						xml.tag!('Ounces', options[:intl_rate_v2_request][:package][:ounces])
+						tag_unless_blank(xml, 'Machinable', options[:intl_rate_v2_request][:package][:machinable])
+						xml.tag!('MailType', options[:intl_rate_v2_request][:package][:mail_type])
+						xml.tag!('GXG') do
+							xml.tag!('POBoxFlag', options[:intl_rate_v2_request][:package][:gxg][:po_box_flag])
+							xml.tag!('GiftFlag', options[:intl_rate_v2_request][:package][:gxg][:gift_flag])
+							xml.tag!('ValueOfContents', options[:intl_rate_v2_request][:package][:gxg][:value_of_contents])
+							xml.tag!('Country', options[:intl_rate_v2_request][:package][:gxg][:country])
+							tag_unless_blank(xml, 'Container', options[:intl_rate_v2_request][:package][:gxg][:container])
+							tag_unless_blank(xml, 'Size', options[:intl_rate_v2_request][:package][:gxg][:size])
+							tag_unless_blank(xml, 'Width', options[:intl_rate_v2_request][:package][:gxg][:width])
+							tag_unless_blank(xml, 'Length', options[:intl_rate_v2_request][:package][:gxg][:length])
+							tag_unless_blank(xml, 'Height', options[:intl_rate_v2_request][:package][:gxg][:height])
+							tag_unless_blank(xml, 'Girth', options[:intl_rate_v2_request][:package][:gxg][:girth])
+							tag_unless_blank(xml, 'OriginZip', options[:intl_rate_v2_request][:package][:gxg][:origin_zip])
+							tag_unless_blank(xml, 'CommercialFlag', options[:intl_rate_v2_request][:package][:gxg][:commercial_flag])
+							tag_unless_blank(xml, 'CommercialPlusFlag', options[:intl_rate_v2_request][:package][:gxg][:commercial_plus_flag])
+							xml.tag!('ExtraServices') do
+								tag_unless_blank(xml, 'ExtraService', options[:intl_rate_v2_request][:package][:gxg][:extra_services][:extra_service])
+								tag_unless_blank(xml, 'AcceptanceDateTime', options[:intl_rate_v2_request][:package][:gxg][:extra_services][:acceptance_date_time])
+								tag_unless_blank(xml, 'DestinationPostalCode', options[:intl_rate_v2_request][:package][:gxg][:extra_services][:destination_postal_code])
+								xml.tag!('Content') do
+									tag_unless_blank(xml, 'ContentType', options[:intl_rate_v2_request][:package][:gxg][:extra_services][:content][:content_type])
+									tag_unless_blank(xml, 'ContentDescription', options[:intl_rate_v2_request][:package][:gxg][:extra_services][:content][:content_description])
+								end if options[:intl_rate_v2_request][:package][:gxg][:extra_services][:content].present?
+							end if options[:intl_rate_v2_request][:package][:gxg][:extra_services].present?
+						end if options[:intl_rate_v2_request][:package][:gxg].present?
+					end if options[:intl_rate_v2_request][:package].present?
+					xml.target!
+				end
+
+			end
+		end
+	end
+end

data/lib/usps/api/endpoints/pts_email.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+# This file was auto-generated by lib/tasks/api.rake
+
+module Usps
+	module Api
+		module Endpoints
+			module PTSEmail
+				#
+				# Track and Confirm by Email API
+				#
+				# The Track and Confirm by
+				# Email API allows the customer to submit their email address to be notified of
+				# current or future tracking activity. When you request access for this API,
+				# please identify your anticipated API volume, mailer ID and how you will be
+				# utilizing this API. A mailer identification number (MID) is a 6 or 9-digit
+				# number assigned to a customer through the USPS Business Customer Gateway (BCG).
+				# Please refer to the following links for help:
+				#
+				# @option option [(Alias)] :PTSEmailRequest (Required)
+				#   @option option [String] :TrackId (Required)
+				#   @option option [String] :ClientIp (Optional)
+				#   @option option [String] :SourceId (Optional)
+				#   @option option [Integer] :MpSuffix (Required)
+				#   @option option [String] :MpDate (Required)
+				#   @option option [Request Type] :RequestType (Optional)
+				#   @option option [String] :FirstName (Optional)
+				#   @option option [String] :LastName (Optional)
+				#   @option option [String] :Email1 (Required)
+				#   @option option [String] :Email2 (Optional)
+				#   @option option [String] :Email3 (Optional)
+
+				#
+				# @see 
+				def pts_email(options = {})
+					throw ArgumentError.new('Required arguments :pts_email_request missing') if options[:pts_email_request].nil?
+					throw ArgumentError.new('Required arguments :pts_email_request, :track_id missing') if options[:pts_email_request][:track_id].nil?
+					throw ArgumentError.new('Required arguments :pts_email_request, :mp_suffix missing') if options[:pts_email_request][:mp_suffix].nil?
+					throw ArgumentError.new('Required arguments :pts_email_request, :mp_date missing') if options[:pts_email_request][:mp_date].nil?
+					throw ArgumentError.new('Required arguments :pts_email_request, :email1 missing') if options[:pts_email_request][:email1].nil?
+
+					request = build_request(:pts_email, options)
+					get('https://secure.shippingapis.com/ShippingAPI.dll', {
+						API: 'PTSEmail',
+						XML: request,
+					})
+				end
+
+				private
+
+				def tag_unless_blank(xml, tag_name, data)
+					xml.tag!(tag_name, data) unless data.blank? || data.nil?
+				end
+
+				def build_pts_email_request(xml, options = {})
+					xml.tag!('TrackId', options[:pts_email_request][:track_id])
+					tag_unless_blank(xml, 'ClientIp', options[:pts_email_request][:client_ip])
+					tag_unless_blank(xml, 'SourceId', options[:pts_email_request][:source_id])
+					xml.tag!('MpSuffix', options[:pts_email_request][:mp_suffix])
+					xml.tag!('MpDate', options[:pts_email_request][:mp_date])
+					tag_unless_blank(xml, 'RequestType', options[:pts_email_request][:request_type])
+					tag_unless_blank(xml, 'FirstName', options[:pts_email_request][:first_name])
+					tag_unless_blank(xml, 'LastName', options[:pts_email_request][:last_name])
+					xml.tag!('Email1', options[:pts_email_request][:email1])
+					tag_unless_blank(xml, 'Email2', options[:pts_email_request][:email2])
+					tag_unless_blank(xml, 'Email3', options[:pts_email_request][:email3])
+					xml.target!
+				end
+
+			end
+		end
+	end
+end

data/lib/usps/api/endpoints/pts_pod.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+# This file was auto-generated by lib/tasks/api.rake
+
+module Usps
+	module Api
+		module Endpoints
+			module PTSPod
+				#
+				# Proof of Delivery API
+				#
+				# Proof of
+				# Delivery is a letter that includes the recipient's name and a copy of their
+				# signature. The Proof of Delivery API
+				# allows the customer to request proof of delivery notification via email. When
+				# you request access for this API, please identify your anticipated API volume,
+				# mailer ID and how you will be utilizing this API. A mailer identification
+				# number (MID) is a 6 or 9-digit number assigned to a customer through the USPS
+				# Business Customer Gateway (BCG). Please refer to the following links for help:
+				#
+				# @option option [(Alias)] :PTSPodRequest (Optional)
+				#   @option option [String] :TrackId (Required)
+				#   @option option [String] :ClientIp (Optional)
+				#   @option option [String] :SourceId (Optional)
+				#   @option option [integer] :MpSuffix (Required)
+				#   @option option [String] :MpDate (Required)
+				#   @option option [String] :RequestType (Required)
+				#   @option option [String] :FirstName (Required)
+				#   @option option [String] :LastName (Required)
+				#   @option option [String] :Email1 (Optional)
+				#   @option option [String] :Email2 (Optional)
+				#   @option option [String] :Email3 (Optional)
+				#   @option option [String] :FaxNumber (Optional)
+				#   @option option [String] :AddressLine1 (Optional)
+				#   @option option [String] :AddressLine2 (Optional)
+				#   @option option [String] :City (Optional)
+				#   @option option [String] :State (Optional)
+				#   @option option [String] :Zip (Optional)
+				#   @option option [Boolean] :VerifyAddress (Optional)
+				#   @option option [String] :TableCode (Required)
+				#   @option option [String] :CustRegID (Optional)
+
+				#
+				# @see 
+				def pts_pod(options = {})
+					request = build_request(:pts_pod, options)
+					get('https://secure.shippingapis.com/ShippingAPI.dll', {
+						API: 'PTSPod',
+						XML: request,
+					})
+				end
+
+				private
+
+				def tag_unless_blank(xml, tag_name, data)
+					xml.tag!(tag_name, data) unless data.blank? || data.nil?
+				end
+
+				def build_pts_pod_request(xml, options = {})
+					xml.tag!('TrackId', options[:pts_pod_request][:track_id])
+					tag_unless_blank(xml, 'ClientIp', options[:pts_pod_request][:client_ip])
+					tag_unless_blank(xml, 'SourceId', options[:pts_pod_request][:source_id])
+					xml.tag!('MpSuffix', options[:pts_pod_request][:mp_suffix])
+					xml.tag!('MpDate', options[:pts_pod_request][:mp_date])
+					xml.tag!('RequestType', options[:pts_pod_request][:request_type])
+					xml.tag!('FirstName', options[:pts_pod_request][:first_name])
+					xml.tag!('LastName', options[:pts_pod_request][:last_name])
+					tag_unless_blank(xml, 'Email1', options[:pts_pod_request][:email1])
+					tag_unless_blank(xml, 'Email2', options[:pts_pod_request][:email2])
+					tag_unless_blank(xml, 'Email3', options[:pts_pod_request][:email3])
+					tag_unless_blank(xml, 'FaxNumber', options[:pts_pod_request][:fax_number])
+					tag_unless_blank(xml, 'AddressLine1', options[:pts_pod_request][:address_line1])
+					tag_unless_blank(xml, 'AddressLine2', options[:pts_pod_request][:address_line2])
+					tag_unless_blank(xml, 'City', options[:pts_pod_request][:city])
+					tag_unless_blank(xml, 'State', options[:pts_pod_request][:state])
+					tag_unless_blank(xml, 'Zip', options[:pts_pod_request][:zip])
+					tag_unless_blank(xml, 'VerifyAddress', options[:pts_pod_request][:verify_address])
+					xml.tag!('TableCode', options[:pts_pod_request][:table_code])
+					tag_unless_blank(xml, 'CustRegID', options[:pts_pod_request][:cust_reg_id])
+					xml.target!
+				end
+
+			end
+		end
+	end
+end

data/lib/usps/api/endpoints/pts_rre.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+# This file was auto-generated by lib/tasks/api.rake
+
+module Usps
+	module Api
+		module Endpoints
+			module PTSRre
+				#
+				# Return Receipt Electronic API
+				#
+				# Overview
+				#
+				# @option option [(Alias)] :PTSRreRequest (Required)
+				#   @option option [String] :TrackId (Required)
+				#   @option option [String] :ClientIp (Optional)
+				#   @option option [String] :SourceId (Optional)
+				#   @option option [integer] :MpSuffix (Required)
+				#   @option option [String] :MpDate (Required)
+				#   @option option [String] :FirstName (Required)
+				#   @option option [String] :LastName (Required)
+				#   @option option [String] :Email1 (Required)
+				#   @option option [String] :Email2 (Optional)
+				#   @option option [String] :Email3 (Optional)
+				#   @option option [String] :TableCode (Required)
+				#   @option option [String] :CustRegID (Optional)
+
+				#
+				# @see 
+				def pts_rre(options = {})
+					throw ArgumentError.new('Required arguments :pts_rre_request missing') if options[:pts_rre_request].nil?
+					throw ArgumentError.new('Required arguments :pts_rre_request, :track_id missing') if options[:pts_rre_request][:track_id].nil?
+					throw ArgumentError.new('Required arguments :pts_rre_request, :mp_suffix missing') if options[:pts_rre_request][:mp_suffix].nil?
+					throw ArgumentError.new('Required arguments :pts_rre_request, :mp_date missing') if options[:pts_rre_request][:mp_date].nil?
+					throw ArgumentError.new('Required arguments :pts_rre_request, :first_name missing') if options[:pts_rre_request][:first_name].nil?
+					throw ArgumentError.new('Required arguments :pts_rre_request, :last_name missing') if options[:pts_rre_request][:last_name].nil?
+					throw ArgumentError.new('Required arguments :pts_rre_request, :email1 missing') if options[:pts_rre_request][:email1].nil?
+					throw ArgumentError.new('Required arguments :pts_rre_request, :table_code missing') if options[:pts_rre_request][:table_code].nil?
+
+					request = build_request(:pts_rre, options)
+					get('https://secure.shippingapis.com/ShippingAPI.dll', {
+						API: 'PTSRre',
+						XML: request,
+					})
+				end
+
+				private
+
+				def tag_unless_blank(xml, tag_name, data)
+					xml.tag!(tag_name, data) unless data.blank? || data.nil?
+				end
+
+				def build_pts_rre_request(xml, options = {})
+					xml.tag!('TrackId', options[:pts_rre_request][:track_id])
+					tag_unless_blank(xml, 'ClientIp', options[:pts_rre_request][:client_ip])
+					tag_unless_blank(xml, 'SourceId', options[:pts_rre_request][:source_id])
+					xml.tag!('MpSuffix', options[:pts_rre_request][:mp_suffix])
+					xml.tag!('MpDate', options[:pts_rre_request][:mp_date])
+					xml.tag!('FirstName', options[:pts_rre_request][:first_name])
+					xml.tag!('LastName', options[:pts_rre_request][:last_name])
+					xml.tag!('Email1', options[:pts_rre_request][:email1])
+					tag_unless_blank(xml, 'Email2', options[:pts_rre_request][:email2])
+					tag_unless_blank(xml, 'Email3', options[:pts_rre_request][:email3])
+					xml.tag!('TableCode', options[:pts_rre_request][:table_code])
+					tag_unless_blank(xml, 'CustRegID', options[:pts_rre_request][:cust_reg_id])
+					xml.target!
+				end
+
+			end
+		end
+	end
+end