PreETA supports two integration models: bulk (recommended for almost all use cases) and synchronous (only for promotional messaging in webshop checkout).
Send parcel data in bulk via the Bettermile Data Gateway. PreETA results are returned through an asynchronous webhook. This covers all use cases except promotional messaging at checkout, where no parcel ID exists yet.
For checkout messaging, query PreETA for a single parcel or address via a REST API call.
- Input: Parcel Number + address + estimated delivery date (optional, if not provided, we send the preETA for the next up to 7 days)
- Output: Predictive delivery window (e.g., 9:00:00–11:00:00), returned immediately
- If for a date, we don't have any data, we respond with Status 404 and message
No PreETA available - If no date is provided in the request
- We return a list of PreETA for the next 7 days
- If in the list, one day is missing, that means we have no data available
- If for a date, we don't have any data, we respond with Status 404 and message
