Levenscyclus
Elke zending heeft een numerieke status. De belangrijkste groepen zijn:
1pending, concept: aangemaakt, nog geen label.2pending, geregistreerd: het label is aangemaakt.3tot en met6onderweg: overgedragen aan de vervoerder, sortering, distributie, douane.7tot en met11bezorgd: bij de ontvanger, klaar om af te halen, afgehaald, of het retour-equivalent daarvan.12en14geprint: een brief of digitale postzegel.30tot en met38inactief: dezelfde fasen voor zendingen die niet meer actief zijn.
Abonneer je op de shipment_status_change-webhook om wijzigingen te horen in plaats van te pollen.
Een zending aanmaken
Doe een POST naar /shipments met het vendor-contenttype. De body verpakt een array van zendingen in een data-object, zodat je er meerdere in één call kunt aanmaken.
POST https://api.myparcel.nl/shipments
Content-Type: application/vnd.shipment+json;version=1.1;charset=utf-8
Authorization: bearer <base64-gecodeerde API-key>
{
"data": {
"shipments": [
{
"carrier": 1,
"reference_identifier": "ORDER-2026-01042",
"recipient": {
"cc": "NL",
"person": "J. de Vries",
"street": "Antareslaan",
"number": "31",
"postal_code": "2132JE",
"city": "Hoofddorp"
},
"options": {
"package_type": 1,
"signature": 1
}
}
]
}
}
carrier, recipient en options.package_type zijn verplicht. Vervoerders en pakkettypes zijn numerieke ID's, en opties zoals signature krijgen 0 of 1. Zie Datatypes.
De response bevat de ID's van de nieuwe zendingen, in de volgorde waarin je ze stuurde:
{
"data": {
"ids": [
{ "id": 123456, "reference_identifier": "ORDER-2026-01042" }
]
}
}
Labels
Haal labels op met GET /shipment_labels/{ids}. Scheid meerdere ID's met ; om ze in één PDF te krijgen. De parameter format kiest A4 of A6, en op A4 bepaalt positions waar de eerste labels komen (1 tot en met 4).
Vraag bij grote batches het label asynchroon op met Accept: application/vnd.shipment_label_link+json. Je krijgt dan een link die de PDF teruggeeft zodra hij klaar is, of je luistert naar de shipment_label_created-webhook.
Zie GET /shipment_labels/{ids} →
Verwijderen
Je kunt een zending alleen verwijderen zolang hij een concept is, dus voordat er een label is aangemaakt. Verwijderen is zelden nodig: zendingen die nooit aan de vervoerder worden overgedragen, worden niet gefactureerd.