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
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
Accept | string |
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}]}