Web Services Standards

 Please note: BIC Web Services have now been replaced by BIC Realtime
 BIC Realtime APIs should be used for all new implementations going forwards. 
 Find out more about BIC Realtime APIs by clicking here

 
Specifications ready for full implementation

 

Price and Availability Request and Response Web Service

The formats have been designed to handle the supply of price and availability information as a value-added service offered by wholesalers and distributors. The typical user of this service will generally be a bookseller, but occasionally a wholesaler referring a bookseller’s enquiry on to the distributor.

New version 1.2 (April 2009), revised July 2011 to incorporate consumer-direct fulfilment (CDF) functionality

Price and Availability Request and Response Web Service specification

Implemented by Bertrams

For more information about the Bertrams implementations, go to http://www.bertrams.com/api.



Order Request and Response Web Service

This service enables the use of web services for the placing of orders by retailers (or possibly, in the case of smaller retailers, their agents) with wholesalers or distributors, or possibly the placing of orders by wholesalers with distributors, where this complements existing paper-based and electronic ordering methods. Using this service, the buyer can receive an immediate response to the order and not simply a technical acknowledgement of receipt.

Order Request and Response Web Service
(New version 1,0, September 2008; corrected November 2008)

a WSDL Definition for the SOAP protocol version of the web service
an XML schema for Request and Response payloads in XML format

Implemented by Bertrams

For more information about the Bertrams implementations, go to http://www.bertrams.com/api.



CDF Order Request and Response Web Service

This service will enable the use of web services for the placing of orders by retailers (or possibly, in the case of smaller retailers, their agents) with wholesalers or distributors, where this complements existing paper-based and electronic ordering methods, involving direct fulfilment of the order to the consumer. Using this service, the buyer can receive an immediate response to the CDF order and not simply a technical acknowledgement of receipt.

Version 1.0 (July 2011)

Consumer-direct Fulfilment Order Request and Response Web Service 

Implemented by Bertrams

For more information about the Bertrams implementations, go to http://www.bertrams.com/api.



Retrieve Order List Web Service

Buyers, including EDI users, need to ensure that they are aware of all orders received and not yet fulfilled by a particular supplier. This web service enables a buyer to retrieve a list of orders, selected by date-of-issue range. Having retrieved such a list, a buyer may then follow up individual orders using other web services or by manual enquiry. This service will also enable an aggregation service to reconcile their system with those of their data suppliers, to check for missing documents and changes made outside their system.

Version 1.0 (June 2010)

Retrieve Order List Web Service

Implemented by Bertrams

For more information about the Bertrams implementations, go to http://www.bertrams.com/api.



Order Status Request and Response Web Service

This web service can be used in one of two ways.

The first is as an order chaser/status update to find the current progress of an order. This web service allows the client to find out if the supplier is awaiting stock, or has already shipped the order, allowing them to update their customer in turn.

The second, in combination with the order list web service, is as a synchronisation process. By using the order list web service the client's system can get the order references of orders that don't exist within it. A subsequent call to the order status request/report service allows the system to fill in the detail of those orders. This is useful when customers use other order channels to raise orders with the supplier - a typical example being a rep order. This makes management of orders easier for the buyer as all their orders are in one place, but also by being aware of what has been ordered via other routes they can avoid potential over ordering. This can be particularly useful in chains where head office might place some orders on behalf of their branches.

Version 1.1 (July 2011), incorporating consumer-direct fulfilment (CDF) functionality

Order Status Request and Response Web Service

Implemented by Bertrams

For more information about the Bertrams implementations, go to http://www.bertrams.com/api.



Order Cancellation Request and Response Web service

The formats have been designed to enable a customer to request cancellation of order items that have been placed on back-order by a supplier and to enable the supplier to response by accepting or rejecting the request and, if the latter, providing a reason for rejecting it.  A typical implementation will be as a value-added service offered by wholesalers and distributors. The typical user will be a bookseller, but occasionally a wholesaler.

New version 1.0 (June 2007), revised July 2011 to incorporate consumer-direct fulfilment (CDF) functionality

Order Cancellation Request and Response Web service

Implemented by Bertrams

For more information about the Bertrams implementations, go to http://www.bertrams.com/api.



Returns Authorisation Request and Response

Post Returns Despatch Advice Request and Response

This pair of services will enable the use of web services to request authorisation to return overstocks, faulty or incorrectly supplied products, and raise claims for shortages or invoicing errors; and to then confirm the despatch of authorized products being returned. This process mirrors that adopted by the Industry Returns Initiative, but with the usual web service gains of avoiding more complicated trading partner configuration and allowing for real time response where suppliers can support it.

Version 1.0 (July 2009)

Returns Authorisation Request and Response/Post Returns Despatch Advice web services

Implemented by Bertrams

For more information about the Bertrams implementations, go to http://www.bertrams.com/api.



Request Financial Document List Web Service

This service answers the need for buyers, including EDI users, to ensure that they are aware of all invoices and credit notes issued by a particular supplier by enabling a buyer to retrieve a list of invoices and credit notes, selected by date-of-issue range or by whether they are settled or not yet settled.

Version 1.0 (June 2010)

Request Financial Document List Web Service

a WSDL Definition for the SOAP protocol version of the web service
an XML schema for Request and Response payloads in XML format

Implemented by Bertrams

For more information about the Bertrams implementations, go to http://www.bertrams.com/api.



Request Financial Document Web Service

Where a suitable trading partner agreement exists, there is a need for a buyer to be able to retrieve financial documents as digital documents from a supplier, either directly or through an aggregation service. There is a need to be able to retrieve both original documents and, where documents are missing or are altered outside the system, copies of originals.

Version 1.0 (June 2010)

Request Financial Document Web Service

a WSDL Definition for the SOAP protocol version of the web service
an XML schema for Request and Response payloads in XML format

Implemented by Bertrams

For more information about the Bertrams implementations, go to http://www.bertrams.com/api.



ONIX Product Information Request and Response Web Service

The formats have been designed to handle the supply of product information in ONIX format as a value-added service offered by wholesalers and distributors as well as by bibliographic information services. The typical user of this service will generally be a bookseller, but occasionally a wholesaler referring a bookseller's enquiry on to the distributor or to a bibliographic information service.

Version 1.0 (November 2009)

ONIX Product Information Request and Response Web service

Implemented by Trust Media Distribution and BookNet Canada

 


Specifications ready for pilot implementation and subject to revision

MARC Product Information Request and Response Web Service

The formats have been designed to handle the supply of product information in MARC 21 or UK MARC format as a value-added service offered by wholesalers and distributors as well as by bibliographic information services. The typical user of this service will generally be a library or a library supplier referring a library enquiry on to the distributor or to a bibliographic information service.

MARC Product Information Request and Response Web service




Post Financial Document Web Service

Where a suitable trading partner agreement exists, there is a need for a supplier to be able to post invoices and credit notes as digital documents to a buyer or to an aggregation service, both as original and as copy documents. There may in future be a need to post other financial documents, such as debit notes and statements.

Post Financial Document Web Service

 



Retrieve Backorder Summary Web Service

This web service is designed to assist buyers in obtaining a clear up-to-date picture of the status of backorder files with their suppliers (possibly intermediated by an agent or aggregation service).

Retrieve Backorder Summary Web Service

 



Request Backorder Release Web Service

This web service is designed to assist buyers in requesting release of backorder file items that are being accumulated by the supplier (possibly intermediated by an agent or aggregation service).

Request Backorder Release Web Service