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 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 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
| Service | Transit Time | Service Codes | Countries |
|---|---|---|---|
| UPS® Ground | 1-5 Business days | ups_ground | US |
| UPS® Ground Saver | 3-7 Business days | ups_ground_saver | US |
| UPS Standard | 1-5 Business days | ups_standard | CA, GB |
| UPS 3 Day Select® | 3 Business days | ups_3_day_select | US |
| UPS 2nd Day Air® | 2 Business days | ups_2nd_day_air | US, CA |
| UPS 2nd Day Air AM® | 2 Business days (before noon) | ups_2nd_day_air_am | US |
| UPS Next Day Air Saver® | 1 Business day (End of day) | ups_next_day_air_saver | US, CA |
| UPS Next Day Air® | 1 Business day | ups_next_day_air | US, CA |
| UPS Next Day Air® Early | 1 Business day (delivery between 8am-10am) | ups_next_day_air_early_am | US, CA |
| UPS Express® | ups_express | AU, DE, FR, GB, NZ | |
| UPS Express Plus® | ups_express_plus | AU, DE, FR, GB, NZ | |
| UPS Worldwide Saver® | ups_worldwide_saver | AU, DE, FR, GB, NZ |
International Services
| Service | Transit Time | Service Codes | Countries |
|---|---|---|---|
| UPS Ground® (International) | ups_ground_international | US | |
| UPS 3 Day Select® | 3 Business days | ups_3_day_select | CA |
| UPS Worldwide Express® | Varies by country | ups_worldwide_express | US, CA, GB |
| UPS Worldwide Expedited® | ups_worldwide_expedited | US, CA, GB | |
| UPS Worldwide Saver® | ups_worldwide_saver | US, CA, GB | |
| UPS Standard® | ups_standard | US, CA, GB | |
| UPS Worldwide Express Plus® | ups_worldwide_express_plus | US, CA, GB |
Shipping from Great Britain to Northern Ireland
At this time, UPS has not provided any details about required changes when creating labels for shipment from Great Britain to Northern Ireland as related to the Windsor Framework.
We will provide details about using UPS to ship to Northern Ireland as soon as they are available.
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 create date and must not have been scanned by UPS.
See our Void a Label page for details about voiding labels with ShipStation API.
Paperless Lables
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 Type | API Code | Description |
|---|---|---|
| Online | online | This is the default option if no confirmation type is specified. |
| Delivery | delivery | Delivery confirmation requested. |
| Signature | signature | Signature confirmation requested. |
| Adult signature | adult_signature | Adult signature confirmation requested. |
| Verbal | verbal | Verbal 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.
| Option | Type | Default Value | Description |
|---|---|---|---|
additional_handling | boolean | null | Indicates the package requires special handling. |
delivered_duty_paid | boolean | false | Indicates the shipment is DDP (that is, the shipper is paying the duties/taxes for the shipment rather than the recipient). |
non_machinable | boolean | false | Indicates that the package cannot be processed through sorting machines. |
saturday_delivery | boolean | false | Indicates 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.