Address rules and warnings
Every item is checked when it arrives, whether it comes from a Postflow, a Postbatch or the API. A problem never makes PostBuddy refuse the item. Instead, the item gets the status Needs attention with a warning, so you can repair it.
How addresses are cleaned up
PostBuddy tidies every address before checking it. Extra spaces are removed, street and city names get capitals, and a Dutch postal code is written as 1234 AB. The house number and its addition are read from address line 1, for example "Dorpsstraat 12 A". An empty country means the Netherlands, and names such as Nederland, Belgium or Deutschland are recognised.
The address rules
| Rule | Details |
|---|---|
| Name | The recipient name may not be empty. |
| Address line 1 | Must contain a street and a house number. |
| Postal code | Netherlands: four digits (not starting with 0) and two letters. Belgium: four digits. Germany: five digits. |
| City | May not be empty. |
| Country | Must be a country PostBuddy supports, and one the product delivers to. |
Warning codes that block printing
| Code | What to fix |
|---|---|
address_invalid | Address line 1 or the name is empty. |
house_number_missing | Add the house number to address line 1. |
postal_code_invalid | Correct the postal code for the country. |
city_missing | Fill in the city. |
country_not_supported | The country is not supported. Check the country code. |
destination_not_supported | The product does not deliver to this country. |
variable_missing | Fill in the required template field. |
variable_type_invalid | The value has the wrong type, for example text in a number field or a web address without https://. |
variable_too_long | Shorten the value to the maximum length. |
Warnings that do not block
| Code | What it means |
|---|---|
late_delivery_expected | The card cannot arrive by its send date and goes with the next run. |
waiting_for_funds | The card waits until your balance or credit covers it; top up to send it. |
suppressed | The address is on your suppression list. |
During production, PostBuddy renders every card. If a card turns out to have overflowing text (text_overflow), an image that cannot be loaded (image_fetch_failed) or too low a resolution (image_resolution_low), it is taken out of the run, its charge is refunded and it gets Needs attention again.
To repair items, see Fix items that need attention.
Open a support ticket in the portal. Tell us what you tried and, if you can, which item or Postbatch it is about.