usps-ruby-client 0.1.0 → 0.1.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (27) hide show
  1. checksums.yaml +4 -4
  2. data/lib/tasks/api.rake +1 -1
  3. data/lib/usps/api/endpoints/carrier_pickup_schedule.rb +22 -47
  4. data/lib/usps/api/endpoints/city_state_lookup.rb +5 -12
  5. data/lib/usps/api/endpoints/e_vs_express_mail_intl.rb +108 -217
  6. data/lib/usps/api/endpoints/e_vs_first_class_mail_intl.rb +95 -191
  7. data/lib/usps/api/endpoints/e_vs_priority_mail_intl.rb +109 -221
  8. data/lib/usps/api/endpoints/e_vsgxg_get_label.rb +103 -208
  9. data/lib/usps/api/endpoints/e_vsi_cancel.rb +5 -12
  10. data/lib/usps/api/endpoints/hfp_facility_info.rb +8 -20
  11. data/lib/usps/api/endpoints/intl_rate_v2.rb +31 -66
  12. data/lib/usps/api/endpoints/pts_email.rb +14 -20
  13. data/lib/usps/api/endpoints/pts_pod.rb +23 -29
  14. data/lib/usps/api/endpoints/pts_rre.rb +15 -21
  15. data/lib/usps/api/endpoints/ptst_pod.rb +16 -22
  16. data/lib/usps/api/endpoints/rate_v4.rb +34 -72
  17. data/lib/usps/api/endpoints/scan.rb +27 -58
  18. data/lib/usps/api/endpoints/track_v2.rb +9 -15
  19. data/lib/usps/api/endpoints/usps_returns_label.rb +33 -70
  20. data/lib/usps/api/endpoints/verify.rb +13 -30
  21. data/lib/usps/api/endpoints/zip_code_lookup.rb +11 -25
  22. data/lib/usps/api/templates/_options.erb +1 -4
  23. data/lib/usps/api/templates/method.erb +4 -8
  24. data/lib/usps/version.rb +1 -1
  25. data/usps-ruby-client-0.1.0.gem +0 -0
  26. data/usps-ruby-client.gemspec +1 -0
  27. metadata +16 -1
data/lib/usps/api/endpoints/e_vs_first_class_mail_intl.rb CHANGED
@@ -6,201 +6,105 @@ module Usps
6
6
  module Api
7
7
  module Endpoints
8
8
  module EVSFirstClassMailIntl
9
- #
10
- # eVS First Class Mail International Label API
11
- #
12
9
  # The
13
10
  # First Class Mail International Label API lets
14
11
  # customers generate First Class International labels given the weight and
15
12
  # dimensions of the item. 
16
- #
17
- # @option option [(Alias)] :eVSFirstClassMailIntlRequest (Required)
18
- # @option option [String] :PASSWORD (Optional)
19
- # - For backward compatibility; not validated.
20
- # @option option [Empty] :Option (Optional)
21
- # - For future use.
22
- # @option option [String] :Revision (Required)
23
- # - Use of value 2 Required as of January 2011. For example: <Revision>2</Revision>
24
- # @option option [(Group)] :ImageParameters (Optional)
25
- # - Groups alternate image options.
26
- # @option option [String] :ImageParameter (Optional)
27
- # - Returns alternate label image. Only alternate 4’’x6’’ size label image may be requested at this time. · 4X6LABEL - (4X6 on a full page 8.5/11” background) · 4X6LABELL - (Landscape – true size 4X6; image rotated, not on an 8.5 x 11 background page) · 4X6LABELP- (Portrait – true size 4X6, not on an 8.5 x 11 background page) · 4X6ZPL203DPI - (ZPL - Zebra Programming Language) format. When using this enumeration, <ImageType> is required - this tag cannot be left blank. Integrators should use either “TIF” or “PDF” for ZPL – neither value will impact the label image itself, but it must be included in the request to return a successful response. · 4X6ZPL300DPI - Prints a label formatted for ZPL printers in 300 dpi. When using this enumeration, <ImageType> is required - this tag cannot be left blank. Integrators should use either “TIF” or “PDF” for ZPL – neither value will impact the label image itself, but it must be included in the request to return a successful response. For example: <ImageParameter>4X6LABEL</ImageParameter>
28
- # @option option [String] :FromFirstName (Required)
29
- # - Both FromFirstName and FromLastName are Required if FromFirmName is left blank. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name. For example: <FromFirstName>John</FromFirstName>
30
- # @option option [String] :FromMiddleInitial (Optional)
31
- # - Middle Initial. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name. For example: <FromMiddleInitial>L</FromMiddleInitial>
32
- # @option option [String] :FromLastName (Required)
33
- # - Both FromFirstName and FromLastName are Required if FromFirmName is left blank. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name. For example: <FromLastName>Doe</FromLastName>
34
- # @option option [String] :FromFirm (Required)
35
- # - FromFirm is Required if FromFirstName and FromLastName are left blank. For example: <FromFirm>XYZ</FromFirm>
36
- # @option option [String] :FromAddress1 (Optional)
37
- # - Use this tag for a suite or apartment number only. For example: <FromAddress1>Suite 100</FromAddress1>
38
- # @option option [String] :FromAddress2 (Required)
39
- # - Use this tag for the primary address line. For example: <FromAddress2>10 Elm Street</FromAddress2>
40
- # @option option [String] :FromUrbanization (Optional)
41
- # - Use this tag for Puerto Rico only. ZIP Code prefixes 006 to 009, if area is so designated. For example:<FromUrbanization>URB Caparra Ter</FromUrbanization>
42
- # @option option [String] :FromCity (Required)
43
- # - Use this tag to specify originating city. For example: <FromCity>Anytown</FromCity>
44
- # @option option [String] :FromState (Required)
45
- # - Use 2-letter USPS abbreviation. For example: <FromState>AK</FromState>
46
- # @option option [String] :FromZip5 (Required)
47
- # - Five-digit valid ZIP code Required. For example: <FromZip5>01234</FromZip5>
48
- # @option option [String] :FromZip4 (Optional)
49
- # - If value is entered, four digits are Required. Must be a valid ZIP+4 extension. For example: <FromZip4>5678</FromZip4>
50
- # @option option [String] :FromPhone (Required)
51
- # - 10 digits Required (including area code), with no punctuation. Use format: 2125551234 For example: <FromPhone>5555555555</FromPhone>
52
- # @option option [String] :ToName (Optional)
53
- # - Deprecated. See “ToFirstName” and “ToLastName” tags.
54
- # @option option [String] :ToFirstName (Required)
55
- # - Both ToFirstName and ToLastName are Required if ToFirm is left blank. For example: <ToFirstName>John</ToFirstName>
56
- # @option option [String] :ToLastName (Required)
57
- # - Both ToFirstName and ToLastName are Required if ToFirm is left blank. For example: <ToLastName>Doe</ToLastName>
58
- # @option option [String] :ToFirm (Required)
59
- # - ToFirm is Required if ToFirstName and ToLastName are left blank. For example: <ToFirm></ToFirm>
60
- # @option option [String] :ToAddress1 (Optional)
61
- # - Three address lines are provided, but only one is Required. Use as many as needed for complete address. For example: <ToAddress1>Apartado 3068</ToAddress1>
62
- # @option option [String] :ToAddress2 (Required)
63
- # - Three address lines are provided, but only one is Required. Use as many as needed for complete address.
64
- # @option option [String] :ToAddress3 (Optional)
65
- # - Three address lines are provided, but only one is Required. Use as many as needed for complete address.
66
- # @option option [String] :ToCity (Required)
67
- # - Recipient's city. For example: <ToCity>PUERTO VALLARTA</ToCity>
68
- # @option option [String] :ToProvince (Optional)
69
- # - Enter the province for the recipient. For example: <ToProvince>JALISCO</ToProvince>
70
- # @option option [String] :ToCountry (Required)
71
- # - The country name entered must match an entry from the USPS-approved International Index of Countries and Localities or be "United States". (http://pe.usps.gov/text/Imm/Immctry.htm - click on the link for "International Country Listings.") Using a country name not on the list will result in a request failure. For example: <ToCountry>MEXICO</ToCountry>
72
- # @option option [String] :ToPostalCode (Required)
73
- # - Enter the postal code for the recipient. For example: <ToPostalCode>46807</ToPostalCode>
74
- # @option option [String] :ToPOBoxFlag (Required)
75
- # - Indicates whether or not the To Address is a Post Office Box. For example: <ToPOBoxFlag>N</ToPOBoxFlag>
76
- # @option option [String] :ToPhone (Optional)
77
- # - No format checking is done on international phone numbers. Required when FirstClassMailIntlRequest[ToPOBoxFlag='Y']. For example: <ToPhone>011 52 (322) 222-0069</ToPhone>
78
- # @option option [String] :ToFax (Optional)
79
- # - No format checking is done on international fax numbers. For example: <ToFax>011 52 (322) 222-0074</ToFax>
80
- # @option option [String] :ToEmail (Optional)
81
- # - One single, complete, and valid e-mail address is Required if tag is used. For example: <ToEmail>cpapple@email.com</ToEmail>
82
- # @option option [String] :FirstClassMailType (Optional)
83
- # - Used to determine the postage rate. See also FirstClassMailIntlRequest/Machinable. For example: <FirstClassMailType>PACKAGE SERVICE</FirstClassMailType>
84
- # @option option [(Group)] :ShippingContents (Required)
85
- # @option option [(Group)] :ItemDetail (Optional)
86
- # @option option [String] :Description (Required)
87
- # - Description of the item. Non-descriptive wording such as 'Gift' will result in an error. For example: <Description>Policy guidelines document</Description>
88
- # @option option [Integer] :Quantity (Required)
89
- # - Quantity of the item. Integer value Required. For example: <Quantity>1</Quantity>
90
- # @option option [Decimal] :Value (Required)
91
- # - The data entered with this tag provides the value of the set of items. If the item is 2 boxes of 50 pens and the value of each box is $10.00, "20.00" (2 boxes x $10.00) should be entered. If the value of each pen is .25 then "25.00" (100 pens x .25) should be entered. For example: <Value>55.00</Value>
92
- # @option option [Integer] :NetPounds (Required)
93
- # - Provide the pounds component of the weight of the individual item listed within this ItemDetail. For example: <NetPounds>1</NetPounds>
94
- # @option option [Decimal] :NetOunces (Required)
95
- # - Provide the ounces component of the weight of the individual item listed within this ItemDetail. For example: <NetOunces>5</NetOunces>
96
- # @option option [String] :HSTariffNumber (Required)
97
- # - For commercial items only. If known, the HS tariff number must be based on the Harmonized Commodity Description and Coding System developed by the World Customs Organization. For example: <HSTariffNumber>490110</HSTariffNumber>
98
- # @option option [String] :CountryOfOrigin (Required)
99
- # - For commercial items only. Country of Origin means the country where the goods originated, e.g. were produced, manufactured, or assembled. It is recommended you supply this information and attach an invoice to the outside to accelerate customs clearance in processing the items. The country name entered must match an entry from the USPS-approved International Index of Countries and Localities or be "United States". (http://pe.usps.gov/text/Imm/Immctry.htm - click on the link for "International Country Listings.") Using a country name not on the list will result in a request failure. For example: <CountryOfOrigin>United States</CountryOfOrigin>
100
- # @option option [String Decimal] :Postage (Optional)
101
- # - Use this tag for entering a postage amount, if known. If the tag is present, but the value is blank, the postage will be automatically calculated. For example: <Postage></Postage>
102
- # @option option [Integer] :GrossPounds (Required)
103
- # - Gross pounds and ounces together represent the total package weight, including packing material. For example, a package weighing 3 lbs 8 ounces would have "3" entered here and "8" entered with the "GrossOunces" tag. The Web Tool will check for maximum shipping weight of 70 pounds. Allowable weight may change based on the service used to send package and the destination country. For example: <GrossPounds>4</GrossPounds>
104
- # @option option [Integer] :GrossOunces (Required)
105
- # - Enter the ounces component of the total package weight with this tag. For example: <GrossOunces>0</GrossOunces>
106
- # @option option [Boolean] :Machinable (Optional)
107
- # - 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 for more information. For example: <Machinable>false</Machinable>
108
- # @option option [String] :ContentType (Required)
109
- # - Specifies the content of the package or envelope. For example: <ContentType>DOCUMENTS</ContentType>
110
- # @option option [String] :ContentTypeOther (Optional)
111
- # - Required when FirstClassMailIntlRequest[ContentType='OTHER'].
112
- # @option option [String] :Agreement (Required)
113
- # - Indicates the requestor's agreement to terms and conditions of mailing. Requires a value of Y to print and in Signature Box along with Current Date (Central Time USA). Any other value returns an error.
114
- # @option option [String] :Comments (Optional)
115
- # - For future use.
116
- # @option option [String] :LicenseNumber (Optional)
117
- # - For future use.
118
- # @option option [String] :CertificateNumber (Optional)
119
- # - For future use.
120
- # @option option [String] :InvoiceNumber (Optional)
121
- # - For future use.
122
- # @option option [String] :ImageType (Required)
123
- # - Label Image Type. Note: All <ImageType> values are ignored when <ImageParameter> = “4X6ZPL203DPI” or “4X6ZPL300DPI”. For example: <ImageType>PDF</ImageType>
124
- # @option option [String] :ImageLayout (Optional)
125
- # - Specified whether the pages are to be returned one per file or all in one file. The current FCMI label is one page so this tag has no effect. For example: <ImageLayout>ONEPERFILE</ImageLayout>
126
- # @option option [String] :CustomerRefNo (Optional)
127
- # - Written to Postal Manifest Detail record. For example: <CustomerRefNo>Ref 369246</CustomerRefNo>
128
- # @option option [String] :CustomerRefNo2 (Optional)
129
- # - Written to Postal Manifest Detail record For example: <CustomerRefNo2>ACT 369246</CustomerRefNo2>
130
- # @option option [String] :POZipCode (Optional)
131
- # - ZIP Code of Post Office or collection box where item is mailed. May be different than FromZip5. This tag will take precedence over FromZip5 when provided. For example: <POZipCode>00962</POZipCode>
132
- # @option option [String] :LabelDate (Optional)
133
- # - Date the mail will enter the mail stream. No more than three days in the future. Default is day of request. For example: <LabelDate>09/28/2010</LabelDate>
134
- # @option option [String] :HoldForManifest (Optional)
135
- # - Restricted use. Holds manifest record for possible inclusion in SCAN request.
136
- # @option option [String] :EELPFC (Optional)
137
- # - Exemption and Exclusion Legend or PFC Code. Currently Optional, in the future it may be Required for use. Please refer to the International Mail Manual for further information - http://pe.usps.gov/text/imm/immc5_007.htm. To activate check boxes use ”30.37a” or “30.37h”. For example: <EELPFC>30.37a</EELPFC>
138
- # @option option [String] :Container (Optional)
139
- # - This tag has been deprecated
140
- # @option option [Decimal] :Length (Optional)
141
- # - 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. Please reference https://about.usps.com/postalbulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing
142
- # @option option [Decimal] :Width (Optional)
143
- # - 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. Please reference https://about.usps.com/postalbulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing
144
- # @option option [Decimal] :Height (Optional)
145
- # - 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. Please reference https://about.usps.com/postalbulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing
146
- # @option option [Decimal] :Girth (Optional)
147
- # - 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. Please reference https://about.usps.com/postalbulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing
148
- # @option option [(Group)] :ExtraServices (Optional)
149
- # - Groups extra services elements
150
- # @option option [Extra Service Name] :ExtraService (Optional)
151
- # - [{"Extra Service Name"=>"e-USPS Delivery Confirmation International", "Service ID"=>"109"}]
152
- # @option option [String] :PriceOptions (Optional)
153
- # - Indicates if retail, commercial base or commercial plus pricing should be returned. For example: <PriceOptions>COMMERCIAL BASE</PriceOptions>
154
- # @option option [String] :ActionCode (Optional)
155
- # - Passed to SPE file via the shipment manifest.
156
- # @option option [boolean] :OptOutOfSPE (Optional)
157
- # - Allows a customer to opt out of SPE file creation. “false” WILL create a SPE file. Note: This request tag is case sensitive.
158
- # @option option [String] :PermitNumber (Optional)
159
- # - Number associated with a mailing permit. The permit is permission to use a certain postage payment method for bulk and commercial mailings
160
- # @option option [String] :AccountZipCode (Optional)
161
- # - ZIP of Account Post Office where mailed if different from <FromZip5/>. Written to Postal Manifest Detail record. Must be valid ZIP Code. For example: <AccountZipCode>00962</AccountZipCode>
162
- # @option option [boolean] :Machinable (Optional)
163
- # - 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 for more information. For example: <Machinable>false</Machinable>
164
- # @option option [String] :DestinationRateIndicator (Required)
165
- # - Required for destination entry packages · I = International Service Center (ISC) · N = None
166
- # @option option [String] :MID (Optional)
167
- # - Mailer ID (MID), Represents Mail Owner MID. Located in position #13 in the Detail 1 record of the Shipping Services File v2.0. For example: <MID>847654321</ MID>
168
- # @option option [String] :LogisticsManagerMID (Optional)
169
- # - The MID of the company that manages the mailing. Located in position #12 in the Detail 1 record of the Shipping Services File v2.0. Note: If LogisticsManagerMID is populated, either CRID or MID must also be populated. For example: <LogisticsManagerMID>489001</LogisticsManagerMID>
170
- # @option option [String] :CRID (Optional)
171
- # - Customer Registration ID, Represents Mail Owner CRID. Located in position #20 in the Detail 1 record of the Shipping Services File v2.0. For example: <CRID>544762</ CRID>
172
- # @option option [String] :VendorCode (Optional)
173
- # - Code from vendor software to identify the developer of the shipping system. Located in position #15 in the Detail 1 record of the Shipping Services File v2.0. For example: <VendorCode>1234<VendorCode>
174
- # @option option [String] :VendorProductVersionNumber (Optional)
175
- # - Shipping software’s product version number. Located in position #16 in the Detail 1 record of the Shipping Services File v2.0. For example: <VendorProductVersionNumber>5.02.1B</ VendorProductVersionNumber>
176
- # @option option [String] :ePostageMailerReporting (Optional)
177
- # - Verifies Sender Information, sender fields must match From information when <ePostageMailerReporting>=1 · 1 - (ePostage sender information in SSF) · 2 - (ePostage sender information through DES) · 3 - (ePostage sender information using child MID)
178
- # @option option [String] :SenderFirstName (Optional)
179
- # - First Name of Sender. For example: <SenderFirstName>Adam </ SenderFirstName> Required when <ePostageMailerReporting>=1
180
- # @option option [String] :SenderLastName (Optional)
181
- # - Last Name of Sender. For example: <SenderLastName>Smith </ SenderLastName> Required when <ePostageMailerReporting>=1
182
- # @option option [String] :SenderBusinessName (Optional)
183
- # - Values for Sender Business Name must be sent. For example: <SenderBusinessName>USPS</ SenderBusinessName>
184
- # @option option [String] :SenderAddress1 (Optional)
185
- # - Sender address line. Use this tag for full address (Address1 and Address2) Must match Address1 and Address2 or will produce an error. For example: <SenderAddress1>STE 150 10 Elm Street </SenderAddress1> Required when <ePostageMailerReporting>=1
186
- # @option option [String] :SenderCity (Optional)
187
- # - Sender city For example: <SenderCity>BETHESDA</ SenderCity> Required when <ePostageMailerReporting>=1
188
- # @option option [String] :SenderState (Optional)
189
- # - Sender state. For example: <SenderState>MD</ SenderState> Required when <ePostageMailerReporting>=1
190
- # @option option [String] :SenderZip5 (Optional)
191
- # - Sender ZIP code. For example: <SenderZip5>20212</SenderZip5> Required when <ePostageMailerReporting>=1
192
- # @option option [String] :SenderPhone (Optional)
193
- # - Sender Phone #. 10 digits Required (including area code), with no punctuation. For example: <SenderPhone>2125551234</ SenderPhone> Required when <ePostageMailerReporting>=1
194
- # @option option [String] :SenderEmail (Optional)
195
- # - E-mail Address of Sender. Valid e-mail addresses must be used. For example: <SenderEMail>cpapple@email.com</ SenderEMail> Required when <ePostageMailerReporting>=1
196
- # @option option [String] :RemainingBarcodes (Required)
197
- # - This contains the number of remaining barcodes that can be generated for this particular request.
198
- # @option option [String] :ChargebackCode (Optional)
199
- # - Used in Shipping Services File v2.0 for G-10 labels. Contact your Technical Integration Specialist for details.
200
-
201
- #
202
- # @see
203
- def e_vs_first_class_mail_intl(options = {})
13
+ # @param [Hash] options
14
+ # @option options [required, Hash] e_vs_first_class_mail_intl_request
15
+ # * *:password* (String) — For backward compatibility; not validated.
16
+ # * *:option* (Empty) — For future use.
17
+ # * *:revision* (required, String) — Use of value 2 Required as of January 2011. For example: <Revision>2</Revision>
18
+ # * *:image_parameters* (Hash) — Groups alternate image options.
19
+ # * *:image_parameter* (String) — Returns alternate label image. Only alternate 4’’x6’’ size label image may be requested at this time. · 4X6LABEL - (4X6 on a full page 8.5/11” background) · 4X6LABELL - (Landscape – true size 4X6; image rotated, not on an 8.5 x 11 background page) · 4X6LABELP- (Portrait – true size 4X6, not on an 8.5 x 11 background page) · 4X6ZPL203DPI - (ZPL - Zebra Programming Language) format. When using this enumeration, <ImageType> is required - this tag cannot be left blank. Integrators should use either “TIF” or “PDF” for ZPL – neither value will impact the label image itself, but it must be included in the request to return a successful response. · 4X6ZPL300DPI - Prints a label formatted for ZPL printers in 300 dpi. When using this enumeration, <ImageType> is required - this tag cannot be left blank. Integrators should use either “TIF” or “PDF” for ZPL – neither value will impact the label image itself, but it must be included in the request to return a successful response. For example: <ImageParameter>4X6LABEL</ImageParameter>
20
+ # * *:from_first_name* (required, String) — Both FromFirstName and FromLastName are Required if FromFirmName is left blank. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name. For example: <FromFirstName>John</FromFirstName>
21
+ # * *:from_middle_initial* (String) — Middle Initial. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name. For example: <FromMiddleInitial>L</FromMiddleInitial>
22
+ # * *:from_last_name* (required, String) — Both FromFirstName and FromLastName are Required if FromFirmName is left blank. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name. For example: <FromLastName>Doe</FromLastName>
23
+ # * *:from_firm* (required, String) — FromFirm is Required if FromFirstName and FromLastName are left blank. For example: <FromFirm>XYZ</FromFirm>
24
+ # * *:from_address1* (String) — Use this tag for a suite or apartment number only. For example: <FromAddress1>Suite 100</FromAddress1>
25
+ # * *:from_address2* (required, String) — Use this tag for the primary address line. For example: <FromAddress2>10 Elm Street</FromAddress2>
26
+ # * *:from_urbanization* (String) — Use this tag for Puerto Rico only. ZIP Code prefixes 006 to 009, if area is so designated. For example:<FromUrbanization>URB Caparra Ter</FromUrbanization>
27
+ # * *:from_city* (required, String) — Use this tag to specify originating city. For example: <FromCity>Anytown</FromCity>
28
+ # * *:from_state* (required, String) — Use 2-letter USPS abbreviation. For example: <FromState>AK</FromState>
29
+ # * *:from_zip5* (required, String) — Five-digit valid ZIP code Required. For example: <FromZip5>01234</FromZip5>
30
+ # * *:from_zip4* (String) — If value is entered, four digits are Required. Must be a valid ZIP+4 extension. For example: <FromZip4>5678</FromZip4>
31
+ # * *:from_phone* (required, String) — 10 digits Required (including area code), with no punctuation. Use format: 2125551234 For example: <FromPhone>5555555555</FromPhone>
32
+ # * *:to_name* (String) — Deprecated. See “ToFirstName” and “ToLastName” tags.
33
+ # * *:to_first_name* (required, String) — Both ToFirstName and ToLastName are Required if ToFirm is left blank. For example: <ToFirstName>John</ToFirstName>
34
+ # * *:to_last_name* (required, String) — Both ToFirstName and ToLastName are Required if ToFirm is left blank. For example: <ToLastName>Doe</ToLastName>
35
+ # * *:to_firm* (required, String) — ToFirm is Required if ToFirstName and ToLastName are left blank. For example: <ToFirm></ToFirm>
36
+ # * *:to_address1* (String) — Three address lines are provided, but only one is Required. Use as many as needed for complete address. For example: <ToAddress1>Apartado 3068</ToAddress1>
37
+ # * *:to_address2* (required, String) — Three address lines are provided, but only one is Required. Use as many as needed for complete address.
38
+ # * *:to_address3* (String) — Three address lines are provided, but only one is Required. Use as many as needed for complete address.
39
+ # * *:to_city* (required, String) — Recipient's city. For example: <ToCity>PUERTO VALLARTA</ToCity>
40
+ # * *:to_province* (String) — Enter the province for the recipient. For example: <ToProvince>JALISCO</ToProvince>
41
+ # * *:to_country* (required, String) — The country name entered must match an entry from the USPS-approved International Index of Countries and Localities or be "United States". (http://pe.usps.gov/text/Imm/Immctry.htm - click on the link for "International Country Listings.") Using a country name not on the list will result in a request failure. For example: <ToCountry>MEXICO</ToCountry>
42
+ # * *:to_postal_code* (required, String) — Enter the postal code for the recipient. For example: <ToPostalCode>46807</ToPostalCode>
43
+ # * *:to_po_box_flag* (required, String) — Indicates whether or not the To Address is a Post Office Box. For example: <ToPOBoxFlag>N</ToPOBoxFlag>
44
+ # * *:to_phone* (String) — No format checking is done on international phone numbers. Required when FirstClassMailIntlRequest[ToPOBoxFlag='Y']. For example: <ToPhone>011 52 (322) 222-0069</ToPhone>
45
+ # * *:to_fax* (String) — No format checking is done on international fax numbers. For example: <ToFax>011 52 (322) 222-0074</ToFax>
46
+ # * *:to_email* (String) — One single, complete, and valid e-mail address is Required if tag is used. For example: <ToEmail>cpapple@email.com</ToEmail>
47
+ # * *:first_class_mail_type* (String) — Used to determine the postage rate. See also FirstClassMailIntlRequest/Machinable. For example: <FirstClassMailType>PACKAGE SERVICE</FirstClassMailType>
48
+ # * *:shipping_contents* (required, Hash) —
49
+ # * *:item_detail* (Hash) —
50
+ # * *:description* (required, String) — Description of the item. Non-descriptive wording such as 'Gift' will result in an error. For example: <Description>Policy guidelines document</Description>
51
+ # * *:quantity* (required, Integer) — Quantity of the item. Integer value Required. For example: <Quantity>1</Quantity>
52
+ # * *:value* (required, Decimal) — The data entered with this tag provides the value of the set of items. If the item is 2 boxes of 50 pens and the value of each box is $10.00, "20.00" (2 boxes x $10.00) should be entered. If the value of each pen is .25 then "25.00" (100 pens x .25) should be entered. For example: <Value>55.00</Value>
53
+ # * *:net_pounds* (required, Integer) — Provide the pounds component of the weight of the individual item listed within this ItemDetail. For example: <NetPounds>1</NetPounds>
54
+ # * *:net_ounces* (required, Decimal) — Provide the ounces component of the weight of the individual item listed within this ItemDetail. For example: <NetOunces>5</NetOunces>
55
+ # * *:hs_tariff_number* (required, String) — For commercial items only. If known, the HS tariff number must be based on the Harmonized Commodity Description and Coding System developed by the World Customs Organization. For example: <HSTariffNumber>490110</HSTariffNumber>
56
+ # * *:country_of_origin* (required, String) — For commercial items only. Country of Origin means the country where the goods originated, e.g. were produced, manufactured, or assembled. It is recommended you supply this information and attach an invoice to the outside to accelerate customs clearance in processing the items. The country name entered must match an entry from the USPS-approved International Index of Countries and Localities or be "United States". (http://pe.usps.gov/text/Imm/Immctry.htm - click on the link for "International Country Listings.") Using a country name not on the list will result in a request failure. For example: <CountryOfOrigin>United States</CountryOfOrigin>
57
+ # * *:postage* (String Decimal) — Use this tag for entering a postage amount, if known. If the tag is present, but the value is blank, the postage will be automatically calculated. For example: <Postage></Postage>
58
+ # * *:gross_pounds* (required, Integer) — Gross pounds and ounces together represent the total package weight, including packing material. For example, a package weighing 3 lbs 8 ounces would have "3" entered here and "8" entered with the "GrossOunces" tag. The Web Tool will check for maximum shipping weight of 70 pounds. Allowable weight may change based on the service used to send package and the destination country. For example: <GrossPounds>4</GrossPounds>
59
+ # * *:gross_ounces* (required, Integer) — Enter the ounces component of the total package weight with this tag. For example: <GrossOunces>0</GrossOunces>
60
+ # * *:machinable* (Boolean) — 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 for more information. For example: <Machinable>false</Machinable>
61
+ # * *:content_type* (required, String) — Specifies the content of the package or envelope. For example: <ContentType>DOCUMENTS</ContentType>
62
+ # * *:content_type_other* (String) — Required when FirstClassMailIntlRequest[ContentType='OTHER'].
63
+ # * *:agreement* (required, String) — Indicates the requestor's agreement to terms and conditions of mailing. Requires a value of Y to print and in Signature Box along with Current Date (Central Time USA). Any other value returns an error.
64
+ # * *:comments* (String) — For future use.
65
+ # * *:license_number* (String) — For future use.
66
+ # * *:certificate_number* (String) — For future use.
67
+ # * *:invoice_number* (String) — For future use.
68
+ # * *:image_type* (required, String) — Label Image Type. Note: All <ImageType> values are ignored when <ImageParameter> = “4X6ZPL203DPI” or “4X6ZPL300DPI”. For example: <ImageType>PDF</ImageType>
69
+ # * *:image_layout* (String) — Specified whether the pages are to be returned one per file or all in one file. The current FCMI label is one page so this tag has no effect. For example: <ImageLayout>ONEPERFILE</ImageLayout>
70
+ # * *:customer_ref_no* (String) — Written to Postal Manifest Detail record. For example: <CustomerRefNo>Ref 369246</CustomerRefNo>
71
+ # * *:customer_ref_no2* (String) — Written to Postal Manifest Detail record For example: <CustomerRefNo2>ACT 369246</CustomerRefNo2>
72
+ # * *:po_zip_code* (String) — ZIP Code of Post Office or collection box where item is mailed. May be different than FromZip5. This tag will take precedence over FromZip5 when provided. For example: <POZipCode>00962</POZipCode>
73
+ # * *:label_date* (String) — Date the mail will enter the mail stream. No more than three days in the future. Default is day of request. For example: <LabelDate>09/28/2010</LabelDate>
74
+ # * *:hold_for_manifest* (String) — Restricted use. Holds manifest record for possible inclusion in SCAN request.
75
+ # * *:eelpfc* (String) — Exemption and Exclusion Legend or PFC Code. Currently Optional, in the future it may be Required for use. Please refer to the International Mail Manual for further information - http://pe.usps.gov/text/imm/immc5_007.htm. To activate check boxes use ”30.37a” or “30.37h”. For example: <EELPFC>30.37a</EELPFC>
76
+ # * *:container* (String) — This tag has been deprecated
77
+ # * *:length* (Decimal) — 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. Please reference https://about.usps.com/postalbulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing
78
+ # * *:width* (Decimal) — 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. Please reference https://about.usps.com/postalbulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing
79
+ # * *:height* (Decimal) — 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. Please reference https://about.usps.com/postalbulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing
80
+ # * *:girth* (Decimal) — 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. Please reference https://about.usps.com/postalbulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing
81
+ # * *:extra_services* (Hash) — Groups extra services elements
82
+ # * *:extra_service* (Extra Service Name) — [{"Extra Service Name"=>"e-USPS Delivery Confirmation International", "Service ID"=>"109"}]
83
+ # * *:price_options* (String) — Indicates if retail, commercial base or commercial plus pricing should be returned. For example: <PriceOptions>COMMERCIAL BASE</PriceOptions>
84
+ # * *:action_code* (String) — Passed to SPE file via the shipment manifest.
85
+ # * *:opt_out_of_spe* (boolean) — Allows a customer to opt out of SPE file creation. “false” WILL create a SPE file. Note: This request tag is case sensitive.
86
+ # * *:permit_number* (String) — Number associated with a mailing permit. The permit is permission to use a certain postage payment method for bulk and commercial mailings
87
+ # * *:account_zip_code* (String) — ZIP of Account Post Office where mailed if different from <FromZip5/>. Written to Postal Manifest Detail record. Must be valid ZIP Code. For example: <AccountZipCode>00962</AccountZipCode>
88
+ # * *:machinable* (boolean) — 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 for more information. For example: <Machinable>false</Machinable>
89
+ # * *:destination_rate_indicator* (required, String) — Required for destination entry packages · I = International Service Center (ISC) · N = None
90
+ # * *:mid* (String) — Mailer ID (MID), Represents Mail Owner MID. Located in position #13 in the Detail 1 record of the Shipping Services File v2.0. For example: <MID>847654321</ MID>
91
+ # * *:logistics_manager_mid* (String) — The MID of the company that manages the mailing. Located in position #12 in the Detail 1 record of the Shipping Services File v2.0. Note: If LogisticsManagerMID is populated, either CRID or MID must also be populated. For example: <LogisticsManagerMID>489001</LogisticsManagerMID>
92
+ # * *:crid* (String) — Customer Registration ID, Represents Mail Owner CRID. Located in position #20 in the Detail 1 record of the Shipping Services File v2.0. For example: <CRID>544762</ CRID>
93
+ # * *:vendor_code* (String) — Code from vendor software to identify the developer of the shipping system. Located in position #15 in the Detail 1 record of the Shipping Services File v2.0. For example: <VendorCode>1234<VendorCode>
94
+ # * *:vendor_product_version_number* (String) — Shipping software’s product version number. Located in position #16 in the Detail 1 record of the Shipping Services File v2.0. For example: <VendorProductVersionNumber>5.02.1B</ VendorProductVersionNumber>
95
+ # * *:e_postage_mailer_reporting* (String) — Verifies Sender Information, sender fields must match From information when <ePostageMailerReporting>=1 · 1 - (ePostage sender information in SSF) · 2 - (ePostage sender information through DES) · 3 - (ePostage sender information using child MID)
96
+ # * *:sender_first_name* (String) — First Name of Sender. For example: <SenderFirstName>Adam </ SenderFirstName> Required when <ePostageMailerReporting>=1
97
+ # * *:sender_last_name* (String) — Last Name of Sender. For example: <SenderLastName>Smith </ SenderLastName> Required when <ePostageMailerReporting>=1
98
+ # * *:sender_business_name* (String) — Values for Sender Business Name must be sent. For example: <SenderBusinessName>USPS</ SenderBusinessName>
99
+ # * *:sender_address1* (String) — Sender address line. Use this tag for full address (Address1 and Address2) Must match Address1 and Address2 or will produce an error. For example: <SenderAddress1>STE 150 10 Elm Street </SenderAddress1> Required when <ePostageMailerReporting>=1
100
+ # * *:sender_city* (String) — Sender city For example: <SenderCity>BETHESDA</ SenderCity> Required when <ePostageMailerReporting>=1
101
+ # * *:sender_state* (String) — Sender state. For example: <SenderState>MD</ SenderState> Required when <ePostageMailerReporting>=1
102
+ # * *:sender_zip5* (String) — Sender ZIP code. For example: <SenderZip5>20212</SenderZip5> Required when <ePostageMailerReporting>=1
103
+ # * *:sender_phone* (String) — Sender Phone #. 10 digits Required (including area code), with no punctuation. For example: <SenderPhone>2125551234</ SenderPhone> Required when <ePostageMailerReporting>=1
104
+ # * *:sender_email* (String) — E-mail Address of Sender. Valid e-mail addresses must be used. For example: <SenderEMail>cpapple@email.com</ SenderEMail> Required when <ePostageMailerReporting>=1
105
+ # * *:remaining_barcodes* (required, String) — This contains the number of remaining barcodes that can be generated for this particular request.
106
+ # * *:chargeback_code* (String) — Used in Shipping Services File v2.0 for G-10 labels. Contact your Technical Integration Specialist for details.
107
+ def e_vs_first_class_mail_intl(options = {})
204
108
  throw ArgumentError.new('Required arguments :e_vs_first_class_mail_intl_request missing') if options[:e_vs_first_class_mail_intl_request].nil?
205
109
  throw ArgumentError.new('Required arguments :e_vs_first_class_mail_intl_request, :revision missing') if options[:e_vs_first_class_mail_intl_request][:revision].nil?
206
110
 
data/lib/usps/api/endpoints/e_vs_priority_mail_intl.rb CHANGED
@@ -6,230 +6,118 @@ module Usps
6
6
  module Api
7
7
  module Endpoints
8
8
  module EVSPriorityMailIntl
9
- #
10
- # eVS Priority Mail International Label API
11
- #
12
9
  # The
13
10
  # eVS Priority Mail Express International Label API lets customers generate eVS Priority
14
11
  # Mail Express International labels given the weight and dimensions of the item.
15
- #
16
- # @option option [(Alias)] :eVSPriorityMailIntRequest (Required)
17
- # - Produces a Priority Mail International label with customs declaration
18
- # @option option [Empty] :Option (Optional)
19
- # - For future use.
20
- # @option option [String] :Revision (Required)
21
- # - Use of value 2 Required as of January 2011. For example: <Revision>2</Revision>
22
- # @option option [(Group)] :ImageParameters (Optional)
23
- # - Groups alternate image options.
24
- # @option option [String] :ImageParameter (Optional)
25
- # - Returns alternate label image. Only alternate 4’’x6’’ size label image may be requested at this time. · 4X6LABEL - (4X6 on a full page 8.5/11” background) · 4X6LABELL - (Landscape – true size 4X6; image rotated, not on an 8.5 x 11 background page) · 4X6LABELP - (Portrait – true size 4X6, not on an 8.5 x 11 background page) · 4X6ZPL203DPI - (ZPL - Zebra Programming Language) format. When using this enumeration, <ImageType> is required - this tag cannot be left blank. Integrators should use either “TIF” or “PDF” for ZPL – neither value will impact the label image itself, but it must be included in the request to return a successful response. · 4X6ZPL300DPI - Prints a label formatted for ZPL printers in 300 dpi. When using this enumeration, <ImageType> is required - this tag cannot be left blank. Integrators should use either “TIF” or “PDF” for ZPL – neither value will impact the label image itself, but it must be included in the request to return a successful response. For example: <ImageParameter>4X6LABEL</ImageParameter>
26
- # @option option [String] :FromFirstName (Required)
27
- # - Both FromFirstName and FromLastName are Required if FromFirmName is left blank. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name. For example: <FromFirstName>John</FromFirstName>
28
- # @option option [String] :FromMiddleInitial (Optional)
29
- # - Middle Initial. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name. For example: <FromMiddleInitial>L</FromMiddleInitial>
30
- # @option option [String] :FromLastName (Required)
31
- # - Both FromFirstName and FromLastName are Required if FromFirmName is left blank. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name. For example: <FromLastName>Doe</FromLastName>
32
- # @option option [String] :FromFirm (Required)
33
- # - FromFirm is Required if FromFirstName and FromLastName are left blank. For example: <FromFirm>XYZ</FromFirm>
34
- # @option option [String] :FromAddress1 (Optional)
35
- # - Use this tag for a suite or apartment number only. Either Address1 or Address2 is Required. For example: <FromAddress1>Suite 100</FromAddress1>
36
- # @option option [String] :FromAddress2 (Required)
37
- # - Use this tag for the primary address line. For example: <FromAddress2>10 Elm Street </FromAddress2>
38
- # @option option [String] :FromUrbanization (Optional)
39
- # - Use this tag for Puerto Rico only. ZIP Code prefixes 006 to 009, if area is so designated. For example: <FromUrbanization>URB Caparra Ter</FromUrbanization>
40
- # @option option [String] :FromCity (Required)
41
- # - For example: <FromCity>Anytown</FromCity>
42
- # @option option [String] :FromState (Required)
43
- # - Use 2-letter USPS abbreviation. For example: <FromState>ST</FromState>
44
- # @option option [String] :FromZip5 (Required)
45
- # - Input tag exactly as presented, not all caps. 5 digits Required. For example: <FromZip5>01234</FromZip5>
46
- # @option option [String] :FromZip4 (Optional)
47
- # - Input tag exactly as presented, not all caps. If value is entered, 4 digits Required. This is the ZIP+4 extension. For example: <FromZip4>5678</FromZip4>
48
- # @option option [String] :FromPhone (Required)
49
- # - 10 digits Required (including area code), with no punctuation. Use format: 2125551234 For example: <FromPhone>5555555555</FromPhone>
50
- # @option option [String] :FromCustomsReference (Optional)
51
- # - Enter a value for the "Sender's Customs Reference" that will appear on the label. The text entered is any reference number that the sender wishes to use. For example: <FromCustomsReference> 45655332 </FromCustomsReference>
52
- # @option option [String] :ToName (Optional)
53
- # - Deprecated. See “ToFirstName” and “ToLastName” tags.
54
- # @option option [String] :ToFirstName (Required)
55
- # - Both ToFirstName and ToLastName are Required if ToFirm is left blank. For example: <ToFirstName>John</ToFirstName>
56
- # @option option [String] :ToLastName (Required)
57
- # - Both ToFirstName and ToLastName are Required if ToFirm is left blank. For example: <ToLastName>Doe</ToLastName>
58
- # @option option [String] :ToFirm (Required)
59
- # - ToFirm is Required if ToFirstName and ToLastName are left blank. For example: <ToFirm>YYZ</ToFirm>
60
- # @option option [String] :ToAddress1 (Optional)
61
- # - Three address lines are provided, but only 1 is Required. Use as many as needed for complete address. For example: <ToAddress1> Apartado 3068</ToAddress1>
62
- # @option option [String] :ToAddress2 (Required)
63
- # - Three address lines are provided, but only 1 is Required. Use as many as needed for complete address.
64
- # @option option [String] :ToAddress3 (Optional)
65
- # - Three address lines are provided, but only 1 is Required. Use as many as needed for complete address.
66
- # @option option [String] :ToCity (Required)
67
- # - Recipient's city. For example: <ToCity>Puerto Vallarta</ToCity>
68
- # @option option [String] :ToProvince (Optional)
69
- # - Enter the province for the recipient. For example: <ToProvince>Jalisco</ToProvince>
70
- # @option option [String] :ToCountry (Required)
71
- # - The country name entered must match an entry from the USPS-approved International Index of Countries and Localities. (http://pe.usps.gov/text/Imm/Immctry.htm - click on the link for "International Country Listings.") Using a country name not on the list will result in a request failure. For example: <ToCountry>Mexico</ToCountry>
72
- # @option option [String] :ToPostalCode (Required)
73
- # - Enter the postal code for the recipient. For example: <ToPostalCode>46807</ToPostalCode>
74
- # @option option [String] :ToPOBoxFlag (Required)
75
- # - Indicates whether the destination address is a Post Office Box. For example: <ToPOBoxFlag>N</ToPOBoxFlag>
76
- # @option option [String] :ToPhone (Optional)
77
- # - No format checking is done on international phone numbers. Required when <ToPOBoxFlag>Y</ToPOBoxFlag> For example: <ToPhone>011 52 (322) 222-0069</ToPhone>
78
- # @option option [String] :ToFax (Optional)
79
- # - No format checking is done on international fax numbers. For example: <ToFax>011 52 (322) 222-0074</ToFax>
80
- # @option option [String] :ToEmail (Optional)
81
- # - Complete valid e-mail address is Required if tag is used. For example: <ToEmail>cpapple@email.com</ToEmail>
82
- # @option option [String] :ImportersReferenceNumber (Optional)
83
- # - Enter a value for the "Recipient's Reference" that will appear on the label. The text entered is any reference number that the recipient wishes to use. For example: <ImportersReferenceNumber>Order 23432</ImportersReferenceNumber>
84
- # @option option [String] :NonDeliveryOption (Optional)
85
- # - In case package is undeliverable, enter one of the following: · "RETURN" for package to be returned to <FromAddress> above. · "REDIRECT" to return package to address specified below in <AltReturn…> tags. · "ABANDON" to dispose of undeliverable package. For example: <NonDeliveryOption>RETURN</NonDeliveryOption>
86
- # @option option [String] :RedirectName (Optional)
87
- # - Enter a value for the recipient's name.
88
- # @option option [String] :RedirectEmail (Optional)
89
- # - Complete valid e-mail address is Required if tag is used.
90
- # @option option [String] :RedirectSMS (Optional)
91
- # - This value must be a syntactically-valid SMS number.
92
- # @option option [String] :RedirectAddress (Optional)
93
- # - Enter the redirect address. This is a free form field.
94
- # @option option [String] :RedirectCity (Optional)
95
- # - Redirect city. For example: <RedirectCity>Anytown</RedirectCity>
96
- # @option option [String] :RedirectState (Optional)
97
- # - Redirect state. For example: <RedirectState>MN</RedirectState>
98
- # @option option [String] :RedirectZipCode (Optional)
99
- # - Redirect ZIP code. For example: <RedirectZipCode>12345</RedirectZipCode>
100
- # @option option [String] :RedirectZip4 (Optional)
101
- # - Redirect ZIP+4 extension. For example: <ToZip5>01234</ToZip5>
102
- # @option option [String] :Container (Optional)
103
- # - For example: <Container>MDFLATRATEBOX</Container> Otherwise, use to specify special containers or container attributes that may affect postage.
104
- # @option option [(Group)] :ShippingContents (Required)
105
- # @option option [(Group)] :ItemDetail (Optional)
106
- # - Groups individual item details
107
- # @option option [String] :Description (Required)
108
- # - Description of the item. For example: <Description>Policy guidelines document</Description>
109
- # @option option [Integer] :Quantity (Required)
110
- # - Quantity of the item. Integer value Required. For example: <Quantity>1</Quantity>
111
- # @option option [Decimal] :Value (Required)
112
- # - The data entered with this tag provides the value of the set of items. For example: If the item is 2 boxes of 50 pens and the value of each box is $10.00, "20.00" (2 boxes x $10.00) should be entered. If the value of each pen is .25 then "25.00" (100 pens x .25) should be entered. For example: <Value>55.00</Value>
113
- # @option option [Integer] :NetPounds (Required)
114
- # - Provide the pounds component of the weight of the individual item listed with <Description>. For example: <NetPounds>1</NetPounds>
115
- # @option option [Decimal] :NetOunces (Required)
116
- # - Provide the ounces component of the weight of the individual item listed with <Description>. For example: <NetOunces>5</NetOunces>
117
- # @option option [String] :HSTariffNumber (Required)
118
- # - For commercial items only. If known, the HS tariff number must be based on the Harmonized Commodity Description and Coding System developed by the World Customs Organization. For example: <HSTariffNumber>490110</HSTariffNumber>
119
- # @option option [String] :CountryOfOrigin (Required)
120
- # - For commercial items only. Country of Origin means the country where the goods originated, e.g. were produced, manufactured, or assembled. It is recommended you supply this information and attach an invoice to the outside to accelerate customs clearance in processing the items. The country name entered must match an entry from the USPS-approved International Index of Countries and Localities or be "United States". (http://pe.usps.gov/text/Imm/Immctry.htm - click on the link for "International Country Listings.") Using a country name not on the list will result in a request failure. For example: <CountryOfOrigin>United States</CountryOfOrigin>
121
- # @option option [String] :Insured (Optional)
122
- # - Restricted use: authorized users may indicate with a value of Y that the item is insured for purposes of obtaining a barcode number from the insured range. All other users must specify N or omit.
123
- # @option option [String] :InsuredNumber (Optional)
124
- # - For backward-compatibility; not validated.
125
- # @option option [Decimal] :InsuredAmount (Optional)
126
- # - Use this tag for entering an insurance amount, if known. For example: <InsuredAmount>100.00</InsuredAmount>
127
- # @option option [Decimal] :Postage (Optional)
128
- # - Use this tag for entering a postage amount, if known. If the tag is present, but the value is blank, the postage will be automatically calculated. For example: <Postage></Postage>
129
- # @option option [Integer] :GrossPounds (Required)
130
- # - Gross pounds and ounces together represent the total package weight, including packing material. For example, a package weighing 3 lbs 8 ounces would have "3" entered here and "8" entered with the <GrossOunces> tag. WebTools will check for maximum shipping weight of 70 pounds. Allowable weight may change based on the service used to send package and the destination country. For example: <GrossPounds>4</GrossPounds>
131
- # @option option [Integer] :GrossOunces (Required)
132
- # - Enter the ounces component of the total package weight with this tag. For example: <GrossOunces>0</GrossOunces>
133
- # @option option [String] :ContentType (Required)
134
- # - Specifies the content of the package or envelope. For example: <ContentType>DOCUMENTS</ContentType> Note : “NonnegotiableDocument” and “Documents” both signify mailable non-negotiable documents and are insured automatically for up to $100. Additional Insurance cannot be purchased. Any non-document <ContentType> values are insured automatically for up to $200. Additional Insurance can be purchased for values $200 and greater.
135
- # @option option [String] :ContentTypeOther (Optional)
136
- # - Required when <ContentType>OTHER<ContentType>. Maximum length enforced via truncation
137
- # @option option [String] :Agreement (Required)
138
- # - Requires a value of Y to print <FromFirstName/> and <FromLastName/> in Signature Box along with Current Date (Central Time USA). Any other value returns an error.
139
- # @option option [String] :Comments (Optional)
140
- # - Enter any comments. For example: <Comments></Comments>
141
- # @option option [String] :LicenseNumber (Optional)
142
- # - Enter license number, if known or if included in package. For example: <LicenseNumber>LIC-24356879</LicenseNumber>
143
- # @option option [String] :CertificateNumber (Optional)
144
- # - Enter certificate number, if known or if included in package. For example: <CertificateNumber>CERT-97865342</CertificateNumber>
145
- # @option option [String] :InvoiceNumber (Optional)
146
- # - Enter invoice number, if known or if included in package. For example: <InvoiceNumber>INV-040903</InvoiceNumber>
147
- # @option option [String] :ImageType (Required)
148
- # - Label Image Type. Note: All <ImageType> values are ignored when <ImageParameter> = “4X6ZPL203DPI” or “4X6ZPL300DPI”. For example: <ImageType>PDF</ImageType>
149
- # @option option [String] :ImageLayout (Optional)
150
- # - Controls how the multipage form is returned in the response tags. "ONEPERFILE" returns one page per response tag while “ALLINONEFILE” returns all pages in a single response tag. The “TRIM” options conserve page space if possible by combining two form parts on a single page. For example: <ImageLayout>ONEPERFILE<ImageLayout>
151
- # @option option [String] :CustomerRefNo (Optional)
152
- # - Written to Postal Manifest Detail record. For example: <CustomerRefNo>Ref 369246</CustomerRefNo>
153
- # @option option [String] :CustomerRefNo2 (Optional)
154
- # - Written to Postal Manifest Detail record. For example: <CustomerRefNo2>ACT369246</CustomerRefNo2>
155
- # @option option [String] :POZipCode (Optional)
156
- # - ZIP Code of Post Office or collection box where item is mailed. May be different than FromZip5. This tag will take precedence over FromZip5 when provided. For example: <POZipCode>00962</POZipCode>
157
- # @option option [String] :LabelDate (Optional)
158
- # - Date the mail will enter the mail stream. No more than 3 days in the future. Default is day of request. For example: <LabelDate>09/28/2010</LabelDate>
159
- # @option option [String] :HoldForManifest (Optional)
160
- # - Restricted use. Holds manifest record for possible inclusion in SCAN request.
161
- # @option option [String] :EELPFC (Optional)
162
- # - Exemption and Exclusion Legend or PFC Code. Use in conjunction with Revision tag with value of 1 to indicate and trigger new functionality. Please refer to the International Mail Manual for further information - http://pe.usps.gov/text/imm/immc5_007.htm. To activate check boxes use ”30.37a” or “30.37h”. For example: <EELPFC>30.37a</EELPFC>
163
- # @option option [String] :PriceOptions (Optional)
164
- # - Price option for package.
165
- # @option option [Decimal] :Length (Optional)
166
- # - 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. Please reference https://about.usps.com/postalbulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing
167
- # @option option [Decimal] :Width (Optional)
168
- # - 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. Please reference https://about.usps.com/postalbulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing
169
- # @option option [Decimal] :Height (Optional)
170
- # - 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. Please reference https://about.usps.com/postalbulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing
171
- # @option option [Decimal] :Girth (Optional)
172
- # - 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. Please reference https://about.usps.com/postalbulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing
173
- # @option option [(Group)] :ExtraServices (Optional)
174
- # - Groups extra services elements
175
- # @option option [Extra Service Name] :ExtraService (Optional)
176
- # - [{"Extra Service Name"=>"e-USPS Return Receipt", "Service ID"=>"105"}]
177
- # @option option [String] :ActionCode (Optional)
178
- # - Used to specify the action code. Value is included in the Shipping Partner Event file for customers who have chose to have a Shipping Partner Event file submitted to USPS on their behalf. M0 – Mailer Owner S0 – Service Provider For example: <ActionCode>M0</ActionCode>
179
- # @option option [Boolean] :OptOutOfSPE (Optional)
180
- # - Allows a customer to opt out of SPE file creation. “false” WILL create a SPE file. Note: This request tag is case sensitive.
181
- # @option option [String] :PermitNumber (Optional)
182
- # - Number associated with a mailing permit. The permit is permission to use a certain postage payment method for bulk and commercial mailings
183
- # @option option [String] :AccountZipCode (Optional)
184
- # - ZIP of Account Post Office where mailed if different from <FromZip5/>. Written to Postal Manifest Detail record. Must be valid ZIP Code. For example: <AccountZipCode>00962</AccountZipCode>
185
- # @option option [String] :ImportersReferenceType (Optional)
186
- # - Tax code / VAT no. / Importer Code.
187
- # @option option [String] :ImportersTelephoneNumber (Optional)
188
- # - For Importer: 10 digits (including area code), with no punctuation. Use format: 2125551234 For example: <ImportersTelephoneNumber>5555555555</ImportersTelephoneNumber>
189
- # @option option [String] :ImportersFaxNumber (Optional)
190
- # - For Importer: No format checking is done on international fax numbers. For example: <ImportersFaxNumber>011 52 (322) 222-0074</ImportersFaxNumber>
191
- # @option option [String] :ImportersEmail (Optional)
192
- # - For Importer: Complete valid e-mail address is Required if tag is used. For example: <ImportersEmail>cpapple@email.com</ImportersEmaill>
193
- # @option option [Boolean] :Machinable (Optional)
194
- # - 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 for more information. For example: <Machinable>false</Machinable>
195
- # @option option [String] :DestinationRateIndicator (Required)
196
- # - Required for destination entry packages. · I = International Service Center (ISC) · N = None
197
- # @option option [String] :MID (Optional)
198
- # - Mailer ID (MID), Represents Mail Owner MID. Located in position #13 in the Detail 1 record of the Shipping Services File v2.0. For example: <MID>847654321</ MID>
199
- # @option option [String] :LogisticsManagerMID (Optional)
200
- # - The MID of the company that manages the mailing. Located in position #12 in the Detail 1 record of the Shipping Services File v2.0. Note: If LogisticsManagerMID is populated, either CRID or MID must also be populated. For example: <LogisticsManagerMID>489001< / LogisticsManagerMID>
201
- # @option option [String] :CRID (Optional)
202
- # - Customer Registration ID, Represents Mail Owner CRID. Located in position #20 in the Detail 1 record of the Shipping Services File v2.0. For example: <CRID>544762</ CRID>
203
- # @option option [String] :VendorCode (Optional)
204
- # - Code from vendor software to identify the developer of the shipping system. Located in position #15 in the Detail 1 record of the Shipping Services File v2.0. For example: <VendorCode>1234<VendorCode>
205
- # @option option [String] :VendorProductVersionNumber (Optional)
206
- # - Shipping software’s product version number. Located in position #16 in the Detail 1 record of the Shipping Services File v2.0. For example: <VendorProductVersionNumber>5.02.1B</ VendorProductVersionNumber>
207
- # @option option [String] :ePostageMailerReporting (Optional)
208
- # - Verifies Sender Information, sender fields must match From information when <ePostageMailerReporting>=1 · 1 - (ePostage sender information in SSF) · 2 - (ePostage sender information through DES) · 3 - (ePostage sender information using child MID)
209
- # @option option [String] :SenderFirstName (Optional)
210
- # - First Name of Sender. For example: <SenderFirstName>Adam</SenderFirstName> Required when <ePostageMailerReporting>=1
211
- # @option option [String] :SenderLastName (Optional)
212
- # - Last Name of Sender. For example: <SenderLastName>Smith</SenderLastName> Required when <ePostageMailerReporting>=1
213
- # @option option [String] :SenderBusinessName (Optional)
214
- # - Values for Sender Business Name must be sent. For example: <SenderBusinessName>USPS</SenderBusinessName>
215
- # @option option [String] :SenderAddress1 (Optional)
216
- # - Sender address line. Use this tag for full address (Address1 and Address2) Must match Address1 and Address2 or will produce an error. For example: <SenderAddress1>STE 150 10 Elm Street </SenderAddress1> Required when <ePostageMailerReporting>=1
217
- # @option option [String] :SenderCity (Optional)
218
- # - Sender city. For example: <SenderCity>BETHESDA</SenderCity>Required when <ePostageMailerReporting>=1
219
- # @option option [String] :SenderState (Optional)
220
- # - Sender state. For example: <SenderState>MD</ SenderState> Required when <ePostageMailerReporting>=1
221
- # @option option [String] :SenderZip5 (Optional)
222
- # - Sender ZIP code. For example: <SenderZip5>20212</SenderZip5> Required when <ePostageMailerReporting>=1
223
- # @option option [String] :SenderPhone (Optional)
224
- # - Sender Phone #. 10 digits Required (including area code), with no punctuation. For example: <SenderPhone>2125551234</ SenderPhone> Required when <ePostageMailerReporting>=1
225
- # @option option [String] :SenderEmail (Optional)
226
- # - E-mail Address of Sender. Valid e-mail addresses must be used. For example: <SenderEMail>cpapple@email.com</ SenderEMail> Required when <ePostageMailerReporting>=1
227
- # @option option [String] :ChargebackCode (Optional)
228
- # - Used in Shipping Services File v2.0 for G-10 labels. Contact your Technical Integration Specialist for details.
229
-
230
- #
231
- # @see
232
- def e_vs_priority_mail_intl(options = {})
12
+ # @param [Hash] options
13
+ # @option options [required, Hash] e_vs_priority_mail_int_request Produces a Priority Mail International label with customs declaration
14
+ # * *:option* (Empty) — For future use.
15
+ # * *:revision* (required, String) — Use of value 2 Required as of January 2011. For example: <Revision>2</Revision>
16
+ # * *:image_parameters* (Hash) — Groups alternate image options.
17
+ # * *:image_parameter* (String) — Returns alternate label image. Only alternate 4’’x6’’ size label image may be requested at this time. · 4X6LABEL - (4X6 on a full page 8.5/11” background) · 4X6LABELL - (Landscape – true size 4X6; image rotated, not on an 8.5 x 11 background page) · 4X6LABELP - (Portrait – true size 4X6, not on an 8.5 x 11 background page) · 4X6ZPL203DPI - (ZPL - Zebra Programming Language) format. When using this enumeration, <ImageType> is required - this tag cannot be left blank. Integrators should use either “TIF” or “PDF” for ZPL – neither value will impact the label image itself, but it must be included in the request to return a successful response. · 4X6ZPL300DPI - Prints a label formatted for ZPL printers in 300 dpi. When using this enumeration, <ImageType> is required - this tag cannot be left blank. Integrators should use either “TIF” or “PDF” for ZPL – neither value will impact the label image itself, but it must be included in the request to return a successful response. For example: <ImageParameter>4X6LABEL</ImageParameter>
18
+ # * *:from_first_name* (required, String) — Both FromFirstName and FromLastName are Required if FromFirmName is left blank. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name. For example: <FromFirstName>John</FromFirstName>
19
+ # * *:from_middle_initial* (String) — Middle Initial. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name. For example: <FromMiddleInitial>L</FromMiddleInitial>
20
+ # * *:from_last_name* (required, String) — Both FromFirstName and FromLastName are Required if FromFirmName is left blank. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name. For example: <FromLastName>Doe</FromLastName>
21
+ # * *:from_firm* (required, String) — FromFirm is Required if FromFirstName and FromLastName are left blank. For example: <FromFirm>XYZ</FromFirm>
22
+ # * *:from_address1* (String) — Use this tag for a suite or apartment number only. Either Address1 or Address2 is Required. For example: <FromAddress1>Suite 100</FromAddress1>
23
+ # * *:from_address2* (required, String) — Use this tag for the primary address line. For example: <FromAddress2>10 Elm Street </FromAddress2>
24
+ # * *:from_urbanization* (String) — Use this tag for Puerto Rico only. ZIP Code prefixes 006 to 009, if area is so designated. For example: <FromUrbanization>URB Caparra Ter</FromUrbanization>
25
+ # * *:from_city* (required, String) — For example: <FromCity>Anytown</FromCity>
26
+ # * *:from_state* (required, String) — Use 2-letter USPS abbreviation. For example: <FromState>ST</FromState>
27
+ # * *:from_zip5* (required, String) — Input tag exactly as presented, not all caps. 5 digits Required. For example: <FromZip5>01234</FromZip5>
28
+ # * *:from_zip4* (String) — Input tag exactly as presented, not all caps. If value is entered, 4 digits Required. This is the ZIP+4 extension. For example: <FromZip4>5678</FromZip4>
29
+ # * *:from_phone* (required, String) — 10 digits Required (including area code), with no punctuation. Use format: 2125551234 For example: <FromPhone>5555555555</FromPhone>
30
+ # * *:from_customs_reference* (String) — Enter a value for the "Sender's Customs Reference" that will appear on the label. The text entered is any reference number that the sender wishes to use. For example: <FromCustomsReference> 45655332 </FromCustomsReference>
31
+ # * *:to_name* (String) — Deprecated. See “ToFirstName” and “ToLastName” tags.
32
+ # * *:to_first_name* (required, String) — Both ToFirstName and ToLastName are Required if ToFirm is left blank. For example: <ToFirstName>John</ToFirstName>
33
+ # * *:to_last_name* (required, String) — Both ToFirstName and ToLastName are Required if ToFirm is left blank. For example: <ToLastName>Doe</ToLastName>
34
+ # * *:to_firm* (required, String) — ToFirm is Required if ToFirstName and ToLastName are left blank. For example: <ToFirm>YYZ</ToFirm>
35
+ # * *:to_address1* (String) — Three address lines are provided, but only 1 is Required. Use as many as needed for complete address. For example: <ToAddress1> Apartado 3068</ToAddress1>
36
+ # * *:to_address2* (required, String) — Three address lines are provided, but only 1 is Required. Use as many as needed for complete address.
37
+ # * *:to_address3* (String) — Three address lines are provided, but only 1 is Required. Use as many as needed for complete address.
38
+ # * *:to_city* (required, String) — Recipient's city. For example: <ToCity>Puerto Vallarta</ToCity>
39
+ # * *:to_province* (String) — Enter the province for the recipient. For example: <ToProvince>Jalisco</ToProvince>
40
+ # * *:to_country* (required, String) — The country name entered must match an entry from the USPS-approved International Index of Countries and Localities. (http://pe.usps.gov/text/Imm/Immctry.htm - click on the link for "International Country Listings.") Using a country name not on the list will result in a request failure. For example: <ToCountry>Mexico</ToCountry>
41
+ # * *:to_postal_code* (required, String) — Enter the postal code for the recipient. For example: <ToPostalCode>46807</ToPostalCode>
42
+ # * *:to_po_box_flag* (required, String) — Indicates whether the destination address is a Post Office Box. For example: <ToPOBoxFlag>N</ToPOBoxFlag>
43
+ # * *:to_phone* (String) — No format checking is done on international phone numbers. Required when <ToPOBoxFlag>Y</ToPOBoxFlag> For example: <ToPhone>011 52 (322) 222-0069</ToPhone>
44
+ # * *:to_fax* (String) — No format checking is done on international fax numbers. For example: <ToFax>011 52 (322) 222-0074</ToFax>
45
+ # * *:to_email* (String) — Complete valid e-mail address is Required if tag is used. For example: <ToEmail>cpapple@email.com</ToEmail>
46
+ # * *:importers_reference_number* (String) — Enter a value for the "Recipient's Reference" that will appear on the label. The text entered is any reference number that the recipient wishes to use. For example: <ImportersReferenceNumber>Order 23432</ImportersReferenceNumber>
47
+ # * *:non_delivery_option* (String) — In case package is undeliverable, enter one of the following: · "RETURN" for package to be returned to <FromAddress> above. · "REDIRECT" to return package to address specified below in <AltReturn…> tags. · "ABANDON" to dispose of undeliverable package. For example: <NonDeliveryOption>RETURN</NonDeliveryOption>
48
+ # * *:redirect_name* (String) — Enter a value for the recipient's name.
49
+ # * *:redirect_email* (String) — Complete valid e-mail address is Required if tag is used.
50
+ # * *:redirect_sms* (String) — This value must be a syntactically-valid SMS number.
51
+ # * *:redirect_address* (String) — Enter the redirect address. This is a free form field.
52
+ # * *:redirect_city* (String) — Redirect city. For example: <RedirectCity>Anytown</RedirectCity>
53
+ # * *:redirect_state* (String) — Redirect state. For example: <RedirectState>MN</RedirectState>
54
+ # * *:redirect_zip_code* (String) — Redirect ZIP code. For example: <RedirectZipCode>12345</RedirectZipCode>
55
+ # * *:redirect_zip4* (String) — Redirect ZIP+4 extension. For example: <ToZip5>01234</ToZip5>
56
+ # * *:container* (String) — For example: <Container>MDFLATRATEBOX</Container> Otherwise, use to specify special containers or container attributes that may affect postage.
57
+ # * *:shipping_contents* (required, Hash) —
58
+ # * *:item_detail* (Hash) — Groups individual item details
59
+ # * *:description* (required, String) — Description of the item. For example: <Description>Policy guidelines document</Description>
60
+ # * *:quantity* (required, Integer) — Quantity of the item. Integer value Required. For example: <Quantity>1</Quantity>
61
+ # * *:value* (required, Decimal) — The data entered with this tag provides the value of the set of items. For example: If the item is 2 boxes of 50 pens and the value of each box is $10.00, "20.00" (2 boxes x $10.00) should be entered. If the value of each pen is .25 then "25.00" (100 pens x .25) should be entered. For example: <Value>55.00</Value>
62
+ # * *:net_pounds* (required, Integer) — Provide the pounds component of the weight of the individual item listed with <Description>. For example: <NetPounds>1</NetPounds>
63
+ # * *:net_ounces* (required, Decimal) — Provide the ounces component of the weight of the individual item listed with <Description>. For example: <NetOunces>5</NetOunces>
64
+ # * *:hs_tariff_number* (required, String) — For commercial items only. If known, the HS tariff number must be based on the Harmonized Commodity Description and Coding System developed by the World Customs Organization. For example: <HSTariffNumber>490110</HSTariffNumber>
65
+ # * *:country_of_origin* (required, String) — For commercial items only. Country of Origin means the country where the goods originated, e.g. were produced, manufactured, or assembled. It is recommended you supply this information and attach an invoice to the outside to accelerate customs clearance in processing the items. The country name entered must match an entry from the USPS-approved International Index of Countries and Localities or be "United States". (http://pe.usps.gov/text/Imm/Immctry.htm - click on the link for "International Country Listings.") Using a country name not on the list will result in a request failure. For example: <CountryOfOrigin>United States</CountryOfOrigin>
66
+ # * *:insured* (String) — Restricted use: authorized users may indicate with a value of Y that the item is insured for purposes of obtaining a barcode number from the insured range. All other users must specify N or omit.
67
+ # * *:insured_number* (String) — For backward-compatibility; not validated.
68
+ # * *:insured_amount* (Decimal) — Use this tag for entering an insurance amount, if known. For example: <InsuredAmount>100.00</InsuredAmount>
69
+ # * *:postage* (Decimal) — Use this tag for entering a postage amount, if known. If the tag is present, but the value is blank, the postage will be automatically calculated. For example: <Postage></Postage>
70
+ # * *:gross_pounds* (required, Integer) — Gross pounds and ounces together represent the total package weight, including packing material. For example, a package weighing 3 lbs 8 ounces would have "3" entered here and "8" entered with the <GrossOunces> tag. WebTools will check for maximum shipping weight of 70 pounds. Allowable weight may change based on the service used to send package and the destination country. For example: <GrossPounds>4</GrossPounds>
71
+ # * *:gross_ounces* (required, Integer) — Enter the ounces component of the total package weight with this tag. For example: <GrossOunces>0</GrossOunces>
72
+ # * *:content_type* (required, String) — Specifies the content of the package or envelope. For example: <ContentType>DOCUMENTS</ContentType> Note : “NonnegotiableDocument” and “Documents” both signify mailable non-negotiable documents and are insured automatically for up to $100. Additional Insurance cannot be purchased. Any non-document <ContentType> values are insured automatically for up to $200. Additional Insurance can be purchased for values $200 and greater.
73
+ # * *:content_type_other* (String) — Required when <ContentType>OTHER<ContentType>. Maximum length enforced via truncation
74
+ # * *:agreement* (required, String) — Requires a value of Y to print <FromFirstName/> and <FromLastName/> in Signature Box along with Current Date (Central Time USA). Any other value returns an error.
75
+ # * *:comments* (String) — Enter any comments. For example: <Comments></Comments>
76
+ # * *:license_number* (String) — Enter license number, if known or if included in package. For example: <LicenseNumber>LIC-24356879</LicenseNumber>
77
+ # * *:certificate_number* (String) — Enter certificate number, if known or if included in package. For example: <CertificateNumber>CERT-97865342</CertificateNumber>
78
+ # * *:invoice_number* (String) — Enter invoice number, if known or if included in package. For example: <InvoiceNumber>INV-040903</InvoiceNumber>
79
+ # * *:image_type* (required, String) — Label Image Type. Note: All <ImageType> values are ignored when <ImageParameter> = “4X6ZPL203DPI” or “4X6ZPL300DPI”. For example: <ImageType>PDF</ImageType>
80
+ # * *:image_layout* (String) — Controls how the multipage form is returned in the response tags. "ONEPERFILE" returns one page per response tag while “ALLINONEFILE” returns all pages in a single response tag. The “TRIM” options conserve page space if possible by combining two form parts on a single page. For example: <ImageLayout>ONEPERFILE<ImageLayout>
81
+ # * *:customer_ref_no* (String) — Written to Postal Manifest Detail record. For example: <CustomerRefNo>Ref 369246</CustomerRefNo>
82
+ # * *:customer_ref_no2* (String) — Written to Postal Manifest Detail record. For example: <CustomerRefNo2>ACT369246</CustomerRefNo2>
83
+ # * *:po_zip_code* (String) — ZIP Code of Post Office or collection box where item is mailed. May be different than FromZip5. This tag will take precedence over FromZip5 when provided. For example: <POZipCode>00962</POZipCode>
84
+ # * *:label_date* (String) — Date the mail will enter the mail stream. No more than 3 days in the future. Default is day of request. For example: <LabelDate>09/28/2010</LabelDate>
85
+ # * *:hold_for_manifest* (String) — Restricted use. Holds manifest record for possible inclusion in SCAN request.
86
+ # * *:eelpfc* (String) — Exemption and Exclusion Legend or PFC Code. Use in conjunction with Revision tag with value of 1 to indicate and trigger new functionality. Please refer to the International Mail Manual for further information - http://pe.usps.gov/text/imm/immc5_007.htm. To activate check boxes use ”30.37a” or “30.37h”. For example: <EELPFC>30.37a</EELPFC>
87
+ # * *:price_options* (String) — Price option for package.
88
+ # * *:length* (Decimal) — 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. Please reference https://about.usps.com/postalbulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing
89
+ # * *:width* (Decimal) — 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. Please reference https://about.usps.com/postalbulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing
90
+ # * *:height* (Decimal) — 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. Please reference https://about.usps.com/postalbulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing
91
+ # * *:girth* (Decimal) — 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. Please reference https://about.usps.com/postalbulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing
92
+ # * *:extra_services* (Hash) — Groups extra services elements
93
+ # * *:extra_service* (Extra Service Name) — [{"Extra Service Name"=>"e-USPS Return Receipt", "Service ID"=>"105"}]
94
+ # * *:action_code* (String) — Used to specify the action code. Value is included in the Shipping Partner Event file for customers who have chose to have a Shipping Partner Event file submitted to USPS on their behalf. M0 – Mailer Owner S0 – Service Provider For example: <ActionCode>M0</ActionCode>
95
+ # * *:opt_out_of_spe* (Boolean) — Allows a customer to opt out of SPE file creation. “false” WILL create a SPE file. Note: This request tag is case sensitive.
96
+ # * *:permit_number* (String) — Number associated with a mailing permit. The permit is permission to use a certain postage payment method for bulk and commercial mailings
97
+ # * *:account_zip_code* (String) — ZIP of Account Post Office where mailed if different from <FromZip5/>. Written to Postal Manifest Detail record. Must be valid ZIP Code. For example: <AccountZipCode>00962</AccountZipCode>
98
+ # * *:importers_reference_type* (String) — Tax code / VAT no. / Importer Code.
99
+ # * *:importers_telephone_number* (String) — For Importer: 10 digits (including area code), with no punctuation. Use format: 2125551234 For example: <ImportersTelephoneNumber>5555555555</ImportersTelephoneNumber>
100
+ # * *:importers_fax_number* (String) — For Importer: No format checking is done on international fax numbers. For example: <ImportersFaxNumber>011 52 (322) 222-0074</ImportersFaxNumber>
101
+ # * *:importers_email* (String) — For Importer: Complete valid e-mail address is Required if tag is used. For example: <ImportersEmail>cpapple@email.com</ImportersEmaill>
102
+ # * *:machinable* (Boolean) — 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 for more information. For example: <Machinable>false</Machinable>
103
+ # * *:destination_rate_indicator* (required, String) — Required for destination entry packages. · I = International Service Center (ISC) · N = None
104
+ # * *:mid* (String) — Mailer ID (MID), Represents Mail Owner MID. Located in position #13 in the Detail 1 record of the Shipping Services File v2.0. For example: <MID>847654321</ MID>
105
+ # * *:logistics_manager_mid* (String) — The MID of the company that manages the mailing. Located in position #12 in the Detail 1 record of the Shipping Services File v2.0. Note: If LogisticsManagerMID is populated, either CRID or MID must also be populated. For example: <LogisticsManagerMID>489001< / LogisticsManagerMID>
106
+ # * *:crid* (String) — Customer Registration ID, Represents Mail Owner CRID. Located in position #20 in the Detail 1 record of the Shipping Services File v2.0. For example: <CRID>544762</ CRID>
107
+ # * *:vendor_code* (String) — Code from vendor software to identify the developer of the shipping system. Located in position #15 in the Detail 1 record of the Shipping Services File v2.0. For example: <VendorCode>1234<VendorCode>
108
+ # * *:vendor_product_version_number* (String) — Shipping software’s product version number. Located in position #16 in the Detail 1 record of the Shipping Services File v2.0. For example: <VendorProductVersionNumber>5.02.1B</ VendorProductVersionNumber>
109
+ # * *:e_postage_mailer_reporting* (String) — Verifies Sender Information, sender fields must match From information when <ePostageMailerReporting>=1 · 1 - (ePostage sender information in SSF) · 2 - (ePostage sender information through DES) · 3 - (ePostage sender information using child MID)
110
+ # * *:sender_first_name* (String) — First Name of Sender. For example: <SenderFirstName>Adam</SenderFirstName> Required when <ePostageMailerReporting>=1
111
+ # * *:sender_last_name* (String) — Last Name of Sender. For example: <SenderLastName>Smith</SenderLastName> Required when <ePostageMailerReporting>=1
112
+ # * *:sender_business_name* (String) — Values for Sender Business Name must be sent. For example: <SenderBusinessName>USPS</SenderBusinessName>
113
+ # * *:sender_address1* (String) — Sender address line. Use this tag for full address (Address1 and Address2) Must match Address1 and Address2 or will produce an error. For example: <SenderAddress1>STE 150 10 Elm Street </SenderAddress1> Required when <ePostageMailerReporting>=1
114
+ # * *:sender_city* (String) — Sender city. For example: <SenderCity>BETHESDA</SenderCity>Required when <ePostageMailerReporting>=1
115
+ # * *:sender_state* (String) — Sender state. For example: <SenderState>MD</ SenderState> Required when <ePostageMailerReporting>=1
116
+ # * *:sender_zip5* (String) — Sender ZIP code. For example: <SenderZip5>20212</SenderZip5> Required when <ePostageMailerReporting>=1
117
+ # * *:sender_phone* (String) — Sender Phone #. 10 digits Required (including area code), with no punctuation. For example: <SenderPhone>2125551234</ SenderPhone> Required when <ePostageMailerReporting>=1
118
+ # * *:sender_email* (String) — E-mail Address of Sender. Valid e-mail addresses must be used. For example: <SenderEMail>cpapple@email.com</ SenderEMail> Required when <ePostageMailerReporting>=1
119
+ # * *:chargeback_code* (String) — Used in Shipping Services File v2.0 for G-10 labels. Contact your Technical Integration Specialist for details.
120
+ def e_vs_priority_mail_intl(options = {})
233
121
  throw ArgumentError.new('Required arguments :e_vs_priority_mail_int_request missing') if options[:e_vs_priority_mail_int_request].nil?
234
122
  throw ArgumentError.new('Required arguments :e_vs_priority_mail_int_request, :revision missing') if options[:e_vs_priority_mail_int_request][:revision].nil?
235
123