UPS Europe and Asia Pacific
Account Number and Services
To add a new UPS Europe and Asia Pacific carrier, in the left panel of the Parcel Configuration (Web Admin) Tool, click the Add Carrier link under the location for which you want to add this carrier. From the Carrier drop-down list, select UPS Europe and Asia Pacific. The screen for entering the UPS Europe and Asia Pacific account number appears. On this screen, you enter the UPS Europe and Asia Pacific account number, display name, and also select the UPS Europe and Asia Pacific services that you use to ship packages from this location (see the following procedure).
Notes:
-
For more information on UPS Europe and Asia Pacific supported origins, services, and other compliance details, see the following Help topic: UPS Europe and Asia Pacific Overview.
-
For more information on adding a carrier, see the Help topic: How to add a carrier .
To configure the UPS Europe and Asia Pacific account number and services, complete these steps...
-
In the Account Number field, type the UPS Europe and Asia Pacific account number for this location.
Caution: This field allows alphanumeric characters. However, you must use all uppercase characters for the check-digit algorithm to generate correct check digits. (This algorithm converts letters in the account number to numbers in such a way that upper- and lower-case letters produce different values for the same letter.) -
In the Carrier Code field, type a name for the carrier as you want it to appear in the Web Admin Tool and elsewhere in Parcel, including the Carrier drop-down list on the Warehouse screen. For example, if you are setting up more than one UPS Europe and Asia Pacific account for this location, you might want to type 'UPSEU-2' (without quotes) if this is the second UPS Europe and Asia Pacific account for this location.
-
In the Services section, select the services that you will use to ship UPS Europe and Asia Pacific packages from this location, and then click ADD to move them from the left-hand column to the right-hand column.
Note: To select all of the services at once, click ADD ALL. You can also use the MOVE UP and MOVE DOWN to change the order of the services in the list.
The Services list on the Add Carrier screen for UPS Europe and Asia Pacific contains the following service types:Service
Description
UPS Express Plus®
9:00 am guaranteed second business day to major business centers.
UPS Express®
Delivery by 10:30 a.m. or noon in 1-3 business days - international.
UPS Standard
UPS standard ground service delivery.
UPS Expedited®
Delivery by end of day in 2-5 business days.
UPS Express NA1®
Overnight delivery; Guaranteed by 10:30 AM where UPS Express® service is available.
UPS Express Saver®
Next business day delivery by 12:00 noon to most metropolitan areas; Saturday delivery by 1:30 PM available for certain destinations.
UPS Worldwide Express Freight SM
Guaranteed, end-of-day door-to-door service for palletized shipments over 150 pounds - International.
Note: For additional information on these services and how they are configured in Parcel, see the following Help topic: UPS EU - Supported Services. It is important to realize that not all services are supported for every possible origin-destination pair. You need to verify which services are supported for the location to which you are adding this UPS Europe and Asia Pacific carrier and Add only those services. This information should be available from the local UPS Europe and Asia Pacific office for the location
-
After configuring this screen, click SAVE in the lower-right corner of the page to save the settings. Otherwise, click CANCEL to cancel the settings.
To continue configuring UPS Europe and Asia Pacific, complete the following screens:
-
Accessorials
-
Port of Entry
-
Shipper Default
-
UPS Developer Kit®
-
URC Version
-
Custom Rate Import
-
Data Import
-
Fuel Surcharge Import
Configuring Time in Transit Calculation with UPS Europe and Asia Pacific
In addition to the previously listed screens, if you enable time in transit calculation on the Shipper Defaults> Tracking\Time in Transit tab, the following additional screens are available for importing and editing time in transit data :
For more information on time in transit calculation, see the following Help topic: Overview of Time in Transit Calculation .
Accessorials
To configure international accessorials (Special Services) for UPS Europe and Asia Pacific, type in values in the fields as described in the following tables. This information should be available in the contract with UPS.
Notes:
-
All fields on the Accessorials screen are either currency amounts or percentages.
-
Flat rate surcharge amounts are in the currency specified in the Currency field (the default is the Euro) for the Rate Origin Country field on the Defaults tab of the Shipper Defaults screen. Therefore, do not include the currency symbol or code in this field. Type in only the numeric amount to two decimal places; for example: 10.00.
-
Percentages are to two decimal places (even if xx.00) without the % sign; for example: 10.00 (for 10%).
-
For more information on the accessorials listed in the sections below, see the following Help topic: UPS Europe and Asia Pacific - Supported Services.
General
In this box... |
Type this... |
Saturday Delivery Domestic |
The surcharge for Saturday Delivery with a Domestic service. |
Saturday Delivery International |
The surcharge for Saturday Delivery with an International service. |
COD Domestic Minimum Fee |
The minimum surcharge for Collect On Delivery (COD) with a Domestic service. |
COD Domestic Percentage |
The surcharge percentage for Collect On Delivery (COD) with a Domestic service. This is a percent to two decimal places without the % sign; for example 10.00 (for 10% even). |
COD International Minimum Fee |
The minimum surcharge for Collect On Delivery (COD) with an International service. |
COD International Percentage |
The surcharge percentage for Collect On Delivery (COD) with an International service. |
Bill Duty and Tax SDT |
The charge for billing the duty charges to a third party if the party responsible for payment of the duty is different from the party responsible for payment of taxes. |
Delivery Duty Paid (DDP) |
The charge to bill delivery duty and value added tax (VAT) charges to a third party. |
Aviation Security Charge |
The aviation security toll charge for Express and Expedited shipments. |
Return of Document |
The charge for the Return of Document service. |
Dry Ice |
The charge for the Dry Ice service. |
Excess Insurance
In this box... |
Type this... |
Surcharge Domestic |
The minimum charge for Domestic Shipment Value Insurance coverage. |
Rate Domestic |
The percentage of shipment declared value that is charged for Domestic Shipment Value Insurance coverage. |
Surcharge International |
The minimum charge for International Shipment Value Insurance coverage. |
Rate International |
The percentage of shipment declared value that is charged for Domestic Shipment Value Insurance coverage. |
Residential Charge
In this box... |
Type this... |
Residential Delivery |
The surcharge for delivery to a residence. |
Additional Handling Charges
In this box... |
Type this... |
Additional Handling |
The surcharge for Additional Handling charges for all services. |
Large Package |
The additional handling surcharge for Large Packages. |
Extended Area
In this box... |
Type this... |
Surcharge Domestic |
The surcharge amount for delivery outside the normal delivery area with a Domestic shipment. |
Rate Domestic |
The percentage of the shipping charge that is charged for delivery outside the normal delivery area with a Domestic shipment.
|
Surcharge International |
The surcharge that is charged for delivery outside the normal delivery area with an International shipment. |
Rate International |
The percentage of the shipping charge that is charged for delivery outside the normal delivery area with an International shipment.
|
Remote Area Surcharge Value |
The fuel surcharge percentage for Express services. |
Remote Area Surcharge Rate |
The percentage of the shipping charge that is charged for delivery outside the normal delivery area. |
Fuel Surcharge
In this box... |
Type this... |
Standard |
The fuel surcharge percentage for UPS Standard (Ground) service. |
Express |
The fuel surcharge percentage for UPS Standard (Ground) service.. |
Delivery Confirmation
In this box... |
Type this... |
Signature |
The surcharge for automatic delivery confirmation with a printed copy of the recipient's digital signature. |
Adult Signature |
The surcharge for automatic delivery confirmation with a printed copy of the adult recipient's digital signature.
|
AOD |
The surcharge for acknowledgment of delivery (AOD) of the shipment. |
Direct Delivery Only Surcharge |
The surcharge for Direct Delivery Only Option. |
Return Service
In this box... |
Type this... |
1 Attempt |
The surcharge for UPS Returns Plus ® - one Pickup Attempt. |
3 Attempts |
The surcharge for UPS Returns Plus ® - three Pickup Attempts. |
|
The surcharge for UPS Returns ® - Printed Matter and Mail return. |
|
The surcharge for UPS Returns ® - Print Label. |
Electronic |
The surcharge for UPS Returns ® - Electronic Return Label. |
UPS Worldwide Express Freight(SM)
Note: Enter the surcharge for the UPS Worldwide Express Freight SM service for the following fields in the default currency for the location to two decimal places without the currency symbol.
In this box... |
Type this... |
Oversize Pallet Handling Surcharge |
The surcharge for handling an oversize pallet. |
Residential |
The surcharge that applies to each shipment to a Residential Address. |
Extended Area Surcharge |
The surcharge for delivery outside the normal delivery area. |
Remote Area Surcharge |
The surcharge for delivery to a remote area outside the normal delivery area. |
Access Point Hold Service
In this box... |
Type this... |
Access Point Hold Service |
The charge for Access Point Hold Service. |
Delivery to Addressee |
The charge for Delivery to Addressee. |
Access Point C.O.D |
The charge for Access Point C.O.D. |
Click SAVE in the lower-right corner of the screen to save any changes you made or click CANCEL to revert to previous values.
Port of Entry
Use the Port of Entry screen and table to define the Ports of Entry that your company uses in shipping to configure UPS Europe and Asia Pacific with World Ease. You can add or delete Port of Entry records to or from this table.
Note: This table is usually imported by e2open, LLC. technical support. This screen allows you to add or edit entries if necessary.
Add a Port of Entry Record
-
Click ADD icon at the top of the screen to add a new row at the bottom of the grid. The Add Record dialog is displayed.
-
Select or enter values for the fields described in the Port of Entry table shown below.
-
Click SAVE in the lower-right corner of the screen to save the new Port of Entry or click CANCEL to cancel the Add.
In this box...
Do this...
Service Level
Type the single-character service level code. Service level codes:
-
UPS Expedited - D
-
UPS Express - R
-
UPS Express Plus - P
-
UPS Standard (all countries) - S
-
UPS Express Saver and Express Saver (all countries) - V
-
Express NA1 - N
Notes: -
Service level codes are not the same as Parcel Service codes.
-
You can type in up to five (5) characters in this field. Do not use separators; for example: DPSVN |
Destination Country Code
Type the country code of the destination country.
Note: UPS provides country codes.Destination Postal High
Type the ending (highest) postal code of the destination postal code range serviced by this Port of Entry.
Destination Postal Low
Type the beginning (lowest) postal code of the destination postal code range serviced by this Port of Entry.
EU Indicator
This value is provided by UPS. It allows the contract to use one port if the shipment is an EU-to-EU movement and a different port of entry if it is a non-EU movement. Valid values are as follows:
-
0 - Non-EU movement
-
1 - EU movement |
Port Code
Type the code for the Port of Entry. This is the five-digit POE code starting with zero (0) that is provided by UPS.
Port Name
Type the name of the Port of Entry.
Consignee
Type the name of the Port Consignee.
Consignee Address 1
Type the Port's street address.
Consignee Address 2
Type any additional address information for the Port address (such as suite or floor).
Consignee City
Type the Port's city.
Consignee State
Type the Port's state or province code.
Consignee Postal
Type the Port's postal code.
Country Code
Type the Port's country code.
-
Edit or Delete a Port of Entry
To edit a Port of Entry
-
Select the row that you want to edit by clicking the far-left column of the Port of Entry row.
-
Click the EDIT icon to display the edit dialog.
-
Change the values in the fields that you want to edit, and then click SAVE to save your changes or CANCEL to revert to the previous values.
To delete a Port of Entry
-
Select the row, and then click the DELETE icon .
-
A confirmation dialog opens. Click OK to delete the holiday or click Cancel to keep the Port of Entry.
Shipper Default
Overview
Use the following tabs on the UPS Europe and Asia Pacific Shipper Defaults screen to configure the default information to use with this UPS Europe and Asia Pacific account.
Tabs
-
Addresses
-
Defaults
-
Electronic PLD
-
Tracking\Time in Transit
-
Contract Services
-
UPS Worldwide Express Freight(SM)
-
Label
Addresses Tab
Use the Addresses tab on the UPS Europe and Asia Pacific Shipper Defaults page to enter the default "Ship From" or "distribution center" address and alternate third party exporter address for this UPS Europe and Asia Pacific account.
Shipper section
In this box... |
Do this... |
Name |
Type the shipper's company name. |
Exporter Name |
If this field is blank, type the shipper's Exporter name if it is different from the company name. If this information is entered for the location under which this UPS EU carrier is added, this field is automatically populated with the Exporter Name for the location. |
Address 1 |
Type the shipper's "Ship From" street address. |
Address 2 |
Type any additional address information such as suite or floor for the shipper's "Ship From" street address. |
Address 3 |
Type any additional address information such as suite or floor for the shipper's "Ship From" street address. |
City |
Type the shipper's "Ship From" city. |
State/Province |
Type the shipper's "Ship From" state or province. |
Zip |
Type the shipper's "Ship From" postal Code. |
Country |
From the list, select the shipper's "Ship From" country. |
Phone |
Type the shipper's telephone number. |
Alternate Third Party section
In this box... |
Do this... |
Company Name |
Type the alternate third party exporter's company name. |
Address 1 |
Type the alternate third party exporter's "Ship From" street address. |
Address 2 |
Type any additional address information such as suite or floor for the alternate third party exporter's "Ship From" street address. |
Address 3 |
Type any additional address information such as suite or floor for the alternate third party exporter's "Ship From" street address. |
City |
Type the alternate third party exporter's "Ship From" city. |
State/Province |
Type the alternate third party exporter's "Ship From" state or province. |
Zip |
Type the alternate third party exporter's "Ship From" postal Code. |
Country |
From the drop-down list, select the alternate third party exporter's "Ship From" country. |
Phone |
Type the alternate third party exporter's telephone number. |
Fax |
Type the alternate third party exporter's fax number. |
Click SAVE at the bottom of the screen to save any changes you made or click CANCEL to revert to previous values.
Defaults Tab
Use the Defaults tab on the UPS Europe and Asia Pacific Shipper Defaults page to enter the following settings for this UPS Europe and Asia Pacific account.
In this box... |
Do this... |
Purge Days |
Type the number of days after which a purge of shipment records will be performed on the carrier database using database scripts or a purge utility. |
Dim Weight Divisor Version |
The version of the current UPS Dim Weight Divisor file appears. |
Routing Code Date |
Accept the default. This field is auto-populated with the date of the current UPS Universal Routing Code (URC) file in the mm/yyyy format; for example: 10/2008. This is a read-only field and cannot be edited. |
Routing Code Version |
Accept the default. This field is auto-populated with the version of the current UPS Universal Routing Code (URC) file; for example: 84.5A. This is a read-only field and cannot be edited.
|
Template Directory |
Type the path to the template directory used by Parcel. This directory is where all of the template files that Parcel uses are stored; for example: ..\templates |
Destination Control Statement |
Type in the Destination Control Statement to be included on the International Invoice. |
Currency |
From the drop-down list, select the currency code of the currency for Parcel to use to rate shipments. The default value for this field is EUR (currency code for Euro). |
Customer Charge |
Type the fee charged to the customer that will be added to every order (in addition to the freight charge).
|
Customer Charge Type |
From the drop-down list, specify whether Customer Charge (see previous row) is to be taken as a fixed amount (select "Fixed") or a percentage amount (select "Percentage"). |
Hazmat Web Service Retry Attempts |
Type the number of retry attempts when web service connectivity is failed. |
Vendor Collect ID |
If this check box is selected user has provide VCI information in the transaction.
|
Disregard VCI Validation |
If this and Vendor Collect ID check boxes are selected the
Disregard VCI Rules applies. User has provide VCI information in the transaction.
|
Additional Handling Weight Section
In this box... |
Do this... |
International (KG) |
Enter the negotiated international additional handling threshold. |
Domestic (KG) |
Enter the negotiated domestic additional handling threshold. |
Letter Weight (KG) |
Enter the negotiated letter weight threshold. |
Dim Weight Divisor (STD) |
Enter the negotiated dimensional weight divisor for Standard shipments. |
Dim Weight Divisor (EXP) |
Enter the negotiated dimensional weight divisor for Express shipments. |
Label Character Set |
Zebra character set. Enter '27' to disable international character conversion (only for Firmware x.14.x and higher) |
Shipper Account Exempt Status |
Account is exempt or non exempt from package level billable weight. |
Shipper Account Type |
From the drop-down list, select one of the following options as the shipper account type:
|
UPS Online Tool Registration Info Section
For more information on UPS Online Tools registration, see the following Help topic: UPS - UPS Developer Kit.
In this box... |
Do this... |
Access License Host |
Accept the default for UPS Online® Tools registration or enter an updated Access License Host address (if applicable). The default URL for the UPS Online® Tools Web site is onlinetools.ups.com. This field is required. |
Port |
Accept the default for port or enter an updated Port number (if applicable). The default is 443. This field is required. |
HTTP Version |
Accept the default for HTTP Version or enter an updated value for the version (if applicable). The default is 1. This field is required. |
Registration Host |
Accept the default for Registration Host or enter an updated host address (if applicable). The default is https://onlinetools.ups.com/webservices/Registration.+ This field is required. |
UPS Fuel Surcharges Download Info Section
In this box... |
Do this... |
Fuel surcharges download URL |
Enter the Fuel surcharges download URL. |
Click SAVE at the bottom of the screen to save any changes you made or click CANCEL to revert to previous values.
Electronic PLD Tab
Use the Electronic PLD tab on the UPS Shipper Defaults page to enter connection information for the UPS server. Parcel connects with this server to return Package Level Details (PLD - a UPS-specific term) with tracking and other information for shipments.
Unless otherwise noted, all settings apply only to this UPS Europe and Asia Pacific account at this location. Fill in values for the following fields or accept the accept the default values:
In this box... |
Do this... |
Book Number 1 |
This is a required field. UPS supplies these values (Book Number 1 and Book Number 2) to the client for each account number.
|
Book Number 2 |
This is a required field. UPS supplies these values (Book Number 1 and Book Number 2) to the client for each account number.
|
UPS Host |
Type the URL of the UPS site to which to upload PLD files. There are the following different sites for testing and production:
|
User Id |
This is a required field. Type the User ID supplied to you by UPS for uploading PLD files. |
Password |
This is a required field. Type the Password supplied to you by UPS for uploading PLD files. |
PLD Stunnel Client IP |
Type the IP address for the Stunnel host or accept the default; for example: 127.0.0.1
|
PLD Stunnel Client Port |
Type the port number for the Stunnel host or accept the default; for example: 4010 |
Click SAVE at the bottom of the screen to save any changes you made or click CANCEL to cancel changes and revert to original values.
Tracking\Time in Transit Tab
Use the Tracking\Time in Transit tab on the UPS Shipper Defaults page to enter settings related to tracking, calculation of time in transit (TINT) and Stunnel (SSL) connection settings for this UPS account.
Tracking Numbers
In this box... |
Do this... |
Starting Tracking Number |
Type the beginning (first) tracking number. You can use up to seven digits. |
Ending Tracking Number |
Type the ending (last) tracking number. You can use up to seven digits. |
Calculate Transit Time |
To specify local calculation only of transit times in Parcel, select (check) this check box. For the behavior of the two transit time options on this screen, see the following Note.
|
Retrieve Transit Data from Web |
To retrieve the data used to calculate time in transit from the UPS Web site, select (check) this check box. If this check box is selected, Parcel first attempts to retrieve time in transit data from the UPS Web site. If available, this data is used by Parcel for time in transit. If, for some reason, data is unavailable from the UPS Web site, Parcel uses local default time in transit data provided by e2open, LLC.
|
Communication Settings
In this box... |
Do this... |
Tracking Stunnel Client IP |
Type the IP address of the Stunnel host. Parcel uses this Stunnel IP address to send and receive files to and from the UPS server. |
Tracking Stunnel Client Port |
Type the port number of the Stunnel host. |
Connection Timeout (seconds) |
Type the number of seconds after which Parcel times out the Stunnel connection or accept the default (120). |
Click SAVE in the lower-right corner of the screen to save any changes you made or click CANCEL to cancel changes and eit the screen.
Note: For information on configuring Time in Transit calculations, see the following Help topics:
Contract Services Tab
Use the Contract Services tab to indicate whether you have a contract with UPS to provide the specified services. Contract services fall into the following categories:
-
Top section – Use this section to specify the following contract services: World Ease, Paperless Invoicing ®
-
Intl Special Commodities – Use this section to specify commodity types for which you have contracted the International Special Commodities (ISC) service.
To specify UPS contract services to which you are subscribed:
-
Select the check box next to each contract service to which you are subscribed.
Note: For more information on these services, see the following sections. -
After you have made all your selections, click SAVE to save this configuration or click CANCEL to exit the tab and return to previous values.
Top Section
In this box... |
Do this... |
International Rate Type |
From the drop-down list, select one of the following UPS International Rate Types:
|
UPS World Ease ® |
If this shipping account has a contract with UPS Europe and Asia Pacific to use the World Ease service, then select this check box.
|
UPS World Ease ® Doc Print Count |
Type the number of copies of each report to print for a World Ease shipment.
|
UPS Paperless Invoicing ® |
If this shipping account has a contract with UPS Europe and Asia Pacific to use the Paperless international service (with "Paperless Invoice"), then select this check box.
|
UPS Dry Ice |
If this shipping account has a contract with UPS Europe and Asia Pacific for the UPS Dry Ice shipping option, then select this check box. |
UPS Direct Delivery Only |
If this shipping account has a contract with UPS Europe and Asia Pacific to use the Direct Delivery Only, then select this check box.
|
UPS Broker of Choice® |
If this shipping account has a contract with UPS Europe and Asia Pacific to use the Broker of Choice, then select this check box. |
UPS Broker of Choice® Account Number |
Type the Broker of Choice Account number for selected shipping account. |
Intl Special Commodities Section
For international shipments, the UPS International Special Commodities (ISC) program is a UPS contract service that allows customers to ship special categories of commodities to approved ISC destination countries. The ISC tab on the UPS Shipper Defaults screen enables you to specify the particular type of UPS service for which a specific ISC commodity type applies.
Notes:
-
Since ISC is a contract service it is available only to UPS approved account numbers.
-
On the label, the text "ISC" prints under the documentation indicator (such as INV or KEY). For the ISC Type "Biological Substances", the text is "ISC-BIO".
Specifying Services for ISC Commodity Types
To specify services...
From the drop-down lists, select a service type for each commodity type allowed or leave the default (blank) of no service selected if the commodity type is not allowed for any service. Service types are as follows:
-
Worldwide Express Freight SM – ISC commodity type is allowed only for Worldwide Express Freight SM .
-
Other Services – ISC commodity type is allowed for all services except Worldwide Express Freight SM .
-
Both – ISC commodity type is allowed for all services including Worldwide Express Freight SM .
You can specify the following ISC commodity types to be allowed with the previous service types:
-
Seeds Allowed
-
Perishables Allowed
-
Tobacco Allowed
-
Plants Allowed
-
Alcoholic Beverages Allowed
-
Biological Substances Allowed
-
Special Exceptions Allowed
Click SAVE to save your changes or click CANCEL to cancel any changes and exit the ISC tab.
Note on ISC Requirements
The following requirements are associated with shipments involving ISC commodities:
-
This is a shipment-level service.
-
ISC is only valid for approved ISC destination countries.
-
In countries that are not on the approved ISC destination countries list, the only type of special commodity allowed with a UPS international shipment is Biological Substances.
-
Different ISC types are allowed on the same shipment but there cannot be duplicate ISC types within a shipment.
-
ISC types are allowed for both single and multi-piece shipments.
-
ISC is allowed with World Ease.
-
Except for Biological Substances, ISC types are not allowed with any return service accessorial.
-
Biological Substances are allowed with Print Return Label and Electronic Return Label services.
UPS Worldwide Express Freight(SM) Tab
UPS Worldwide Express Freight
SM
Use this tab to configure the UPS Worldwide Express Freight
SM
service. For more information on this service, see the following Help topic: UPS Europe Worldwide Express Freight
In this box... |
Do this... |
Allow Dangerous Goods |
To allow dangerous goods shipments with UPS Worldwide Express Freight
SM
shipments from Europe and Asia Pacific origins, select (check) this check box.
|
Allow shipments over 2,000 kg. (4,400 lbs.) |
To allow shipments over 2,000 kg. (4,400 lbs.) with UPS Worldwide Express Freight
SM
shipments from European origins, select (check) this check box.
|
Pallet Label Count |
Enter the number of pallet label copies to print for each UPS Worldwide Express Freight SM shipment or accept the required minimum number default of 5. |
Click SAVE at the bottom of the screen to save any changes you made or click CANCEL to cancel changes and revert to original values.
Label Tab
Use the Label tab on the UPS Europe and Asia Pacific Shipper Defaults page to enter settings related to label for this UPS Europe and Asia Pacific account.
In this box... |
Do this... |
Print Shipper Notice |
Select (check) this check box to print shipper notice in the label.
|
Is Inverted (Supported only for Zebra Printer) |
Select (check) this check box if the shipping label needs to be printed inverted. This works with Zebra printers only. |
Click SAVE in the lower-right corner of the screen to save any changes you made.
UPS Developer Kit®
UPS offers some services through a Web Service called UPS Developer Kit
®
. Parcel uses UPS Developer Kit
®
to process tracking, Time in Transit, and Ground Freight Rating requests. Access to this Web Service requires that you first register for a UPS Developer Kit
®
account. You can do so using the Parcel UPS Developer Kit
®
Registration screen.
Notes:
-
You need to register separately with UPS Online® Tools for each of these UPS services, for each carrier you configure for each location.
-
If you are upgrading from a previous Parcel version that already has a UPS Online® Tools account set up in conjunction with a configured UPS carrier or carriers, you are not required to re-register for these carriers. However, it is recommended that you do so. For more information on setting up a UPS Developer Kit® account, see the following Help topic: UPS Developer Kit® .
-
UPS Developer Kit ® replaces UPS Online ® Tools in previous Parcel versions.
URC Version
This screen is autopopulated with the version and date of UPS routing data.
Note: This screen is read only and non-editable.
Field |
Description |
URC Version |
The current version of the URCGLOBAL routing data provided by UPS. URC routing data is printed on UPS Europe and Asia Pacific labels and is used for routing lookup. |
URC Date |
The effective date of the current URC version. |
Custom Rate Import
Use the Custom Rate Import screen to import custom rate files for a UPS Europe and Asia Pacific carrier and to specify the date on which these rates go into effect. You can import multiple files in one operation, including different files for different services.
Note:
-
Custom rate files for importing into Parcel must be CSV files that follow a specific format as detailed in the section below on custom rate file format.
-
e2open, LLC. support in conjunction with UPS produces these files from data provided by the Parcel customer, and then provides the Custom Rate files to the customer for importing into their Parcel system.
To import custom rate files...
-
From the System menu. select Settings > UPS Europe and Asia Pacific > UPSEU_APAC _Carrier > Custom Rate Import to open the Custom Rate Import screen.
In this box...
Do this...
Rate Effective Date
Type the date on which the UPS custom rates go into effect. Use the following date format: YYYYMMDD; for example, for a Rate Effective Date of May 1, 2010: 20100501.
Custom Rate Directory
Type the complete path name of the folder (directory) where the UPS custom rate files are located; for example: C:\Program Files\Kewill\Flagship\UPS EU\Custom Rate Files.
Notes:-
This folder must be local to the Parcel server itself; that is, it must be located on either on a local hard drive or on a mapped network drive.
-
You can import any number of custom rate files provided that they are all placed in the same folder. Parcel imports all the correctly formatted CSV files in this folder. |
On the Custom Rate Import screen, fill in the fields as follows:
-
-
Click SAVE to import the files in the specified folder or click CANCEL to exit the Custom Rate Import screen.
Custom Rate File format
Note: Each Custom Rate File contains data for a combination of one origin and one customer account. All services available for this origin and account are listed in this file (see following table and example).
Each custom rate file is a CSV file containing the following information:
Field |
Description |
Customer |
The name of the customer. |
Origin |
The two-letter code for the country of origin; for example, for the Czech Republic: CZ |
Account |
The UPS Europe and Asia Pacific customer account number; for example: 12356 |
Service |
The UPS service name. |
Packaging Type |
Valid values for packaging type are as follows:
|
Rate Currency |
The three-letter currency code for the rates; for example, for the Czech Crown (Ceska Koruna): CZK |
Weight Units |
The three-character abbreviation for the weight units used; for example, for pounds: KGS |
Multi Piece |
Valid values for Multi Piece are as follows:
|
Outbound |
Valid values for Outbound are as follows:
|
Bill Types |
The billing type used for this shipment. Valid values are:
|
Weight (kg) |
The minimum weight for a particular row of rates in kilograms to one decimal place (see example below); for example: 1.5 |
Zone |
The name of the UPS Europe and Asia Pacific zone for which the rate is applicable; for example: Zone 5 |
Note: For the format of this file see the following topic: Custom Rate Import File Format.
Example of Custom Rate file (portion with header and one table)
Customer |
Carrier Name |
|
|
|
|
|
|
Origin |
CZ |
|
|
|
|
|
|
Account |
123456 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Service |
Express Saver |
|
|
|
|
|
|
Packaging Type |
Documents |
|
|
|
|
|
|
Rate Currency |
CZK |
|
|
|
|
|
|
Weight Units |
KGS |
|
|
|
|
|
|
Multi Piece |
No |
|
|
|
|
|
|
Outbound |
Yes |
|
|
|
|
|
|
Bill Types |
Prepaid |
Collect |
Third Party |
Consignee |
|
|
|
|
|
|
|
|
|
|
|
Weight |
Zone 6 |
Zone 7 |
Zone 8 |
Zone 9 |
Zone 10 |
Zone 11 |
Zone 12 |
Envelope |
841.68 |
841.68 |
913.40 |
1022.85 |
1087.02 |
1132.31 |
1275.74 |
0.5 |
1211.57 |
1181.38 |
1352.73 |
1419.16 |
1502.20 |
1539.94 |
1672.05 |
1.0 |
1517.30 |
1521.07 |
1803.39 |
1815.47 |
1955.12 |
2189.13 |
2381.63 |
1.5 |
1755.08 |
1823.02 |
2116.67 |
2211.78 |
2408.05 |
2687.35 |
2951.56 |
2.0 |
1992.87 |
2124.97 |
2433.71 |
2608.09 |
2860.97 |
3185.57 |
3521.49 |
2.5 |
2230.65 |
2426.92 |
2762.08 |
3004.40 |
3313.90 |
3683.78 |
4091.41 |
Notes: For clarity, the above example shows how a portion of the sample Custom Rates file (header and one table) appears in spreadsheet form. The equivalent of the same portion of the comma-delimited CSV file is as follows:
Customer,Carrier Name,,,,,,
Origin,CZ,,,,,,
Account,123456,,,,,,
,,,,,,,
Service,Express Saver,,,,,,
Packaging Type,Documents,,,,,,
Rate Currency,CZK,,,,,,
Weight Units,KGS,,,,,,
Multi Piece,No,,,,,,
Outbound,Yes,,,,,,
Bill Types,Prepaid,Collect,Third Party,Consignee,,,
,,,,,,,
Weight,Zone 6,Zone 7,Zone 8,Zone 9,Zone 10,Zone 11,Zone 12
Envelope,841.68,841.68,913.40,1022.85,1087.02,1132.31,1275.74
0.5,1211.57,1181.38,1352.73,1419.16,1502.20,1539.94,1672.05
1.0,1517.30,1521.07,1803.39,1815.47,1955.12,2189.13,2381.63
1.5,1755.08,1823.02,2116.67,2211.78,2408.05,2687.35,2951.56
2.0,1992.87,2124.97,2433.71,2608.09,2860.97,3185.57,3521.49
2.5,2230.65,2426.92,2762.08,3004.40,3313.90,3683.78,4091.41
Data Import
The UPS Europe and Asia Pacific Data Import screen enables you to import files for the following functionality in Parcel:
-
Worldwide Validation
-
Billable Weight Determination
-
Peak/Demand Surcharge
The following sections describe these functions and how to import the files to support them.
WorldWide Validation Import
UPS provides a monthly distribution called "WorldWide Distribution Validation" in the form of a Zip file containing a set of CSV validation files for accessorials, billing, and services. Parcel enables you to import these files into your Parcel system using the WW Validation Import screen.
To import UPS WorldWide Validation files...
-
Extract the files from the UPS WorldWide Validation Zip file into a directory on your Parcel server.
Caution: The directory to which you unzip the WorldWide Validation files must be on the same computer as the Parcel server. -
In the Parcel Web Admin tool, select a UPS Europe and Asia Pacific carrier, and then select the Data Import screen.
-
In the Import Date box, type the World Wide Validation Effective Date in YYYYMMDD format; for example: July 9, 2010, is rendered as "20100709" (without quotation marks). This is mandatory field for World Wide Validation import.
-
In the World Wide Validation Data Directory box, enter the full (absolute) path to the folder to which you extracted the WorldWide validation Zip file; for example: C:\Program Files\Kewill\Flagship\wvdata\
-
To retain WorldWide validation data that you have previously imported, select (check) the check box labeled Keep previous World Wide Validation Data.
Caution: If you leave this check box unselected (the default), previous WorldWide validation data is automatically purged when you download the new data.
Note : Selecting this option retains one copy of the most recent WorldWide validation data that you imported. Additionally, if you specify a future effective date, you need to select this option to retain a copy of your previously imported WorldWide Validation Data if you wish to have it available until the effective date of the new data. -
Click SAVE to save your settings.
Note: When you specify the location for the UPS WorldWide Validation files under one UPS Europe and Asia Pacific carrier, Parcel uses these files globally to validate accessorials, billing, and services for all UPS Europe and Asia Pacific carriers.
Billable Weight Determination Import
Parcel performs a Minimum Billable Weight calculation for international multi-piece shipments.
If an account or destination country is not exempt from package-level billable weight rules, billable weight is determined using package level data. If the destination status is exempt, shipment-level billable weight is used. Shipment billable weight is based on shipment-level data and does not require determining the billable weight for each package in the shipment.
When package billable weight is used, the following process is carried out. First the Package Billable Weight is determined for each package in the shipment. This weight is compared to the minimum billable weight for a package as defined by UPS, and the greater of the two values is taken as the package billable weight. This process is repeated for each package in the shipment and the sum of the package billable weights determined by this method is the shipment billable weight.
For a Shipper Account or Third Party Account, use UPS Online Tool to determine whether the account has an exempt status. UPS provides a file listing which countries are exempt and which countries are not. This is the file that you need to import using this screen.
*To import the UPS Billable Weight data file:*
-
In the UPS Billable Weight Data Directory box, enter the full (absolute) path to the folder to which you extracted the UPS file; for example: C:\Program Files\Kewill\Flagship\bwdata
-
Click SAVE to save your settings.
UPS Peak/Demand Surcharge Import
UPS provides a weekly distribution called "Object Distribution" in the form of a Zip file containing a comma-separated format (text file with the extension "txt") for peak/demand surcharge rates, effective dates, accessorials, and specified domestic and international services. Parcel enables you to import these files into your Parcel system using the UPS Data Import screen.
To import UPS Peak/Demand Surcharge Data Import files...
1. Extract the files from the UPS Peak/Demand Surcharge Data Import Zip file into a directory on your Parcel server.
Caution: The directory to which you unzip the UPS Data Import files must be on the same system as the Parcel server.
2. In the Parcel Web Admin tool, select a UPS carrier, and then select the Data Import screen.
3. In the Import Date box, type the Peak/Demand Surcharge Import date in YYYYMMDD format; for example: July 30, 2020, is rendered as "20200730" (without quotation marks). This is optional field.
4. In the Peak/Demand Surcharge Data Directory box, enter the path to the folder to which you extracted the UPS Peak/Demand Surcharge Zip file; for example: C:\Program Files\Kewill\Flagship\psdata
5. Click SAVE to save your settings.
Note: When you specify the location for the UPS Peak/Demand Surcharge Data Import files under one UPS carrier, Parcel uses these files globally to import peak/demand surcharge rates, effective dates, accessorials and services for all UPS carriers.
Fuel Surcharge Import
UPS Weekly FSC (Fuel Surcharge) - Manual Download
Field |
Description |
Effective Date |
Enter the effective of the download rates, in format YYYYMMDD. If data is not available for provided date (for example, a future date a few weeks in the future), Parcel will download the most updated data available. |