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.
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.