Sorry, you need to enable JavaScript to visit this website.
Skip to main content

Freight Pickup Errors

Error Codes

When the UPS system is unable to respond to a request, be it from a malformed request, an illegal or invalid value, or other issues, the API generates an error response. 

  • Successful responses may or may not include alerts.
    • Without alerts - Indicates the request has been processed as anticipated.
    • With alerts - Indicates the request has been processed with potentially unanticipated results. The alert contains information in the response that should be passed to the end user.
  • The severity of an error may be transient or hard.
    • Transient error - Indicates an error that is temporary in nature. Such errors may be caused by response timeouts due to high server loads or scheduled maintenance in progress. The request may be issued successfully at a later time.
    • Hard error - Indicates the request has a problem that the system is not able to resolve. These errors are critical and prevent requests from processing.
    • Do not resubmit requests with Hard Errors until the problems causing the error have been resolved.

Common Error Codes

The following error codes can apply to all APIs.

Code Severity Description
10001 Hard The request is not well formed.
10002 Hard The request is well formed but the request is not valid.
10003 Hard The request is either empty or null.
10006 Hard Although the document is well formed and valid, the element content contains values which do not conform to the rules and constraints contained in this specification.
10013 Hard The message is too large to be processed by the Application.
20001 Transient General process failure.
20002 Hard The specified service name, {0}, and version number, {1}, combination is invalid.
20006 Hard Invalid request action.
20007 Hard Missing Required field, {0}.
20008 Hard The field, {0}, contains invalid data, {1}.
20012 Hard The Client Information exceeds its Maximum Limit of {0}.
250005 Hard No Access and Authentication Credentials provided.
250006 Hard The maximum number of user access attempts was exceeded.
250007 Hard The UserId is currently locked out; please try again in 30 minutes.
250019 Hard Invalid Field value.

Pickup Ground Freight Error Codes

9360001 - 9510185

Code Severity Description
9360001 Hard Missing Ship From.
9360002 Hard Missing or Invalid Ship From Name.
9360003 Hard Missing Ship From Address.
9360004 Hard Missing or Invalid first Ship From Address Line.
9360005 Hard Invalid second Ship From Address Line.
9360006 Hard Invalid third Ship From Address Line.
9360007 Hard Missing or Invalid Ship From City.
9360008 Hard Missing or Invalid Ship From Country Code.
9360009 Hard Missing or Invalid Ship From Phone Number.
9360010 Hard Invalid or Missing Ship From Attention Name.
9360011 Hard Missing or Invalid Ship From Postal Code.
9360012 Hard Missing or Invalid Ship From State Province Code.
9360013 Hard Unable to Service Ship From Postal Code.
9360015 Hard Invalid Int''l origin city/country code combination provided in the request.
9360016 Hard Invalid Ship From Phone Extension..
9360017 Hard Invalid Origin Location
9360061 Hard Missing or Invalid Unit of Measurement for PackageWeight.
9360062 Hard Missing or Invalid Ship To Name.
9360063 Hard Missing Ship To Address.
9360064 Hard Missing or Invalid first Ship To Address Line.
9360065 Hard Invalid second Ship To Address Line.
9360066 Hard Invalid third Ship To Address Line.
9360067 Hard Missing or Invalid Ship To City.
9360068 Hard Missing or Invalid Ship To Country Code.
9360069 Hard Missing or Invalid Ship To Phone Number.
9360070 Hard Invalid or missing Ship To Attention Name.
9360071 Hard Missing or Invalid Ship To Postal Code.
9360072 Hard Missing or Invalid Ship To State Province Code.
9360073 Hard Unable to Service Ship To Postal Code.
9360075 Hard Invalid Int''l destination city/country code combination provided in the request.
9360076 Hard Invalid Ship To Phone Extension.
9360077 Hard Origin and Destination are the same.
9360078 Hard Invalid Destination Location.
9360079 Hard TForce Freight LTL Guaranteed A.M. service is not valid for the destination postal code you entered.
9360080 Hard Shipment is not eligible for LTL guaranteed service.
9360081 Hard Shipment is not eligible for TForce Freight LTL Guaranteed A.M. service.
9360082 Hard LTL guaranteed Service not available.
9360246 Hard Missing or Invalid Shipment Number.
9360247 Hard Missing or Invalid BOL Id.
9360257 Hard Missing or Invalid Commodity {0} Description.
9360258 Hard Missing or Invalid Commodity {0} Weight''s Unit Of Measure Code.
9360259 Hard Missing or Invalid Commodity {0} Weight''s Value.
9360266 Hard Missing or Invalid Packaging Type Code of Commodity {0}.
9360279 Hard Missing or Invalid UOM Code for Shipment Total Weight
9360388 Hard At least one email address is required
9360389 Hard Email Address must be in the form xxx@xxx.xxx
9360390 Hard Email address is too long
9360526 Hard Missing Pickup Requester Name.
9360527 Hard Missing Pickup Requester Attention Name.
9360528 Hard Missing or Invalid email address for the Pickup Requester.
9360529 Hard Missing or Invalid Phone Number for the Pickup Requester.
9360530 Hard Invalid Requester Phone Extension.
9360541 Hard Missing or Invalid Pickup Date.
9360542 Hard/Warning Missing or Invalid Earliest Ready Pickup Time.
9360543 Hard Missing or Invalid Latest Ready Pickup Time.
9360544 Hard NEarliest pickup ready time is later than latest pickup ready time.
9360545 Hard Earliest pickup ready time has already occurred.
9360546 Hard Latest pickup ready time has already occurred.
9360547 Hard Pickup Date is a holiday
9360549 Hard Earliest pickup ready time must be scheduled at least 90 minutes prior to latest ready time for same day pickup.
9360550 Hard Pickup date time cannot be in the past
9360551 Hard Same day pickup cannot be scheduled past 3PM
9360552 Hard Pickup request required for shipment.
9360553 Hard Pickup Date is scheduled in advance of the latest available pickup date.
9360554 Hard Pickup Service is Temporarily Unavailable for the postal code you have requested.
9360556 Hard Requested pickup date exceeds future date maximum
9360557 Hard Requested pickup date/time is not valid (occurs after orig in cut-off)
9360558 Hard/Warning Same-day pickups scheduled at 3pm or later may be rescheduled for the following day.
9360559 Hard Ready Time and Drop off Time both provided.
9360560 Hard Pickup date is a Saturday
9360561 Hard Same day pickup not available. Pickup the next available pickup date.
9360562 Hard Drop off time is not valid. After last drop off time.
9360563 Hard Pickup date is not valid. No pickups on Sat
9360564 Hard Pickup ready time missing.
9360565 Hard Requested Pickup date future date maximum.
9360566 Hard Insufficient Last Pickup Time and Lead Time data.
9360567 Hard Missing or Invalid Pickup Ready Time.
9360568 Hard Missing or Invalid Dropoff Ready Time.
9360569 Hard Invalid failedEmail address
9360570 Hard Two or more of the selected services cannot be combined. Please resubmit using another combination.
9360572 Hard Missing PickupNotifications element
9360573 Hard Missing emailNotification element
9360574 Hard Missing failed email address
9360575 Hard Email address is missing
9360576 Hard EventType is missing
9360577 Hard POM not available for this origin
9360578 Hard Not more than 5 EmailNotification elements allowed
9360579 Hard Not more than 4 EventTypes allowed
9360580 Hard Invalid confirmation number
9360581 Hard Missing confirmation number
9360582 Hard Unable to cancel the request.
9360583 Hard Invalid Event type
9360584 Hard Invalid POM Number
9360585 Hard Invalid POM Number type
9360586 Hard POM is only available for Ground Freight shipments.
9360587 Hard Too late to cancel request. (Driver already at the dock or en route)
9360588 Hard Unable to cancel request. Pickup has been completed.
9360589 Hard Unable to cancel request. Pickup not found.
9360590 Hard Unable to modify pickup request.
9360591 Hard No freight service is available for origin and destination pair.
9360592 Hard Saturday delivery is not valid only for selected service.
9360593 Hard Guaranteed service is unavailable for the Postal code you have requested.
9360594 Hard North American Saturday delivery is not valid for selected service or pickup date or lane pair
9360595 Hard North American Saturday delivery is not valid for ShipTo.
9360596 Hard International Saturday delivery is not valid for selected service or pickup date or lane pair
9360600 Hard Invalid Service Code.
9360602 Hard Accessorial not valid with lane and service selected.
9360603 Hard Invalid E2K Account Number.
9360604 Hard Pickup Time Ready is greater than Latest Time Ready.
9360605 Hard Cannot consolidate shipment. Only House Accounts are allowed.
9360606 Hard Miscellaneous Business Rule Error
9360607 Hard Either Pickup Ready time or Drop off time needs to be provided for this shipment.
9360608 Hard Cannot have both Pickup Ready and Drop off time.
9360651 Hard One or more documents request are not valid for the selected service
9370907 Hard Missing POM Number
9370908 Hard Missing POM Number Type
9370907 Hard Missing POM Number
9390000 Hard Freight Pickup webservice is unavailable
9390001 Hard Missing ShipFrom Phone
9390021 Hard Missing Pickup Requester
9390022 Hard Missing Requester Phone
9390041 Hard Missing Packaging Type of Commodity{0}
9390042 Hard Missing Weight of Commodity{0}
9390043 Hard Missing Commodity{0} weight's Unit of Measure
9390081 Hard Either ExistingShipmentID or ShipmentDetail is required
9390101 Hard Missing or Invalid Destination country Code
9391000 Hard Invalid Freight Pickup Request Document
9510028 Hard It is too late to trigger a GWN pickup for today.
9510029 Hard GWN Pickup is not available on this account.
9510090 Transient Pickup service is unavailable due to unknown error
9510091 Transient Pickup service is unavailable
9510100 Transient Pickup Service Days webservice is unavailable
9510101 Transient Pickup Creation webservice is unavailable
9510102 Transient Pickup Trigger GWN webservice is unavailable
9510103 Transient Pickup Trigger GWN webservice is unavailable
9510103 Transient Pickup Rate webservice is unavailable
9510104 Transient Pickup Cancel webservice is unavailable
9510105 Transient Pickup Pending Status webservice is unavailable
9510106 Transient Pickup Get Service Center webservice is unavailable
9510110 Hard Closing time is less than the minimum window after present time
9510111 Hard Closing time is less than the minimum window after ready time
9510112 Hard Closing time and ready time are not on the same day
9510113 Hard Received data containing a ready time later than the latest allowable ready time for the location
9510114 Hard Closing time must be later than or equal to the earliest allowable close time
9510115 Hard No Pickup days available for this location
9510116 Hard Non-serviceable area. Location does not have pickup service available
9510117 Hard The service(s) can not be picked up based on your ready time due to invalid data
9510118 Hard The service(s) is not available for pickup on the selected day.
9510119 Hard Invalid service designation
9510120 Hard Order contains invalid pickup item quantities
9510121 Hard Sorry, we are unable to service your pickup request on the day you have selected
9510122 Hard Only future date pickup is available for pickup request with only Germany to Germany Standard shipments
9510123 Hard The billing account information provided was invalid.
9510124 Hard The tracking numbers must be return or forward movement. Please remove those that are not return or forward movement, and re-submit order.
9510125 Hard Tracking number does not start with 1Z
9510126 Hard No more than 30 Tracking Numbers can be accepted
9510127 Hard Tracking number does not accept pickup charge, please select other payment method.
9510128 Hard Tracking number failed check digit validation
9510129 Hard Return service labels do not accept pickup charge anymore, please select other payment method
9510130 Hard Invalid data has been received, please check your request again
9510131 Hard Order has already been canceled
9510132 Hard Cannot cancel an order that has already been completed
9510133 Hard Cannot cancel an order that has an invalid state
9510134 Hard Unknown order number (PRN). Order number not found in data source
9510135 Hard The provided pickup date is not the Green When Needed eligible date
9510136 Hard It is too early to trigger a GWN pickup for the Next eligible day
9510139 Hard GWN pickup is not available for the provided country code
9510140 Hard It is too late to cancel the pickup request
9510141 Hard No Pickup days available for this location
9510142 Hard The address information passed in were not enough to guarantee a unique location for non-postal country.
9510143 Hard Tracking number length error.
9510144 Hard Tracking number contains invalid service indicator
9510145 Hard Data integrity and or dependency is violated among some fields
9510146 Hard Order Number must be 11 characters long
9510148 Hard Populate the returnTrackingNumber element or the trackingData element, not both.
9510150 Hard The postal code is invalid for state and country name
9510151 Hard The state is not a valid state abbreviation for the country
9510152 Hard Please verify that country code is correct and in upper case
9510153 Hard The pickup window start time must be before the end time
9510154 Hard The account number provided does not belong to the user
9510155 Hard The account number provided is not able to pay for the pickup
9510156 Hard The Origin postal code is invalid for the selected location
9510160 Hard Pickup ready time cannot be later than close time
9510161 Hard Partial Data Returned. GWN pending not available
9510162 Hard Partial Data Returned. On call pending not available
9510163 Hard Order cannot be canceled with this PRN
9510164 Hard Pickup Address not found for the Account Number. Please set up Pickup Address before you trigger Smart Pickup
9510165 Hard This account is not set up for Smart Pickup service
9510166 Hard Missing or Invalid ChargeCard
9510167 Hard Missing or invalid ChargeCard Type
9510168 Hard Missing or invalid ChargeCard expiration date
9510169 Hard Missing or invalid ChargeCard security code
9510170 Hard Missing or invalid ChargeCard number
9510171 Hard Credit card has expired
9510172 Hard Missing ChargeCard Address
9510178 Hard Credit card declined, contact your financial institution
9510179 Hard This credit card has been locked due to multiple unsuccessful attempts. Please use another credit card to continue or try again after 12 hours.
9510180 Hard Invalid CardHolderName
9510181 Hard Invalid ChargeCard AddressLine
9510182 Hard Invalid ChargeCard City
9510183 Hard Invalid ChargeCard StateProvince
9510184 Hard Invalid ChargeCard PostalCode
9510185 Hard Missing or Invalid ChargeCard country code

 

9500100 - 9500770

Error Code Severity Description
9500100 Hard Invalid Request Document for Pickup Services
9500500 Hard Missing or invalid PickupType
9500501 Hard Missing or invalid DaysCountType
9500502 Hard Missing or invalid NumberOfDays
9500503 Hard Missing or invalid PickupAddress
9500504 Hard Missing or invalid City
9500505 Hard Missing or invalid StateProvince
9500506 Hard Missing or invalid PostalCode
9500507 Hard Missing or invalid CountryCode
9500508 Hard Missing or invalid PickupPiece
9500509 Hard Missing or invalid ServiceCode
9500510 Hard Missing or invalid Quantity
9500511 Hard Missing or invalid DestinationCountryCode
9500512 Hard Missing or invalid ContainerCode
9500520 Hard Missing or Invalid RatePickupIndicator
9500522 Hard Missing Account when payment method is shipper account
9500523 Hard Missing or invalid AccountNumber
9500524 Hard Missing or invalid AccountCountryCode
9500525 Hard Missing or invalid PickupDateInfo
9500526 Hard Missing or invalid CloseTime
9500527 Hard Missing or invalid ReadyTime
9500528 Hard Missing or invalid PickupDate
9500529 Hard Missing or invalid CompanyName
9500530 Hard Missing or invalid ContactName
9500531 Hard Missing or invalid AddressLine
9500532 Hard Invalid Room
9500533 Hard Invalid Floor
9500534 Hard Invalid Urbanization
9500535 Hard Invalid PickupPoint
9500536 Hard Missing Phone
9500537 Hard Missing or invalid Phone number
9500538 Hard Invalid Phone extension
9500539 Hard Invalid StreetNumber
9500540 Hard Invalid StreetPrefix
9500541 Hard Invalid StreetName
9500542 Hard Invalid StreetType
9500522 Hard Missing Account when payment method is shipper account
9500543 Hard Invalid StreetSuffix
9500545 Hard Invalid UnparsedStreetAddress
9500546 Hard Invalid StreetAddressArtifactSource
9500547 Hard Invalid StreetAddressMatchCode
9500548 Hard Missing or Invalid AlternateAddressIndicator
9500549 Hard Missing or invalid number of PickupPiece
9500550 Hard Missing or invalid Weight
9500551 Hard Missing or invalid UnitOfMeasurement
9500552 Hard Missing or invalid OverweightIndicator
9500553 Hard nvalid TrackingNumber
9500554 Hard Missing or invalid PaymentMethod
9500555 Hard Invalid Urbanization
9500556 Hard Invalid ReferenceNumber
9500557 Hard Invalid ConfirmationEmailAddress
9500558 Hard nvalid UndeliverableEmailAddress
9500559 Hard Invalid ProfileId
9500560 Hard Invalid ProfileCountryCode
9500561 Hard Missing or Invalid ResidentialIndicator
9500590 Hard Missing or invalid ServiceDateOption
9500600 Hard Invalid AddressLine
9500603 Hard Missing PickupDateInfo When ServiceDateOption is 03
9500650 Hard Missing or Invalid CancelBy
9500651 Hard Missing or invalid AccountNumber when CancelBy is 01
9500652 Hard Missing or invalid ServiceDate when CancelBy is 01
9500653 Hard Missing or invalid GMTOffset when CancelBy is 01
9500654 Hard Missing or invalid PRN when CancelBy is 02
9500655 Hard Missing or invalid TrackingData /TrackingNumber
9500656 Hard Missing or Invalid FreightOptions
9500657 Hard No more than 1 PickupPiece is allowed for WW Express Freight shipments
9500658 Hard Missing or Invalid Origin Service CountryCode
9500659 Hard Missing or Invalid Origin ServiceCode
9500660 Hard Missing or Invalid ShipmentDetail
9500661 Hard Lift Gate for Pick Up accessorial is not allowed with Drop Off At UPS Facility accessorial.
9500662 Hard Missing or Invalid DestinationAddress - City
9500663 Hard Missing or Invalid DestinationAddress - StateProvince
9500664 Hard Missing or Invalid DestinationAddress - PostalCode
9500665 Hard Missing or Invalid DestinationAddress - CountryCode
9500666 Hard Missing or Invalid Dimensions - UnitofMeasurement
9500667 Hard Missing or Invalid Dimensions - Length
9500668 Hard Missing or Invalid Dimensions - Width
9500669 Hard Missing or Invalid Dimensions - Height
9500670 Hard Missing or Invalid OriginAddress - City
9500671 Hard Missing or Invalid OriginAddress - StateProvince
9500672 Hard Missing or Invalid OriginAddress - PostalCode
9500673 Hard Missing or Invalid OriginAddress - CountryCode
9500674 Hard A pickup cannot have a KGS/IN or LBS/CM as its unit of measurements
9500678 Hard Invalid ContainerCode
9500679 Hard Invalid ServiceCode
9500680 Hard Invalid Service Center Search Request
9500684 Hard No Drop-Off Facilities available for this location
9500685 Hard No Hold for Pickup Facility available for this location
9500686 Hard Drop-off time must be with in Facility's hours of operations
9500687 Hard Smart Pickup cannot be mixed with WW Express Freight shipment
9500690 Hard Shipment total weight has exceeded the maximum shipment weight limit of 99,999.9 kgs or 99,999.9 pounds.
9500693 Hard The maximum per pallet weight for the selected service from the selected origin is %maxWeightOrig% pounds.
9500694 Hard The maximum per pallet weight for the selected service from the selected origin is %maxWeightOrig% kg.
9500695 Hard The maximum per pallet weight for the selected service to the selected destination is %maxWeightDest% pounds.
9500696 Hard The maximum per pallet weight for the selected service to the selected destination is %maxWeightDest% kg.
9500697 Hard The maximum dimensions for a pallet are ({0}) cm (length) by ({1}) cm (width) by ({2}) cm (height) for the selected origin.
9500698 Hard The maximum dimensions for a pallet are ({0}) in (length) by ({1}) in (width) by ({2}) in (height) for the selected origin.
9500699 Hard The maximum dimensions for a pallet are ({0}) cm (length) by ({1}) cm (width) by ({2}) cm (height) for the selected destination.
9500700 Hard The maximum dimensions for a pallet are ({0}) in (length) by ({1}) in (width) by ({2}) in (height) for the selected destination.
9500701 Hard Invalid pallet dimensions, the length must be longer than the width.
9500702 Hard Missing or Invalid Unit Of Measure of Distance
9500703 Hard Missing or Invalid Locale
9500704 Hard Missing or Invalid Street Address
9500708 Hard Invalid Search Radius
9500709 Hard Invalid Maximum Location
9500710 Hard Missing Origin Search Criteria Container

UPS Freight Less-than-Truckload (“LTL”) transportation services are offered by TFI International Inc., its affiliates or divisions (including without limitation TForce Freight), which are not affiliated with United Parcel Service, Inc. or any of its affiliates, subsidiaries or related entities (“UPS”). UPS assumes no liability in connection with UPS Freight LTL transportation services or any other services offered or provided by TFI International Inc. or its affiliates, divisions, subsidiaries or related entities.