Integration Options

Different Use cases favor different integration models. That is why Bettermile offers two integration options, each with some different variants to meet your requirements perfectly.

PreETA for the bulk of parcels (with parcel id)

For all use cases that require a full set of PreETA information for many or all parcels in your system, we recommend using Bettermile Data Gateway to send us the necessary parcel job data in bulk. We will push the PreETA information back to you via an asynchronous webhook approach.

We commend the use of your data connector if you want to receive PreETA information for a large number of parcels, and especially if you have built the connector already. By sending Pre-Advise (earliest information of shipments) data including the estimated day of delivery to Data Gateway, all but one use case is covered. The only use case not covered is the promotional messaging in the checkout of webshops, since this parcel/parcel id does not exist yet. Please check the section for PreETA for a single parcel below.

PreETA queries for single parcels or addresses (Synchronous)

If you would like to request PreETA for single parcels or even single addresses, you can also use our synchronous integration flow. This supports the use case of promotional messaging in the checkout of webshops.

In the synchronous integration, you need to send the request to our REST API. You need to request the PreETA information via a single call that specifies an address or geolocation along with the estimated date of delivery. We will respond with the respective ETA time window.

Synchronous Flow:

• Call the PreETA API with the address + estimated date
• Receive the ETA window immediately

Schematic Overview of PreETA and the Synchronous Integration