PARCEL.ONE @ shipcloud

Services

Standard

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

POST https://api.shipcloud.io/v1/shipments

{
  "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"
  },
  "package": {
    "weight": 0.5,
    "length": 20,
    "width": 15,
    "height": 5,
    "type": "parcel"
  },
  "carrier": "parcel_one",
  "service": "standard",
  "create_shipping_label": true
}

Returns

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

Notice: The carrier is working in partnership with (their) "local heroes". This means that you can't specify the carrier that will transport the return shipment. The carrier is chosen by PARCEL.ONE and the shipment will then have to be brought to one of the outlets of the corresponding carrier from the shipping label.

Requirements:

Returns can be send from the following countries:
- Austria (AT)
- Belgium (BE)
- Germany (DE)
- Denmark (DK)
- Spain (ES)
- Finland (FI)
- France (FR)
- Italy (IT)
- The Netherlands (NL)
- Sweden (SE)
label.format has to be pdf_a5
package.type has to be parcel

Show example

POST https://api.shipcloud.io/v1/shipments

{
  "from": {
    "first_name": "Carl Gustaf",
    "last_name": "Bernadotte",
    "street": "Kungliga slottet",
    "street_no": "107",
    "city": "Stockholm",
    "zip_code": "70",
    "country": "SE"
  },
  "to": {
    "first_name": "Serge",
    "last_name": "Sender",
    "company": "Sender Corp.",
    "street": "Sender Str.",
    "street_no": "99",
    "zip_code": "20148",
    "city": "Hamburg",
    "country": "DE"
  },
  "package": {
    "weight": 0.5,
    "length": 20,
    "width": 15,
    "height": 5,
    "type": "parcel"
  },
  "carrier": "parcel_one",
  "service": "returns",
  "create_shipping_label": true
}

Package types

Parcel

The most basic package type for shipping parcels there is.

Show example

POST https://api.shipcloud.io/v1/shipments

{
  "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"
  },
  "package": {
    "weight": 0.5,
    "length": 20,
    "width": 15,
    "height": 5,
    "type": "parcel"
  },
  "carrier": "parcel_one",
  "service": "standard",
  "create_shipping_label": true
}

Parcel letter

Everything which is too small for a parcel but larger and heavier than a classical letter

Requirements:

package.type has to be parcel_letter

Show example

POST https://api.shipcloud.io/v1/shipments

{
    "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"
    },
    "package": {
        "weight": 0.5,
        "length": 25,
        "width": 36,
        "height": 5,
        "type": "parcel_letter"
    },
    "carrier": "parcel_one",
    "service": "standard",
    "create_shipping_label": true
}

Other attributes

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:

customs_declaration.contents_type is mandatory
customs_declaration.currency has to be EUR
customs_declaration.items is mandatory

Show example

POST https://api.shipcloud.io/v1/shipments

{
  "from": {
    "first_name": "Serge",
    "last_name": "Sender",
    "company": "Sender Corp.",
    "street": "Sender Str.",
    "street_no": "99",
    "zip_code": "20148",
    "city": "Hamburg",
    "country": "DE"
  },
  "to": {
    "company": "Apple Inc.",
    "first_name": "Tim",
    "last_name": "Cook",
    "street": "Infinite Loop",
    "street_no": "1",
    "zip_code": "95014",
    "city": "Cupertino",
    "state": "CA",
    "country": "US",
    "phone": "408-996-1010"
  },
  "package": {
    "weight": "2",
    "length": "8",
    "width": "26",
    "height": "15",
    "type": "parcel"
  },
  "customs_declaration": {
    "contents_type": "commercial_goods",
    "contents_explanation": "Alcoholic beverages",
    "currency": "EUR",
    "additional_fees": 0.0,
    "drop_off_location": "DE",
    "posting_date": "2017-10-07",
    "invoice_number": "123ABC",
    "total_value_amount": 108.50,
    "items": [
      {
        "origin_country": "DE",
        "description": "Caol Ila 18 years",
        "hs_tariff_number": "123384890",
        "quantity": "1",
        "value_amount": "108.50",
        "net_weight": "0.8"
      }
    ]
  },
  "carrier": "parcel_one",
  "service": "standard",
  "create_shipping_label": true
}

Label formats

PDF

DIN A5: pdf_a5
DIN A6: pdf_a6

ShippingWCF API

Services

Standard

Returns

Package types

Parcel

Parcel letter

Other attributes

Customs declaration

Label formats

PDF