...
- WMO-00013 Empty body
Order
placeOrder
The operation placeOrder supports sending one order for a customer. An order can contain multiple orderlines, each for a specific title. Confirmation of the operation is provided with a http-response-code.
Check order identification (Requestor Order Id)
The identification of an order is used to check if an order already exists in the CB systems. If this is the case the new order is rejected. Only open orders are taken into account, so closed/cancelled orders are ignored.
Order type
The operation is available for order types ShipBuyer (LNAFN), ShipOwner (LNEIG) and ShipSecundaryOwner (LMEONE).
Sender and Owner
In the common scenario for media orders the sender requests CB to ship titles owned by a publisher to a consumer. This scenario identifies the publisher as owner, the sender (shop) as buyer from the owner and the consumer as receiver (and buying from the shop).
An alternative scenario is secondary ownership, in this alternative scenario the sender (shop) already purchased titles from the publisher and requests CB to ship from its own stock.
Party
Because parties where goods have to be delivered are not known by CB the PartyType “ReceiverAddress,” is mandatory and all name and address information must be provided.
Values added services (VAS)
VAS activities can be controlled by means of special handling instructions for the order.
Examples of instructions:
- Wrap the books in gift paper
- Add leaflet to the package
Available special handling instructions must be agreed upon in advance by requestor and CB.
Specific error messages
OMS-01097 Unknown SKU
OMS-01099 Duplicate OrderId
OMS-01100 Unknown ShipmentCode
OMS-01107 Unknown CountryCode
OMS-01202 Unknown RelationId
OMS-01315 Unknown SKU
OMS-01338 Unknown document
cancelOrderLine
The operation cancelOrderLine supports cancellation of one orderline. Cancellation is available until the orderline is released for production (“vrijgegeven”). Confirmation of the operation is provided with a http-response-code.
The operation requires the OrderId and OrderLineId as input and is available for orders entered via webservices only.
Specific error messages
OMS-01201 Unable to map sending party
OMS-01216 Unable to map OrderId
OMS-01251 Unable to map OrderLineId
OMS-01269 Unable to cancel. Orderline already processed
getOrderStatus
When the status of an order or orderline is changed a notifyOrder message is sent. This is the preferred trigger to call the operation getOrderStatus.
The operation getOrderStatus provides the status summary of the requested order. An order can contain multiple orderlines, each for a specific title. The status of every orderline is reported separately. An orderline can also be reported in multiple statuses, for instance when part of the quantity is available and ready for production and the remaining quantity is in backorder.
If (a part of) the order is not delivered, the status includes an explanation why.
The operation requires the OrderId as input and available for orders entered via webservices only.
Available statuses for notifyOrder:
- New Order is accepted after being received during the service window
- InProgress Order(line) passed validation
- ProductionReady Order(line) is ready for pick/pack in warehouse
- Warning Order processing started with an issue for at least one orderline
- Processed Order is finished with shipment
- Cancelled Order is finished without shipment