Table of Contents

Revision

Date	Description
08 Aug 2022	Delivery Channel BS (Bookshelf) is deprecated
22 Feb 2022	As of July 1, 2022, CB will no longer support Bookshelf
03 May 2021	Specific messages (type/code/text) for this webservice: Some of EBS-* error code will change to WMS-* codes
29 Apr 2021	As of May 17, 2021, CB will no longer support TLS 1.0 and 1.1
08 Apr 2021	Initial document

...

checkOrderable
getContentUrl
placeOrder

Path: /rest/api/v1/DigitalProductOrderService

Delivery channel: Bookshelf

A Bookshelf order must be seen as a request to send a specific e-book to a certain user on the Bookshelf platform. It is therefore necessary to include the information of the Bookshelf- user with the order. If the user does not already have a Bookshelf account, an account can be made through the registration form below:

https://bookshelf.vitalsource.com/#/user/registration

Specific messages (type/code/text) for this webservice:

10050EBS-,\"BS\"

Type

Code

Text

New code

New text

Note
Date to be announced

E

EBS-10001

The field EAN is mandatory

WMS-00008

[object has missing required properties ([\"EAN\"])]

E

EBS-10003

A product with this EAN is not available

E

EBS-10004

This product is not available for delivery

E

EBS-10005

This OrderReference has already been used, use another reference

E

EBS-10006

This product can not be ordered yet

E

EBS-10009

This product may not be ordered yet

E

EBS-10011

This audio book is no longer available via CB. Please contact the publisher for more info

E

EBS-10017

Your credit limit has been exceeded

E

EBS-10034

This product is not available for the given reading method

E

EBS-10038

Vitalsource user account unknown

E

EBS-

The field DeliveryChannel is mandatory

WMS-00008

[object has missing required properties ([\"DeliveryChannel\"])]

E

10056

Invalid value for DeliveryChannel

WMS-00008

[instance value (\"<onjuiste waarde>\") not found in enum (possible values: [\"CBW\"

])]

E

EBS-10057

UserId is mandatory for Bookshelf order

E

EBS-10060

Product ordered but no price available yet, please try again tomorrow

E

EBS-10073

The field EAN must be 13 long

WMS-00008

[ECMA 262 regex \"^([0-9]{13})$\" does not match input string \"<onjuiste waarde>\"]

E

EBS-10075

The field OrderReference must be maximum 100 long

WMS-00008

[string \"<onjuiste waarde>\" is too long (length: 168, maximum allowed: 100)]

E

EBS-10076

The field OrderReference is mandatory

E

EBS-10077

No order found with this OrderReference

...

Parameter	Description	Optionality	Allowed values
EAN	The EAN of which availability and deliverability needs to be checked	Mandatory	13 positions
DeliveryChannel	The method the subscriber uses to read the digital product (Download or On-line reading in the Cloud).	MandatoryOptional	CBW (CB registered web shop) ~~BS (BookShelf)~~
UserId	The identification of the end user. Is used to authenticate the end user (subscriber of the customer) upon delivery of the digital product.	Optional	Max. 50 positions
deprecated

Response

Parameter

Description

Optionality

Allowed values

Orderable

Indicates orderability of the requested digital product through the desired channel.

Mandatory

Y (Yes = Orderable)

N (No = Not orderable)

...

Situation

Orderable product at CB

Code Block

language	yml
title	Request

{
  "EAN": "9789084999813",
  "DeliveryChannel": "CBW"
}

Code Block

language	yml
title	Response

{
  "Orderable": {
     "orderable": "Y" 
  }
}

Situation

Orderable product at Bookshelf

Code Block

language	yml
title	Request

{
  "EAN": "9789084999813",
  "DeliveryChannel": "BS",
  "UserId": "bookshelf@cb-logistics.nl"
}

Code Block

language	yml
title	Response

{
  "Orderable": {
     "orderable": "Y" 
 
  }
}

Situation

Non-orderable product at CB

Code Block

language	yml
title	Request

{
  "EAN": "9999999999999",
  "DeliveryChannel": "CBW"
}

Code Block

language	yml
title	Response

{
   "Message":    {
      "MessageType": "I",
      "MessageCode": "EBS-10003",
      "MessageText": "A product with this EAN is not available"
   },
   "Orderable": {
      "orderable": "N" 
    }
}

...

Parameter	Description	Optionality	Allowed values
EAN	The EAN of which availability and deliverability needs to be checked	Mandatory	13 positions
DeliveryChannel	The method the subscriber uses to read the digital product (Download or On-line reading in the Cloud).	MandatoryOptional	CBW (CB registered web shop) ~~BS (BookShelf)~~	UserId	The identification of the end user. Is used to authenticate the end user (subscriber of the customer) upon delivery of the digital product.	Optional	Max. 50 positions deprecated
OrderReference	This is an internal reference used by the CB-customer to identify the order. This identifier needs to be unique.	Mandatory	Max. 100 positions

...

Situation

Orderable product at CB

Code Block

language	yml
title	Request

{
  "EAN": "9789084999813",
  "OrderReference" : "1423575022409",
  "DeliveryChannel": "CBW"
}

Code Block

language	yml
title	Response

{
 "placeOrder": {
    "CbOrderReference": "1669231",
    "OrderedItem": [{
       "EAN": "9789084999813",
       "URL": "https://tstep2.eboekhuis.nl/wmDwld.php?uid=58403560d6961&ean=9789084999813&r=1"
        }]
  }
}

code

Situation

Orderable product at Bookshelf

language	yml
title	Request

{
  "EAN": "9789084999813",
  "OrderReference" : "1423575022409",
  "DeliveryChannel": "BS",
  "UserId": "bookshelf@cb-logistics.nl"
}

Code Block

language	yml
title	Response

{
 "placeOrder": {
    "CbOrderReference": "1669231",
    "OrderedItem": [{
       "EAN": "9789084999813"
       }]
  }
}

Situation

Non-orderable product at CB

Code Block

language	yml
title	Request

{
  "EAN": "9999999999999",
  "OrderReference" : "1423575022409",
  "DeliveryChannel": "CBW"
}

Code Block

language	yml
title	Response

{
 "Message":    {
      "MessageType": "I",
      "MessageCode": "EBS-10003",
      "MessageText": "A product with this EAN is not available"
  }
}

...

Include Page

	Digital products for testing purposes getStockAvailability
	Digital products for testing purposes getStockAvailability

Include Page

	DigitalProductPublisherService and OrderService DigitalProductOrderService webservice Volume limits and performance requirementsDigitalProductPublisherService and OrderService
	DigitalProductOrderService webservice Volume limits and performance requirements

...

Versions Compared

Old Version 9

New Version Current

Key

Revision

Delivery channel: Bookshelf

Specific messages (type/code/text) for this webservice:

Response

Page Comparison

Versions Compared

Old Version 9

New Version Current

Key

Revision

Delivery channel: Bookshelf

Specific messages (type/code/text) for this webservice:

Response