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

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

Shipping Ground Freight Error Codes

Code Severity Description
9360081 Hard Shipment is not eligible for TForce Freight LTL Guaranteed A.M. service.
9368782 Hard Invalid request type. Valid values are L, F, B and P.
9360017 Hard Invalid Origin Location
9360032 Hard Confirmation Number not found.
9360033 Hard Invalid Tariff Point Code
9360034 Hard Cannot update completed shipment.
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.
9360082 Hard LTL guaranteed Service not available.
9360083 Hard Invalid destination postal code, please verify and resubmit.
9360117 Hard 3rd Party Payment terms and 3rd country payer not allowed.
9360481 Hard Customs Value is Missing or Invalid.
9360482 Hard Hazmat Transportation Mode is Missing or Invalid.
9360483 Hard Invalid Saturday Delivery Accessorial.
9360484 Hard Hold At Airport For Pickup accessorial is not valid for service selected.
9360500 Hard Invalid Accessorial Code
9360558 Hard 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, Sunday or Holiday and cannot be accommodated
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 Missing or Invalid Ready Time
9360564 Hard Pickup date is not valid. No pickups on Sat, Sun or Holiday
9360565 Hard Requested Pickup date future date maximum
9360566 Hard Insufficient Last Pickup Time and Lead Time data to calculate cut-off. Ready Time must be prior to 9:00:00 AM
9360567 Hard Missing POM Number
9360568 Hard Missing POM Number Type
9360569 Hard Invalid failed Email 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 email notification element
9360574 Hard Missing failed email address.
9360575 Hard Email address is missing.
9360576 Hard Event type 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
9360583 Hard Invalid Event type
9360584 Hard Invalid POM Numbe
9360585 Hard Invalid POM Number type
9360586 Hard POM is only available for Ground Freight shipments
9360600 Hard Invalid Service Code
9360654 Hard Missing or Invalid Handling Unit {0} Quantity.
9360655 Hard Missing or Invalid Handling Unit {0} Packaging Type Code.
9360656 Hard Missing or Invalid Handling Unit {0} Dimension Length.
9360657 Hard Missing or Invalid Handling Unit {0} Dimension Width.
9360658 Hard Missing or Invalid Handling Unit {0} Dimension Height.
9360659 Hard Missing or Invalid Unit of Measurement Code for Handling Unit {0}.
9360660 Hard Shipper has density pricing. Handling unit dimension required.
9360661 Hard Density rate is not available but NMFC and class number are missing for class based rating.
9360662 Hard Missing Handling Unit {0} Package Type Container.
9360663 Hard Missing Handling Unit {0} Dimension Container.
9360664 Hard Missing Handling Unit {0} UOM Container
9360665 Hard Excess liability cannot be greater than 100000.00.
9360728 Hard Shipment total weight under 151 pounds
9360729 Hard Linear feet is required for total weight more than 10,000 lbs.
9360730 Hard Missing required shipment parties.
9360731 Hard Duplicate Shipment Number.
9368775 Hard Invalid NMFC Prime Number for commodity{0}
9368780 Hard Invalid ship date. Ship date should not be in the past.
9368781 Hard Invalid numbers of handling units. Should be between 1 and 9999.
9368783 Hard Invalid request party. Valid values are S, C and T.
9368784 Hard At least one shipment is required.
9368785 Hard Please contact TForce Freight Customer Service for Rates at 800-333-7400.
9368786 Hard Please contact TForce Freight Customer Service for Rates at 800-333-7400.
9368787 Hard Invalid Ship From Address.
9368788 Hard Shipment weight must be less than 10,000 lbs.
9368789 Hard Please contact TForce Freight Customer Service for Rates at 800-333-7400.
9368790 Hard Weight unit of measure is invalid
9368791 Hard Please contact TForce Freight Customer Service for Rates at 800-333-7400
9369061 Hard The origin is located in an extended area requiring an estimated 2 days additional transit time.
9369062 Hard The destination is located in an extended area requiring an estimated 1 day additional transit time.
9369063 Hard The destination is located in an extended area requiring an estimated 2 day additional transit time.
9369064 Hard UPS 3 Day transit time is greater than 3 days.
9369065 Hard Payment Terms and lane selected requires pre-authorization.
9370000 Transientrd Freight Shipping Web Service is Unavailable
9370001 Hard Missing Ship From Phone
9370041 Hard Missing or Invalid Shipper Number
9370060 Hard Missing Confirmation Number container.
9370061 Hard Missing or Invalid Account Type Code.
9370062 Hard Missing Confirmation Number Type.
9370063 Hard Missing or invalid Code for Confirmation Number Type.
9370064 Hard Missing or invalid Confirmation Number Value.
9370065 Hard BOLID and confirmation number cannot be used together. Please use confirmation number instead.
9370066 Hard Missing or Invalid Creation Date.
9370101 Hard Missing Payment Information
9370151 Hard Missing Shipment Billing Option
9370175 Hard Missing or Invalid Manufacturer Country Code.
9370201 Hard Missing Service
9370216 Hard Missing or Invalid Handling Unit One Quantity
9370217 Hard Missing Handling Unit One Type
9370231 Hard Missing or Invalid Handling Unit Two Quantity
9370232 Hard Missing Handling Unit Two Type
9370245 Hard Missing or Invalid Shipment Total Weight Value.
9370246 Hard Missing Unit of Measurement for Shipment Total Weight.
9370247 Hard Missing or Invalid Unit of Measurement Code for Shipment Total Weight.
9370256 Hard Missing Commodity {cardinality} Weight
9370257 Hard Missing Commodity {cardinality} Weights Unit Of Measure
9370258 Hard Missing the Commodity {cardinality} Dimensions Unit of Measurement
9370259 Hard Missing Packaging Type of Commodity {cardinality}
9370260 Hard Missing or Invalid Monetary Value of Commodity {cardinality}s Commodity Value
9370261 Hard NMFC Commodity Prime Code is required when NMFC Commodity Sub Code is supplied for Commodity{0}
9370262 Hard NMFCCommodity container and NMFCCommodityCode are mutually exclusive for Commodity{0}
9370327 Hard Missing Reference {cardinality}s Number
9370328 Hard Invalid Number of Cartons in Reference {cardinality}.
9370329 Hard Missing Reference {cardinality} Weights Unit of Measure
9370376 Hard For a shipment, the maximum number of Email Information allowed for {Email Type} is 1
9370377 Hard Missing Email Information {cardinality}s Email Type
9370378 Hard Missing or Invalid Email Information {cardinality}s Email Type Code.
9370379 Hard Missing Shipment Notification Email.
9370380 Hard Missing or Invalid Shipment Notification undeliverable email address.
9370381 Hard Missing Delivery Notification Email.
9370382 Hard Missing or Invalid Delivery Notification undeliverable email address.
9370383 Hard Missing Exception Notification Email.
9370384 Hard Missing or Invalid Exception Notification undeliverable email address.
9370385 Hard Missing Air Way Bill Notification Email.
9370386 Hard Missing or Invalid Air Way Bill Notification undeliverable email address.
9370387 Hard Missing BOL/Label Bill Notification Email.
9370388 Hard Missing or Invalid BOL/Label Notification undeliverable email address.
9370421 Hard Missing COD Value.
9370422 Hard Missing the COD Payment Method.
9370423 Hard Missing the COD Billing Option.
9370424 Hard Missing Remit To Address
9370425 Hard Missing COD Remit To
9370446 Hard Missing Overseas Leg Dimensions
9370447 Hard Missing the Unit of Measurement for the Overseas Leg Dimensions
9370448 Hard Missing or Invalid Overseas Leg Value
9370449 Hard Missing or Invalid Overseas Leg Volume
9370450 Hard Missing or Invalid Overseas Leg Height
9370451 Hard Missing or Invalid Overseas Leg Length
9370452 Hard Missing or Invalid Overseas Leg Width
9370453 Hard Missing or Invalid Monetary Value for the Overseas Leg Price per Cubic Foot.
9370454 Hard Missing or Invalid Monetary Value for the Overseas Leg Price per CWT.
9370455 Hard Missing Value for Overseas Leg.
9370466 Hard Invalid combination of Percentage and Value for the Handling Charge service option.
9370467 Hard Missing Dangerous Goods Contact Name
9370468 Hard Missing Dangerous Goods Phone
9370469 Hard Missing Dangerous Goods Phone Number
9370470 Hard Missing or Invalid Handling Charge Percentage or value
9370471 Hard Invalid Combination of Handling Charge Percentage and Value
9370527 Hard Missing Pickup Requester Phone.
9370651 Hard Missing or Invalid document image labels per page for image {cardinality}
9370652 Hard Missing or Invalid document image type code for image {cardinality}
9370653 Hard Missing or invalid format code for image {cardinality}
9370654 Hard Missing print size for image {cardinality}
9370655 Hard Missing or invalid print size width for image {cardinality}
9370656 Hard Missing or invalid print size length for image {cardinality}
9370657 Hard Missing print format for image {cardinality}.
9370658 Hard Missing or invalid print format code for image {cardinality}.
9370659 Hard Missing document image type for image{cardinality}.
9370660 Hard Missing format for image {cardinality}.
9370661 Hard Invalid document image {cardinality} print sizes.
9370701 Hard Invalid processing option
9370751 Hard Missing or invalid ship from company name in packing list.
9370752 Hard Invalid ship from attention name in packing list.
9370753 Hard Missing or invalid ship from address line one in packing list.
9370754 Hard Invalid ship from address line two in packing list.
9370755 Hard Invalid ship from address line three in packing list.
9370756 Hard Missing or invalid ship from city in packing list.
9370757 Hard Invalid ship from state code in packing list.
9370758 Hard Missing or invalid ship from country code in packing list.
9370759 Hard Invalid ship from postal code in packing list.
9370760 Hard Invalid ship from town in packing list.
9370761 Hard Invalid ship from phone number in packing list.
9370762 Hard Invalid ship from phone extension in packing list.
9370764 Hard Missing or invalid ship to company name in packing list.
9370765 Hard Invalid ship to attention name in packing list.
9370766 Hard Missing or invalid ship to address line one in packing list.
9370767 Hard Invalid ship to address line two in packing list.
9370768 Hard Invalid ship to address line three in packing list.
9370769 Hard Missing or invalid ship to city in packing list.
9370770 Hard Invalid ship to state code in packing list.
9370771 Hard Missing or invalid ship to country code in packing list.
9370772 Hard Invalid ship to postal code in packing list.
9370773 Hard Invalid ship to town in packing list.
9370774 Hard Invalid ship to phone number in packing list.
9370775 Hard Invalid ship to phone extension in packing list.
9370777 Hard Missing or invalid packing list reference value one.
9370778 Hard Missing or invalid packing list reference value two.
9370779 Hard Invalid packing list reference label one.
9370780 Hard Invalid packing list reference label two.
9370781 Hard Invalid total number of commodities in packing list.
9370782 Hard Invalid handling unit instructions in packing list.
9370783 Hard Invalid handling unit total number of pieces in packing list.
9370784 Hard Invalid handling unit total weight in packing list.
9370785 Hard Missing or invalid handling unit UOM in packing list.
9370786 Hard Invalid handling unit currency code in packing list.
9370787 Hard Invalid number of pieces for commodity {index} in packing list.
9370788 Hard Missing or invalid packaging type for commodity{index} in packing list.
9370790 Hard Invalid description for commodity{index} in packing list.
9370791 Hard Invalid NMFCCommodityCode for commodity{index} in packing list.
9370792 Hard Invalid freight class for commodity{index} in packing list.
9370793 Hard Missing or invalid length for commodity{index} in packing list.
9370794 Hard Missing or invalid width for commodity{index} in packing list.
9370795 Hard Missing or invalid height for commodity{index} in packing list.
9370796 Hard Invalid weight for commodity{index} in packing list.
9370797 Hard Invalid price for commodity{index} in packing list.
9370798 Hard Invalid total number of handling units in packing list.
9371000 Hard Invalid Freight Shipping Request Document
9372000 Hard Missing TaxID Type Container.
9372001 Hard Missing or Invalid Code for TaxID Type.
9372002 Hard Missing or Invalid TaxID Number

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.