Bulk shipments require a CMR waybill and corresponding routing labels.
This guide will go through how the generate these through the API.
Note:
This is only supported for Bring at the moment.

Request body

The CMR waybill requires sender, receiver, loading and delivery addresses. Although if the receiver and delivery address are the same, delivery can be left out.
The same goes for sender and loading, although the loading date is still required.
Knowing this (packages will be explained in the next section) the minimal request body looks as follows:

{
  "carrier_code": "bring",
  "sender": {
    "name": "Min Virksomhed ApS",
    "address1": "Strandvejen 6",
    "zipcode": "5240",
    "city": "Odense NØ",
    "country_code": "DK"
  },
  "receiver": {
    "name": "Lene Hansen",
    "address1": "Skibhusvej 52",
    "zipcode": "5000",
    "city": "Odense C",
    "country_code": "DK"
  },
  "loading": {
    "date": "2019-01-30T14:54:29+01:00"
  }
  "packages": [
    {
      "product_code": "BRI_PPB",
      "package_type": "PARCEL",
      "amount": 3,
      "weight": 1000
    }
  ]
}

The packages array

The packages array, as seen the example earlier, contains the data of the pallets which are covered by the CMR waybill. This is also the information required the generate routing labels.

"packages": [
  {
    "product_code": "BRI_PPB",
    "package_type": "PARCEL",
    "amount": 3,
    "weight": 1000
  }
]

Each object in the array contains product_code, package_type, amount and weight.

Product code

Product code is the code of the product which the package/pallet contains.
The available product codes are:

  • BRI_PPB - Pickup Parcel Bulk
  • BRI_BPB - Business Parcel Bulk

Should one of these give you an "invalid product code" error, your account may not have access to these products. If so, please contact customer service.

Package type
Package type is whether the pallet is a pallet of many parcel goods or the good is the whole pallet.
The available package types are:

  • PALLET - Pallet
  • PARCEL - Pallet containing parcels

Amount
Amount differs depending on the given package type.

If the package type is pallet, amount is the amount of pallets and this will generate that amount of routing labels. This means, if you have multiple pallet, of same product and weight, you don't need multiple package objects.

If package type is parcel, amount is the amount of parcel on one pallet and this will generate one routing label. This means, if you want multiple pallet of parcels, you must give multiple package object.

Weight

Weight is the weight in grams of each pallet. So if the package type is parcel the weight is of the whole pallet, and if it is pallet it's the weight of each pallet.

Response

If a valid request body is posted the following response will be returned:

{
  "id": 23,
  "reference": "CS000000000NO",
  "carrier_code": "bring",
  "created_at": "2018-06-16T08:25:44.557+02:00",
  "sender": {
    "name": "Min Virksomhed ApS",
    "address1": "Strandvejen 6",
    "address2": null,
    "zipcode": "5240",
    "city": "Odense NØ",
    "country_code": "DK"
  },
  "receiver": {
    "name": "Lene Hansen",
    "address1": "Skibhusvej 52",
    "address2": null,
    "zipcode": "5000",
    "city": "Odense C",
    "country_code": "DK"
  },
  "loading": {
    "name": "Lene Hansen",
    "address1": "Skibhusvej 52",
    "address2": null,
    "zipcode": "5000",
    "city": "Odense C",
    "country_code": "DK",
    "date": "2019-01-30T14:54:29+01:00"
  },
  "delivery": {
    "name": "Min Virksomhed ApS",
    "address1": "Strandvejen 6",
    "address2": null,
    "zipcode": "5240",
    "city": "Odense NØ",
    "country_code": "DK"
  },
  "shipment": {
    "id": 123456,
    "label_base64": "..."
  },
  "base64": "..."
}

sender, receiver, loading and delivery will be the same as you have given.
reference
is the reference which will appear on the CMR waybill.

CMR Waybill

The response object will contain base64 which is a PDF, as a Base64 encoded string.

Routing labels

The shipment object the given packages which have been made into a shipment. It contains label_base64 which is a PDF of all the routing labels, as a Base64 encoded string.

Fandt du dit svar?