Update a terminal order

PATCH {{baseUrl}}/merchants/:merchantId/terminalOrders/:orderId

Updates the terminal products order identified in the path. Updating is only possible while the order has the status Placed. The request body only needs to contain what you want to change. However, to update the products in the items array, you must provide the entire array. For example, if the array has three items: To remove one item, the array must include the remaining two items. Or to add one item, the array must include all four items. To make this request, your API credential must have the following role: * Management API—Terminal ordering read and write

Request Body

{"items"=>[{"id"=>"TBOX-V400m-684-EU", "name"=>"V400m Package", "quantity"=>1}, {"id"=>"PART-287001-EU", "name"=>"Bluetooth Charging Base - V400m", "quantity"=>2}, {"id"=>"PART-620222-EU", "name"=>"Receipt Roll", "quantity"=>20}]}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{"id":"4154567890100682","customerOrderReference":"YOUR_REFERENCE","status":"Placed","shippingLocation":{"id":"S2-73536B20665526704F30792642212044452F714622375D477270","name":"YOUR_MERCHANT_ACCOUNT Barcelona depot","contact":{"firstName":"Rita","lastName":"Perengano","phoneNumber":"+34931234567","email":"Rita.Perengano@company.com"},"address":{"companyName":"YOUR_COMPANY","streetAddress":"El quinto pino 42","postalCode":"08012","city":"Barcelona","stateOrProvince":"","country":"ES"}},"billingEntity":{"id":"MerchantAccount.YOUR_MERCHANT_ACCOUNT","name":"YOUR_MERCHANT_ACCOUNT","taxId":"ES1234567890","email":"Pablo.Mengano@company.com","address":{"streetAddress":"Paseo de la Castellana 43, 7","postalCode":"28046","city":"Madrid","country":"ES"}},"orderDate":"2022-01-21T16:12:33Z","items":[{"id":"TBOX-V400m-684-EU","name":"V400m Package","quantity":1},{"id":"PART-287001-EU","name":"Bluetooth Charging Base - V400m","quantity":2},{"id":"PART-620222-EU","name":"Receipt Roll","quantity":20}]}