If you want to send less urgent shipments to destinations outside of Europe you can use the UPS
service expedited to reach more than 220 countries and territories.
Requirements:
description is mandatory
service has to be ups_expedited
The recipient has to be located outside of the EU, Liechtenstein, Norway or Switzerland
For climate friendly shipping you can use the additional service carbon neutral. "UPS's
carbon neutral option supports projects that offset the emissions of the shipment's
transport."
Requirements:
service has to be standard, one_day,
one_day_early, returns, ups_expedited or
ups_express_1200
you'll have to use your own contract with the carrier
To make sure that a shipment only gets delivered to the address provided you can use the
additional service direct delivery only.
Direct Delivery Only ensures that a package is delivered to the residential or commercial
address you provide. This service stops recipients from redirecting packages and prevents our
drivers from rerouting deliveries when recipients are not at home, that includes UPS Access
Points.
Requirements:
service has to be standard, one_day,
one_day_early, ups_express_1200 or ups_expedited
you'll have to use your own contract with the carrier
When sending packages with the UPS additional service signature required you can make sure that
the receiver needs to supply a signature upon receiving the shipment.
Requirements:
service has to be standard, one_day,
one_day_early, ups_express_1200 or ups_expedited
you'll have to use your own contract with the carrier
Using the billing_options attribut, you can determine who is responsible for
paying for transportation and/or duties and taxes for a given shipment.
The following options are available:
sender, the sender of the shipment will pay
receiver, the receiver of the shipment will pay
third_party, a third party will pay
If you don't provide billing options, transportation will be billed to the sender. In UPS
terms, this is called pre payed. P/P will beprinted on the shipping label.
Another common use case, especially in a B2B setting, is called bill receiver, where the
receiver of a shipment pays for the tansportation of a shipment. You will receive a shipment
where the following is printed on the shipping label F/C BILL RECEIVER + Acc# +
ISO-Code.
Requirements:
You'll have to use your own UPS contract
When receiver or third_party has to pay, you will have to provide the
attributes account_number, zip_code and country
Determining who will pay for transportation is applicable for domestic and
international shipments
Determining who will pay for duties_and_taxes is only applicable for international
shipments
Shipper pays transportation charges (also referred to as "Prepaid")
Sender
Sender
F/D
Shipper pays all charges (also referred to as "Free Domicile")
Sender
Third party
P/P TPR + Acc# + ISO-Code
Shipper pays transportation charges; a third party (could be in another country) pays the duties and taxes
Receiver
-
F/C BILL RECEIVER + Acc# + ISO-Code
Receiver pays transportation charges
Receiver
Receiver
F/C RECEIVER + Acc#
Receiver pays all charges (also referred to as "Freight Collect")
Third Party
-
P/P TPS + Acc# + ISO-Code
A third party pays transportation charges
Third Party
Third Party
F/D TPS + Acc# + ISO-Code
A third party pays all charges
Customs declaration
If you want to send a shipment to a country where a customs declaration is necessary you can specify
this the following way. Detailed information about the parameters can be found in our
documentation of creating a shipment.
{"id":"199f803bf82fab79e17654213b61993fa78b0524","carrier":"dhl","carrier_tracking_no":"84168117830018","tracking_url":"https://track.shipcloud.io/199f803bf8","label_url":"https://shipping-labels.shipcloud.io/shipments/01370b4d/199f803bf8/label/shipping_label_199f803bf8.pdf","price":10.7,"customs_declaration":{"id":"cd-f466905c","contents_type":"commercial_goods","contents_explanation":"Alcoholic beverages","invoice_number":"123ABC","drop_off_location":"DE","posting_date":"2017-10-07","additional_fees":"0.0","total_value_amount":"247.0","currency":"EUR","created_at":"2017-10-04T15:49:44+02:00","updated_at":"2017-10-04T15:49:44+02:00","carrier_declaration_document_url":"https://documents.shipcloud.io/shipments/519895c7165cdc032356d42c6d9babe8e3151473/customs_declaration_document.pdf","items":[{"id":"cdi-50a46bf8","description":"Linkwood 25 years","hs_tariff_number":"501293884","net_weight":0.8,"origin_country":"DE","quantity":1,"value_amount":"138.5","created_at":"2017-10-04T15:49:44+02:00","updated_at":"2017-10-04T15:49:44+02:00"},{"id":"cdi-081a523d","description":"Caol Ila 18 years","hs_tariff_number":"123384890","net_weight":0.8,"origin_country":"DE","quantity":1,"value_amount":"108.5","created_at":"2017-10-04T15:49:44+02:00","updated_at":"2017-10-04T15:49:44+02:00"}]}}
Declared value
By using
UPS declared value
you can insure your parcel beyond the usual liability limits of EUR 510.
Caution:
Additional fees will be charged by UPS. Check your UPS contract or ask your account manager to get
a quote.
You shouldn't specify "declared_value" when creating a shipment up to EUR 510 or lesser value
unless you actually want the insurance instead of the liability.
When using UPS as a carrier it is possible to let shipments be delivered to a UPS access point.
This way recipients do not have to be at home for receiving their shipments but can collect them
from the access point at a later time.
Requirements:
the recipients address has to be provided as you normally would using the
to attribute
you have to provide the exact address of the UPS access point using the
drop_off_point attribute
the attribute drop_off_point.type has to be
parcel_shop
you also have to use the additional service
ups_access_point_notification
(see example)
{"from":{"first_name":"Serge","last_name":"Sender","company":"Sender Corp.","street":"Sender Str.","street_no":"99","zip_code":"20148","city":"Hamburg","country":"DE"},"to":{"first_name":"Roger","last_name":"Receiver","street":"Receiver Str.","street_no":"1","city":"Hamburg","zip_code":"20535","country":"DE"},"drop_off_point":{"company":"The BlueYellowShirts Store","street":"Drop Off Str.","street_no":"1","city":"Hamburg","zip_code":"20457","country":"DE","type":"parcel_shop"},"package":{"weight":0.5,"length":20,"width":15,"height":5,"type":"parcel"},"additional_services":[{"name":"ups_access_point_notification","properties":{"email":"roger@receiver.inc","language":"DE"}}],"carrier":"ups","service":"standard","create_shipping_label":true}
Cutoff times
When requesting a pickup by UPS, the carrier is validating your request if it's possible for them
to reach you within the requested time period. This validation factors in if there is enough time
for the driver to come to you and how far their depot is located from you.
UPS also has a list of cutoff times for postcodes in Germany, you can find within a service pdf
which is provided as a
download on
the UPS website.
Rules
If one of the following conditions is true, the parameter description is
mandatory:
from and to countries are not the same
from and/or to countries are not in the EU
from and to countries are in the EU and the shipments service is not standard
Trackers
A tracker can be used for tracking shipments that were created using a tool outside of shipcloud.
This way you can get notified of shipment changes, even if your shipping label has been created
somewhere else.