| Field Name | Field Type | Maximum Field Length | Required | Valid Values |
|---|
| Contact Name |
Alphanumeric |
35 |
Yes (for an international movement or a UPS Next Day Air Early service) |
Name of recipient (# entered in front of the first field results in an error) |
| Company or Name |
Alphanumeric |
35 |
Yes |
Company or name of recipient |
| Country |
Alphanumeric |
2 |
Yes |
Recipient's (See Country/Territory Code table for valid codes.) |
| Address 1 |
Alphanumeric |
35 |
Yes |
Address 1 for recipient (required) |
| Address 2 |
Alphanumeric |
35 |
No |
Address 2 for recipient (optional) |
| Address 3 |
Alphanumeric |
35 |
No |
Address 3 for recipient (optional) |
| City |
Alphanumeric |
30 |
Yes |
Recipient's city |
| State/Province/Other |
Alphanumeric |
30 |
Conditional |
Required for certain destination countries (See State/Province code table for valid codes.) |
| Postal Code |
Alphanumeric |
10 |
Conditional |
Required for certain destination countries |
| Telephone |
Alphanumeric |
15 |
Conditional |
Required for international destinations and UPS Next Day Air Early service |
| Extension |
Alphanumeric |
5 |
No |
Recipient's telephone extension |
| Residential Indicator |
0/1 |
1 |
No |
1=Residential; 0=Commercial |
| E-mail Address |
Alphanumeric |
50 |
No |
Recipient's e-mail address |
| Packaging Type |
Alphanumeric |
2 |
Yes |
See Packaging Type table for valid codes |
| Customs Value |
Numeric |
15 |
Conditional |
Required from U.S.-to-CA and U.S.-to-PR movements. Currency defaults to USD. Decimals allowed. |
| Weight |
Numeric |
5 |
Conditional |
Required for a packaging type of Other Packaging = 2. Weights are accepted optionally for a packaging type of Letter/Envelope. Use commas in numeric fields, such as weights (10,0) they would have to encase that field in double-quotation marks. |
| Length |
Numeric |
4 |
No |
Defaults to inches for U.S./PR; centimeters everywhere else. CA has choice between inches and centimeters. |
| Width |
Numeric |
4 |
No |
Defaults to inches for U.S./PR; centimeters everywhere else. CA has choice between inches and centimeters. |
| Height |
Numeric |
4 |
No |
Defaults to inches for U.S./PR; centimeters everywhere else. CA has choice between inches and centimeters. |
| Unit of Measure |
LB/KG |
2 |
No |
Defaults to pounds/lbs. (U.S./PR) or kilograms/kgs. CA has choice between lbs./kgs. |
| Description of Goods |
Alphanumeric |
35 |
Conditional |
Conditionally required when Ship to/Ship from countries or territories are not the same |
| Documents of No Commercial Value |
0/1 |
1 |
No |
Indicates the shipment does not contain any dutiable items |
| GNIFC (Goods not in Free Circulation) |
0/1 |
1 |
Conditional |
Required for movements within the EU when the goods are dutiable |
| Declared Value |
Numeric |
7 |
No |
Must be less than US$1000 or local equivalent if entered. Denominaton will default to the currency of the shipment origin country. UPS's liability for loss or damage to a package. No decimals allowed. |
| Service |
Numeric |
2 |
Yes |
See Service table for valid values. |
| Delivery Confirmation |
Alphanumeric |
1 |
No |
See Delivery Confirmation table for valid values. |
| Shipper Release/Deliver Wthout Signature |
0/1 |
1 |
No |
A shipper may request UPS release a package on the first delivery attempt without a signature. UPS will not be liable to shippers or third parties for any damages arising from the release of the package. (Not supported outside of U.S.) |
| Return of Document |
0/1 |
1 |
No |
Only used for Poland-to-Poland movements. |
| Deliver on Saturday |
0/1 |
1 |
No |
Available with select services (Refer to service guide for additional information.) |
| UPS carbon neutral |
0/1 |
1 |
No |
Request the option to offset the climate impact of your shipment. |
| Large Package |
0/1 |
1 |
No |
Applied when length plus girth (2 * width) + (2 * height) combined exceeds 118 inches but is less than 157 inches. Surcharge assessed. (Outside of U.S., large package limit is 400cms.) |
| Additional Handling |
Numeric |
4 |
No |
For U.S.: Applied when an article is encased in an outside shipping container made of metal or wood, packages exceed 70 lbs. or 32 kg., longest side exceeds 150cm. Refer to service guide for additional information. Outside of U.S.: If weight exceeds 32 kg. or the longest side exceeds 150cm then additional handling will be automatically supplied. |
| Reference 1 |
Alphanumeric |
35 |
No |
Used to record information about a package |
| Reference 2 |
Alphanumeric |
35 |
No |
Used to record information about a package |
| Reference 3 |
Alphanumeric |
35 |
No |
Only used in UPS CampusShip package level packaging (U.S., PR, and CA) |
| E-mail Notification 1 - Address |
Alphanumeric |
50 |
No |
E-mail address that will receive the specified notification (ship, exception, or delivery) |
| E-mail Notification 1 - Ship |
0/1 |
1 |
No |
E-mail notification sent when the package is shipped |
| E-mail Notification 1 - Exception |
0/1 |
1 |
No |
E-mail notification sent when there has been an exception in delivering the package |
| E-mail Notification 1 - Delivery |
0/1 |
1 |
No |
E-mail notification sent upon package delivery |
| E-mail Notification 2 - Address |
Alphanumeric |
50 |
No |
E-mail address that will receive the specified notification (ship, exception, or delivery) |
| E-mail Notification 2 - Ship |
0/1 |
1 |
No |
E-mail notification sent when the package is shipped |
| E-mail Notification 2 - Exception |
0/1 |
1 |
No |
E-mail notification sent when there has been an exception in delivering the package |
| E-mail Notification 2 - Delivery |
0/1 |
1 |
No |
E-mail notification sent upon package delivery |
| E-mail Notification 3 - Address |
Alphanumeric |
50 |
No |
E-mail address that will receive the specified notification (ship, exception, or delivery) |
| E-mail Notification 3 - Ship |
0/1 |
1 |
No |
E-mail notification sent when the package is shipped |
| E-mail Notification 3 - Exception |
0/1 |
1 |
No |
E-mail notification sent when there has been an exception in delivering the package |
| E-mail Notification 3 - Delivery |
0/1 |
1 |
No |
E-mail notification sent upon package delivery |
| E-mail Notification 4 - Address |
Alphanumeric |
50 |
No |
E-mail address that will receive the specified notification (ship, exception, or delivery) |
| E-mail Notification 4 - Ship |
0/1 |
1 |
No |
E-mail notification sent when the package is shipped |
| E-mail Notification 4 - Exception |
0/1 |
1 |
No |
E-mail notification sent when there has been an exception in delivering the package |
| E-mail Notification 4 - Delivery |
0/1 |
1 |
No |
E-mail notification sent upon package delivery |
| E-mail Notification 5 - Address |
Alphanumeric |
50 |
No |
E-mail address that will receive the specified notification (ship, exception, or delivery) |
| E-mail Notification 5 - Ship |
0/1 |
1 |
No |
E-mail notification sent when the package is shipped |
| E-mail Notification 5 - Exception |
0/1 |
1 |
No |
E-mail notification sent when there has been an exception in delivering the package |
| E-mail Notification 5 - Delivery |
0/1 |
1 |
No |
E-mail notification sent upon package delivery |
| E-mail Message |
Alphanumeric |
150 |
No |
Additional messaging or special instructions to be provided in the e-mail notification |
| E-mail Failure Address |
Alphanumeric |
50 |
No |
E-mail address that will receive a notification if the e-mail notification to the recipient failed delivery |
| Location ID |
Alphanumeric |
10 |
No |
Unique identifier for an alternate delivery location such as a UPS Access Point™ location |
| Notification Media Type |
Alphanumeric |
2 |
No |
See Media Types table for valid values. |
| Notification Language |
Alphanumeric |
6 |
No |
A list of valid country/language pairs. Default value based on origin/destination of shipment. See Notification Language table for valid values |
| Notification Address |
Alphanumeric |
50 |
No |
Email address or mobile number used to receive delivery notification for packages delivered to an alternate delivery location |
| ADL COD Value |
Numeric/Money |
10 |
No |
Monetary amount to be collected at the UPS Access Point location must be specified in the currency of that location. Decimals allowed. |
| ADL Deliver to Addressee |
0/1 |
1 |
No |
0 = option not requested 1 = Deliver To address only option requested |
| ADL Shipper Media Type |
Alphanumeric |
2 |
No |
See Media Types table for valid values. |
| ADL Shipper Language |
Alphanumeric |
6 |
No |
A list of valid country/language pairs. Default value based on origin/destination of shipment. See Notification Language table for valid values. |
| ADL Shipper Notification |
Alphanumeric |
50 |
No |
Email address or mobile number used for the shipper to receive notification when the package has arrived at the UPS Access Point location and when it has been picked up. |
Download
