Adresregels en waarschuwingen

Bijgewerkt 16 oktober 2026 · 2 min lezen

Elk poststuk wordt gecontroleerd zodra het binnenkomt, of het nu uit een Postflow, een Postbatch of de API komt. Door een probleem weigert PostBuddy een poststuk nooit. Het poststuk krijgt in plaats daarvan de status Aandacht nodig met een waarschuwing, zodat je het kunt herstellen.

Hoe adressen worden opgeschoond

PostBuddy maakt elk adres netjes voordat het wordt gecontroleerd. Extra spaties worden verwijderd, straat- en plaatsnamen krijgen hoofdletters en een Nederlandse postcode wordt geschreven als 1234 AB. Het huisnummer en de toevoeging worden uit adresregel 1 gehaald, bijvoorbeeld "Dorpsstraat 12 A". Een leeg land betekent Nederland, en namen zoals Nederland, Belgium of Deutschland worden herkend.

De adresregels

RegelDetails
NaamDe naam van de ontvanger mag niet leeg zijn.
Adresregel 1Moet een straat en een huisnummer bevatten.
PostcodeNederland: vier cijfers (niet beginnend met 0) en twee letters. België: vier cijfers. Duitsland: vijf cijfers.
PlaatsMag niet leeg zijn.
LandMoet een land zijn dat PostBuddy ondersteunt, en waar het product naartoe bezorgt.

Waarschuwingscodes die drukken tegenhouden

CodeWat je oplost
address_invalidAdresregel 1 of de naam is leeg.
house_number_missingVoeg het huisnummer toe aan adresregel 1.
postal_code_invalidVerbeter de postcode voor het land.
city_missingVul de plaats in.
country_not_supportedHet land wordt niet ondersteund. Controleer de landcode.
destination_not_supportedHet product bezorgt niet in dit land.
variable_missingVul het verplichte templateveld in.
variable_type_invalidDe waarde heeft het verkeerde type, bijvoorbeeld tekst in een getalveld of een webadres zonder https://.
variable_too_longMaak de waarde korter, tot de maximale lengte.

Waarschuwingen die niet tegenhouden

CodeWat het betekent
late_delivery_expectedDe kaart kan niet op de verzenddatum aankomen en gaat mee met de volgende run.
waiting_for_fundsDe kaart wacht tot je saldo of krediet hem dekt; waardeer op om hem te versturen.
suppressedHet adres staat op je onderdrukkingslijst.

Tijdens de productie rendert PostBuddy elke kaart. Blijkt een kaart tekst te hebben die buiten het kader loopt (text_overflow), een afbeelding die niet kan worden geladen (image_fetch_failed) of een te lage resolutie (image_resolution_low)? Dan wordt de kaart uit de run gehaald, wordt de afschrijving teruggeboekt en krijgt het poststuk weer Aandacht nodig.

Wil je poststukken herstellen? Zie Poststukken herstellen die aandacht nodig hebben.

Kom je er niet uit?

Vertel ons wat je hebt geprobeerd en, als dat kan, om welk poststuk of welke Postbatch het gaat.

Neem contact op