update order status from service provider

Updates an order's status, currency, reference and per-detail data (state, addresses, remoteReference, trackingData) from the service provider perspective. Authentication: requires ROLE_MANUFACTURER_ADMIN and the service provider must belong to the current client. All body fields are optional — the server only applies fields actually provided. Status transitions are validated against a fixed set of allowed status values; invalid values return 400. Detail updates are matched by reference between request and existing order details. When status or trackingData of a detail changes, a configured webhook is triggered.

Request

Path Params

Header Params

Body Params application/json

Example

{
    "reference": "shop-order-12345",
    "currency": "EUR",
    "status": "in_production",
    "details": [
        {
            "state": "in_production",
            "product_id": "p1111111-1111-1111-1111-111111111111",
            "reference": "cart-item-1",
            "remoteReference": "FA-12345",
            "trackingData": {
                "carrier": "DHL",
                "tracking_number": "JD123456789DE"
            }
        }
    ]
}

Responses

🟢200Unauthorized request

application/json

Bodyapplication/json

Example

{
    "jsonapi": {
        "version": "1.0"
    },
    "data": {
        "type": "orders",
        "id": "ord-uuid-1111",
        "attributes": {
            "reference": "shop-order-12345",
            "currency": "EUR",
            "status": "in_production"
        }
    }
}

🟠401OK

🟠404