Ship Webservice

Services

Standard

The most basic service. Normal ground shipping without any modifier to speed up the shipping time.

One day

Express shipment that will be delivered the next working day

One day early

Express shipment that will be delivered the next working day before noon

Returns

A shipment that the customer sends back to the store / sender

Requirements:

  • the parameter package.description is mandatory

Expedited

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
  • You'll have to use your own UPS contract
  • The recipient has to be located outside of the EU, Liechtenstein, Norway or Switzerland

Express 12:00

The UPS service Express 12:00 ensures a next business day delivery by noon throughout the country.

Requirements:

  • The sender and recipient have to be located in Germany
  • service has to be ups_express_1200
  • Label size can be A5 & A6

Package types

Parcel

The most basic package type for shipping parcels there is.

Additional services

Cash on delivery

Requirements:

  • only collection of cash is available for now, no collection of checks
  • you'll have to use your own contract with the carrier

Adult signature

When sending packages via UPS you can specify that the receiver needs to be an adult, and prove the fact with his or her signature.

Requirements:

  • you'll have to use your own contract with the carrier

Other attributes

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.

Requirements:

  • You'll have to use your own UPS contract

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.

Requirements:

  • description is mandatory
  • customs_declaration.currency has to be EUR

Label formats

PDF

  • DIN A5: pdf_a5
  • DIN A6: pdf_a6

Misc

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

Field lengths

  • company: 1 - 35 characters (only 30 characters will be printed on the label)
  • last_name: 1 - 35 characters (firstname + last_name <= 35 characters - only 30 characters will be printed on the label)
  • care_of: 0 - 35 characters (only 30 characters will be printed on the label)
  • street: 1 - 35 characters (street + street_no <= 35 characters - only 30 characters will be printed on the label)
  • zip_code: 1 - 9 characters
  • city: 1 - 30 characters (only 15 characters will be printed on the label)
  • state: 2 characters
  • phone: 0 - 15 characters
  • reference_number: 0 - 35 characters