API

Verzenden vanuit je eigen systemen met de ParcelParcel API

Q: Kan ik testen zonder echt te boeken?

Ja. Maak een zending zonder bookShipment (of met false ): dan komt er een conceptzending in ‘API shipments’ in je account, die je kunt aanpassen of laten staan. Voor tracking kun je het testnummer 123456789 gebruiken.

Q: Moet ik kunnen programmeren?

Voor de API wel. Zonder code kan het ook: via Zapier , Shopify of je AI-assistent met de MCP-server .

Vraag tarieven op, boek zendingen, haal labels op en volg pakketten vanuit je ERP, WMS of webshop. Met de prijzen van je eigen ParcelParcel-account en de douanefactuur in dezelfde call.

Tarieven van alle vervoerders in één call
Klaarzetten of direct boeken, inclusief label
Invoerrechten en btw vooraf schatten
Webhooks bij aanmaken en boeken

Bekijk de API-documentatie →Maak een gratis account

Wat kun je ermee?

Alles wat je in MyParcelParcel doet, via de API

De API draait op https://services.parcelparcel.com/partners-api/v1. Elk antwoord heeft hetzelfde formaat: errors, message en data.

POST/rates

Tarieven vergelijkenPrijzen en levertijden van alle vervoerders voor een document, pakket of pallet, op basis van jouw account. Met of zonder verzekering.

POST/shipments

Zending klaarzetten of boekenMaak een conceptzending die je in MyParcelParcel nog kunt aanpassen, of boek direct en krijg het label terug (bookShipment).

POST/shipments/{id}/cancel

Zending annulerenAnnuleer een conceptzending of geboekte zending.

GET/shipments/{id}/labels

Labels ophalenDe verzenddocumenten als base64-string, klaar om te printen of op te slaan.

GET/track/{trackingNumber}

Zending volgenStatus en checkpoints van zendingen die via ParcelParcel zijn geboekt.

GET/shipments

Zendingen opvragenFilter je zendingen op status, vervoerder, boekdatum, land van herkomst of bestemming.

POST/duties-taxes-estimate

Invoerrechten en btw schattenSchatting van invoerrechten en btw per artikel. Zonder HS-code kiezen we de best passende code op basis van je omschrijving.

🔔Webhooks

Meldingen bij aanmaken en boekenOntvang een bericht zodra een zending is aangemaakt of geboekt met trackingnummer. Wij zetten ze voor je aan.

Aan de slag

In drie stappen je eerste call

Maak een accountRegistreer je gratis in MyParcelParcel. Je hebt geen contract of minimum nodig.

Pak je API-gegevensGa naar Mijn instellingen › API-instellingen. Daar staan je API-key en API-secret.

Doe je eerste callZet X-PP-API: key@secret in de header en vraag tarieven op. Of maak een conceptzending: die wordt niet geboekt.

Headers bij elke call

X-PP-API: {API-key}@{API-secret}
Content-Type: application/json

Voorbeelden

De API in de praktijk

Echte calls uit de documentatie, ingekort. Vervang de placeholders door je eigen gegevens.

1. Tarieven opvragen

curl -X POST 'https://services.parcelparcel.com/partners-api/v1/rates' \
  -H 'X-PP-API: {API-key}@{API-secret}' \
  -H 'Content-Type: application/json' \
  -d '{
    "parcels": [{ "type": "NONDOC", "weight": "4", "length": "40", "width": "30", "height": "20", "count": "1" }],
    "fromCountry": "NL", "fromZipcode": "1411 AW",
    "toCountry": "US", "toZipcode": "10001",
    "insured": true, "totalValue": 750
  }'
# Antwoord: per vervoerder en service de prijs van jouw account en de levertijd

2. Zending boeken met douanegegevens

POST /partners-api/v1/shipments
{
  "parcels": [{ "type": "NONDOC", "weight": "9.6", "length": "84", "width": "74", "height": "10", "count": "1" }],
  "contentItems": [{ "description": "Stainless steel valve, 2 inch", "quantity": "1",
                     "price": "690.00", "hsCode": "84818079", "country": "NL" }],
  "reasonForExport": "commercial",
  "incoterms": "DAP",
  "reference": "ORDER-1042",
  "pickupAddress": { "countryCode": "NL", "companyName": "Jouw bedrijf", ... },
  "destinationAddress": { "countryCode": "US", "companyName": "Klant Inc.", ... },
  "bookShipment": true
}

3. Antwoord: vervoerder, trackingnummer en label

{
  "message": "Your shipment has been booked",
  "data": {
    "id": 1588448,
    "status": "created_at_carrier",
    "carrier": "FedEx",
    "product": "FedEx - FedEx Economy",
    "trackingNumber": "6516516533",
    "labels": "JVBERi0xLjQK..."   # label als base64 (pdf)
  }
}

4. Invoerrechten en btw vooraf schatten

POST /partners-api/v1/duties-taxes-estimate
{
  "fromCountry": "NL", "toCountry": "GB",
  "contentItems": [{ "description": "Cylinder head for diesel engine",
                     "numberOfItems": 9, "cost": 800, "originCountry": "NL" }]
}
# Geen HS-code? Dan bepalen we de best passende code op basis van je omschrijving.
# Antwoord: invoerrechten en btw per regel, een totaal ("estimate") en de gebruikte HS-code

5. Volgen, zendingen filteren en labels ophalen

GET https://services.parcelparcel.com/partners-api/v1/track/{trackingNumber}
GET https://services.parcelparcel.com/partners-api/v1/shipments?status=created_at_carrier&carrier=DHL&bookedFrom=2026-10-01&destinationCountry=US
GET https://services.parcelparcel.com/partners-api/v1/shipments/{shipmentId}/labels

Liever klikken dan typen? Download de Postman-collectie met voorbeeldcalls voor tarieven en zendingen.

Toepassingen

Wat bouwen bedrijven met de API?

Verzenden vanuit je ERP of WMSEen order wordt een zending, met adressen, artikelen en HS-codes uit je eigen systeem. Je magazijn print alleen nog het label.Over ERP-koppelingen →

Verzendkosten in je offerte of checkoutVraag live tarieven op voor het gewicht en de bestemming van je klant en reken met de echte prijs.

Douanekosten vooraf berekenenSchat invoerrechten en btw in voordat je verstuurt. Handig als je DDP levert of je klant vooraf wilt informeren.Over invoerrechten →

Track & trace in je eigen portaalToon de status van zendingen in je klantportaal of stuur zelf updates, voor alle vervoerders op dezelfde manier.

Conceptzendingen ter controleLaat je systeem zendingen klaarzetten. Je team controleert ze in MyParcelParcel en boekt met één klik.

Rapportages en controleHaal je zendingen op per periode, vervoerder of land voor je eigen dashboards en facturatiecontrole.

Veelgestelde vragen over de API

Wat kost de ParcelParcel API?+

De API geeft de prijzen van je eigen ParcelParcel-account terug. Je betaalt voor de zendingen die je boekt; tarieven opvragen en conceptzendingen maken boekt niets.

Kan ik testen zonder echt te boeken?+

Ja. Maak een zending zonder bookShipment (of met false): dan komt er een conceptzending in ‘API shipments’ in je account, die je kunt aanpassen of laten staan. Voor tracking kun je het testnummer 123456789 gebruiken.

Hoe zit het met de douanefactuur?+

Geef per artikel een omschrijving, aantal, waarde, land van herkomst en eventueel de HS-code mee, plus de reden van export en de Incoterm (DAP of DDP). Bij een geboekte zending krijg je de verzenddocumenten terug als base64.

Welke vervoerders kan ik gebruiken?+

Dezelfde vervoerders en services die je in MyParcelParcel ziet. De tarieven-call geeft per optie een productId terug, waarmee je precies die service boekt.

Kan ik meldingen ontvangen als er iets verandert?+

Ja, met webhooks: zodra een zending is aangemaakt en zodra hij is geboekt met een trackingnummer. Neem contact op, dan zetten we ze voor je aan.

Moet ik kunnen programmeren?+

Voor de API wel. Zonder code kan het ook: via Zapier, Shopify of je AI-assistent met de MCP-server.

Integraties

Andere koppelingen

MCP ServerVergelijk tarieven, schat invoerrechten en boek zendingen vanuit Claude of ChatGPT.Meer informatie →Shopify (bèta)Je internationale Shopify-orders vergelijken, in bulk labels maken en tracking terugzetten.Meer informatie →ZapierParcelParcel koppelen aan duizenden apps, zonder te programmeren.Meer informatie →

Reviews

Wat verzenders over ons schrijven

Lees alle reviews op Trustpilot →

Verstuur je eerste zending met 10% welkomstkorting

Vergelijken kan zonder account. De welkomstkorting geldt voor zakelijke accounts en activeer je bij het afronden van je boeking.

Bereken je tarief → Gratis account aanmaken