Asendia @ shipcloud

Carrier specifics

Manifests

When using Asendia as a carrier you MUST send them a manifest containing all the shipments you want the carrier to transport.

The posting_hub_address you will have to send us within the manifest will be provided to you by Asendia.

Additionally you will have to print the manifest and provide it to the carrier person picking up the shipments.

You can read everything about creating manifests in our OpenAPI spec .

Requirements

These global requirements apply to every call when using the carrier Asendia:

You'll have to use your own contract with the carrier
Sender and recipient have to be located in different countries.

Services

e-Paq Standard Economy

The service "e-Paq Standard Economy" is a standard service without tracking and without modifier to speed up shipping time for less urgent cross-border shipments.

Additional requirements (see global requirements):

Only applicable for shipments up to 2,000g
Maximum dimensions: longest side 600mm, length + width + thickness combined 900mm

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": "Wien",
    "zip_code": "1000",
    "country": "AT"
  },
  "package": {
    "weight": 0.5,
    "length": 20,
    "width": 15,
    "height": 5,
    "type": "parcel"
  },
  "carrier": "asendia",
  "service": "asendia_epaq_standard_economy",
  "create_shipping_label": true
}

e-Paq Standard Priority

The service "e-Paq Standard Priority" is a standard service without tracking and with the modifier "Priority" to speed up the shipping time for more urgent cross-border shipments.

Additional requirements (see global requirements):

Only applicable for shipments up to 2,000g
Maximum dimensions: longest side 600mm, length + width + thickness combined 900mm

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": "Wien",
    "zip_code": "1000",
    "country": "AT"
  },
  "package": {
    "weight": 0.5,
    "length": 20,
    "width": 15,
    "height": 5,
    "type": "parcel"
  },
  "carrier": "asendia",
  "service": "asendia_epaq_standard_priority",
  "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": "Wien",
    "zip_code": "1000",
    "country": "AT"
  },
  "package": {
    "weight": 0.5,
    "length": 20,
    "width": 15,
    "height": 5,
    "type": "parcel"
  },
  "carrier": "asendia",
  "service": "asendia_epaq_standard_economy",
  "create_shipping_label": true
}

Additional services

Bonus tracking

When using the additional service bonus tracking you will get a milestone based tracking of the shipment. This means that tracking will stop upon entry of the destination country.

Requirements:

Can only be used in combination with the service e-Paq Standard Priority

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": "Wien",
    "zip_code": "1000",
    "country": "AT"
  },
  "package": {
    "weight": 0.5,
    "length": 20,
    "width": 15,
    "height": 5,
    "type": "parcel"
  },
  "additional_services": [
    {
      "name": "asendia_bonus_tracking"
    }
  ],
  "carrier": "asendia",
  "service": "asendia_epaq_standard_priority",
  "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.currency can be one of the following: DKK, EUR, GBP, HKD, NOK, SEK, SGD, USD

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": 1.9,
    "length": 20,
    "width": 15,
    "height": 5,
    "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": 247,
    "items": [{
        "origin_country": "DE",
        "description": "Linkwood 25 years",
        "hs_tariff_number": "501293884",
        "quantity": "1",
        "value_amount": "138.50",
        "net_weight": "0.8"
      },
      {
        "origin_country": "DE",
        "description": "Caol Ila 18 years",
        "hs_tariff_number": "123384890",
        "quantity": "1",
        "value_amount": "108.50",
        "net_weight": "0.8"
      }
    ]
  },
  "carrier": "asendia",
  "service": "asendia_epaq_standard_economy",
  "create_shipping_label": true
}

Incoterms

Requirements:

incoterm can be dap, ddp, or ddu

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": "Daniel",
    "last_name": "Bernoulli",
    "street": "Rue du Grand-Pré",
    "street_no": "2a",
    "city": "Lausanne",
    "zip_code": "1007",
    "country": "CH"
  },
  "package": {
    "weight": 1.9,
    "length": 20,
    "width": 15,
    "height": 5,
    "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": 247,
    "items": [{
        "origin_country": "DE",
        "description": "Linkwood 25 years",
        "hs_tariff_number": "501293884",
        "quantity": "1",
        "value_amount": "138.50",
        "net_weight": "0.8"
      },
      {
        "origin_country": "DE",
        "description": "Caol Ila 18 years",
        "hs_tariff_number": "123384890",
        "quantity": "1",
        "value_amount": "108.50",
        "net_weight": "0.8"
      }
    ]
  },
  "carrier": "asendia",
  "service": "asendia_epaq_standard_economy",
  "incoterm": "ddp",
  "create_shipping_label": true
}

Label formats

PDF

DIN A6: pdf_a6

Asendia Shipping API V2

Carrier specifics

Manifests

Requirements

Services

e-Paq Standard Economy

e-Paq Standard Priority

Package types

Parcel

Additional services

Bonus tracking

Other attributes

Customs declaration

Incoterms

Label formats

PDF