Developer Announcements and API Updates
Stay Updated on UPS APIs
October Updates
- TForce Freight has launched Pickup, Shipping, Rating, and Tracking within their new API PORTAL (https://developer.tforcefreight.com).
- On 5/1/2024, UPS will no longer be supporting Pickup, Shipping, Rating, and Tracking integrations related to TForce Freight. Please visit the new portal to begin your TForce Freight Pickup, Shipping, Rating, and Tracking integrations.
September Updates
- TForce Freight has launched Rating and Tracking within their new API PORTAL (https://developer.tforcefreight.com).
- On 5/1/2024, UPS will no longer be supporting Rating and Tracking integrations related to TForce Freight. Please visit the new portal to begin your TForce Freight Rating and Tracking integrations.
August Updates
- TForce Freight has launched Tracking within their new API PORTAL (https://developer.tforcefreight.com).
- On 5/1/2024, UPS will no longer be supporting Tracking integrations related to TForce Freight. Please visit the new portal to begin your TForce Freight Tracking integration.
February Updates
Ship API Developer Guide Updates
- “Return to shipper” info removed from Shipper/Address element and new FAQ added
- New FAQ added about Access Point Shipping
- New Surepost Additional Handling options added
- New values in VendorCollectIDTypeCode element
Rate API Developer Guide Updates
- Rate Type table removed
- New Surepost Additional Handling options added
Announcement Affecting UPS Shipping in Mexico
In 2022 the Mexican Tax Administration Service implemented Carta Porte regulations, requiring merchandise description for all packages to Mexico, from Mexico, and within Mexico. Customers were notified of this regulation.
Effective March 6, 2023, UPS APIs will begin enforcing the Carta Porte regulation and all packages sent to, from, or within Mexico will be required to have a package-level description of the shipment.
The package-level description field shown in various API formats:
- {“ShipmentRequest”: {“Shipment”: {“Package”: {“Description”: {}}}}}
- /ShipmentRequest/Shipment/Package/Description
- /ShipConfirmRequest/Shipment/Package/Description
Shipments that do not include the package-level description will fail with the following error code:
- 121984 - A package in a Mexico shipment must have a Merchandise Description.
January Updates
- The Ship API and Rate API will support future date quoting when SubVersion 2205 is sent in the request (available only to API customers with a contract).
October Updates
Rate API
New subversion 2205 is being introduced to support the following Rate Request Containers/Elements:
Updated Request Containers/Elements
- /RatingServiceSelectionRequest/Request/SubVersion
New Response Containers/Elements
- /RatingServiceSelectionResponse/RatedShipment/RatedPackage/RateModifier
- /RatingServiceSelectionResponse/RatedShipment/RatedPackage/RateModifier/ModifierType
- /RatingServiceSelectionResponse/RatedShipment/RatedPackage/RateModifier/ModifierDesc
- /RatingServiceSelectionResponse/RatedShipment/RatedPackage/RateModifier/Amount
Rate Types Table Update
- If negotiated rates are requested then the published rate returned will be those associated to the account number, regardless of the CustomerClassification requested.
Ship API
New subversion 2205 is being introduced to support the following Ship Request Containers/Elements
Updated Request Containers/Elements
- /ShipmentRequest/Request/SubVersion
- /ShipConfirmRequest/Request/SubVersion
- /ShipAcceptRequest/Request/SubVersion
New Response Containers/Elements
- /ShipmentResponse/ShipmentResults/PackageResults/RateModifier
- /ShipmentResponse/ShipmentResults/PackageResults/RateModifier/ModifierType
- /ShipmentResponse/ShipmentResults/PackageResults/RateModifier/ModifierDesc
- /ShipmentResponse/ShipmentResults/PackageResults/RateModifier/Amount
- /ShipAcceptResponse/ShipmentResults/PackageResults/RateModifier
- /ShipAcceptResponse/ShipmentResults/PackageResults/RateModifier/ModifierType
- /ShipAcceptResponse/ShipmentResults/PackageResults/RateModifier/ModifierDesc
- /ShipAcceptResponse/ShipmentResults/PackageResults/RateModifier/Amount
July Updates
- The tracking number for all Ship API responses from wwwcie (test environment) will be 1ZXXXXXXXXXXXXXXXX.
- Print and Mail (PNM, option 2) has been removed as an option for Return Service shipments in Ship API.
February Updates
Landed Cost Quoting API:
- Can be used at any point when establishing products, shopping/quoting or at checkout
- Calculates costs and who pays duties, taxes, VAT and brokerage fees
- Eliminates unforeseen issues for your retail customers
- Predicts your HTS code automatically
Improvements to International Shipping (Ship API):
- Denied Party Screening
- Duty, Tax, and Brokerage Fee Estimates provided
- Save Parts functionality
January Updates
Developer Guide Updates (Rate API/Ship API)
- Within the Extended Area Surcharge group, Congested is updated to Remote Area.
- Surcharge category of Peak Season Surcharge is updated to Peak/Demand Surcharge, and Subtypes have been updated.