Skip to Main Content
Search

Batch File Shipping

Batch File Shipping Help

Batch File Shipping enables you to create up to 250 shipments using a .csv (comma separated value) or .ssv (semicolon separated value) file format. The origin address must be the same for all the shipments but the destination addresses can be different.

Batch File Shipping only supports single piece shipments where the payment method is either by UPS Shipper Account (prepaid) or Third Party. After confirming the return to address and payment method, you can ship your packages. Prior to processing your file, verify the printer setting. When the process is complete, you will get an indication of how many packages were successfully processed.

The table below contains a sample file for your reference.

File NameFile FormatDate CreatedDownload
Sample File
07/11/2010


Batch File Import Format

Note: The import file uses a comma/semicolon as the field delimiter. The import file must include the comma/semicolon delimiter, even for optional fields. Column headers should not be included.

If a particular record fails validation during the import, the system will create an error file with the records that the system could not import. Review the report and make any corrections necessary. Once the errors have been resolved, try the import process again.

Batch File Import Format
The Batch File Import format contains a .csv/.ssv extension.
Field NameField TypeMaximum Field LengthRequiredValid 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 country (See Country 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 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 130 inches but is less than 165 inches. Surcharge assessed. (Outside of U.S., large package limit is 419cms.)
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.


The Import Batch File Processing format contains a field named Packaging Type. The valid codes for this field are:

Packaging Type Codes
The Import Batch File Processing format contains a field named Packaging Type. The valid codes for this field are:
1=UPS Letter/Envelope
4=UPS PAK
3=UPS Tube
S=UPS Express Box (Small)
M=UPS Express Box (Medium)
L=UPS Express Box (Large)
21=UPS Box
25=UPS 10 KG Box
24=UPS 25 KG Box
2=Other Packaging
30=Pallet (valid only for PL to PL)

The Import Batch File Processing format contains a field named Service. The valid 2-digit codes for this field are:

Service Type Codes

The Import Batch File Processing format contains a field named Service. The valid 2-digit codes for this field are:
14=UPS Next Day Air Early (US/PR) 54=UPS Express Plus
01=UPS Next Day Air (US/PR) 07=UPS Express
13=UPS Next Day Air Saver (US/PR) 08=UPS Expedited
59=UPS 2nd Day Air A.M. (US/PR) 11=UPS Standard
02=UPS 2nd Day Air (US/PR) 65=UPS Express Saver
12=UPS 3 Day Select
03=UPS Ground Service (US/PR)
82=UPS Today Standard (PL to PL)
83=UPS Dedicated Courier (PL to PL)
85=UPS Today Express (PL to PL)
86=UPS Today Express Saver (PL to PL)

The Import Batch File Processing format contains a field named Delivery Confirmation. If you do not want delivery confirmation leave the field blank, otherwise enter a valid code. The valid codes for this field are:

Delivery Confirmation Codes

The Import Batch File Processing format contains a field named Delivery Confirmation. The valid codes for this field are:
S=Signature Required
N=Delivery Confirmation with No Signature
A=Adult Signature Required
V=Verbal Confirmation

The Import Batch File Processing format contains a field named Media Type. The valid codes for this field are:

Media Type
The Import Batch File Processing format contains a field named Media Type. The valid codes for this field are:
01=Voice
03=Email
12=SMS Text

The Import Batch File Processing format contains a field named Valid Language Codes. The valid codes for this field are:

Valid Language Codes:
The valid codes for this field are:
"DAN_97"=Danish
"DEU_97"=German
"ENG_CA"=Canadian English
"ENG_GB"=Queen's English
"ENG_US"=U.S. English
"FIN_97"=Finnish
"FRA_97"=Canadian French
"FRA_CA"=France French
"ITA_97"=Italian
"NLD_97"=Netherlands Dutch
"NOR_97"=Norwegian
"POL_97"=Polish
"SPA_97"=Spanish
"SPA_MX"=Mexican Spanish
"SPA_PR"=Puerto Rican Spanish
"SWE_97"=Swedish

Contact UPS

For questions about UPS CampusShip, contact your UPS CampusShip Administrator. For UPS CampusShip Technical Support, select the link below.

UPS CampusShip Technical Support