The following sections suggests features that can benefit e-commerce
solutions, e.g. web stores, that integrates with Bring's APIs. Each section
represents a part of a suggested order process and contains a list of
suggested features for that step in the process.
Selecting a shipping method
Shipping Guide API
A shipping method is a way to fulfill delivery to customers of the goods
that they purchased. The Shipping Guide API shows your customers which
shipping methods are available; for example an express delivery, parcels
delivered to your door or perhaps a parcel that is paid on delivery.
| Feature |
Suggested web store implementation |
| Selection of a shipping method |
Display minimum 2 available shipping methods and support manual
selection of a shipping method
|
| Shipping method titles |
Display shipping method titles defined in the response from Bring
Shipping Guide API or the overridden titles
|
| Sort order of shipping methods |
Display shipping methods in the exact order defined in the response
from Bring Shipping Guide API or in an overridden order
|
| Shipping method language |
Provide Bring Shipping Guide API queries with the language displayed
to the end user to ensure that the description of the methods are in
the preferred language
|
| Estimated time of delivery |
Display estimated time of delivery for shipment methods |
| Posten / Bring logo |
Display Posten / Bring logo with the shipping methods in accordance
with guidelines by Posten/Bring
|
| Order weight |
Include total weight of order in grams in Bring Shipping Guide API
queries
|
| Order dimensions or volume |
Include dimensions or volume of order in Bring Shipping Guide API
queries
|
| Adjust Bring Shipping Guide API prices |
Display adjusted prices |
| Rounding of prices |
Display rounded prices for shipping methods |
| Relative price |
Display value added service charges separately at selection. Shipping
method prices are relative to the currently selected shipping method's
price
|
| Coupon code for discounted or free shipment |
Display input field for coupon code and adjust prices according to the
code
|
| Support free shipment based on criteria |
Adjust price if some criteria are met |
| Hide shipping method(s) based on total price |
Hide shipping method(s) if the total price of items exceeds given max
price
|
| eVarsling |
Include eVarsling data when requesting shipping methods from Bring
Shipping Guide API
|
| Parcel delivered at post office |
Include whether a parcel is delivered at the post office or not when
quering Bring Shipping Guide API for prices
|
| Support item dimensions |
Include item dimensions (if available) when quering Bring Shipping
Guide API for prices
|
Selecting a pickup point
Pickup Point API
Freedom of choice is essential when shopping online and that is also true
when it comes to choosing your favorite pickup point. The Pickup Point API
let’s your customers decide which pickup point they prefer; for example the
closest one to their work place, kindergarten or perhaps mother in law. Via
the API you can also display, in addition to the address, the opening hours
of the pickup point.
| Feature |
Suggested web store implementation |
| Selection of a delivery point |
Display available delivery points and support manual selection of a
delivery point
|
| Selection of a delivery point on a map |
Display available delivery points on a map and support manual
selection of a delivery point
|
| Address/postal code for pickup point queries |
Ensure address specifications in pickup point queries (country code
and postal and/or address)
|
Booking details
Booking API
| Feature |
Suggested web store implementation |
| Delivery option |
Customer can choose delivery option and price is updated accordingly
|
| Message for recipient |
Support free text information for receiver in transport booking |
| Instructions for driver |
Support free text instructions for the driver |
| Cash on delivery |
Support display of "Cash on delivery" as an option for supported
shipping methods
|
| Customs declaration |
Display input field for the end user or provide customs information
when performing the booking throught Bring Booking API
|
| Order weight |
Include total weight of order in grams when creating a booking through
Bring Booking API
|
| Order dimensions or volume |
Include dimensions or volume when creating a booking through Bring
Booking API
|
| Tracking link |
Display a shipment tracking link returned by the Bring Booking API for
the customer on the order confirmation (page and/or email)
|
| Expected delivery time |
Display expected delivery time on the receipt |
Label management
Booking API
The Booking API sends all necessary EDI messages and a PDF label is returned
in responses. Having a label management system makes it possible for the web
shops to print its own labels and attach it to the shipments.
| Feature |
Suggested web store implementation |
| Label list |
Support handling of label URLs returned by the Bring Booking API for
local printing
|
Tracking
Tracking API
| Feature |
Suggested web store implementation |
| Manual tracking |
Enable manual tracking for the customer by displaying a search field
|
Configuration
Booking API
Shipping Guide API
| Feature |
Suggested web store implementation |
| Configurable API key |
Make API key configurable and include it in the requests to Shipping
Guide API and Booking API to enable agreement prices, prices for value
added services, lead time and coverage
|
| Limit receiver countries |
Limit countries available for shipments (receiver country) |
| Supported sender countries |
Sender countries available for use by the Bring APIs are supported
|
Error handling and validation
Booking API
Pickup Point API
Shipping Guide API
Postal Code API
Well-written applications include error-handling code that allows them to
recover gracefully from unexpected errors. The order should still be intact,
even if the Shipping Guide returns an error or a timeout occurs.
| Feature |
Suggested web store implementation |
| Shipping Guide errors |
Log error data and prevent display of error message to end users.
Bring shipping methods should not be displayed to the customer when an
error occurs.
|
| Booking errors |
Log error data and prevent display of error message to end users.
|
| Tracking errors |
Log error data and prevent display of error message to end users.
|
| Verify postal code |
Verify receiver's postal code by using
Postal Code API
|