In this Guide

Account Number and Services
Configuring Time in Transit Calculation with TNT Express
Account Defaults
Defaults
Import Time in Transit Files

Account Number and Services

When you add a new TNT Express carrier account (Add Carrier > Carrier > TNT Express), Parcel displays the screen to enter the TNT Express Connect account number and code. On this screen, you also select the TNT Express services with which you will ship packages from the location under which you are adding this TNT carrier.

To configure the TNT Express account number and services, complete these steps...

In the Account Number field, type the TNT Express account number for this location.
In Carrier Code field, type a name for the carrier as you want it to appear on the Web Admin (Configuration) Tool screens and on the shipping screens in Parcel. For example, if you are setting up more than one TNT Express account for this location, you might want to label these TNTXP-1, TNTXP-2, etc.
In the Services section, select the services that you will use to ship TNT Express packages from this location by selecting the service or services from the list in the following Help topic: TNT Express > Supported Services .
Caution: Not all services are supported for all locations. Before configuring a TNT Express carrier, you need to obtain from your local TNT representative a list of supported services for the Location to which you are adding this carrier.
Click ADD to move the selected service from the left-hand column to the right-hand column. To select and move all of the services at once, click ADD ALL.
You can also use the Move Up and Move Down (up arrow and down arrow) buttons on the right to change the order of the services in the list of following services. Services appear in the configured order on the Services drop-down list on the Warehouse screen.
Notes:
- TNT classifies services as National (called Domestic in Parcel - country of destination is the same as country of origin) and International (country of destination is different from country of origin). Service names are identical for some Domestic and International services.
- For more information on TNT Express services, see the Compliance Help topic: TNT Express > Overview .
- You need a unique TNT Account Number for each location to which you are adding a TNT carrier.
When you are done configuring this page, click SAVE in the lower-right corner of the page to save the settings. Otherwise, click CANCEL to cancel the settings.

To continue configuring TNT Express, complete the following screens: Account Defaults

Configuring Time in Transit Calculation with TNT Express

In addition to the previously listed screens, if you enable time in transit calculation on the Account Defaults > Time in Transit tab, the following additional screen is available for importing time in transit data: Carrier Configuration > Import Time in Transit Files
For more information on time in transit calculation, see the following Help topic: Carrier Configuration > Overview of Time in Transit Calculation .

Account Defaults

Overview

Use the following tabs on the TNT Express Account Defaults screen to configure the default information to use with this TNT Express Carrier account:

Account tab
ExpressConnect tab
ExpressLabel tab
Report Server tab
Time in Transit tab

After you fill out the information for a tab, click SAVE in the lower-right corner of the screen to save any changes you made or click CANCEL to cancel out of the dialog without saving changes.

Account Tab

Use the Account tab on the TNT Account Defaults screen to enter the following settings for this TNT Express account.

Top section

In this box...	Do this...
Currency	From the drop-down list, select the default currency for the Ship From location (Location of Origin). Parcel uses this currency as the default for all shipments with this TNT Express carrier. Note: This is a required field and is currently used for rating purposes.
Saturday Delivery Charge	Type the shipment-level surcharge for Saturday delivery in the specified default currency units without the currently symbol to two decimal places; for example: 5.00
Customer Charge	Type the fee that will be added to every order (in addition to the freight charge) if the Add Charge check box above is selected (checked) according to whether the Customer Charge type selected (see following row) is Fixed or Percentage. For example, if the Customer Charge Type is Fixed and the Customer Charge is €4.00, type 4.00 without the currency symbol. If the customer charge is 10%, type 10.00 without the percent sign.
Customer Charge Type	From the drop-down list, specify whether customer charge is to be taken as a fixed amount (Fixed) or a percentage amount (Percentage).

Fuel Surcharge section

In this box...	Do this...
Domestic Fuel Surcharge %	Type the Fuel Surcharge as a percent to be applied for a Domestic (within country of origin) shipment; for example: 10
International Fuel Surcharge %	Type the Fuel Surcharge as a percent to be applied for an International shipment; for example: 10

Shipment Rating section

In this box...	Do this...
Rate Shipment	Select (check) this check box to enable shipment rating for TNT shipments. Note: This check box is selected by default.
Web Service Request Retry	Type the number of retries to perform if a rate request fails or accept the default of 0. The value of this field also specifies the number of retries for a failed booking request on Close.

Preferred Collection Time section

Use these fields to enter a range for the preferred time that you want TNT to pick up your packages for shipment.
Caution: This information is required by both TNT and Parcel. Arrange your Collection Time range with TNT, and then enter the information in these fields using the 24-hour military format for the times. Your Collection Time range must lie within the following range specified by TNT: 0900 - 1600 (9AM - 4 PM).
Your Preferred Collection Times (From and To) range must be one-hour difference specified in the following fields by TNT.

In this box...	Do this...
From (hhmm)	Enter the start time for your Collection Time range; for example, if this is 12:30 AM local time zone, enter the following value: 1230
To (hhmm)	Enter the cutoff time with one-hour difference from your Start time of Collection; for example, if this is 1:30 PM local time zone, enter the following value: 1330

Package Limits section

Notes:

For TNT Express, package weight and dimensions use the following metric units: meters (m.)and kilograms kg.) However, note that spatial dimensions on the Warehouse screen are in cm/in. (Parcel automatically converts these values to meters.)

If you attempt to ship a package that exceeds the maximum weight or one or more of the maximum dimensions specified in the following fields, Parcel displays a message indicating that the package exceeds the maximum value(s).

In this box...	Do this...
Max weight (kg)	If you have negotiated a different maximum package weight with TNT, type that weight in kilograms. Otherwise, accept the default (currently 70).
Max length (m)	If you have negotiated different maximum package dimensions with TNT, type the maximum length in meters. Otherwise, accept the default (currently 2.4).
Max width (m)	If you have negotiated different maximum package dimensions with TNT, type the maximum width in meters. Otherwise, accept the default (currently 1.2).
Max height (m)	If you have negotiated different maximum package dimensions with TNT, type the maximum height in meters. Otherwise, accept the default (currently 1.5).

Click SAVE in the lower-right corner of the screen to save any changes you made or click CANCEL to revert to the original values.

ExpressConnect Tab

For TNT Express shipments, Parcel interfaces with TNT's Web services called TNT ExpressConnect (for rating, shipping, and tracking) and TNT ExpressLabel (for printing labels). To use Parcel with a TNT Express carrier, you first need to register with these TNT Web services. Use this tab to enter the account and location information for these Web services.
Note: For information on registering with these TNT Web services, contact your local TNT account representative.

ExpressConnect section

Parcel uses the information in these fields to communicate with the TNT ExpressConnect service when performing a TNT Express shipment. When you register with TNT Express, you should receive the necessary information for filling out these fields.
Note: TNT uses separate Web services for pricing (rating), shipping, and tracking. These services have separate URLs. Parcel uses the information in the following table to connect to these services. Except for User ID and Password, Parcel populates these fields by default. Unless you receive specific instructions from TNT that the values for one or more of these parameters have changed, it is recommended that you accept the defaults.

In this box...	Do this...
ExpressConnect User ID	Type in the User ID provided by TNT for accessing your ExpressConnect Web Service account.
ExpressConnect Password	Type in the password for accessing your ExpressConnect Web Service account.
Pricing Host	Type the host name of the ExpressConnect Pricing service or (recommended) accept the default.
Pricing Port	Type the port number of the ExpressConnect Pricing service or (recommended) accept the default.
Pricing Url	Type the URL for the ExpressConnect Pricing service or (recommended) accept the default.
Pricing DTD	Type the Document Type Definition (DTD) for ExpressConnect Pricing service or (recommended) accept the default. This parameter configures validation of the input XML that Parcel sends to the Pricing service.
Pricing HTTP version	Type the HTTP version for ExpressConnect Pricing service or (recommended) accept the default.
Shipping Host	Type the host name of the ExpressConnect Shipping service or (recommended) accept the default.
Shipping Port	Type the port number for the ExpressConnect Shipping service or (recommended) accept the default.
Shipping Url	Type the URL for the Shipping service or (recommended) accept the default.
Shipping DTD	Type the Document Type Definition (DTD) for ExpressConnect Shipping service or (recommended) accept the default. This parameter configures validation of the input XML that Parcel sends to the Shipping service.
Shipping HTTP version	Type the HTTP version for ExpressConnect Shipping service or (recommended) accept the default.
Tracking Host	Type the host name of the ExpressConnect Tracking service or (recommended) accept the default.
Tracking Port	Type the port number for the ExpressConnect Tracking service or (recommended) accept the default.
Tracking URL	Type the URL for the Tracking service or (recommended) accept the default.
Tracking HTTP version	Type the HTTP version for ExpressConnect Tracking service or (recommended) accept the default.

To configure this TNT Express carrier with the values in these fields, click SAVE at the bottom of the screen to save any changes you made or click CANCEL to revert to the original values.

ExpressLabel Tab

In addition to the ExpressConnect Web Services, Parcel interfaces with the TNT ExpressLabel server for printing labels. To use Parcel with this Web Service, you first need to register with TNT for this Web Service. Use this tab to enter the account and location information for this Web service.
Parcel uses the information in the following table to connect to the TNT Express Label server. Except for User ID and Password, Parcel populates these fields by default. Unless you receive specific instructions from TNT that the values for one or more of these parameters have changed, it is recommended that you accept the defaults.

ExpressLabel section

In this box...	Do this...
ExpressLabel User ID	Type in the User ID provided by TNT for accessing your ExpressLabel Web Service account.
ExpressLabel Password	Type in the password for accessing your ExpressLabel Web Service account.
ExpressLabel Host	Type the host name of the ExpressLabel server or (recommended) accept the default.
ExpressLabel Port	Type the port number of the ExpressLabel server or (recommended) accept the default.
ExpressLabel Url	Type the URL for the ExpressLabel server or (recommended) accept the default.
ExpressLabel HTTP version	Type the HTTP version for ExpressLabel server or (recommended) accept the default.

To configure this TNT Express carrier with the values in these fields, click SAVE at the bottom of the screen to save any changes you made or click CANCEL to revert to the original values.

Report Server Tab

Use the Reports tab on the TNT Express Account Defaults screen to enter settings related to the Jasper reporting tool.
Caution: If a field on this tab contains a default value, it is strongly recommended that you accept the default and do not try to enter a different value. If you think you need to change any of the default settings, contact Customer Support first at: 1.866.649.1900.

In this box...	Do this...
Location	Accept the default. This is the path to the directory where the Jasper report service is started. The current service deployment directory is fixed. Unless the service will be moved to another directory, the service should be started from the default location, which is: ..\Java
Report Format	Accept the default. This is the file format of the TNT Express reports. Currently, only PDF is supported.
Requestor	Accept the default: "Parcel" (without quotation marks) is the default Requestor.
Server Name	If the current service name appears as the default, accept the default. Otherwise, type the Jasper report service name. Unless the service will be recompiled with a new service name, the default service name should be used to start the report service.
Server Level	Leave this field blank or else type "debug" or "trace" (either without quotation marks) to log transactions taking place on the Server side. This sets the report service (Server side) debug logging level. Blank means normal, which means no debug logging.
Server Wait Time	The number of seconds to wait for the Jasper report service to start before sending an XML request.
Print Report	Select this check box to automatically send the report to the printer that is set in the printer map. If this check box is cleared, the report appears on the client screen (if a PDF viewer is installed on the client) and the user can select File > Print to print the report. If a PDF viewer is not installed on the client, the user is prompted to save the report file. Note: Each client workstation must have a PDF viewer (such as Adobe Reader) installed on it so that the user can print the report by selecting File > Print.
Enable Debugging	Select this check box to create the debug request and response files. (See the following rows. These files contain the transactions that occur on the client side). The debug files are useful in troubleshooting any problems.
Debug Request Filename	Type the path (to store) and the file name of the XML debug requests. Note: If a default path name and filename for the debug Request file appear in this field, you can edit the path name but do not edit the filename.
Debug Response Filename	Type the path (to store) and the file name of the XML debug responses. The response.xml file indicates success or any errors that occurred. Note: If a default path name and filename for the debug Response file appear in this field, you can edit the path name but do not edit the filename.

Click SAVE in the lower-right corner of the screen to save any changes you make or click CANCEL to revert to the original values.

Time in Transit Tab

Use the Time In Transit tab on the TNT Express Account Defaults page to enter settings related to time-in-transit for this TNT Express account.

In this box...	Do this...
Calculate Transit Time	To specify calculation of transit times, select (check) this check box. Parcel uses the data that you import using the Import Time in Transit Files screen for transit time calculations. *Note:* This check box is unselected by default.

Click SAVE in the lower-right corner of the screen to save any changes you made or click CANCEL to cancel changes and revert to original values.

Note: For information on configuring Time in Transit calculations, see the following Help topics:

Carrier Configuration > Overview of TINT Calculation
Carrier Configuration > Time in Transit Files
Carrier Configuration > Importing Time in Transit Files

Defaults

Address Tab

Use the Address tab on the TNT Defaults page to enter the default Ship From or distribution center (DC) location information for this TNT Express account. By default, the Address tab is automatically populated with the address information for the Location to which this TNT Express carrier was added. You can accept the default values or type in new values as necessary.

In this box...	Do this...
Name	Type the Ship From company name for this Location/Carrier Code or accept the default.
Attention	Type the name of the contact person at the Ship From address for this Location/Carrier Code or accept the default.
Address 1	Type the primary Ship From street address for this Location/Carrier Code or accept the default.
Address 2	Type any additional street address information for the Ship From address such as apartment number, suite, or floor for this Location/Carrier Code or accept the default.
Address 3	Type any additional street address information for the Ship From address such as apartment number, suite, or floor for this Location/Carrier Code or accept the default.
City	Type the Ship From city or accept the default.
State	Type the Ship From state or Province or accept the default.
Postal Code	Type the Ship From Postal Code or accept the default.
Country	From the drop-down list, select the Ship From country name or accept the default. Note: This Country must be a Country of Origin supported for Parcel. For the list of supported countries of origin, see the following Help topic:
Phone	Type the Ship From phone number or accept the default.

Click SAVE at the bottom of the screen to save the changes or CANCEL to cancel any changes.

Import Time in Transit Files

Transit time calculations for TNT Express require user-maintained transit time data. You can import this data into the Parcel carrier database using the Import Time in Transit Files screen. This feature also includes the capability for the user optionally to import and maintain carrier Holidays at the destination level for the Time in Transit calculation to include when calculating an expected delivery date.
You must create and maintain the following Time in Transit files for data import:

Geographical information (origin/destination cities, postal codes, etc.) - Required for first import.
Time in transit data based on carrier service and destination - Always required.
Holiday file containing information about destination holidays - Optional

When you import these files, Parcel inserts the data from these files into the TNT Express carrier database. If you have Time in Transit enabled, when you perform a Rate or Ship, Parcel displays the transit time for the shipment.
Notes:

Time in transit calculations for TNT Express is based on user estimate of typical delivery times for specific services and routes.
All files that you import must be located on a local drive of the DIServer. The absolute path that you specify according to the following table represents the file location on the DIServer.
This data does not come from TNT ExpressConnect and must be specified by the customer.

Import Time in Transit Files

Use the Import Time in Transit screen to import the following data files for transit times and locations (origins and destination (required files are in bold).
To import Time in Transit files:

Create the Time in Transit files (see the following section for file format information), and then copy these files to a directory local to the Parcel DIServer.

Use the Import Time in Transit screen in the Parcel Configuration (Web Admin) tool to specify the path names and filenames for these files according to the following table:

In this box...	Do this...
Geographic Data File	Type in or paste in the absolute local path for this file on the Parcel DIServer, including the filename. Note: This file is required the first time you import the set of Time in Transit files but is optional on subsequent file imports.
Time in Transit File	Type in or paste in the absolute local path for this file on the Parcel DIServer, including the filename.
Holiday File	Optionally, to include carrier holidays in Parcel's time in transit calculation, type in or paste in the absolute local path for this file on the Parcel DIServer, including the filename.

Format for Time in Transit Files

The time in transit files that you import (see previous section) must be comma-delimited CSV files of which the first row consists of the column (field) names listed in the following table. Subsequent rows contain comma-delimited data corresponding to the column names.
Notes:

You can copy and paste the following column name strings directly into the CSV file.
The values in the Geo Code fields can be arbitrarily defined, but since this column serves as the primary key, they must follow the same convention in all the files.
The Origin and Destination address data for a shipment must be identical to the corresponding data in the Geographic Data file (Address <n>, City, State).
The values for Transit Days and Transit Time are those estimated for the route defined by the Origin Geo Code and Destination Geo Core.

The values for the day columns in the Work Days file are: "y" (without quotation marks) if the day is a working day and "n" (without quotation marks) if it is not a working day.

File Type	Required column names
Geographic Data File	Address 1,Address 2,Address 3,City,State,Country,Low Postal Code,High Postal Code,Geo Code,Geo Code Description,Record Type
Time in Transit File	ServiceId,Origin Geo Code,Destination Geo Code,Transit Days, Transit Time(HH24:MM:DD)
Holiday File	Destination Geo Code,Holiday Date(YYYYMMDD),Holiday Description