Overzicht
MyParcel is het toonaangevende Nederlandse pakketbezorgplatform dat kleine en middelgrote e-commercebedrijven en logistieke operaties toegang biedt tot PostNL binnenlandse en internationale bezorgdiensten via een uniforme API en dashboard. Voor Nederlandse e-commerceoperaties die via PostNL verzenden — de dominante pakketvervoerder in Nederland — staat MyParcel tussen het bedrijf en PostNL's infrastructuur, en biedt labelgeneratie, track en trace, retourbeheer en de operationele tooling die hoog-volume verzenden vereist zonder een directe PostNL-contract te vereisen.
De MyParcel API biedt programmatische toegang tot het volledige bereik van MyParcel's verzendmogelijkheden. Zendingen aanmaken en verzendlabels genereren voor Nederlandse binnenlandse leveringen, internationale zendingen naar Europese en wereldwijde bestemmingen, brievenbuspakketten en digitale postzegels.
Wij bouwen MyParcel-integraties voor Nederlandse e-commercebedrijven, fulfilmentoperaties en multi-channel retailers die hun orderbeheer-, magazijnbeheer- en operationele systemen moeten verbinden met MyParcel voor geautomatiseerde verzendlabelgeneratie en zendingstracking.
Wat MyParcel Integratie Dekt
Authenticatie en API-toegang. De MyParcel API gebruikt API-sleutelauthenticatie.
API-sleutel: de MyParcel API-sleutel gegenereerd in de MyParcel-accountinstellingen. De Authorization: bearer {base64_gecodeerde_api_sleutel} header opgenomen in elk API-verzoek. De API-sleutel base64-gecodeerd en doorgegeven als bearer-token.
Zendingen aanmaken. De kern MyParcel API-operatie — het aanmaken van zendingsrecords die verzendlabels genereren.
Zending aanmaken: het POST /shipments eindpunt voor het aanmaken van één of meer zendingen in een enkel verzoek. De verzoekbody met de shipments array die één zendingsobject bevat per te genereren label.
Zendingsobject: de zendingsgegevensstructuur met carrier (de vervoerder-ID — 1 voor PostNL, 2 voor bpost, 4 voor DPD), options (de bezorgopties), recipient (het afleveradres) en reference_identifier (de eigen orderreferentie van de integratie).
Ontvanger adres: het recipient object met cc (tweeletter landcode), city, street (straatnaam), number (huisnummer), number_suffix (huisnummertoevoeging), postal_code, person, company, email en phone. Het Nederlandse adresformaat dat straatnaam scheidt van huisnummer.
Bezorgopties. De zendingsopties die bezorggedrag configureren.
Pakkettype: het package_type veld in het optiesobject — 1 voor pakket, 2 voor brievenbuspakje, 3 voor brief, 4 voor digitale postzegel.
Standaard pakketopties: de opties voor standaard PostNL pakketbezorging — only_recipient (1 om bezorging alleen bij de ontvanger te vereisen), signature (1 om handtekening van de ontvanger bij bezorging te vereisen), return (1 om automatisch retour in te schakelen als bezorging mislukt).
Verzekering: het insurance object met amount (de verzekerde waarde in centen) en currency (EUR).
Avondbezorging: de evening_delivery optie voor PostNL avondbezorgservice. Leeftijdscontrole: de age_check optie voor zendingen die leeftijdsverificatie van de ontvanger bij bezorging vereisen.
Zendingsrespons en labelophalen. De zendingsaanmaakrespons verwerken en de gegenereerde labels ophalen.
Zending-ID's: de zendingsaanmaakrespons bevat de ids array met de MyParcel zending-ID voor elke aangemaakte zending.
Label downloaden: het GET /shipment_labels/{shipment_ids} eindpunt voor het downloaden van gegenereerde labels als PDF. De format queryparameter — A4 voor standaard A4 labelvellenvel (vier labels per pagina), A6 voor individueel A6 labelformaat.
Labelformaatopties: de positions parameter voor A4-formaat die specificeert welke labelposities op het vel te gebruiken.
Tracking en zendingsstatus. Zendingsstatus monitoren via de bezorglevenscyclus.
Zendingsstatus ophalen: het GET /shipments/{ids} eindpunt voor het ophalen van huidige zendingsdata inclusief status. De zendingsstatus codes — 1 (in behandeling, nog niet geregistreerd), 2 (in behandeling, geregistreerd), 3 (onderweg, gesorteerd), 4 (bezorgd), 5 (retourzending), 7 (uitzondering — bezorgprobleem).
Track en trace code: het barcode veld in het zendingsobject — de PostNL track en trace-barcode. De PostNL track en trace-URL: https://postnl.nl/tracktrace/?B={barcode}&P={postal_code}&D={country_code}&T=C.
Webhooks — realtime statusnotificaties. MyParcel webhooks voor het ontvangen van zendingsstatuswijzigingen zonder pollen.
Webhook configuratie: het MyParcel webhookabonnement aangemaakt via het POST /webhook_subscriptions eindpunt. Het abonnement met de hook (het eventtype — shipment_status_change, shipment_label_created) en de url.
Webhook payload: de webhook POST payload met het data object dat de zending-ID's en de nieuwe status bevat.
Webhook beveiliging: de X-MyParcel-Hook-Hmac-SHA256-Signature header — de HMAC-SHA256 handtekening berekend van de webhookpayload met de API-sleutel van de account als ondertekeningssleutel.
Retourzendingen. Retouretiket ten beheren voor klanten die pakketten retourneren.
Retourzending aanmaken: het POST /return_shipments eindpunt voor het aanmaken van retouretiket ten. De retourzending met het ontvangeradres (het magazijnadres) en de afzendergegevens.
Retourlabel levering: het retourlabel geleverd aan het e-mailadres van de klant.
Bezorgopties voor adressen. Beschikbare bezorgopties opvragen voor specifieke ontvangeradressen.
Bezorgopties: het GET /delivery_options eindpunt voor het ophalen van de beschikbare bezorgopties voor een specifiek afleveradres — de postcode en huisnummer opzoeking die beschikbare leveringstijdslots, afhaalpunten en bezorgtypeopties retourneert.
Afhaalpunten: de beschikbare PostNL-afhaalpuntlocaties voor een specifiek postcodegebied.
Multi-vervoerder ondersteuning. MyParcel ondersteunt vervoerders naast PostNL.
Vervoerder selectie: het carrier veld in het zendingsobject dat selecteert tussen PostNL, bpost, DPD en andere ondersteunde vervoerders.
Adresvalidatie. Nederlandse adressen valideren voor zendingsaanmaak.
Adrescontrole: het GET /address eindpunt voor het valideren van Nederlandse adressen op postcode en huisnummer.
Integratiepatronen
Orderbeheersysteem integratie. Het meest voorkomende MyParcel-integratiepatroon — het orderbeheersysteem dat MyParcel-zendingen aanmaakt wanneer orders de gereed-om-te-verzenden-status bereiken.
Magazijnbeheersysteem integratie. Het WMS dat labelaanmaak triggert wanneer een pick-en-pack-operatie is voltooid.
E-commerceplatform integratie. Het Magento-, WooCommerce- of maatwerk e-commerceplatform dat MyParcel integreert voor verzenden bij het afrekenen en na de bestelling.
Batchverwerking. De einde-van-dag batchTaak die alle MyParcel-zendingen voor de bestellingen van de dag tegelijkertijd aanmaakt.
Gebruikte Technologieën
- C# / ASP.NET Core — primaire MyParcel integratie implementatie .NET HTTP-client met JSON-serialisatie gebruikend
- PHP / Laravel — MyParcel-integratie voor PHP-gebaseerde e-commerceplatforms de
myparcelnl/sdkPHP-bibliotheek gebruikend - TypeScript / Node.js — MyParcel-integratie voor Node.js-gebaseerde orderbeheer- en e-commercesystemen
- Python — MyParcel-integratie voor Python-gebaseerde operationele tools en fulfilmentsystemen
- Rust / Axum — hoge-prestatie MyParcel labelgeneratie voor hoog-volume verzendoperaties
- REST / HTTP — MyParcel API-communicatie
- Webhooks — realtime zendingsstatus levering
- SQL (PostgreSQL / MySQL) — zendingsrecords, trackingdata, order-naar-zending mapping
- Redis — webhookdeduplicatie, labelcaching, statustracking
- Hangfire / geplande taken — batch zendingsaanmaak, statuspollen voor accounts zonder webhooks
- ZPL / PDF afdrukken — labelprinten naar thermische labelprinters en standaard printers
- Docker — gecontaineriseerde integratiedienst implementatie
- GitHub Actions — CI/CD pijplijn voor integratiedienst implementatie
MyParcel in de Nederlandse E-commerce Context
MyParcel bezet een specifieke en waardevolle niche in het Nederlandse e-commerceecosysteem — de API-toegankelijke gateway naar het binnenlandse bezorgnetwerk van PostNL die geen volumeverplichtingen en commerciële complexiteit van een direct PostNL-contract vereist.
De labelgeneratie-automatisering die MyParcel-integratie mogelijk maakt — het elimineren van handmatige labelaanmaak, het verminderen van adresinvoerfouten, het automatiseren van track en trace-communicatie naar klanten — heeft een directe impact op operationele efficiëntie bij verzendvolumes waar handmatige labelaanmaak een knelpunt wordt.
Geautomatiseerde Verzendlabels en Tracking voor Nederlandse E-commerce
MyParcel-integraties gebouwd op productiestandaarden — correct adresopmaak met gesplitste straat en huisnummer, batch labelaanmaak voor hoog-volume operaties, webhook-gebaseerde statusmonitoring met HMAC handtekeningvalidatie, retourzendingsbeheer en de operationele betrouwbaarheid waarop verzendoperaties vertrouwen voor dagelijkse fulfilment.