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:
- 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_2222",
"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": "[email protected]",
"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": "[email protected]",
"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_2222",
"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_3333",
"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": "[email protected]",
"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": "[email protected]",
"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_3333",
"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
