Error Codes

Overview

The PB Shipping APIs return the application-specific errors listed here. Click the SOLUTION link when available. If you receive an error that is not listed here, please contact ShippingAPISupport@pb.com.

See also:

7-Digit Error Codes: 1000002 - 1209999

The following codes use Error Body Format 1.

Error Code Message  
1000002 Invalid value for Accept-Language in http header, ex: en-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 ___  
1000046 Invalid shipmentOptions.
1000049 Invalid elements in document.  
1000050 Invalid JSON Structure.
1000052 Invalid use of rate plan in request header  
1000053 Missing required rate plan in request header  
1000502 Unparsed address lines cannot exceed 12 lines.  
1000503 Invalid senderUserId ___  
1000504 More than one rate object under shipment is not allowed  
1000505 Country Code must be 2 letters.  
1000506 Invalid or missing Shipment Option. SOLUTION
1001320 System error from ___  
1009997 Invalid JSON structure under ___.  
1009998 Invalid value for ___  
1009999 A system error occurred, try again later. If the error persists, please contact the service provider. Contact Us
1010314 Too many empty fields ___  
1010990 Invalid or missing value for countryCode  
1012003 Company field cannot exceed ___ characters ___  
1012010 email field cannot exceed ___ characters ___  
1012012 Invalid/missing cityTown ___  
1012013 CityTown field cannot exceed ___ characters ___  
1012014 Invalid/missing stateProvince ___  
1012015 Invalid stateProvince field value. stateProvince field length has to be ___ characters ___  
1012016 Invalid/missing postalCode ___  
1012020 Only 3 address delivery lines are allowed ___  
1012021 Invalid/missing addressDeliveryLine1 ___  
1012022 AddressLines field cannot exceed ___ characters ___ SOLUTION
1012038 Either companyName or name fields are mandatory  
1012049 Provide at least one addressLine ___  
1019000 Invalid address provided. SOLUTION
1019002 Invalid or missing value for countryCode.  
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
1021000 Invalid Future Shipment Date.  
1021001 No rating rules found for provided combination. SOLUTION
1021003 Invalid/unsupported ___ 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 ___ selected. SOLUTION
1021120 Special service ___ is unsupported for the service.  
1021121 Special service ___ requires an input value.  
1021122 Special service ___ has an input value greater than the maximum for the special service.  
1021123 Special service ___ has an input value less than the minimum for the special service.  
1021126 Invalid/missing Postal Code for the recipient.  
1021127 Provide a postal code that is of the correct format for the ___.  
1021128 WeightUOM is invalid, it must be either grams or hundredthsofanounce  
1021129 WeightUOM ___ is invalid for the selected carrier  
1021131 Dimension UOM ___ is invalid for the selected carrier  
1021132 Invalid Dimensions.  
1021133 ServiceId and specialService combination is not supported  
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.  
1021141 Invalid combination of Service Id and Parcel type. SOLUTION
1021142 Military parcelType to a non military destination is not allowed.  
1021145 ___ phoneNumber Required  
1021150 Missing or Invalid Return Receipt Number  
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  
1021205 Invalid value for parcelType.  
1021210 ___ address is required  
1021211 Duplicate special services not allowed.  
1021239 rateTypeId ___ is invalid  
1021241 Invalid combination of Service Id, Option ID and Rate Type ID  
1021250 Invalid Integrator Rate Plan  
1021251 Invalid Shipper Rate Plan
1021311 Invalid Origin/Destination Pair.  
1021312 Shipper is not eligible for ___  
1021313 Invalid/missing value for ___  
1021314 ServiceId ___ is unsupported ___.  
1021315 Mutually exclusive special services present in request.  
1021316 ___ is not allowed.  
1021317 Special Service requires another special service as a pre-requisite.  
1021318 ___ is not able to serve the request. Please try again later.  
1021319 ___ does not match with ___
1021351 ___ Option Value is Invalid (true/false) is expected.
1022001 Invalid weight for ___  
1022002 Invalid length for ___  
1022003 Invalid width for ___  
1022004 Invalid height for ___  
1022005 Invalid special service value for ___  
1022006 Invalid or unsupported special service for ___  
1022007 Dimensions required for ___  
1022008 Invalid unit of measure for ___  
1022010 Dimensions greater than Max Length + Girth  
1022021 Invalid/missing ___ countryCode.  
1022022 Invalid/missing ___ postalCode.  
1022024 Special Service ___ requires a prerequisite of one of the following: (___) or associated prerequisite value is too small.  
1022025 Special Service ___ is incompatible with ___  
1022026 The Service or at least one of the included special services must be trackable. SOLUTION
1022028 Special service ___ is incompatible with endorsement ___  
1022029 No Service Name, Service option, Rate Type combination found that matches the shopping request.  
1025945 Invalid Destination  
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
1039999 A system error occurred, try again later. If the error persists, please contact the service provider. Contact Us
1049999 A system error occurred, try again later. If the error persists, please contact the service provider. Contact Us
1050019 Invalid Scanform/Manifest labelPaperSize.  
1050051 ShipmentOptions/PrintCusomMessage1 length should be less than 51 characters.  
1050072 AddressLine length of ___ cannot exceed 40 characters SOLUTION
1050073 Combined length of addressLine1, addressLine2 or addressLine3 of ___ cannot exceed 40 characters  
1050075 Combined length of cityTown, stateProvince,postalCode and zip4 of ___ cannot exceed 40 characters  
1050076 Combined length of cityTown, stateProvince and postalCode of ___ cannot exceed 40 characters
1059999 A system error occurred, try again later. If the error persists, please contact the service provider. Contact Us
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 cannot be initiated for Inbound Shipment  
1070013 Refund Initiator cannot be used for non-trackable mail class. SOLUTION
1070014 ShipmentId or Tracking Number could not be found. SOLUTION
1070017 CancelShipment cannot be voided.  
1079999 A system error occurred, try again later. If the error persists, please contact the service provider. Contact Us
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
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 ___ 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.  
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.  
1110017 Invalid Shipment(s) to Manifest.  
1110018 Manifest cannot be created  
1110019 No shipments are available to create a scanform/manifest document SOLUTION
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
1120006 ___ Time limit has been passed.  
1120007 Max ___ requests ___ have already been reached.  
1129999 A system error occurred, try again later. If the error persists, please contact the service provider. Contact Us
1130001 Dispense with given transactionid and transactiondatetime already exists.  
1130002 X-PB-TransactionId already exists. SOLUTION
1130005 Scanform with given transactionid already exists.  
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
1170001 Invalid ServiceId, Parceltype or specialService  
1171048 Invalid length for ___ in the http header  
1171049 ___ should be numeric type only  
1171050 irregularParcelGirth is required.  
1171051 Maximum of ___ references are allowed.  
1171052 Invalid/missing value for references  
1171053 Value for PERMIT_NUMBER cannot exceed ___ characters.  
1171054 At least RECIPIENT_NOTIFICATION_EMAIL or RECIPIENT_NOTIFICATION_PHONE is required with RECIPIENT_NOTIFICATION_TYPE.  
1171055 Maximum ___ CustomItems are supported.  
1179999 A system error occurred, try again later. If the error persists, please contact the service provider. Contact Us
1200009 Value for ___ cannot exceed ___ 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
1209999 A system error occurred, try again later. If the error persists, please contact the service provider. Contact Us

 

8-Digit Error Codes: 40000011 - 50000021

The following codes use Error Body Format 2.

Error Code 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.  
40000211 Valid paypal account number is not found against the provided email ID and developer ID.  
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 Error Codes

The following codes use Error Body Format 2.

Error Code Description  
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  
  X-PB-IntegratorId Not Found  
PB-APIM-ERR-1010 The Service is temporarily unavailable  
PB-APIM-ERR-1404 Invalid or missing resource  
PB-APIM-ERR-1500 Quota limit exceeded.  
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 Error Codes

The following codes use Error Body Format 2.

Error Code Description  
PB-TRKPKG-ERR-1002 Input parameter packageIdentifierType is missing  
PB-TRKPKG-ERR-1003 Input parameter carrier is missing  
PB-TRKPKG-ERR-7500 Partner ID is invalid  
PB-TRKPKG-ERR-7501 Password is invalid.  
PB-TRKPKG-ERR-7503 Invalid PartnerTransactionID
PB-TRKPKG-ERR-7505 Invalid PartnerTransaction Date Provided  
PB-TRKPKG-ERR-7506 Internal Error  
PB-TRKPKG-ERR-7507 Partner does not have access to the method  
PB-TRKPKG-ERR-7508 Carrier Tracking Service is not available at the moment. Please try after some time.  
PB-TRKPKG-ERR-7600 Invalid PackageIdentifier provided SANDBOX SOLUTION
PB-TRKPKG-ERR-7601 Invalid Package Identifier Type Provided  
PB-TRKPKG-ERR-7603 Invalid ShipDateRangeBegin provided  
PB-TRKPKG-ERR-7604 Invalid ShipDateRangeEnd provided  
PB-TRKPKG-ERR-7606 Invalid DestinationCountryCode provided  
PB-TRKPKG-ERR-7607 Carrier Internal Error  
PB-TRKPKG-ERR-7608 Invalid Carrier Account Number  
PB-TRKPKG-ERR-7609 Invalid Carrier Name Provided  
PB-TRKPKG-ERR-7610 This tracking number does not exist in the carrier site  
PB-TRKPKG-ERR-7611 No Information present in carrier site for this tracking number.  
PB-TRKPKG-ERR-7612 New Package Status found  
PB-TRKPKG-ERR-7613 New Service Code Found  
PB-TRKPKG-ERR-7614 Invalid Account Number Provided  
PB-TRKPKG-ERR-7615 Invalid Package Identifier Provided  
PB-TRKPKG-ERR-7622 Invalid Package Identifier Provided  
PB-TRKPKG-ERR-7700 Request Logging Failed  
PB-TRKPKG-ERR-7701 Request Logging Failed  
PB-TRKPKG-ERR-7702 Internal Database Error  
PB-TRKPKG-ERR-7703 Error in Request Validation  
PB-TRKPKG-ERR-7704 Error in forming the Request  
PB-TRKPKG-ERR-7705 Error in forming the Response  

 

SAAS-ERR Error Codes

The following codes use Error Body Format 2.

Error Code Description
SAAS-ERR-510 Subscription already exists for the user  
SAAS-ERR-1000 Invalid Request Body Received
SAAS-ERR-1007 Invalid or missing Locale field  
  Invalid developer Id ___  
SAAS-ERR-1008 Invalid or missing PBPlanIds field  
  Unrecognized error received from Merchant Registry: ___
SAAS-ERR-1198 ___ Payment method is missing

 

SAAS-MC-ERR Error Codes

The following codes use Error Body Format 2.

Error Code Description  
SAAS-MC-ERR-1999 Invalid request received  
SAAS-MC-ERR-2000 Missing merchant contact information  
SAAS-MC-ERR-2001 Missing merchant payment information  
SAAS-MC-ERR-2003 Initial postage balance has to be a value greater than 0  
SAAS-MC-ERR-2004 Refill amount has to be a value greater than 0  
SAAS-MC-ERR-2005 Threshold amount has to be a value greater than 0  
SAAS-MC-ERR-2006 Merchant address verification has failed. Please correct the same and retry.  

 

SAAS-MR-ERR Error Codes

The following codes apply to the Merchant Registry and use Error Body Format 2. See also Merchant Registry Error Codes.

Error Code Description  
SAAS-MR-ERR-2001 Address Line cannot be PO Box.  
SAAS-MR-ERR-2011 Invalid phone number.  
SAAS-MR-ERR-2012 Invalid email address.  

 

Merchant Registry Error Codes

The following codes apply to the Merchant Registry and use Error Body Format 3. See also SAAS-MR-ERR Error Codes.

Key  
access.denied  
address.not.verified  
bad.input  
bad.request  
constraint.violation  
database.error  
error.http  
error.unknown  
internal.misconfiguration  
invalid.address  
invalid.developer  
invalid.merchant  
not.authenticated  
not.found  
upstream.resource.unavailable  
validation.failed  

 

Ledger Error Codes

The following codes use Error Body Format 4.

Error Code Error Message Solution
data.integrity.violation    
insufficient.balance    
internal.server.error   A system error occurred. If the error persists, contact support.
invalid.account.number    
invalid.date.time Failed due to bad request, ___  
invalid.merchant.status    
invalid.payment.method    
invalid.request Failed due to bad request, ___  
  ___ field values are invalid  
invalid.request.field    
missing.request.body    
missing.search.criteria Failed due to bad request, ___  
missing.transaction.id    
not.authenticated Not Authenticated  
resource.not.found no unique matching mailer found SOLUTION
  no unique matching shipper rate plan found SOLUTION
  no matching integrator rate plan found SOLUTION
smaller.to.date.time Failed due to bad request, ___  
unauthorized.transaction    
unknown.developer    
unknown.error   If the error persists, contact support.
unregistered.merchant    
upstream.failure   A system error occurred. If the error persists, contact support.

 

Transaction Reports Error Codes

The following codes use Error Body Format 4.

Error Code Error Message Solution
invalid.date.time Provided Date/time ___ is invalid, valid format is YYYY-MM-DDThh:mm:ss.sZ See the explanations of fromDate and toDate in Reports Query Parameters.