Update order line status
Update the order status for a single line in an order.
New Authentication & URLs introduced Q2 2024
URL |
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 |
| ||
Request |
| Required | Audience: |
| Required |
| |
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 | empty on success | ||
Returns | 200 | Ok | |
40x | On error |
Allowed values for status
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. |