developer

E-commerce

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