You can now access extended lead time (ETA) information for a range of Norwegian and cross-border parcel and cargo services. This gives your customers a better understanding of when to expect their deliveries.
Note: setting the actual shipping date in the Shipping Guide request is a prerequisite for getting the correct estimate back from the machine learning model, as the leadtime is always calculated from the day and time the parcel arrives at a Bring terminal. It is recommended to read this guide for a better understanding of how the provided shipping date affects the returned lead time. In absence for a shipping date set by the user, the Shipping Guide API will default to “now”.
For the above mentioned services, you can now get extended leadtime information - the estimated arrival time.
Earlier, we have just returned the expected delivery date when you request our Shipping Guide API to get leadtime. Now, based on a machine learning model gathering scanning data from deliveries made in Norway, we are also predicting the arrival window - i.e. when the shipment is expected to arrive at the recipient address. If you are already presenting expected delivery date in your checkout, we strongly recommend that you consider increasing the value by also including the predicted arrival window.
The estimated arrival window is returned automatically as long as the WithExpectedDelivery flag is set to true. If we for some reason are unable to predict the arrival window, the expected delivery date will still be returned.
The arrival window is returned as time slots in the API response:
<ns2:ExpectedDelivery>
<ns2:WorkingDays>1</ns2:WorkingDays>
<ns2:UserMessage/>
<ns2:FormattedExpectedDeliveryDate>29.01.2021</ns2:FormattedExpectedDeliveryDate>
<ns2:ExpectedDeliveryDate>
<ns2:Year>2021</ns2:Year>
<ns2:Month>1</ns2:Month>
<ns2:Day>29</ns2:Day>
<ns2:TimeSlots>
<ns2:TimeSlot>
<ns2:StartTime>
<ns2:Hour>9</ns2:Hour>
<ns2:Minute>0</ns2:Minute>
</ns2:StartTime>
<ns2:EndTime>
<ns2:Hour>13</ns2:Hour>
<ns2:Minute>0</ns2:Minute>
</ns2:EndTime>
</ns2:TimeSlot>
</ns2:TimeSlots>
</ns2:ExpectedDeliveryDate>
<ns2:AlternativeDeliveryDates/>
</ns2:ExpectedDelivery>
We recommend to insert the start (X) and end (Y) time values together with the expected delivery date, we recommend the following implementation:
Even though the API response schema supports minute granularity for start and end time, the minute value will always be set to 0. It is therefore sufficient to parse hours only.
Note that Bring cannot guarantee the arrival time for a specific parcel. The estimated arrival time indicates when, based on historical scanning data, the parcel normally will arrive at the recipient address.
For the services Servicepakke (SERVICEPAKKE) and Pakke til hentested (5800), you can now get extended leadtime information - the estimated arrival time for one or more pickup points.
Earlier, we have just returned the expected delivery date when you request our Shipping Guide API to get leadtime for SERVICEPAKKE/5800. Now, based on a machine learning model gathering scanning data from all pickup points in Norway, we are also predicting the arrival window - i.e. when the parcel is expected to arrive at a specific pickup point on that specific date. If you are already showing expected delivery date in your checkout, we strongly recomment that you consider increasing the value by also including the predicted arrival window.
To get the estimaterd arrival time for one or more pickup points, use the following new fields:
Note: along with WithEstimatedDeliveryTime, make sure ensure the flag WithExpectedDelivery is also set to true.
There are two ways of using the functionality for estimated arrival time for pickup points in our Shipping Guide API - with or without the Pickup Point API:
You specify which pickup points you want us to return estimated arrival time for by including the relevant pickup point IDs in the Shipping guide request. Based on that, we return the start and end time of the expected arrival time window for each pickup point ID you have specified in the request. For a best possible customer experience, we strongly recommend that you use the functionality in combination with the Pickup Point API. For an example on how to do this, see the example request at the bottom of this page.
In the absence of specified pickup point IDs, we take care of looking up the recipient´s default pickup point(s), based on its postal code. Based on that, we return the start and end time of the expected arrival time window for the recipient´s default pickup point(s).
In this case, we will also provide the name of the default pickup point(s). To use the API this way, just omit the PickupPoints/pickuppoints element from the example at the page bottom. Please note that in some cases, the recipient´s postal code may have several default pickup points.
For arrival times at pickup points, the ExpectedDelivery response element normally used for lead time information is not returned. In stead a list of EstimatedDeliveryTimes is available:
<ns2:EstimatedDeliveryTimes>
<ns2:EstimatedDeliveryTime>
<ns2:PickupPointId>121532</ns2:PickupPointId>
<ns2:PickupPointName>Extra Vestby</ns2:PickupPointName>
<ns2:DeliveryStartTime>13:00</ns2:DeliveryStartTime>
<ns2:DeliveryEndTime>16:00</ns2:DeliveryEndTime>
<ns2:FormattedExpectedDeliveryDate>05.01.2022</ns2:FormattedExpectedDeliveryDate>
<ns2:ShippingDate>04.01.2022</ns2:ShippingDate>
<ns2:WorkingDays>1</ns2:WorkingDays>
</ns2:EstimatedDeliveryTime>
<ns2:EstimatedDeliveryTime>
<ns2:PickupPointId>121532</ns2:PickupPointId>
<ns2:PickupPointName>Extra Vestby</ns2:PickupPointName>
<ns2:DeliveryStartTime>13:00</ns2:DeliveryStartTime>
<ns2:DeliveryEndTime>16:00</ns2:DeliveryEndTime>
<ns2:FormattedExpectedDeliveryDate>06.01.2022</ns2:FormattedExpectedDeliveryDate>
<ns2:ShippingDate>05.01.2022</ns2:ShippingDate>
<ns2:WorkingDays>1</ns2:WorkingDays>
</ns2:EstimatedDeliveryTime>
</ns2:EstimatedDeliveryTimes>
Each item in the list represents an expected delivery time at a specific pickup point. If multiple pickup points are specified in the request, a delivery time for each pickup point is available in the list. If combined with the NumberOfAlternativeDeliveryDates request parameter, the list will contain the requested number of delivery dates for each requested pickup point.
NOTE: The delivery time might be different for each returned delivery date.
We recommend to insert the start (X) and end (Y) time values into the following sentence:
Together with the expected delivery date, we recommend the following implementation:
Note that Bring cannot guarantee the arrival time for a specific parcel. The estimated arrival time indicates when, based on historical scanning data, the parcel normally will become available for pickup at a specific pickup point on that specific date.