Identifiers
Zendingen en webhook-abonnementen hebben integer-ID's. Orders gebruiken UUID's, zoals db610547-7434-4f6d-9e13-178b686a94d6.
Prijzen
Een prijs is een object met een bedrag in centen en een valuta. Alleen EUR wordt ondersteund.
{ "insurance": { "amount": 25000, "currency": "EUR" } } // €250,00
Booleans
Zendingopties zijn integer-booleans: 1 voor aan, 0 voor uit.
{ "options": { "signature": 1, "only_recipient": 0 } }
Datum en tijd
- Datums:
YYYY-MM-DD, bijvoorbeeld2026-04-20. - Timestamps:
YYYY-MM-DD HH:MM:SS, bijvoorbeeld2026-04-20 08:12:34.
Landcodes
Landen zijn ISO 3166-1 alpha-2-codes (NL, BE, DE, FR, …) in het veld cc.
Vervoerder-ID's
1: PostNL2: bpost3: Cheap Cargo4: DPD9: DHL For You10: DHL Parcel Connect11: DHL Europlus12: UPS Standard13: UPS Express Saver14: GLS15: BRT16: Trunkrs17: InPost18: Poste Italiane
ID's 5 tot en met 8 (Instabox, DHL Cheap Cargo, bol en de oude UPS) zijn verouderd. Welke vervoerders je kunt gebruiken, hangt af van je platform en contracten.
Pakkettypes
1: pakket2: brievenbuspakje3: brief4: digitale postzegel5: pallet6: klein pakket7: envelop
Errorformaat
Een error-response bevat een melding, een request-ID en een lijst errors met numerieke codes:
{
"message": "…",
"request_id": "…",
"errors": [
{ "code": 3501, "message": "Invalid address" }
]
}
Handel errors af op de code, niet op de tekst van de melding.