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.
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 Shipping products endpoint, and include the paramater multicollo: true.
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 Create multiple parcels endpoint. The maximum number of parcels you can create under quantity is 20.
- If the value of
request_labelistrue, 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_labelisfalse, 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.
