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.
FeatureSuggested web store implementation
Selection of a shipping methodDisplay minimum 2 available shipping methods and support manual selection of a shipping method
Shipping method titlesDisplay shipping method titles defined in the response from Bring Shipping Guide API or the overridden titles
Sort order of shipping methodsDisplay shipping methods in the exact order defined in the response from Bring Shipping Guide API or in an overridden order
Shipping method languageProvide 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 logoDisplay Posten / Bring logo with the shipping methods in accordance with guidelines by Posten/Bring
Order weightInclude total weight of order in grams in Bring Shipping Guide API queries
Order dimensions or volumeInclude dimensions or volume of order in Bring Shipping Guide API queries
Adjust Bring Shipping Guide API prices Display adjusted prices
Rounding of pricesDisplay rounded prices for shipping methods
Relative priceDisplay additional service charges separately at selection. Shipping method prices are relative to the currently selected shipping method's price
Coupon code for discounted or free shipmentDisplay input field for coupon code and adjust prices according to the code
Support free shipment based on criteriaAdjust price if some criteria are met
Hide shipping method(s) based on total priceHide shipping method(s) if the total price of items exceeds given max price
eVarslingInclude eVarsling data when requesting shipping methods from Bring Shipping Guide API
Parcel delivered at post officeInclude whether a parcel is delivered at the post office or not when quering Bring Shipping Guide API for prices
Support item dimensionsInclude 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.
FeatureSuggested web store implementation
Selection of a delivery pointDisplay available delivery points and support manual selection of a delivery point
Selection of a delivery point on a mapDisplay available delivery points on a map and support manual selection of a delivery point
Address/postal code for pickup point queriesEnsure address specifications in pickup point queries (country code and postal and/or address)

Booking details Booking API

FeatureSuggested web store implementation
Delivery optionCustomer can choose delivery option and price is updated accordingly
Message for recipientSupport free text information for receiver in transport booking
Instructions for driverSupport free text instructions for the driver
Cash on deliverySupport 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 weightInclude total weight of order in grams when creating a booking through Bring Booking API
Order dimensions or volumeInclude dimensions or volume when creating a booking through Bring Booking API
Tracking linkDisplay a shipment tracking link returned by the Bring Booking API for the customer on the order confirmation (page and/or email)
Expected delivery timeDisplay 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.
FeatureSuggested web store implementation
Label listSupport handling of label URLs returned by the Bring Booking API for local printing

Tracking Tracking API

FeatureSuggested web store implementation
Manual trackingEnable manual tracking for the customer by displaying a search field

Configuration  Booking API  Shipping Guide API

FeatureSuggested web store implementation
Configurable API keyMake API key configurable and include it in the requests to Shipping Guide API and Booking API to enable agreement prices, prices for additional services, lead time and coverage
Limit receiver countriesLimit countries available for shipments (receiver country)
Supported sender countriesSender 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.
FeatureSuggested web store implementation
Shipping Guide errorsLog 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 errorsLog error data and prevent display of error message to end users.
Tracking errorsLog error data and prevent display of error message to end users.
Verify postal codeVerify receiver's postal code by using Postal Code API