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
| 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 it's 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 |