Click or drag to resize

Return Codes

[This is preliminary documentation and is subject to change.]

This page lists the error codes which might be returned by a web service response.

Messages Sorted By Return Code

Return Code

Type

Message *

Explanation

Add Order

Add LTL Order

Get Rates

Update Order

Add Package

Add Item

Get Label

Closeout

Closeout Update Weight

Closeout With LTL

Add Consolidated LTL Shipment

Void Packages

Void Orders

Get ZPL Initialization Images

Get Order Status

Shipment Verification

1

Error

The credentials didn't match or were not provided.

The UserName and/or Password and/or ClientID was incorrect.

x

x

x

x

x

x

x

x

x

x

x

x

x

x

x

x

2

Error

The service code isn't valid.

The valid text for the each Service is: "9AM", "1030AM", "Saturday", "OSNR", "HFP", "NotifyConsignee", "DangerousLQ", "Dangerous500KG", & "DangerousRegulated"

x

x

x

3

Error

The specified Ship Method isn't valid.

Either the destination Postal Code is not serviced by Purolator, or the Ship Method text is not one of the following: "Air, "Ground", "PuroLetter", "PuroPak", "PuroPost", "Fastest", or "LTL"

x

x

x

x

x

x

4

Error

The specified Country isn't valid.

Either the two digit ISO 3166 Country Code or the full country name is accepted. See the Country Names tab.

x

x

x

5

Error

The specified Currency isn't valid. USD and CAD supported.

The only accepted currency codes USD and CAD.

x

x

x

6

Error

The specified PIN wasn't found in the database.

The pin number was not found.

x

8

Error

The supported label types are ZPL, ZPLIMAGES, and IMAGE.

The valid Label types are: "ZPL", "ZPLIMAGES", "IMAGE", and "NONE".

x

x

x

9

Error

The supported billing types are PREPAID, COLLECT, and 3RDPARTY.

The valid Billing Options are: "Prepaid", "Collect", and "3rdParty".

x

x

10

Error

Invalid Purolator account number.

The specified Purolator account number does not have the correct format.

x

x

10

Error

Invalid Purolator account number.

This account does not have access to the package with the matching Pin or PackageID.

x

11

Error

Invalid Order number.

No shipment with specified Order Number was found.

x

x

12

Warning

Invalid Contract number.

The contract number was not provided or was blank.

x

x

x

x

13

Error

Invalid Province for the postal code.

The specified Postal Code is not valid for the specified province.

x

x

x

14

Error

Only packages that are Ready for Pickup or Verified can be voided

The customer may only void a package/order until it is picked up by Purolator.

x

x

15

Error

9 AM service is unavailable for this location.

9:00 am service is unavailable for LTL shipments.

x

x

16

Error

10:30 AM service is unavailable for this location.

10:30 am service is unavailable for LTL shipments.

x

x

17

Error

Saturday service is unavailable for this location.

Saturday service is unavailable for LTL shipments.

x

x

18

Error

Only one time/date service may be selected.

More than one of the following mutually exclusive time services was specified: 9AM, 1030AM, SATURDAY

x

x

x

20

Error

Only one Dangerous Goods service may be selected.

More than one of the following mutually exclusive dangerous goods services was specified: DANGEROUSLQ, DANGEROUS500KG, DANGEROUSREGULATED

x

x

x

21

Error

Dangerous Goods cannot be selected with Saturday service.

Dangerous Goods cannot be selected with Saturday service.

x

x

22

Error

Dangerous Goods cannot be shipped to beyond points.

Dangerous Goods cannot be shipped to beyond points.

x

x

23

Error

Dangerous Goods Limited Quantities and Dangerous Goods 500 KG Exemption packages are limited to 66 lbs.

Dangerous Goods Limited Quantities and Dangerous Goods 500 KG Exemption packages are limited to 66 lbs.

x

x

x

24

Error

Dangerous Goods Limited Quantities and Dangerous Goods 500 KG Exemption shipments must be shipped ground.

Dangerous Goods Limited Quantities and Dangerous Goods 500 KG Exemption shipments must be shipped ground.

x

x

25

Error

Dangerous Goods Fully Regulated shipments are limited to 1000KG (2204 lbs).

Dangerous Goods Fully Regulated shipments are limited to 1000KG (2204 pounds).

x

x

x

26

Error

9:00am, 10:30am and Saturday shipments must be shipped via the fastest ship method

For 9:00am, 10:30am, and Saturday services, Ground may not be selected if Air is faster and visa versa.

x

x

27

Error

9:00am, 10:30am and Saturday shipments must be shipped to a location with one day delivery

The specified destination does not offer 9:00am, 10:30am, or Saturday services.

x

28

Error

Dangerous Goods cannot be shipped to points serviced by ferries.

Dangerous Goods cannot be shipped to points serviced by ferries.

x

x

29

Error

Hold For Pickup and OSNR - Signature Not Required may not be selected together.

Hold For Pickup and No Signature Required may not be selected together.

x

x

30

Error

Order number is required.

The Order Number for the shipment is a required field.

x

x

31

Error

Ship Date is required.

The Ship Date is a required field.

x

x

x

32

Error

Either PackageID or PIN is required.

Get Label requires either the package's Pin or its PackageID.

x

33

Error

Valid PackageID or PIN is required.

No package with the specified Pin or PackageID was found.

x

34

Error

Existing Order number is required.

The Order Number specified in the request could not be found.

x

x

x

x

35

Error

LTL shipments must be standard delivery time.

LTL shipments cannot be marked for 9AM, 1030AM, or SATURDAY delivery.

x

x

x

36

Error

Each order number must be unique.

An Order Number cannot be used on more than one shipment within the same Account.

x

x

37

Error

Dangerous Goods may not be shipped to US or international destinations.

Dangerous Goods may not be shipped to US or international destinations.

x

x

38

Error

Shipments to the US are limited to 551 lbs.

A shipment to the United States cannot weigh more than 551 pounds.

x

x

x

39

Error

This account is not authorized to ship to US destinations.

This account is not authorized to ship to US destinations.

x

x

x

40

Error

The Consignee name is required.

The name of the consignee is required when Hold For Pickup is selected.

x

x

41

Error

The destination address requires a postal code.

The destination address requires a street address.

x

x

42

Error

The Consignee postal code is required.

The destination address requires a postal code.

x

x

x

43

Error

The Consignee phone number is required.

A valid phone number is required if Hold For Pickup is selected.

x

x

44

Error

The Consignee city is required.

Consignee City is required.

x

x

x

45

Error

The Consignee province is required.

Consignee Province is required.

x

x

x

46

Warning

The Consignee email is required for shipments with advanced notification.

Consignee Email is required for shipments with advanced notification.

x

x

47

Warning

The Consignee email is required for shipments with advanced notification.

If provided, the Consignee Email should be properly formatted.

x

x

49

Error

Consignee postal code must be properly formatted.

Consignee postal code must be properly formatted.

x

x

x

50

Error

The Sender's name or company is required.

Sender's name or Company is required.

x

x

51

Error

The Sender's street address is required.

Sender's address requires a street address.

x

x

52

Error

The Sender's postal code is required.

Sender's address requires a postal code.

x

x

54

Error

The Sender's city is required.

Sender's city is required.

x

x

55

Error

The Sender's state or province is required.

Sender's state or province is required.

x

x

56

Error

The Sender's postal / zip code must be properly formatted.

Sender's postal or zip code must be properly formatted.

x

x

58

Error

Declared Value insurance is not available for LTL Shipments.

Declared Value insurance is not available for LTL Shipments.

x

x

x

59

Error

At least one Item is required for customs.

Item information is required for Customs if Purolator is handling customs for a Canadian bound shipment or if the shipment is a US bound shipment.

x

x

x

60

Error

A valid SKU is required.

The item's SKU is required.

x

x

x

61

Error

Customs description for items is required.

A short description of each item is required by customs.

x

x

x

62

Error

Billing Account is required.

The Billing Account is required for COLLECT and 3RDPARTY billing types.

x

x

63

Error

Item values must be greater than $1 CAD.

Item values must be greater than $1 CAD.

x

x

x

64

Error

Item Quantity is required.

Item quantity is required.

x

x

x

65

Error

The date is too old to be used.

The Ship Date must be the day the request is submitted, or later.

x

x

x

66

Error

The maximum declared value is $5,000.

Declared value for a shipment must be between $0 and $5,000 USD, inclusive.

x

x

x

67

Error

This package is too heavy.

A package may not weigh more than 150 pounds.

x

x

x

68

Error

This package is too heavy for a time/date service shipment or to a beyond point.

A package weighing more than 70 pounds cannot be shipped using a time/date service or shipped to a beyond point.

x

x

x

69

Error

The package is too long.

An Air package cannot have a length larger than 96 inches/144 centimeters. A Ground package cannot have a length larger than 120 inches/300 centimeters.

x

x

x

70

Error

The package is too large.

An Air package cannot have a dimension product (length + 2*(height + width)) larger than 144 inches/370 centimeters. A Ground package cannot have a dimension product larger than 216 inches/550 centimeters.

x

x

x

71

Error

There are no packages to close out.

There are no packages to close out.

x

x

x

72

Warning

There are no packages to rate.

Packages with the correct weight and dimensions are required to rate a shipment accurately.

x

73

Error

There are no packages.

There are no packages.

x

x

x

75

Error

Each package must have a positive weight.

Packages with a zero weight can be entered, but the weight must be corrected before the shipment can be shipped.

x

x

x

76

Error

Each package must have a package number.

The Package Number was not provided for at least one package.

x

x

x

77

Error

Each package is required to have all three dimensions set to at least 1 inch.

If the package dimensions are specified all must be larger than 0.

x

x

x

78

Error

Declared Currency must be CAD or USD.

x

x

79

Error

Customers using Purolator for Customs Clearance must include a list of packages to closeout.

Customers using Purolator for Customs Clearance must include a list of packages to closeout.

x

x

x

80

Error

The PackageID must be unique.

Two non-void packages in the same Purolator Account cannot have the same Package Number.

x

x

x

x

81

Error

Air service is not available to this postal code.

Air was specified, but Air service is not available to this postal code.

x

x

x

x

82

Error

Ground service is not available to this postal code.

Ground was specified, but Ground service is not available to this postal code.

x

x

x

x

86

Error

Sum of Items total values is too large for PASS clearance.

The total value for all Items listed cannot exceede $1600 CAD.

x

x

x

87

Error

Web services Closeout PackIDType must be Pin or PackageID.

Web services Closeout PackIDType must be 'Pin' or 'PackageID'.

x

x

x

88

Error

The following packages do not exist or are not available for closeout:

The following packages do not exist or are not available for closeout.

x

x

x

89

Error

Southbound shipments must originate in Canada.

Southbound shipments must originate in Canada.

x

x

93

Error

Return shipments must be sent from a Canadian address.

Return shipments must be sent from a Canadian address.

x

x

94

Error

Return shipments must be sent to a Canadian address.

Return shipments must be sent to a Canadian address.

x

95

Error

Return shipments may not be Puro Letter or Puro Pak.

Return shipments cannot be PuroLetters or PuroPaks.

x

x

96

Error

Return shipments may not be LTL.

Return shipments cannot be LTL shipments.

x

97

Error

Return shipments may not be Collect or third party.

Return shipments cannot be Collect or Third Party shipments.

x

99

Error

The Ship To Country is required and must be a two digit ISO 3166 Country Code (US - United States, CA - Canada).

The Ship To Country is required and must be a two digit ISO 3166 Country Code (US - United States, CA - Canada).

x

x

x

101

Error

The origin is invalid.

The Postal Code in the from address is not a valid Canadian Postal Code. (Spaces, dashes, and capitalization differences are ignored.)

x

x

x

x

102

Error

The destination is invalid.

The destination Postal Code/ZIP Code is not valid. (Spaces, dashes, and capitalization differences are ignored.)

x

x

x

x

103

Error

Purolator doesn't service this origin.

The Postal Code in the from address may be valid, but it is not serviced by Purolator.

x

x

x

x

104

Error

Purolator doesn't service this destination.

The destination Postal Code may be valid, but it is not serviced by Purolator.

x

x

x

x

105

Error

Invalid sort code.

Purolator does not ship to this destination.

x

x

x

x

106

Error

Invalid transit code.

Purolator does not ship to this destination.

x

x

x

x

199

Error

Unexpected error occurred when trying to make service calculations.

An unexpected internal problem occurred when attempting to determine which services to the destination address are available.

x

x

x

x

201

Error

The update type is not supported.

x

202

Error

Web services Closeout PalletIDType must be TrackNo or PalletID.

x

203

Error

The PARS number must be unique

x

x

x

205

Error

Each package is required to have minimum dimensions of {0}.

x

x

x

206

Error

Dangerous Goods are prohibited for this ship method.

x

x

x

207

Error

This service type does not support Third Party or Collect billing.

x

x

208

Error

This product may not have more than {0} package(s).

x

x

x

209

Error

This product must have at least {0} packages.

x

x

x

210

Error

This product requires a shipment of at least {0} lbs.

x

x

x

211

Error

This product has a maximum shipment weight of {0} lbs.

x

x

x

1000

Error

Name or Company is required.

x

x

1001

Error

Name is too long.

Name cannot be longer than 50 characters.

x

x

1002

Error

Company is too long.

Company cannot be longer than 50 characters.

x

x

1051

Error

Address 1 is too long.

Address 1 cannot be longer than 50 characters.

x

x

1052

Error

Address 2 is too long.

Address 2 cannot be longer than 50 characters.

x

x

1053

Error

Address 3 is too long.

Address 3 cannot be longer than 50 characters.

x

x

1055

Error

Purolator cannot ship to post office boxes.

x

x

1101

Error

Postal Code is too long.

Postal Code cannot be longer than 10 characters.

x

x

x

1151

Error

City is too long.

City cannot be longer than 30 characters.

x

x

x

1201

Error

Province/State must be a two character abbreviation.

Province/State cannot be longer than 2 characters.

x

x

x

1261

Error

Email is too long.

Email cannot be longer than 40 characters.

x

x

1301

Error

Phone is too long.

Phone cannot be longer than 20 characters.

x

x

1402

Error

All packages must have a weight greater than 0.

x

2002

Error

Orders must be LTL ship type.

x

2003

Error

All orders in an LTL shipment must have the same consignee address.

x

2004

Error

ProNumbers for LTL Shipments must be unique.

x

9011

Error

Order Number is too long.

The shipment's Order Number cannot be longer than 50 characters.

x

x

9012

Error

Currency is too long.

The Currency Code cannot be longer than 3 characters.

x

x

x

9015

Error

Reference is too long.

The Reference field cannot be longer than 50 characters.

x

x

9016

Error

Reference2/Note is too long.

The Reference2/Note field cannot be longer than 50 characters.

x

x

9017

Error

PO Number is too long.

The PO Number field cannot be longer than 50 characters.

x

x

x

9020

Error

Package Number is too long.

The package's Package Number cannot be longer than 50 characters.

x

x

9025

Error

SKU is too long.

The package's SKU cannot be longer than 25 characters.

x

x

x

9026

Error

Description is too long.

The package's Description cannot be longer than 50 characters.

x

x

x

9027

Error

HSCode is too long.

The package's HSCode cannot be longer than 20 characters.

x

x

x

9999

Error

Unhandled Exception

The web service encountered an unexpected problem and was unable to process the request properly.

x

x

x

x

x

x

x

x

x

x

x

x

x

x

x

x

* The error message may contain additional information, for example specifying which package Pin in a shipment is invalid.