Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This API allows the sender of an order to update the amount of each row on an existing order. Only reduction of numbers are allowed and you cannot add new products to an existing order (if this is required send a new order). 

 

...

Info

New Authentication & URLs introduced Q2 2024

URL

https://api.bokbasen.io/orders/v1/{id}/update

Expand
titleLegacy

https://api.order.boknett.no/orders/{

ID

id}/update


MethodPOSTRequest

headers

Authorization

Required

The token acquired from the Authentication Service.

Formated "Boknett TGT-...."

Required header: Date

Required

The timestamp the request was made. Must comply with RFC 1123 date formats. Example: Tue, 10 Jun 2014 16:23:42 GMT

Method

POST

Request
headers

Authorization

Required

See Authentication Service

Audience: https://api.bokbasen.io/orders/

Content-type

Required

application/json

Request body

 


Code Block
{
  "
ISBN
ean": "
ISBN
EAN of product", 
  "number": negative number
}

 

Response
body

empty on success

Returns

200

Ok

403

Is returned if you do not have access to update to the given number (e.g. number is higher than total on order, or set as FULFILLED_BLOCKED)

40x

On error

 

Validations

The system checks status on the rows that is requested to change and if the total number does not go below 0. If the request row has been set to FULFILLEDto FULFILLED_BLOCKED by the seller, then the change will be rejected. If the change is accepted (API returns 200) then the change will appear as a new row in the order and have the initial status REQUESTED.