Error Codes

Overview

If a request fails, the PB Shipping APIs return an error object in the response body. The object includes an error code and a human-readable error message. Depending on the error, the object might also include additional information, such as the names of parameters where the error occurred.

The PB Shipping APIs return the error codes listed here. For additional information on an error, click the SOLUTION link when available. If you receive an error that is not listed here, please contact Client Support at ClientSupportTechServices@pb.com or +1(844) 470-6626. See also the Troubleshooting page and the Pitney Bowes API Status Page.

7-Digit Error Codes

100####

Error Code	Error Description
1000001	Invalid Carrier
1000002	Invalid value for Accept-Language in http header, ex: en-US.
	No Tracking data available for the referenceNumber
1000003	Invalid reference number
1000004	Invalid clientId
1000005	Internal server error
1000007	Invalid/missing partner id in the request header	Contact Us
1000011	Invalid or unsupported value for carrier.
1000032	Authentication error occurred.
1000033	Unauthorized API Access for given credentials.
1000042	Invalid value for rateTypeId.
1000045	Invalid or missing value for {1}
1000046	Invalid shipmentOptions.
1000049	Invalid elements in document.
1000050	Invalid JSON Structure.
1000051	Invalid Carrier Authentication Detail.
1000052	Invalid use of rate plan in request header
1000053	Missing required rate plan in request header
1000500	System error from {carrier}	Contact the carrier, using the information provided
1000502	Unparsed address lines cannot exceed 12 lines.
1000503	Invalid senderUserId {1}
1000504	More than one rate object under shipment is not allowed
1000505	Country Code must be 2 letters.	SOLUTION
1000506	Invalid or missing Shipment Option.	SOLUTION
1000510	Invalid Shipment Option with documentType {1}
1000511	Invalid documentType for {1} shipment
1001320	System error from {1}
1005001	The address is invalid.
1005002	The consignee information is invalid.
1005003	The COP transportation information is invalid.
1005004	The requested return currency is invalid.
1005005	The request currency is not supported for the target country.
1005006	The order cannot be shipped by the method selected.
1005007	The order value has exceeded the allowed value.
1005010	There are errors at the Quote Line Level
1005011	There are errors at the Quote Item Level
1005013	The address has missing fields
1005014	Missing fields in basket
1005015	Invalid fields in basket
1005016	The consignee information is missing
1005017	The COP transportation information is missing
1005018	Shipping Speed or service unavailable
1005019	Missing Basket
1005020	Missing Parcel Fields
1005021	Missing fields in the basket commodity source
1005022	Seller has missing fields
1005023	Seller has invalid fields
1005103	Invalid/Missing User Id.
1005555	Fedex Rating is not responding at this moment. Please try again later	SOLUTION
1006001	The commodity is invalid
1006002	The commodity is too large to ship (length, width or height)
1006004	The commodity has a negative price
1006005	The commodity’s price was too low and did not have a dutiable value.
1006006	The item price exceeds maximum
1006007	Item weight exceeds maximum
1006009	The Commodity is restricted for this Country of Destination
1006010	Commodity cannot be quoted.
1006012	Categories associated with the commodity are not available for quoting
1006013	Categories associated with the commodity are restricted for this country of destination
1006014	Category associated with commodity is invalid
1007001	Order value exceeded on this line
1007003	The quantity is invalid or missing
1007006	Missing fields in basket line
1007007	Invalid fields in basket line
1007123	Invalid/Missing Password.
1009997	Invalid JSON structure under {1}.
1009998	Invalid value for {1}
1009999	A system error occurred, try again later. If the error persists, please contact the service provider.	Contact Us

101####

Error Code	Error Description
1010101	Either Invalid or missing street or stateProvince or postalcode for fromAddress Address
1010314	Too many empty fields {1}
1010990	Invalid or missing value for countryCode	SOLUTION
1012003	Company field cannot exceed {1} characters {2}
1012010	email field cannot exceed {1} characters {2}
1012012	Invalid/missing cityTown {1}
1012013	CityTown field cannot exceed {1} characters {2}
1012014	Invalid/missing stateProvince {1}
1012015	Invalid stateProvince field value. stateProvince field length has to be {1} characters {2}
1012016	Invalid/missing postalCode {1}
1012020	Only 3 address delivery lines are allowed {1}
1012021	Invalid/missing addressDeliveryLine1 {1}
1012022	AddressLines field cannot exceed {1} characters {2}	SOLUTION
1012038	Either companyName or name fields are mandatory
1012049	Provide at least one addressLine {1}
1019000	Invalid address provided.	SOLUTION
1019002	Invalid or missing value for countryCode.	SOLUTION
1019003	Either Invalid or missing street or stateProvince or postalcode.
1019999	A system error occurred, try again later. If the error persists, please contact the service provider.	Contact Us

102####

Error Code	Error Description
1021000	Invalid Future Shipment Date.
1021001	No rating rules found for provided combination.	SOLUTION
1021003	Invalid/unsupported {1} countryCode
1021012	Invalid/missing Origin City
1021013	Invalid/missing Destination City
1021105	Invalid/missing weight.
1021107	Length is greater than maximum allowed.
1021108	Length is less than minimum allowed.
1021109	Width is greater than maximum allowed.
1021110	Width is less than minimum allowed.
1021111	Height is greater than maximum allowed.
1021112	Height is less than minimum allowed.
1021115	Length must be longer than the height.
1021116	Length must be longer than the width.
1021117	Weight is greater than the maximum for the service.	SOLUTION
1021118	Weight is less than the minimum for the service.
1021119	Invalid special service {1} selected.	SOLUTION
1021120	Special service {1} is unsupported for the service.	SOLUTION
1021121	Special service {1} requires an input value.	SOLUTION
1021122	Special service {1} has an input value greater than the maximum for the special service.	SOLUTION
1021123	Special service {1} has an input value less than the minimum for the special service.	SOLUTION
1021126	Invalid/missing Postal Code for the recipient.
1021127	Provide a postal code that is of the correct format for the {1}.
1021128	WeightUOM is invalid, it must be either grams or hundredthsofanounce
1021129	WeightUOM {1} is invalid for the selected carrier
1021131	Dimension UOM {1} is invalid for the selected carrier
1021132	Invalid Dimensions.
1021133	ServiceId and specialService combination is not supported	SOLUTION
1021135	Length must be a properly formatted positive number.
1021136	Width must be a properly formatted positive number.
1021137	Height must be a properly formatted positive number.
1021138	Special Service input value must be a properly formatted positive number.	SOLUTION
1021141	Invalid combination of Service Id and Parcel type.	SOLUTION
1021142	Military parcelType to a non military destination is not allowed.
1021145	{1} phoneNumber Required
1021150	Missing or Invalid Return Receipt Number
1021151	Requested Dimensions outside the allowed limits. {1}, {2}, {3}
1021153	Missing or Invalid Email address for Inbound Transaction
1021154	Missing or Invalid Phone number for Inbound Transaction
1021155	Missing Name or Company Name for Inbound Transaction
1021203	Invalid value for ServiceId	SOLUTION
1021205	Invalid value for parcelType.	SOLUTION
1021210	{1} address is required
1021211	Duplicate special services not allowed.
1021239	rateTypeId {1} is invalid
1021240	Shipment direction is invalid
1021241	Invalid combination of Service Id, Option ID and Rate Type ID	SOLUTION
1021250	Invalid Integrator Rate Plan
1021251	Invalid Shipper Rate Plan
1021311	Invalid Origin/Destination Pair.
1021312	Shipper is not eligible for {1}
1021313	Invalid/missing value for {1}
1021314	ServiceId {1} is unsupported {2}.	SOLUTION
1021315	Mutually exclusive special services present in request.	SOLUTION
1021316	{1} is not allowed.
1021317	Special Service requires another special service as a pre-requisite.	SOLUTION
1021318	{1} is not able to serve the request. Please try again later.
1021319	{1} does not match with {2}
1021351	{1} Option Value is Invalid (true/false) is expected.
1022001	Invalid weight for {1}, {2}, {3}
1022002	Invalid length for {1}, {2}, {3}
1022003	Invalid width for {1}, {2}, {3}
1022004	Invalid height for {1}, {2}, {3}
1022005	Invalid special service value for {1}, {2}, {3}	SOLUTION
1022006	Invalid or unsupported special service for {1}, {2}, {3}	SOLUTION
1022007	Dimensions required for {1}, {2}, {3}
1022008	Invalid unit of measure for {1}, {2}, {3}
1022010	Dimensions greater than Max Length + Girth
1022021	Invalid/missing {1} countryCode.
1022022	Invalid/missing {1} postalCode.
1022024	Special Service {1} requires a prerequisite of one of the following: ({2}) or associated prerequisite value is too small.	SOLUTION
1022025	Special Service {1} is incompatible with {2}	SOLUTION
1022026	The Service or at least one of the included special services must be trackable.	SOLUTION
1022028	Special service {1} is incompatible with endorsement {2}
1022029	No Service Name, Service option, Rate Type combination found that matches the shopping request.
1025945	Invalid Destination
1026025	No Mailer ID For Plan
1026027	No Integrator Rate Plan
1026030	{1} is not associated with the {2} in the {3} carrier side
1029005	Invalid value for Girth (the sum of twice the width and twice the height).
1029999	A system error occurred, try again later. If the error persists, please contact the service provider.	Contact Us

103####

Error Code	Error Description
1039999	A system error occurred, try again later. If the error persists, please contact the service provider.	Contact Us

104####

Error Code	Error Description
1040153	Requested Debit Amount Exceeds Debit Limit
1040154	Requested Debit Amount Below Debit Minimum
1049999	A system error occurred, try again later. If the error persists, please contact the service provider.	Contact Us

105####

Error Code	Error Description
1050001	Invalid label paper size
1050003	Invalid label file output format.
1050019	Invalid Scanform/Manifest labelPaperSize.
1050051	ShipmentOptions/PrintCusomMessage1 length should be less than 51 characters.
1050072	AddressLine length of {1} cannot exceed 40 characters	SOLUTION
1050073	Combined length of addressLine1, addressLine2 or addressLine3 of {1} cannot exceed 40 characters
1050075	Combined length of cityTown, stateProvince,postalCode and zip4 of {1} cannot exceed 40 characters
1050076	Combined length of cityTown, stateProvince and postalCode of {1} cannot exceed 40 characters
1050081	Invalid label file output format for given paper size
1050082	Invalid data stream flag for label file output format
1050085	Invalid Resolution value for Inbound shipment
1051157	Invalid Request: Duplicate document type
1051158	Origin/destination invalid for label broker.
1051159	Multi-page shipping labels invalid for label broker.
1051160	Invalid Request: Invalid document type combination
1059999	A system error occurred, try again later. If the error persists, please contact the service provider.	Contact Us

107####

Error Code	Error Description
1070001	Cancelshipment time limit has passed.
1070003	Cancelshipment already initiated.	SOLUTION
1070004	Original Transaction not found
1070010	Invalid CancelInitiator. Cancel Initiator can be shipper or partner only.
1070011	Refund can not be initiated for inbound
1070013	Refund Initiator cannot be used for non-trackable mail class.
1070014	ShipmentId or Tracking Number could not be found.	SOLUTION
1070017	CancelShipment cannot be voided.
1070026	Cancelindicium already initiated.
1070027	CancelIndicium can not be initiated for non trackable Indicia
1079999	A system error occurred, try again later. If the error persists, please contact the service provider.	Contact Us

109####

Error Code	Error Description
1090001	Original Transaction not found.
1090006	Time limit has passed.
1090007	Max number of attempts already reached.
1090011	Cancelshipment already initiated. You cannot perform retry/reprint.
1099999	A system error occurred, try again later. If the error persists, please contact the service provider.	Contact Us

110####

Error Code	Error Description
1101001	Must have exactly one CustomsInfo block.	SOLUTION
1101002	customsItems cannot be more than the expected.
1101009	Invalid quantity for a Line Item.	SOLUTION
1101010	UnitPrice for an individual shipping item must be a properly formatted positive number.
1101013	CutomsItems must have a description.
1101015	The country of origin must be a valid 2 character countryCode
1101019	Invalid unit of measurement for weight/customsItems.
1101021	The reasonForExport / customsInfo must exist.
1101023	Reason for export / content type must be of this valid set: gift, …	SOLUTION
1101025	Invalid value for InsuredAmount.
1101031	EELPFC has an invalid format, it must contain a proper AES Number, AESDOWN with valid information, or an appropriate Federal Trade Regulation Number.
1101051	Quantity for an individual shipping item must be a properly formatted positive number.
1101052	Price for an individual shipping item must be a properly formatted positive number.
1101080	Must have a {1} address.
1101081	Company or Name is required.
1101083	At least one address line must exist, but no more than 3.
1101201	Customs Declared Value amount must be a properly formatted value greater than 0.
1101202	Invalid value for CustomsInfo/SDR.
1101203	Invalid Currency Code.
1101204	Currency Code Must Exist.
1101205	Sum of the weight of the contents is greater than the package weight.
1101206	The USPS does not allow shipping non-documents to APO/FPO/DPO destinations with FLAT (Large Envelope) parcel shipping labels.
1101210	Reason for export is prohibited.
1101211	Customs Declared Value or Total Line Item value is to high and prohibited

111####

Error Code	Error Description
1110001	Duplicate parceltrackingnumber in request.
1110002	Invalid submissiondate.
1110004	ManifestId doesn’t exist.
1110007	Cancel shipment for one of the package is already initiated.
1110008	Mismatch in dateOfShipment for original transaction
1110009	Manifest is already created for one or more given parceltrackingnumber.
1110011	Invalid parcelTrackingNumber in request.
1110013	Manifest time limit has passed.	SOLUTION
1110014	Invalid Submission date format. Format must be yyyy-MM-dd or yyyy-MM-dd HH:mm:ss.SSS or yyyy-MM-dd HH:mm:ss .
1110015	Parceltrackingnumbers passed in request are more than allowed limit.
1110016	PackageId cannot be null	SOLUTION
1110017	Invalid Shipment(s) to Manifest.
1110018	Manifest cannot be created
1110019	No shipments are available to create a scanform/manifest document	SOLUTION
1110020	Invalid shipperid.
1110025	Invalid or missing manifestParameters/CLIENT_ID
1119999	A system error occurred, try again later. If the error persists, please contact the service provider.	Contact Us

112####

Error Code	Error Description
1120006	{1} Time limit has been passed.
1120007	Max {1} requests {2} have already been reached.
1129999	A system error occurred, try again later. If the error persists, please contact the service provider.	Contact Us

113####

Error Code	Error Description
1130001	Dispense with given transactionid and transactiondatetime already exists.
1130002	X-PB-TransactionId already exists.	SOLUTION
1130004	Duplicate parceltrackingnumber in request.
1130005	Scanform with given transactionid already exists.

115####

Error Code	Error Description
1150001	Invalid field value related to Payment.	SOLUTION
1150002	Authentication error from ledger API.
1150003	Account is not having sufficient funds.
1150005	Internal Error from ledger API
1159999	A system error occurred, try again later. If the error persists, please contact the service provider.	Contact Us

116####

Error Code	Error Description
1169999	Error from client - Server error from carrier

117####

Error Code	Error Description
1170001	Invalid ServiceId, Parceltype or specialService	SOLUTION for services or parcel types SOLUTION for special services
1171048	Invalid length for {1} in the http header
1171049	{1} should be numeric type only
1171050	irregularParcelGirth is required.
1171051	Maximum of {1} references are allowed.
1171052	Invalid/missing value for references
1171053	Value for PERMIT_NUMBER cannot exceed {1} characters.
1171054	At least RECIPIENT_NOTIFICATION_EMAIL or RECIPIENT_NOTIFICATION_PHONE is required with RECIPIENT_NOTIFICATION_TYPE.
1171055	Maximum {1} CustomItems are supported.
1179999	A system error occurred, try again later. If the error persists, please contact the service provider.	Contact Us

120####

Error Code	Error Description
1200009	Value for {1} cannot exceed {2} characters
1200013	Invalid Account Number
1200014	Postal code and Province/State or Country code in the address is incorrect or not associated with the account number in the carrier’s records
1200015	Requested shipper account authorization failed
1200016	Carrier tool/API access has not been provided
1200017	Account is not added to the user profile because invoice information is not present
1200019	Valid address {1} must be provided
1200020	Invalid value for {1} in {2} address
1209999	A system error occurred, try again later. If the error persists, please contact the service provider.	Contact Us
1280001	Invalid value for stampOptions/{1}
1280002	Insufficient funds available
1280051	Authentication Error occurred
1281313	Invalid or missing value
1289998	System error from NGP
1289999	CreateStamp API Internal Error

130####

Error Code	Error Description
1300000	System error.
1300002	The field is null or empty string.
1300003	Invalid value.
1300004	String value exceeds the maximum supported length.
1300005	Address is restricted
1300006	Insufficient account balance.
1300007	The merchant account’s status is wrong for the API call
1300008	Country is not supported.
1300010	Restricted item.	SOLUTION
1300011	The shipment dimension exceeds the limits for selected service.
1300012	The shipment weight exceeds the limits for selected service.
1300013	The shipment value exceeds the limits for selected service.
1300014	Restricted zone or PO Box.
1300020	Shipment cannot be created at this time. Please try again later by calling retry shipment method using the same transaction id
1300021	Shipment cannot be created at this time. A label was not created and no charge had been applied. Please try again later by calling create shipment again.
1300022	Shipment cannot be created

700#### - HS Code API

The following errors are returned by the Retrieve HS Code API:

Error Code	Error Description
7001004	Required field value(s) are missing from the input record
7001005	Invalid Value.
7001012	Value exceeds supported maximum length
7002001	Error while classifying commodity.
7002002	The prediction services are not configured to classify for this merchant
7002009	The prediction services are not configured to classify for this category

 

8-Digit Error Codes

Error Code	Error Description
40000011	Missing value for hostUri
40000012	Invalid value for hostUri
40000021	Invalid value for styleSheet
40000031	Invalid value for postMethod
40000041	Invalid JSON structure for userInfo.
40000042	Missing userInfo.
40000051	Invalid value for email
40000052	Missing value for email.
40000061	Invalid value for developerId. Max 8 numeric characters are allowed.
40000071	Missing value for renderType.
40000072	Invalid value for renderType.
40000081	Invalid value for paymentAccountNumber. For e.g. PYPL123456.
40000091	Enter valid firstName. Max 50 characters are allowed.
40000101	Enter valid lastName. Max 50 characters are allowed.
40000111	Enter valid company. Max 100 characters are allowed.
40000112	Missing value for company.
40000121	Enter valid phone. Max 20 characters are allowed.
40000122	Missing value for phone.
40000131	Invalid JSON structure for address in userInfo.
40000132	Missing address.
40000141	Address line 1 is required.
40000151	Enter valid city. Max 50 characters are allowed.
40000152	Missing value for city.
40000161	Enter valid state. Max 50 characters are allowed.
40000162	Missing value for state.
40000171	Enter valid postalCode.
40000172	Missing value for postalCode.
40000181	Enter valid countryCode. Max 2 characters are allowed.
40000182	Missing value for countryCode.
40000191	Either userInfo.shipperId or paymentAccountNumber or (developerId and userInfo.email) should be present in case of update.
40000201	Invalid value for returnUrl.
40000212	Unable to get payment account number from provided email id and developer id.
40000213	Missing value for fedTaxId.
40000300	Either paymentAccountNumber or shipperId is required.
40000302	Valid payment account number is not found against provided shipper ID.
40000304	Invalid value for shipperId. Max 10 numeric characters are allowed.
40100001	Unauthorized access.
40100002	Unauthorized access. Invalid access token.
40100003	Unauthorized access. Access token is expended.
40100004	Token has expired.
40100005	Invalid access token.
50000001	Error has occurred while accessing system storage.
50000005	Error has occurred while processing your request.
50000006	Error has occurred while fetching user information by using email id and developer id
50000007	Error has occurred while requesting remote services.
50000008	Request timed out while requesting remote services.
50000009	Connection refused while requesting remote services.
50000021	Something went wrong while processing Credit Card Payment.

 

PB-APIM-ERR Errors

Error Code	Error Description
PB-APIM-ERR-0401	Invalid client ID or secret
PB-APIM-ERR-0402	Invalid Subscription Id
PB-APIM-ERR-0403	Developer App is not enriched with DOMAIN_INFO	SOLUTION
	Developer App is not enriched with METER_POOL
	Invalid ProductId Attribute value
	Invalid SHIPPER_RATE_PLAN	SOLUTION
	User exceeded configured monetization limits
PB-APIM-ERR-0404	User not allowed to access the requested resource	SOLUTION
PB-APIM-ERR-1000	GCS Domain Info: Invalid JSON
	Internal Error Occurred	SOLUTION
PB-APIM-ERR-1002	Invalid Access Token	SOLUTION
PB-APIM-ERR-1003	Access Token Expired
PB-APIM-ERR-1004	Invalid API Call	SOLUTION
PB-APIM-ERR-1005	Invalid or Missing Client Credentials
PB-APIM-ERR-1006	Spike arrest violation	SOLUTION
	X-PB-IntegratorId Not Found
PB-APIM-ERR-1008
PB-APIM-ERR-1010	The Service is temporarily unavailable
PB-APIM-ERR-1404	Invalid or missing resource
PB-APIM-ERR-1500	Quota limit exceeded.	SOLUTION: Contact ClientSupportTechServices@pb.com and ask that your limit be reset for the day.
PB-APIM-ERR-4001	X-PB-TransactionId Length cannot be greater than 25 chars
PB-APIM-ERR-4002	X-PB-TransactionId is missing

 

PB-TRKPKG-ERR Errors

Error Code	Error Description
PB-TRKPKG-ERR-7600	Invalid PackageIdentifier provided	SOLUTION
PB-TRKPKG-ERR-7506	Internal Error
PB-TRKPKG-ERR-7609	Invalid Carrier Name Provided
PB-TRKPKG-ERR-7611	No Information present in carrier site for this tracking number.
PB-TRKPKG-ERR-7614	Invalid Account Number Provided

 

SAAS Errors

Error Code	Error Description
SAAS-ERR-510	Subscription already exists for the user
	Initial postage cannot be triggered, merchant status is SUSPENDED	Contact Us
SAAS-MR-ERR-2001	Address Line cannot be PO Box.
SAAS-MR-ERR-2011	Invalid phone number.
SAAS-MR-ERR-2012	Invalid email address.

 

Non-numeric Error Codes

Error Code	More Info
access.denied
address.not.verified
bad.input
bad.request
constraint.violation
data.integrity.violation
database.error
error.http
error.unknown
insufficient.balance
internal.misconfiguration
internal.server.error	This indicates a system has error occurred. If the error persists, contact support.
invalid.account.number
invalid.address
invalid.date.time	SOLUTION
invalid.developer
invalid.merchant
invalid.merchant.status
invalid.payment.method
invalid.request
invalid.request.field
missing.request.body
missing.search.criteria
missing.transaction.id
not.authenticated
not.found
resource.not.found	SOLUTION for “no unique matching mailer found” SOLUTION for “no unique matching shipper rate plan found” SOLUTION for “no matching integrator rate plan found”
smaller.to.date.time
unauthorized.transaction
unknown.developer
unknown.error	If the error persists, contact support.
unregistered.merchant
upstream.failure	This indicates a system error has occurred. If the error persists, contact support.
upstream.resource.unavailable
validation.failed

 

 

 

 

• Error Object
• HTTP Status Codes

 
 
 
 

• next
• previous |

© Copyright 2021, PB.