Support Portal

Welcome
Login

Create Multi-Shipment labels

TABLE OF CONTENTS


Goal: The goal of this document is to describe, how to create labels for a so called Multi-Coli shipment using the 7S label API.

Definition: Multi-Coli is an order which is split and shipped in multiple packages. The split may occur due to weight or size of the individual packages/parcels. All packages belong to the same order but receive separate labels with their unique reference number.

Note: Before creating Multi-Coli shipments, please note the following:

  • order_id cannot be printed on the label
  • reference_number has to be unique overall/across all orders, hence can only be used once

Step-by-Step Label Creation for Multi-Coli

Step 1: Create order

See Create order page.

Request body

{
  "order_id": "0003456",
  "order_url": "https://website.com",
  "order_date": "2020-05-26T13:31:42.470Z",
  "boarding_complete": true,
  "language": "en",
  "promised_delivery_date": "2020-05-26T13:31:42.470Z"
}

Response body

{
  "order_id": "0003456",
  "order_url": "https://website.com",
  "order_date": "2020-05-26T13:31:42+00:00",
  "boarding_complete": true,
  "state": "new",
  "language": "en",
  "states_history": [
    {
      "order_id": "0003456",
      "state": "new",
      "datetime": "2020-05-26T13:31:42+00:00",
      "location": null
    }
  ],
  "order_tags": [],
  "promised_delivery_date": "2020-05-26T13:31:42+00:00",
  "tracking_page_url": "https://trackingpages.7senders.com/#/order/0003456"
}

Step 2: Create a label for package #1

Request body

{
  "format": "pdf",
  "reference_number": "package#1",
  "sender_first_name": "First name",
  "sender_last_name": "Name",
  "sender_company_name": "Company",
  "sender_street": "Street",
  "sender_house_no": "1",
  "sender_zip": "12345",
  "sender_city": "City",
  "sender_country": "NL",
  "sender_phone": "123456789",
  "sender_email": "mail@mail.de",
  "cod": false,
  "order_id": "0003456",
  "carrier": {
    "name": "postnl",
    "country": "NL"
  },
  "carrier_service": "standard",
  "recipient_first_name": "First name",
  "recipient_last_name": "Name",
  "recipient_company_name": "Company",
  "recipient_email": "mail@mail.nl",
  "recipient_street": "street",
  "recipient_house_no": "2",
  "recipient_zip": "12345",
  "recipient_city": "city",
  "recipient_country": "NL",
  "recipient_phone": "123456789",
  "return_parcel": "both",
  "weight": 1.5
}

Response body

{
  "reference_number": "package#1",
  "tracking_code": "3SABCD0000280",
  "outbound": {
    "label_url": "https://api.sevensenders.com/v2/label-download/816413",
    "shipment_id": "60206543",
    "tracking_code": "3SABCD0000846",
    "print_format": "A6",
    "mime_type": "application/pdf"
  },
  "return": {
    "label_url": "https://api.sevensenders.com/v2/label-download/816414",
    "shipment_id": "60206544",
    "tracking_code": "3SABCD0000280",
    "print_format": "A6",
    "mime_type": "application/pdf"
  }
}

Step 3: Create a label for package #2

Differences to step 2 - other values for following fields: 

  • reference_number
  • weight

Request body

{
  "format": "pdf",
  "reference_number": "package#2",
  "sender_first_name": "First name",
  "sender_last_name": "Name",
  "sender_company_name": "Company",
  "sender_street": "Street",
  "sender_house_no": "1",
  "sender_zip": "12345",
  "sender_city": "City",
  "sender_country": "NL",
  "sender_phone": "123456789",
  "sender_email": "mail@mail.de",
  "cod": false,
  "order_id": "0003456",
  "carrier": {
    "name": "postnl",
    "country": "NL"
  },
  "carrier_service": "standard",
  "recipient_first_name": "First name",
  "recipient_last_name": "Name",
  "recipient_company_name": "Company",
  "recipient_email": "mail@mail.nl",
  "recipient_street": "street",
  "recipient_house_no": "2",
  "recipient_zip": "12345",
  "recipient_city": "city",
  "recipient_country": "NL",
  "recipient_phone": "123456789",
  "return_parcel": "both",
  "weight": 0.8
}

Response body

{
  "reference_number": "package#2",
  "tracking_code": "3SABCD0000281",
  "outbound": {
    "label_url": "https://api.sevensenders.com/v2/label-download/816416",
    "shipment_id": "60206761",
    "tracking_code": "3SABCD0000847",
    "print_format": "A6",
    "mime_type": "application/pdf"
  },
  "return": {
    "label_url": "https://api.sevensenders.com/v2/label-download/816417",
    "shipment_id": "60206763",
    "tracking_code": "3SABCD0000281",
    "print_format": "A6",
    "mime_type": "application/pdf"
  }
}

Step 4: Download labels

API end-point: GET /label-download/[id] 

Label #1

Label #2



Did you find it helpful? Yes No