Update order line status

Update the order status for a single line in an order.

New Authentication & URLs introduced Q2 2024

URL

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

https://api.order.boknett.no/orders/{id}/lines/{lineId}

The token acquired from the Authentication Service. Formated "Boknett TGT-...."

Required header: Date 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 https://bokbasen.jira.com/wiki/spaces/api/pages/2994962433

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

Content-type

Required

application/json

Request body



{ "status": "STATUS_VALUE", "comment": "Free text comment included in order details" }

Example for digital learning products (additional fields are optional but allows extra information around when a buyer can use the product to be sent when confirming the order. Important when this deviates from standards that can be read from metadata). Price amount is including tax, and tax is in %:

{ "status": "STATUS_VALUE", "comment": "Free text comment included in order details", "valid_to": "2019-12-12", "valid_from": "2019-05-05", "price": { "amount": 250.15, "tax": 25 } }

(comment field is optional)

Response
body

empty on success

Returns

200

Ok

40x

On error

Allowed values for status

Value

Description

Conditions

Value

Description

Conditions

FULFILLED

The order line is delivered to the end customer.

Order line must have been processed without errors.

FULFILLED_BLOCKED

The order line is delivered to the end customer and the seller does not allow any changes to be made to this line.

 Order line must have been processed without errors.

FULLFILLED_ASSIGNED_ORGANIZATION

Special status used for products that are automatically assigned to all users in the customer organisation (typically an entire school). Digitalelev will not send any assignments on these products but will allow provider to send updates on number of licenses that are used (in case of usage restrictions).

Order line must have been processed without errors.

RECEIVED

The order line is received by the seller party



REJECTED

The seller does not accept this order lines, it is highly recommended that you also provide a comment when using this status.