of
  • Service Adjustments related to Coronavirus… More
  • Temporary Service Adjustment during Tokyo 2020 Olympic Games in Japan… More
  • Temporary Service Adjustments due to Typhoons in Zhejiang Province, China Mainland… More
  • Temporary Service Suspension due to Heavy Rain and Floods in Henan Province, China Mainland… More
  • Customs regulations and requirements for import or export of medical supplies and equipment… More
Skip to Main Content

Developer Announcements and API Updates

July 2021

Zonal Large Package Surcharge: (Rate/Ship)

  • Zonal LPS will now affect Hundredweight Services

IOSS and VAT Reform for European Union (Ship)

  • New fields to be added for IOSS number
  • This is for supporting the new European Union VAT reforms.

Simple Rate Developer Kit Update (Ship/Rate)

  • Simple Rate Supplement elements moved to Rate & Ship Developer Kits on UPS.com
  • Includes the Business Rules and XPath table elements

April 2021

Zonal Large Package Surcharge: (Rate/Ship)

  • U.S. Zones only
  • Not changed to include for Hundredweight Services
  • Rates will vary by zones.

January 2021

Brexit Northern Ireland Rules: (All)

  • Changes to PostalCode for Northern Ireland Cities – Must start with BT.
  • New Accessorial for Ship and Rate API : 551 - UK Border Fee

Remove Verbal Confirmation (Ship/Rate):

  • Verbal Confirmation of Delivery data elements from the Dev Guide
  • NRF/Rave will error this accessorial if it is sent after removal date. No new error but will use the generic that accessorial is not valid.
  • New Error Message: 111262-The accessory is not valid with the selected option. To replace previous error messages

EORI number: (Ship)

  • Information regarding EORI number can now be found in the FAQ section of the Developer Guide.
  • EORI Number should be entered in additional comments section of Invoice
  • If needed for label - EORI should be entered as the 1st or 2nd Package Level ReferenceNumber.

Addition of Reference Numbers Allowed at the Package Level (Ship):

  • Reference Number can now be used 5 times at Package Level.
  • Only the first 2 reference numbers will be put on the label
    • Systems read from top to bottom of the request

UPS Premier

A new contract service that will provide the additional visibility to critical healthcare-specific movement events in visibility systems. Please reach out to your sales person for more information

New Functionality added in dependent upon Premier Category

  • Categories
    • Silver
    • Gold
    • Platinum
  • Requirements
    • Must have an RFID printer
    • For Category Silver only ZPL printer language accepted
    • Must have a Contract for specific category
  • Impacted APIs
    • Shipping API
    • Rating API
    • Tracking API

July 2020 Updates

Shipping API – Small Package

Weekend Service Enhancements

  • UPS shippers shipping US Ground or US 3 Day Select will have the option to have their packages delivered to a Commercial Address on a Saturday if the origin/destination lane is in a Weekend Service Territory. The payer of transportation charges will incur the new Saturday Non-Premium Commercial Delivery Surcharge. To check Weekend Service Territory eligibility please Refer to The Time in Transit API or UPS.com 

New Error Codes - Please refer to the Developer Guide Appendix for error codes.

Rating API – Small Package 

Weekend Service Enhancements

  • UPS shippers shipping US Ground or US 3 Day Select will have the option to have their packages delivered to a Commercial Address on a Saturday or Sunday if the origin/destination lane is in a Weekend Service Territory. The payer of transportation charges will incur the new Saturday or Sunday Non-Premium Commercial Delivery Surcharge. To check Weekend Service Territory eligibility please use Ratetimeintransit request option or reference UPS.com  

New Error Codes - Please refer to the Developer Guide Appendix for error codes.

Time In Transit Web Service Developer Guide

Description Weekend delivery support

  • Support for Saturday and Sunday 3day Select and Ground commercial delivery options.
  • Support for Sunday 3 Day Select and Ground commercial delivery options.
  • Support for Sunday Residential delivery options.

New Request Containers/Elements
/TimeInTransitRequest/SundayDeliveryInfoRequestIndicator

New Response Containers/Elements
/TimeInTransitResponse/TransitResponse/ServiceSummary/
SundayDelivery
SundayDeliveryDisclaimer

Pickup - Package Web Service Developer Guide

Weekend Operations

The Weekend Operations project evaluates the need for expanding UPS pickup operations from a 6- day a week to a 7-day a week with Weekend Service Territory region.
From Internet Pickup, Sunday can be selected by the user if they would like to schedule pickup (only in Weekend Service Territory (WST) areas).
Deliverables to support Sunday Ground (delivery & pickup) include:

  • Enhance dispatch, route planning, and sorting capabilities
  • Support shipping process changes
  • Support pickup changes (Scheduled, Smart and On-Call)
  • Provide accurate visibility for Sunday Volume
  • Support billing changes to allow for expanded Weekend Operations


New Elements
/PickupCreationResponse/WeekendServiceTerritory /PickupCreationResponse/WeekendServiceTerritory/SatWST /PickupCreationResponse/WeekendServiceTerritory/SunWST /PickupRateResponse/WeekendServiceTerritory /PickupRateResponse/WeekendServiceTerritory/SatWST /PickupRateResponse/WeekendServiceTerritory/SunWST

Quantum View® - Package

July 2020 New Features

  • Quantum View API will include the new elements SaturdayNonPremiumCommercialDeliveryIndicator and SundayNonPremiumCommercialDeliveryIndicator in Manifest M1 & M2 records for all product

March 2020 Updates

Shipping API – Small Package

FRS Negotiated Rates
Ship API will support negotiated FRS shipment transportation rates

New Warning codes:
120395 Payment Account is not associated with ups.com user profile.
120396 Full-Published Rates Returned. Customer could not be found for that zip code.


Rating API – Small Package

FRS Negotiated Rates
Rate API will support negotiated FRS shipment transportation rates

New Warning code:
111671 Payment Account is not associated with ups.com user profile.

Rating API - Freight

FRS Negotiated Rates
Ground Freight Rate API will support negotiated FRS shipment transportation rates.


July 2019

Locator Plug-In

The UPS Global Locator Plug-In is now available with the Global Locator API developer kit. Customers will be required to login and obtain an Access Key to download the Global Locator API developer kit, which includes the Plug-In. The Plug-In will be available in the same countries as the Locator API.

Download the Global Locator API developer kit and Plug-in

Locator API

This improvement includes the following Europe Origin Countries to the Global Locator API:

Israel (IL), Russia (RU), Ukraine (UA), and Turkey (TR).

Shipping API

A new contractual service, UPS Worldwide Economy, is a cost-effective, deferred international small- package service designed to address the boom in cross-border e-commerce and help merchants penetrate new markets.

Initially the contractual service will include the United States (US), United Kingdom (GB), Canada (CA), China Mainland (CN), and Hong Kong SAR, China (HK). There will be additional countries launching in September and in January 2020.

January 2019

Collection API

Additions for the Pickup API include allowing cash as a form of payment in Ireland and Saturday Pickup in Ireland with a charge. Secondly, a postcode expansion to support 4- and 8-digit postcodes for Argentina.

Rating API

Updates to the Rating API include support for the Heavy Goods when an origin and destination is entered to calculate Time in Transit.

Changed the name of Large Parcel Surcharge to Irregular Parcel Surcharge to align with the Rate and Service Guide.

Additional support for Saturday Collection for UPS Worldwide Express Plus®, UPS Worldwide Express®, and UPS Worldwide Saver® shipments with U.S. origins to 62 destination countries.

Shipping API

Updates to the Shipping API include changing the name of Large Parcel Surcharge to Irregular Parcel Surcharge to align with the Rate and Service Guide.

Additional support for Saturday Collection for UPS Worldwide Express Plus®, UPS Worldwide Express® and UPS Worldwide Saver® shipments with US origins to 62 destination countries.

Time in Transit API

Updates to the Time in Transit API include support for Heavy Goods when the origin and destination is provided.

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.