In this Guide

Account Number and Services

Account Number and Services

When you add a new Canada Post carrier account, the page to enter the Canada Post account number appears. On this page, you also select the Canada Post services with which you will ship packages from this location.
To configure the Canada Post account number and services, complete these steps...

In the Account Number field, type the seven-digit Canada Post account number for this location. Be sure to enter exactly seven digits. If it is not seven digits, tracking errors can occur.
In the Domestic Code field, type a name for the carrier as you want it to appear in this Configuration Tool and in Parcel. For example, if you are setting up more than one Canada Post account for this location, you might want to type CAPO-2 if this is the second Canada Post account for this location.
In the Services section, select the services that you will use to ship Canada Post packages from this location by moving them from the left-hand column to the right-hand column. 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.

Service	Description
Expedited Parcel	Domestic - delivery within one to seven days
Regular Parcel	Delivery within two to nine days
Priority	Domestic - delivery usually by noon the next day
XpressPost	Domestic - Delivery by the end of the next day if local, up to days elsewhere.

4. When you are done configuring this page, click ADD in the lower-right corner of the page to save the settings. Otherwise, click [CANCEL] to cancel the settings.

To continue configuring Canada Post, complete the following sections:

AccountDefaults
Split Horizon
TrackFormat
Zone Rate Mapping

Configuring Time in Transit Calculation with Canada Post

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 screens are available for importing and editing time in transit data:

Geographic Code
Transit Days
Holidays
Import Time in Transit Files

For more information on time in transit calculation, see the following Help topic: Overview of Time in Transit Calculation .

Account Defaults

Overview

Use the following tabs on the Canada Post Account Defaults page to configure the default information to use with this Canada Post account.
Tabs

Account
Default
SystemTab
Tracking
Report
Time in Transit

Account Tab

Use the Account tab on the Canada Post Account Defaults screen to enter the account information for a Canada Post account.

Note: The following information is based on the Canada Post eLink electronic data file format. See the Canada Post Web site for the latest eLink data file specification.

In this box..	Type this..
Version No	Enter the version number of the Canada Post eLink electronic data file format that is being used or accept the default. *Note:* Parcel displays the current version number in this field by default; for example 12.
Contract No	Enter the contract number for the account.
Record Type	Enter the record type for the account or accept the default; for example H.
Induction Site	Enter the Induction Site Number of the Induction Site for the account. This is the induction site responsibility number assigned by the Canada Post Corporation (CPC).
Record Number	Enter the record number for the account or accept the default; for example 2.
Trailer Version Number	Enter the trailer version number for the account.
Trailer Record Type	Accept the default for the trailer record type for the account. The trailer record provides the total number of all record types that are being submitted in the eLink file to ensure that all lines are received and so indicates that the transmission has ended. The trailer record is identified by the record type "T" (without quotation marks - the default value for this field). Note: The record must contain 8 fields.
Trailer Record Version	Enter the trailer record version for the account or accept the default; for example 2.
Rate Type	From the drop-down list, select one of the following rate types: Non-Generic Generic Custom *Note:* The default value for this field is Generic.
Rates To Use	From the drop-down list, select one of the following rates to use to specify whether rates are account specific or list rates. List Rates Negotiated Rates *Note:* The default value for this field is List Rates.

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

Default Tab

Use the Defaults tab on the Canada Post Account Defaults page to enter default values for use with this Canada Post account.

Unless otherwise noted, all settings apply only to this Canada Post account at this location.

Note: To calculate Sales Tax when rating Canada Post shipments in Parcel, select the Calculate Sales Tax check box.

In this box...	Do this...
DC ID	Accept the default of the Shipper ID you entered when creating the location under which this Canada Post carrier is configured or, if different from the default, enter the ID of the distribution center (DC) ID that will use this Canada Post account.
Volume Key	Enter the dim weight factor. This is the factor by which the volume is divided to determine the dimensional weight.
Currency	Accept the default "Canadian Dollar" currency type or, if different, select another currency from the drop-down list.
Template Dir	Accept the default path (..\templates) to the directory where the CAPO label templates reside or, if different, enter the new path. It is recommended that you accept the default.
Printer Name	Type the name of the printer that you will use to print Canada Post shipping labels. Note: The printer settings in the Printer Map screen for the location override this setting.
Label Date Format	Accept the default of ddmmmyyyy for the date format for labels or, if different, enter the desired date format. Valid values are as follows: DDMMYY YY MMddyy Mmddyyyy yyyyMMdd ddMMMyy ddMMMyyy ddmmmyyyy y
DPRN Date Format	Accept the default date format (G) for the PNG printer used to print reports and manifests or, if different, enter the desired date format (see following note). Note: The DPRN date format is the single-character code for the date format on reports printed from Parcel. Valid values are as follows: G – General date format (Year/Month/Day) E – European date format (Day/Month/Year)
Purge Days	Accept the default (90) or, if different, enter the number of days after which a purge of records will be performed on the carrier database.
Spot Rating	This field is not used.
Sales Tax Calculation	Select this check box for Parcel to calculate the sales tax. Note: This check box is de-selected (cleared) by default.
Weight UOM	Accept the default Unit of Measure (UOM) for the weight (Kilograms) or select another Weight UOM from the drop-down list.
Dimension UOM	Accept the default Unit of Measure (UOM) for dimension (Centimeters) or select another Dimension UOM from the drop-down list.
Origin SAC	Accept the default Service Area Code for the origin or, if different, enter a new, two-character Province code. Note: This field is populated from the value in the State/Province field on the Location Defaults screen for the location, using the two-character abbreviation for the Canadian province; for example: ON for Ontario. This value is used in transit day calculations.
COD Cheque Max Amount	Accept the default for the maximum amount allowed for a COD check in terms of the specified currency or enter a different amount. Caution: Do not use commas, a decimal, or a currency symbol.
COD Cash Max Amount	Accept the default for the maximum amount allowed for a COD cash payment in terms of the specified currency or enter a different amount. Caution: Do not use commas, a decimal, or a currency symbol.
Coverage Amount	Accept the default for the amount of insurance in the specified currency that Canada Post provides for free or if different enter this amount. Caution: Do not use commas, a decimal, or a currency symbol.
Line home	Enter the coordinate where printing begins on the label (the line home); for example 10. Note: The value of this coordinate depends on the label printer. Refer to your printer documentation for more information.
Rate Level	Enter the rate level of your Canada Post rates. Canada Post supports 16 levels of rates (numbered 0 through 15). See the Canada Post Web site for a description of these rate levels.
FS System Pneumonic	Accept the default or enter a new acronym for your Parcel system if desired.
FS System Version	Accept the default or, or, if different, enter the version number of your Parcel system.
Zip Char	Accept the default for significant character for the "Ship From" postal code or enter, if different enter a new value. For "Ship From" postal codes in Canada, this value is 3 (the default).
Remittance Form Copies	Accept the default for the number of copies of the remittance form to print or, if different, enter a new value.
Origin Destination Base	Accept the default for the country on which to base the international character set translation on or, if different enter a new value. Valid values are as follows: O – Origin Country D – Destination Country Note: This field currently applies only to Zebra printers.
Packaging Type Rating	To include the packaging type in rating calculations, select this check box.
Default Packaging Type	Enter the code for the default packing type. Valid values are as follows: u – Parcel p – Packet
FS System Version Date	Accept the default date on which the Parcel system was last updated (format: yyyymmdd). Note: This date prints on the manifest.
Declaration Statement	This field is not used.

Fuel Surcharge Section
Notes:

The percent factors for the following fuel surcharges are set monthly by Canada Post.
Enter the percentages in the following fields as decimal percents without the % sign. For example, enter 1.51% simply as 1.51.

In this box...	Do this...
Expedited Parcel Fuel charges	Enter the Fuel charge as a percent to be applied for the Expedited Parcel Service.
Regular Parcel Fuel charges	Enter the Fuel charge as a percent to be applied for the Regular Parcel Service.
Priority Fuel charges	Enter the Fuel charge as a percent to be applied for the Priority Service.
Xpresspost Fuel charges	Enter the Fuel charge as a percent to be applied for the Xpresspost Service.

System Tab

Use the System tab on the Canada Post Account Defaults page to enter system-related values for use with this Canada Post account.

Unless otherwise noted, all settings apply only to this Canada Post account at this location.

Top section

In this box...	Do this...
Vendor ID	Enter the Vendor ID Number assigned by the Canadian Department of Supply & Services (CDSS). This is used when generating the unique manifest number. Note: The maximum length for this value is three digits.
Specification Number and Version	Accept the defaults of 3509 V13 for the Specification Number (3509) and Version (13). These are values internal to the system.

Manifest section

In this box...	Do this...
Append manifest to ESM	To append the manifest to the ESM file, select this check box.
Min File Number	Enter the minimum file number for manifest files or accept the default of 1.
Max File Number	Enter the maximum file number for manifest files or accept the default of 99999999.
Manifest Number Increment By	Enter the amount to increment the Manifest File Number by or accept the default of 1.

ESM Upload section

In this box...	Do this...
Site ID	Enter the Site ID for the SFTP site assigned by Canada Post.
SFTP Upload	Select this check box to transmit the Electronic Shipping Manifest (ESM) to the CAPO SFTP server.
SFTP Server	Enter the host name or IP address of the Canada Post SFTP server where you upload ESM files; for example: secure.cpclink.ca
SFTP Port	Enter the port number for the Canada Post SFTP server (if different from the default) or accept the default of 22.
SFTP User ID	Enter the user ID provided by Canada Post for your account on the SFTP site.
SFTP Password	Enter the password provided by Canada Post for your account on the SFTP site.
SFTP Directory	Enter the SFTP directory path where uploaded ESM files are stored if this path is provided by Canada Post. Note: If the directory path is not provided, leave this field blank.
SFTP File Path	Enter the path to the local directory for the ESM file.

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

Tracking Tab

Use the Tracking tab on the Canada Post Account Defaults page to enter settings related to tracking for this Canada Post account.

In this box...	Do this...
Track URL	Type the URL of the Canada Post tracking site or accept the following default: {+} https://obc.canadapost.ca/emo/basicPin.do+
Host Name	Type the IP address of the Stunnel host. Parcel uses Stunnel to send and receive files to and from Canada Post.
User ID	Type the user ID for the tracking site.
Password	Type the password for the tracking site.
Tracking Page	Type the address of the tracking page or accept the following default: sap/bc/soap/rfc?sap-client=100
Track Number Repeat Warning	If a Canada Post package has a tracking number that was used before for a different Canada Post package, Parcel can display a warning to the user. To enable this feature, select this check box.
Tracking Type	Accept the default of dom to indicate that the tracking numbers are for domestic services.
Mini Tracking Quantity	Type the minimum quantity of tracking numbers. The default is 10.

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

Report Tab

Use the Reports tab on the Canada Post 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...
Output report location	Type in the path name where you want the Jasper report files to be saved.
Report version	Accept the default Jasper Reports version unless you are positive that the actual version differs from the default value.
Jasper Server 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
Jasper 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.
Jasper Server IP	Type in the IP address for the Jasper server or accept the default.
Jasper Server Port	Type in the Port Number for the Jasper server or accept the default.
API Report Printer Name	Type in the name of the printer to use for printing Jasper reports.

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.

Time in Transit Tab

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

In this box...	Do this...
Calculate Transit Time	To specify the 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:

Overview of TINT Calculation
Transit Days, Weekends, and Holidays
Time in Transit Files (includes Geographic Codes)
Importing Time in Transit Files

Split Horizon

What is Split Horizon?

Determining shipping rates and accessorials is typically accomplished by querying a database with rate and accessorial tables supplied by the carrier. Most carriers have a default set of list rates and accessorials that they publish annually or semiannually. In addition to list rates and accessorials, some large shippers negotiate their own custom rates with a carrier.
Because carriers may decide to change their rates at any time during the year, there is a date when a set of rates goes into effect. There may also come a date when the current set of rates is no longer in effect. This means that more than one set of list rates can be stored in the database simultaneously, including custom rates. Split horizon rating provides a way to automatically determine the correct rates to use.
Use the Split Horizon screen to define Split Horizon tables for rates and accessorials.

Note: For additional information on working with tables in the Parcel Web Admin tool, see the following Help topic: How to Add, Edit, or Delete Table Entries .
Add a Split Horizon Table

Click the 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 table shown below.
Click SAVE in the lower-right corner of the screen to save the new Split Horizon table or click CANCEL to cancel the Add.

Note: If you use the Split Horizon feature (multiple rate files per carrier), select the Split Horizon table that you want these changes applied to from the Split Horizon Table Selection list at the top of the page.

In this box...	Type this...
Start Date	The date that the rates become effective in the form yyyymmdd; for example: 20081215
End Date	The last date that the rates or accessorials are effective in the form yyyymmdd; for example: 20121215
Start Time	The start time when rates or accessorials are effective using 24-hour notation and no colon (hhmm); for example: 0900 for 9:00 AM local time Note: Use this field together with the End Time field (following row) to indicate the range of time that this rate table is effective during the day.
End Time	At the end of the time period that the rates or accessorials are effective for. Note: Use this field together with the Start Time field (previous row) to indicate the range of time that this rate table is effective during the day. If rates are to be effective for the entire 24-hour period, set Start Time to 0000 and End Time to 2359.
Specific Day	The three character abbreviation for the day of the week that these rates apply or type "ALL" (without quotation marks) to indicate that the rates or accessorials apply to all days of the week.
Table Type	The table type; for example: "accessorials" (without quotation marks).
Table Name	The table name.
Description	A user-friendly description of the Split Horizon table (not required).

Edit or Delete a Split Horizon table

To edit a Split Horizon table:

Select the row that you want to edit by clicking the far-left column of the row.
Note: You can select more than one row by holding down the left mouse and dragging the mouse. Or hold down the Ctrl key on your keyboard and click specific rows.
Click the EDIT icon at the top of the screen 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 Split Horizon table from the displayed list of tables:

Select the row, and then click the DELETE icon.
A confirmation dialog opens. Click Yes to delete the table or click No to keep the table.

Track Format

The Canada Post tracking number is a 16-digit number that consists of a 7-digit character number (Track Header), an 8-digit sequential number, and a MOD 10 check digit. The track format is saved in the track_format table.

Parcel generates tracking numbers for Canada Post carriers using a unique 8-digit sequential number across all carrier services.

Note: For additional information on working with tables in the Parcel Web Admin tool, see the following Help topic: How to Add, Edit, or Delete Table Entries .

Enter Track Format information for the following fields:

In this box...	Type this...
Service	The name of the carrier's service that this Track Format applies to. Type ALL for all services. (ALL is the default value.)
Track Length	The total length of the Track string. The default value for TrackLength is 16.
Track Mod Digit	The modulus (MOD) for the tracking number check digit algorithm. By default this is 10. The Canada Post module uses this number with its check digit algorithm to verify the tracking number.
Track Seq Pos	The position in the tracking number where the Sequential number begins; that is, its index. The default value for this number is 8.
Track Seq Len	The length of the sequential number that Parcel appends to the Canada Post Track Header to generate a unique tracking number. The default value for the sequential number is 8.
Track Check Pos	The position in the tracking number for the check digit; that is, its index. The default value for this number is 16 (meaning that the check digit is appended to the end of the tracking number).
Track Check Len	The length of the check digit appended to the Tracking Number. The default value for length of the check digit is 1. (Using 10 for a modulus causes the check digit to be a number in the range 0-9).
Track Calc Start	The position in the tracking number at which the check digit algorithm starts its calculation. By default, this value is 1.
Track Calc End	The position in the tracking number at which the check digit algorithm ends its calculation. By default, this value is 15 (Header length plus Sequential Number length).
Track Header	The string that represents the header of the tracking number. The TrackHeader is the 7-digit number assigned to each customer by Canada Post.
Track Header Pos	The position in the tracking number where the Track Header begins, that is, its index. The default value for this field is 1.
Track Header Len	The length of the Track Header string. Since the Header provided by Canada Post consists of 7 digits, this should be 7 by default.
Track Tail	The string that represents the "tail" of the tracking number. By default, there is no Track Tail, and so this field has a NULL (blank) entry in the track_format table.
Track Tail Pos	The position in the tracking number where the tail begins; that is, its index. Since, by default, there is no Track Tail (see row above), the default value for this field is 0.
Track Tail Len	The length of the Track Tail string. Since, by default, there is no Track Tail (see rows above), the default value for this field is 0.
Track Multiplier	A string that represents the multiplier used to calculate check sums.

Zone Rate Mapping

Use the Zone Rate Mapping screen to add, edit, delete zone rate map records for Canada Post.

Note: For additional information on working with tables in the Parcel Web Admin tool, see the following Help topic: How to Add, Edit, or Delete Table Entries .

Add a Zone Rate Map Record

Click the ADD icon at the top of the screen. The Add Record dialog box appears.

Complete the boxes as follows:

In this box...	Do this...
Service	Type the API code for the Canada Post service ( Canada Post > Supported Services) that this record applies to.
File Type	Type "r" or "z" (without the quotes) for the type of table that is being mapped: r - rate table z - zone table
Table Name	Type the file name of the table file.
Effective Date	Type the effective date of the table file.
Expiration Date	Type the expiration date of the table file.
UOM	Type "LBS" or "KGS" (without the quotes) for the unit of measure (UOM) to use when using this table file and service.

Click SAVE to save the new record. Otherwise, click CANCEL to cancel the new record.

Edit a Zone Rate Map Record

Click EDIT icon in the left column in the row containing the record that you want to edit.
A dialog box appears. Edit the fields as needed.
Click SAVE at the bottom of the dialog box to save the changes or click CANCEL to revert to previous values.

Delete a Zone Rate Map Record

Click the DELETE icon in the left column in the row containing the record that you want to delete.
A confirmation dialog box appears. Click OK to delete the record or click Cancel to keep the record.

Defaults

Address Tab

Use the Address tab on the Canada Post Defaults page to enter the default "Ship From" or 'distribution center' address for this Canada Post account.
Note: The fields on this screen are automatically populated with the information entered on the Location Details screen . If you change this information on the Defaults Address tab, Parcel uses the information entered on this tab as the "Ship From" Address on the Warehouse screen.

In this box...	Do this...
Company Name	Type the "Ship From" company name if different from the default.
Contact Name	Type the name of the contact person at the "Ship From" address if different from the default..
Address 1	Type the "Ship From" street address if different from the default..
Address 2	Type any additional street address information for the "Ship From" address such as suite or floor.
Address 3	Type any additional street address information for the "Ship From" address such as suite or floor.
City	Type the "Ship From" city if different from the default..
State/Province	From the drop-down list, select the "Ship From" province code if different from the default..
Postal Code	Type the "Ship From" postal code if different from the default..
Country Code	From the drop-down list, select Canada (the default value).
Phone	Type the "Ship From" phone number if different from the default..
Fax	Type the "Ship From" fax number if different from the default..
Telex	Type the "Ship From" telex number.
Email ID	Type the "Ship From" primary e-mail address. This is used for notification e-mails from Canada Post.
Alternate Email ID	Type a secondary "Ship From" e-mail address. This is used for notification e-mails from Canada Post.
Shipper Customer Reference Number	Type the customer reference number assigned by the shipper.

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