Multicollo

You can create multiple parcels at one time, and announce all of them together in one shipment. This is referred to as multicollo.

What is multicollo?

In certain situations, you may wish to combine multiple parcels into one shipment so that they stay together during the delivery journey. Provided that all the parcels are shipping to the same sender address, have the same weight, and that you choose a carrier and method which supports multicollo, you can use this endpoint to announce all of the parcels at the same time.

Some restrictions apply to multicollo shipments. See our Help Center for more information.

Supporting carriers

Not every carrier supports multicollo. You can find a list of supporting carriers on our Help Center.

You can retrieve a list of shipping methods which support multicollo by making a GET request to the (link to repository) Shipping products endpoint, and include the paramater multicollo: true.

Note: Multicollo is not supported for shipping international parcels where customs documentation is required.

How to create multicollo shipments

To create a multicollo, include the number of parcels you wish to ship in the quantity field under the parcel object, and make a POST request to the (link to respository) Create multiple parcels endpoint. The maximum number of parcels you can create under quantity is 20.

  • If the value of request_label is true, then the parcels will be announced together, and the response will include the URL to download each individual shipping label.
  • If the value of request_label is false, the parcel object will be created with a quantity matching the value you specified in your request. The parcel will appear in the Incoming order overview of the Sendcloud panel with the status “Ready to process”. When the parcel is processed, the correct number of shipping labels will be created.

Example request

POST https://panel.sendcloud.sc/api/v2/parcels

 1curl --location -g --request POST 'https://panel.sendcloud.sc/api/v2/parcels' \
 2--header 'Authorization: Basic <credentials>' \
 3--data-raw '
 4{
 5   "parcels": [
 6   	{
 7   		"name": "John Doe",
 8   		"company_name": "Sendcloud",
 9   		"address": "Insulindelaan",
10   		"house_number": "115",
11   		"city": "Eindhoven",
12   		"postal_code": "5642CV",
13   		"telephone": "+31612345678",
14   		"email": "john@doe.com",
15   		"data": [],
16   		"country": "NL",
17   		"shipment": {
18   			"id": 4203
19   		},
20   		"weight": "10.000",
21   		"order_number": "1",
22   		"insured_value": 0,
23   		"total_order_value": "11.11",
24   		"total_order_value_currency": "EUR",
25   		"quantity": 3,
26   		"request_label": true
27   	}
28   ]
29}'

Example response

  1{
  2	"parcels": [
  3		{
  4			"id": 1,
  5			"address": "Insulindelaan 115",
  6			"address_2": "",
  7			"address_divided": {
  8				"street": "Insulindelaan",
  9				"house_number": "115"
 10			},
 11			"city": "Eindhoven",
 12			"company_name": "Sendcloud",
 13			"country": {
 14				"iso_2": "NL",
 15				"iso_3": "NLD",
 16				"name": "Netherlands"
 17			},
 18			"data": {},
 19			"date_created": "22-06-2022 12:27:59",
 20			"date_announced": "22-06-2022 12:28:00",
 21			"date_updated": "22-06-2022 12:28:00",
 22			"email": "john@doe.com",
 23			"name": "John Doe",
 24			"postal_code": "5642 CV",
 25			"reference": "0",
 26			"shipment": {
 27				"id": 4203,
 28				"name": "DPD Classic 0-31.5kg + Agecheck 18"
 29			},
 30			"status": {
 31				"id": 1000,
 32				"message": "Ready to send"
 33			},
 34			"to_service_point": null,
 35			"telephone": "+31612345678",
 36			"tracking_number": "05222728167396",
 37			"weight": "10.000",
 38			"label": {
 39				"normal_printer": [
 40					"https://panel.sendcloud.sc/api/v2/labels/normal_printer/1?start_from=0",
 41					"https://panel.sendcloud.sc/api/v2/labels/normal_printer/1?start_from=1",
 42					"https://panel.sendcloud.sc/api/v2/labels/normal_printer/1?start_from=2",
 43					"https://panel.sendcloud.sc/api/v2/labels/normal_printer/1?start_from=3"
 44				],
 45				"label_printer": "https://panel.sendcloud.sc/api/v2/labels/label_printer/1"
 46			},
 47			"customs_declaration": {},
 48			"order_number": "1",
 49			"insured_value": 0,
 50			"total_insured_value": 520,
 51			"to_state": null,
 52			"customs_invoice_nr": "",
 53			"customs_shipment_type": null,
 54			"parcel_items": [],
 55			"documents": [
 56				{
 57					"type": "label",
 58					"size": "a6",
 59					"link": "https://panel.sendcloud.sc/api/v2/parcels/1/documents/label"
 60				}
 61			],
 62			"type": "parcel",
 63			"shipment_uuid": null,
 64			"shipping_method": 4203,
 65			"external_order_id": "1",
 66			"external_shipment_id": "",
 67			"external_reference": null,
 68			"is_return": false,
 69			"note": "",
 70			"to_post_number": "",
 71			"total_order_value": "11.11",
 72			"total_order_value_currency": "EUR",
 73			"colli_tracking_number": "",
 74			"colli_uuid": "d566c214-30a5-4646-8c02-dc93a12f34bd",
 75			"collo_nr": 0,
 76			"collo_count": 3,
 77			"awb_tracking_number": null,
 78			"box_number": null,
 79			"length": null,
 80			"width": null,
 81			"height": null,
 82			"shipping_method_checkout_name": null,
 83			"carrier": {
 84				"code": "dpd"
 85			},
 86			"tracking_url": "https://sendcloudfr.shipping-portal.com/tracking/?country=nl&tracking_number=05222728167396&postal_code=5642+cv"
 87		},
 88		{
 89			"id": 1,
 90			"address": "Insulindelaan 115",
 91			"address_2": "",
 92			"address_divided": {
 93				"street": "Insulindelaan",
 94				"house_number": "115"
 95			},
 96			"city": "Eindhoven",
 97			"company_name": "Sendcloud",
 98			"country": {
 99				"iso_2": "NL",
100				"iso_3": "NLD",
101				"name": "Netherlands"
102			},
103			"data": {},
104			"date_created": "22-06-2022 12:27:59",
105			"date_announced": "22-06-2022 12:28:00",
106			"date_updated": "22-06-2022 12:28:00",
107			"email": "john@doe.com",
108			"name": "John Doe",
109			"postal_code": "5642 CV",
110			"reference": "0",
111			"shipment": {
112				"id": 4203,
113				"name": "DPD Classic 0-31.5kg + Agecheck 18"
114			},
115			"status": {
116				"id": 1000,
117				"message": "Ready to send"
118			},
119			"to_service_point": null,
120			"telephone": "+31612345678",
121			"tracking_number": "05222728167397",
122			"weight": "10.000",
123			"label": {
124				"normal_printer": [
125					"https://panel.sendcloud.sc/api/v2/labels/normal_printer/1?start_from=0",
126					"https://panel.sendcloud.sc/api/v2/labels/normal_printer/1?start_from=1",
127					"https://panel.sendcloud.sc/api/v2/labels/normal_printer/1?start_from=2",
128					"https://panel.sendcloud.sc/api/v2/labels/normal_printer/1?start_from=3"
129				],
130				"label_printer": "https://panel.sendcloud.sc/api/v2/labels/label_printer/1"
131			},
132			"customs_declaration": {},
133			"order_number": "1",
134			"insured_value": 0,
135			"total_insured_value": 520,
136			"to_state": null,
137			"customs_invoice_nr": "",
138			"customs_shipment_type": null,
139			"parcel_items": [],
140			"documents": [
141				{
142					"type": "label",
143					"size": "a6",
144					"link": "https://panel.sendcloud.sc/api/v2/parcels/1/documents/label"
145				}
146			],
147			"type": "parcel",
148			"shipment_uuid": null,
149			"shipping_method": 4203,
150			"external_order_id": "1",
151			"external_shipment_id": "",
152			"external_reference": null,
153			"is_return": false,
154			"note": "",
155			"to_post_number": "",
156			"total_order_value": "11.11",
157			"total_order_value_currency": "EUR",
158			"colli_tracking_number": "",
159			"colli_uuid": "d566c214-30a5-4646-8c02-dc93a12f34bd",
160			"collo_nr": 1,
161			"collo_count": 3,
162			"awb_tracking_number": null,
163			"box_number": null,
164			"length": null,
165			"width": null,
166			"height": null,
167			"shipping_method_checkout_name": null,
168			"carrier": {
169				"code": "dpd"
170			},
171			"tracking_url": "https://sendcloudfr.shipping-portal.com/tracking/?country=nl&tracking_number=05222728167397&postal_code=5642+cv"
172		},
173		{
174			"id": 1,
175			"address": "Insulindelaan 115",
176			"address_2": "",
177			"address_divided": {
178				"street": "Insulindelaan",
179				"house_number": "115"
180			},
181			"city": "Eindhoven",
182			"company_name": "Sendcloud",
183			"country": {
184				"iso_2": "NL",
185				"iso_3": "NLD",
186				"name": "Netherlands"
187			},
188			"data": {},
189			"date_created": "22-06-2022 12:27:59",
190			"date_announced": "22-06-2022 12:28:00",
191			"date_updated": "22-06-2022 12:28:01",
192			"email": "john@doe.com",
193			"name": "John Doe",
194			"postal_code": "5642 CV",
195			"reference": "0",
196			"shipment": {
197				"id": 4203,
198				"name": "DPD Classic 0-31.5kg + Agecheck 18"
199			},
200			"status": {
201				"id": 1000,
202				"message": "Ready to send"
203			},
204			"to_service_point": null,
205			"telephone": "+31612345678",
206			"tracking_number": "05222728167398",
207			"weight": "10.000",
208			"label": {
209				"normal_printer": [
210					"https://panel.sendcloud.sc/api/v2/labels/normal_printer/1?start_from=0",
211					"https://panel.sendcloud.sc/api/v2/labels/normal_printer/1?start_from=1",
212					"https://panel.sendcloud.sc/api/v2/labels/normal_printer/1?start_from=2",
213					"https://panel.sendcloud.sc/api/v2/labels/normal_printer/1?start_from=3"
214				],
215				"label_printer": "https://panel.sendcloud.sc/api/v2/labels/label_printer/1"
216			},
217			"customs_declaration": {},
218			"order_number": "1",
219			"insured_value": 0,
220			"total_insured_value": 520,
221			"to_state": null,
222			"customs_invoice_nr": "",
223			"customs_shipment_type": null,
224			"parcel_items": [],
225			"documents": [
226				{
227					"type": "label",
228					"size": "a6",
229					"link": "https://panel.sendcloud.sc/api/v2/parcels/1/documents/label"
230				}
231			],
232			"type": "parcel",
233			"shipment_uuid": null,
234			"shipping_method": 4203,
235			"external_order_id": "1",
236			"external_shipment_id": "",
237			"external_reference": null,
238			"is_return": false,
239			"note": "",
240			"to_post_number": "",
241			"total_order_value": "11.11",
242			"total_order_value_currency": "EUR",
243			"colli_tracking_number": "",
244			"colli_uuid": "d566c214-30a5-4646-8c02-dc93a12f34bd",
245			"collo_nr": 2,
246			"collo_count": 3,
247			"awb_tracking_number": null,
248			"box_number": null,
249			"length": null,
250			"width": null,
251			"height": null,
252			"shipping_method_checkout_name": null,
253			"carrier": {
254				"code": "dpd"
255			},
256			"tracking_url": "https://sendcloudfr.shipping-portal.com/tracking/?country=nl&tracking_number=05222728167398&postal_code=5642+cv"
257		}
258	]
259}

Multicollo labels

The shipping label will reflect the total number of parcels in the consignment, and the position of each individual parcel, e.g. Packages 1/3, 2/3, 3/3, etc. Each parcel will have a unique tracking number, but the customer will only receive one tracking email for all of the parcels in the consignment.

Labels can be printed directly from the Sendcloud panel, or you can request them via the Bulk label print endpoint by including the id of each individual parcel contained in the collo in your request.


Go to top