Site Logo

🎉 ShipEngine is becoming ShipStation API 🎉

Over the next few months you'll notice the ShipEngine website, documentation portal, and dashboard being rebranded as ShipStation API. For our ShipEngine customers, you don't need to take any action or change any of your integrations in any way. All endpoints will remain the same and continue to function as they always have.

To learn more about what's coming, review our New ShipStation API page.

UPS from ShipStation

UPS from ShipStation offers domestic and international shipping services at pre-negotiated rates to ShipStation API accounts in the following countries:

  • US
  • Canada
  • UK
  • Australia
  • New Zealand
  • France
  • Germany

This guide provides developers with the details needed to build UPS from ShipStation shipping capabilities into your ShipStation API workflows.

ShipStation API also allows you to connect your own existing UPS account and the requirements and service details are different than those for UPS from ShipStation. For details about connecting and using your own UPS account with ShipStation API, see our UPS Guide.

Requirements

carrier_name: ups_walleted

  • A ShipStation API account based in one of the supported countries.
  • ShipStation Carriers must be activated for the account and have a positive account balance to create labels. See our Using ShipStation Carriers page for details about activating it in your account.
  • A weight value is required for all shipments.
  • Available services will vary by country. See the Service Details section for specifics.

Rates

UPS from ShipStation supports rate shopping with ShipStation API.

Service Details

Available UPS from ShipStation services are provided below. Please note that carriers may update their available services at any time. To ensure you are always using valid services, you can use the list carrier services endpoint at any time.

Domestic Services

ServiceTransit TimeService CodesCountries
UPS® Ground1-5 Business daysups_groundUS
UPS® Ground Saver3-7 Business daysups_ground_saverUS
UPS Standard1-5 Business daysups_standardCA, GB
UPS 3 Day Select®3 Business daysups_3_day_selectUS
UPS 2nd Day Air®2 Business daysups_2nd_day_airUS, CA
UPS 2nd Day Air AM®2 Business days (before noon)ups_2nd_day_air_amUS
UPS Next Day Air Saver®1 Business day (End of day)ups_next_day_air_saverUS, CA
UPS Next Day Air®1 Business dayups_next_day_airUS, CA
UPS Next Day Air® Early1 Business day (delivery between 8am-10am)ups_next_day_air_early_amUS, CA
UPS Express®ups_expressAU, DE, FR, GB, NZ
UPS Express Plus®ups_express_plusAU, DE, FR, GB, NZ
UPS Worldwide Saver®ups_worldwide_saverAU, DE, FR, GB, NZ

International Services

ServiceTransit TimeService CodesCountries
UPS Ground® (International)ups_ground_internationalUS
UPS 3 Day Select®3 Business daysups_3_day_selectCA
UPS Worldwide Express®Varies by countryups_worldwide_expressUS, CA, GB
UPS Worldwide Expedited®ups_worldwide_expeditedUS, CA, GB
UPS Worldwide Saver®ups_worldwide_saverUS, CA, GB
UPS Standard®ups_standardUS, CA, GB
UPS Worldwide Express Plus®ups_worldwide_express_plusUS, CA, GB

Shipping from Great Britain to Northern Ireland

As of 1st May 2025, UPS will support all movement types (B2B, B2C, C2C, and C2B) for shipping from Great Britain (GB) to Northern Ireland (NI), as related to the Windsor Framework.

Let UPS know in advance if your goods are considered 'at risk' of moving through Northern Ireland to be sold in the EU. To learn when goods can be considered as ‘not at risk’, see the page UK Government Guidance page Moving goods you bring into Northern Ireland as 'not at risk’ of moving to the EU.

Shippers must send an email to [email protected] for UPS to add instructions to their UPS UK shipping account number, along with UKIMS approval number & XI Duty Deferment number, when applicable. They must also enter their B2B NI customer’s XI EORI number with the shipping data in the ​Destination Tax ID​​ field, if they know it.

NI Importers, and if required, some GB shippers, will need to be authorised under the new ​UK Internal Market Scheme (UKIMS)​​ to avoid EU duties. Merchants may want to consider signing up for the ​UK Government's [Trader Support Service​​}(https://www.gov.uk/guidance/trader-support-service).

Windsor Framework Parameters​

ParameterRequired?Description
Movement IndicatorMovement Indicator required for GB-NI shipments.
Not at risk flagB2B: Default value = Unknown. You can set to ‘at risk’/'not at risk' for B2B.
B2B/C2C/C2B: Default value = NotAtRisk
Commercial InvoiceSee the UPS Commercial Invoice Guide.
UKIMS Number
(NI Importer of Record UKIMS Number)
----Required for B2B Movements
NI Importers, and if required, some GB shippers, need to be authorised under the new UK Internal Market Scheme(UKIMS) to avoid EU duties.
Not required for B2C/C2C/C2B
Can be Recipient UKIMS Number or Sender UKIMS Number (an entity who is NI Importer of Record)
UKIMS can be also assigned to a UPS Account Number within the UPS store settings.
EORI----Required for B2B Movements
EORI Number (registered in NI starts with “NI”)
EORI can be also assigned to a UPS Account Number within the UPS store settings.

Data Expectations

NOTE: Clear goods descriptions, values, and commodity codes are required for all movement types.

*Please specify each item in the shipment with its commodity code, weight, and a concise description, eg. "Ladies woven 100% cotton blouse”, “Men’s leather shoes” or "iPhone" instead of a general one.

  • Incorrect: Nuts
  • Correct: 26 hexagonal aluminum bicycle nuts
  • Incorrect: T-Shirts
  • Correct: 15 men's T-Shirts, Size L, 100% Cotton

B2B parcels with UKIMS authorisation:

  • at-risk statement should be present in the *QAART segment (Shipment Question Attribute)
  • Product.Description*
  • Product.Value
  • Product.ValueCurrency
  • Product.Quantity
  • Product.Country
  • 6-Digit HS Code [Product.HarmonisedCode]
  • EORI Number (Importer of Record)
    Present in the *QAID2 Identification Numbers segment.
  • UKIMS Number (Importer of Record)
    Present in the *QAID2 Identification Numbers segment.
  • NI Importer of Record Duty Deferment Number(if applicable)
    Present in the *QAID2 Identification Numbers segment.

B2B parcels without UKIMS authorisation:

  • at-risk statement should be present in the *QAART segment (Shipment Question Attribute)
  • Product.Description*
  • Product.Value
  • Product.ValueCurrency
  • Product.Quantity
  • Product.Country
  • 6-Digit HS Code [Product.HarmonisedCode]
  • EORI Number (Importer of Record)
    Present in the *QAID2 Identification Numbers segment.
  • NI Importer of Record Duty Deferment Number(if applicable)
    Present in the *QAID2 Identification Numbers segment.

B2B/B2C/C2B parcels

  • at-risk statement should be present in the *QAART segment (Shipment Question Attribute)
  • Product.Description*
  • Product.Value
  • Product.ValueCurrency
  • Product.Quantity
  • Product.Country
  • 6-Digit HS Code [Product.HarmonisedCode]

TIP: You may find it helpful to see the Products Object section of our International Shipping page.

Additional Considerations for Validation

  • Comply with weight limits for parcels.
    B2C / C2B / C2C shipments with any number of items or multiple parcels must weigh less than 31.5kg. If a parcel exceeds this limit, it will be considered a B2B shipment that requires customs clearance.
    B2C / C2B / C2C shipments must contain only one (single) item of goods and weigh less than 100kg. If not, it will be considered a B2B shipment that requires customs clearance.
  • Commercial Invoice or Paperless Invoice
    Paperless Invoice is the default. If a physical Commercial Invoice is required, then Shipment.ContentType must be set to InvoiceGenerated.
  • Statement at risk/not at risk (recommended for B2B - default is Unknown, optional for B2C/C2C/C2B)
  • NI Importer of Record → Duty Deferment Number (if applicable)
  • For additional assistance, please email your queries to [email protected].

Return Services

You can use the following UPS from ShipStation domestic services for returns:

  • UPS® Ground
  • UPS 3 Day Select®
  • UPS 2nd Day Air®
  • UPS Next Day Air Saver®
  • UPS Next Day Air®
  • UPS Next Day Air® Early
  • UPS 2nd Day Air AM®
  • UPS Express®
  • UPS Express Plus®
  • UPS Worldwide Saver®

Review the Return Shipping Labels page for details on creating return labels with ShipStation API.

Packages

UPS from ShipStation does not specify carrier package types. You can use custom package types or the generic package package type.

Adding Shipment Insurance

UPS from ShipStation does not support adding carrier insurance to shipments created with ShipStation API. US accounts can add Parcelguard protection to UPS from ShipStation shipments.

Review the Parcel Insurance page for details about adding shipment insurance with ShipStation API.

Label Support

  • Label sizes: 4" x 6"
  • Label formats: PDF, PNG, ZPL

Label Reference Fields

UPS from ShipStation supports adding custom label messages.

Multi-Package Labels

All UPS from ShipStation services support creating multi-package labels.

See our Multi-Package Shipping page for details about creating multi-package labels.

Label Branding

UPS from ShipStation does not support label branding.

Voiding Labels

UPS from ShipStation supports voiding labels with ShipStation API. Labels must be voided within 30 days of the label's creation date and must not have been scanned by UPS.

See our Void a Label page for details about voiding labels with ShipStation API.

Paperless Labels

UPS from ShipStation supports creating paperless labels.

See our Paperless Labels page for details about creating paperless labels with ShipStation API.

Customs Declarations

UPS from ShipStation electronically submits customs declarations in a commercial invoice. The label will display "EDI" to indicate electronic submission. If you wish to print the commercial invoice, you can access it from the label response form_download object.

Delivery Confirmation

UPS from ShipStation supports the following delivery confirmation options (options other than online may incur an additional fee from UPS).

Confirmation TypeAPI CodeDescription
OnlineonlineThis is the default option if no confirmation type is specified.
DeliverydeliveryDelivery confirmation requested.
SignaturesignatureSignature confirmation requested.
Adult signatureadult_signatureAdult signature confirmation requested.
VerbalverbalVerbal confirmation requested.

See our Delivery Confirmation page for more details about using the confirmation property.

Advanced Options

UPS from ShipStation supports certain advanced options, which you can add to the shipment object when creating a shipment or label.

OptionTypeDefault ValueDescription
additional_handlingbooleannullIndicates the package requires special handling.
delivered_duty_paidbooleanfalseIndicates the shipment is DDP (that is, the shipper is paying the duties/taxes for the shipment rather than the recipient).
non_machinablebooleanfalseIndicates that the package cannot be processed through sorting machines.
saturday_deliverybooleanfalseIndicates that the carrier should charge for delivery on Saturday for services that do not otherwise include Saturday delivery. Only valid for certain services.

To ensure you always have the most up-to-date information about a carrier's advanced options, use the list carrier options call.

Dangerous Goods

UPS from ShipStation does not support shipping dangerous goods.

Manifests

UPS from ShipStation does not support creating printable manifests. All shipment data is submitted electronically to UPS at the time of label creation, so UPS will have the shipment data in their system.

Scheduling Pickups

UPS from ShipStation supports schedule carrier pickups. Using this option may incur additional fees.

Service Points (PUDO)

UPS from ShipStation does not support shipping to service points.

Tracking

UPS from ShipStation supports receiving tracking updates. Review our ​Track a Package guides​​ for details on tracking with the ShipStation API.