Update Order

PUT {{baseUrl}}/orders/:order_id

This endpoint allows you to update a specific normal order based on five details:

• Customer: It can be modified if there's no associated customer or if the customer is guest.
• Receiver: It can be modified if the order status isn't marked as completed.
• Shipping: It can be modified if the order status isn't marked as completed.
• Payments: It can be modified if the order status is set to pending.
• Coupon: It can be modified if the order status isn't marked as completed.

📝 Note:

For a darfted order, you have no restrictions to update any field

Scope: orders.read_write- Orders Read & Write

Request Body

{"customer"=>{"id"=>"<integer>", "name"=>"<string>", "mobile"=>"<string>", "email"=>"<string>"}, "receiver"=>{"name"=>"<string>", "country_code"=>"<string>", "phone"=>"<string>", "email"=>"<string>", "notify"=>"<boolean>"}, "delivery_method"=>"<string>", "branch_id"=>"<integer>", "courier_id"=>"<integer>", "ship_to"=>{"country"=>"<integer>", "city"=>"<integer>", "block"=>"<string>", "street_number"=>"<string>", "address"=>"<string>", "address_line"=>"<string>", "postal_code"=>"<string>", "geo_coordinates"=>{"lat"=>"<number>", "lng"=>"<number>"}}, "payment"=>{"status"=>"<string>", "method"=>"<string>", "store_bank_id"=>"<integer>", "receipt_image_path"=>"<string>", "accepted_methods"=>["<string>", "<string>"], "cash_on_delivery"=>{"amount"=>"<integer>", "currency"=>"<string>"}}, "coupon_code"=>"<string>"}

HEADERS

RESPONSES

status: OK

{"status":"\u003cnumber\u003e","success":"\u003cboolean\u003e","data":{"receipt_image":"\u003cstring\u003e","store":{"id":"\u003cnumber\u003e","store_id":"\u003cnumber\u003e","user_id":"\u003cnumber\u003e","user_email":"\u003cstring\u003e","username":"\u003cstring\u003e","name":{"ar":"\u003cstring\u003e","en":"\u003cstring\u003e"},"avatar":"\u003cstring\u003e"},"id":"\u003cnumber\u003e","cart_reference_id":"\u003cnumber\u003e","reference_id":"\u003cnumber\u003e","urls":{"customer":"\u003cstring\u003e","admin":"\u003cstring\u003e"},"date":{"date":"\u003cdateTime\u003e","timezone_type":"\u003cnumber\u003e","timezone":"\u003cstring\u003e"},"updated_at":{"date":"\u003cstring\u003e","timezone_type":"\u003cstring\u003e","timezone":"\u003cstring\u003e"},"source":"mahly-app","source_device":"\u003cstring\u003e","source_details":{"type":"\u003cstring\u003e","value":"\u003cstring\u003e","device":"\u003cstring\u003e","user-agent":"\u003cstring\u003e","ip":"\u003cstring\u003e"},"status":{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","slug":"\u003cstring\u003e"},"is_price_quote":"\u003cboolean\u003e","payment_method":"\u003cstring\u003e","first_complete_at":{"date":"\u003cstring\u003e","timeone_type":"\u003cinteger\u003e","timezone":"\u003cstring\u003e"},"currency":"\u003cstring\u003e","amounts":{"sub_total":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"},"shipping_cost":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"},"cash_on_delivery":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"},"tax":{"percent":"\u003cstring\u003e","amount":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"}},"discounts":[{"title":"\u003cstring\u003e","type":"\u003cstring\u003e","code":"\u003cstring\u003e","discount":"\u003cstring\u003e","discounted_shipping":"\u003cinteger\u003e"},{"title":"\u003cstring\u003e","type":"\u003cstring\u003e","code":"\u003cstring\u003e","discount":"\u003cstring\u003e","discounted_shipping":"\u003cinteger\u003e"}],"total":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"}},"can_cancel":"\u003cboolean\u003e","show_weight":"\u003cboolean\u003e","can_reorder":"\u003cboolean\u003e","is_pending_payment":"\u003cboolean\u003e","pending_payment_ends_at":"\u003cinteger\u003e","total_weight":"\u003cstring\u003e","rating_link":"\u003cstring\u003e","shipping":{"id":"\u003cnumber\u003e","app_id":"\u003cnumber\u003e","company":"\u003cstring\u003e","logo":"\u003cstring\u003e","receiver":{"name":"\u003cstring\u003e","email":"\u003cstring\u003e","phone":"\u003cstring\u003e"},"shipper":{"name":"\u003cstring\u003e","company_name":"\u003cstring\u003e","email":"\u003cstring\u003e","phone":"\u003cstring\u003e"},"pickup_address":{"country":"\u003cstring\u003e","country_code":"\u003cstring\u003e","city":"\u003cstring\u003e","shipping_address":"\u003cstring\u003e","street_number":"\u003cstring\u003e","block":"\u003cstring\u003e","postal_code":"\u003cstring\u003e","geo_coordinates":{"lat":"\u003cnumber\u003e","lng":"\u003cnumber\u003e"}},"address":{"country":"\u003cstring\u003e","country_code":"\u003cstring\u003e","city":"\u003cstring\u003e","shipping_address":"\u003cstring\u003e","street_number":"\u003cstring\u003e","block":"\u003cstring\u003e","postal_code":"\u003cstring\u003e","geo_coordinates":{"lat":"\u003cinteger\u003e","lng":"\u003cinteger\u003e"}},"shipment":{"id":"\u003cnumber\u003e","pickup_id":"\u003cinteger\u003e","tracking_link":"\u003cstring\u003e","label":[{"format":"\u003cstring\u003e","url":"\u003cstring\u003e"},{"format":"\u003cstring\u003e","url":"\u003cstring\u003e"}]},"policy_options":[{"boxes":"\u003cstring\u003e"},{"boxes":"\u003cstring\u003e"}]},"shipments":[{"id":"\u003cnumber\u003e","created_at":"\u003cstring\u003e","type":"\u003cstring\u003e","courier_id":"\u003cnumber\u003e","courier_name":"\u003cstring\u003e","courier_logo":"\u003cstring\u003e","shipping_number":"\u003cstring\u003e","tracking_number":"\u003cstring\u003e","pickup_id":"\u003cinteger\u003e","trackable":true,"tracking_link":"\u003cstring\u003e","label":{"format":"\u003cstring\u003e","url":"\u003cstring\u003e"},"payment_method":"\u003cstring\u003e","source":"\u003cstring\u003e","total":{"amount":"\u003cstring\u003e","currency":"\u003cstring\u003e"},"cash_on_delivery":{"amount":"\u003cstring\u003e","currency":"\u003cstring\u003e"},"ship_to":{"type":"\u003cstring\u003e","name":"\u003cstring\u003e","email":"\u003cstring\u003e","phone":"\u003cstring\u003e","country":"\u003cstring\u003e","country_id":"\u003cnumber\u003e","country_code":"\u003cstring\u003e","city":"\u003cstring\u003e","city_id":"\u003cnumber\u003e","address_line":"\u003cstring\u003e","street_number":"\u003cstring\u003e","block":"\u003cstring\u003e","postal_code":"\u003cstring\u003e","latitude":"\u003cnumber\u003e","longitude":"\u003cnumber\u003e"},"ship_from":{"type":"\u003cstring\u003e","name":"\u003cstring\u003e","company_name":"\u003cstring\u003e","email":"\u003cstring\u003e","phone":"\u003cstring\u003e","country":"\u003cstring\u003e","country_id":"\u003cstring\u003e","country_code":"\u003cstring\u003e","city":"\u003cstring\u003e","city_id":"\u003cnumber\u003e","address_line":"\u003cstring\u003e","street_number":"\u003cstring\u003e","block":"\u003cstring\u003e","postal_code":"\u003cstring\u003e","latitude":"\u003cnumber\u003e","longitude":"\u003cnumber\u003e","branch_id":"\u003cinteger\u003e"},"total_weight":{"value":"\u003cnumber\u003e","units":"\u003cstring\u003e"},"packages":[{"item_id":"\u003cinteger\u003e","external_id":"\u003cinteger\u003e","quantity":"\u003cinteger\u003e","weight":{"value":"\u003cnumber\u003e","units":"\u003cstring\u003e"}},{"item_id":"\u003cinteger\u003e","external_id":"\u003cinteger\u003e","quantity":"\u003cinteger\u003e","weight":{"value":"\u003cnumber\u003e","units":"\u003cstring\u003e"}}],"is_international":false,"meta":{"app_id":"\u003cstring\u003e","policy_options":{"boxes":"\u003cstring\u003e","dimensions":{"length":"\u003cstring\u003e","width":"\u003cstring\u003e","height":"\u003cstring\u003e"}}}},{"id":"\u003cnumber\u003e","created_at":"\u003cstring\u003e","type":"\u003cstring\u003e","courier_id":"\u003cnumber\u003e","courier_name":"\u003cstring\u003e","courier_logo":"\u003cstring\u003e","shipping_number":"\u003cstring\u003e","tracking_number":"\u003cstring\u003e","pickup_id":"\u003cinteger\u003e","trackable":true,"tracking_link":"\u003cstring\u003e","label":{"format":"\u003cstring\u003e","url":"\u003cstring\u003e"},"payment_method":"\u003cstring\u003e","source":"\u003cstring\u003e","total":{"amount":"\u003cstring\u003e","currency":"\u003cstring\u003e"},"cash_on_delivery":{"amount":"\u003cstring\u003e","currency":"\u003cstring\u003e"},"ship_to":{"type":"\u003cstring\u003e","name":"\u003cstring\u003e","email":"\u003cstring\u003e","phone":"\u003cstring\u003e","country":"\u003cstring\u003e","country_id":"\u003cnumber\u003e","country_code":"\u003cstring\u003e","city":"\u003cstring\u003e","city_id":"\u003cnumber\u003e","address_line":"\u003cstring\u003e","street_number":"\u003cstring\u003e","block":"\u003cstring\u003e","postal_code":"\u003cstring\u003e","latitude":"\u003cnumber\u003e","longitude":"\u003cnumber\u003e"},"ship_from":{"type":"\u003cstring\u003e","name":"\u003cstring\u003e","company_name":"\u003cstring\u003e","email":"\u003cstring\u003e","phone":"\u003cstring\u003e","country":"\u003cstring\u003e","country_id":"\u003cstring\u003e","country_code":"\u003cstring\u003e","city":"\u003cstring\u003e","city_id":"\u003cnumber\u003e","address_line":"\u003cstring\u003e","street_number":"\u003cstring\u003e","block":"\u003cstring\u003e","postal_code":"\u003cstring\u003e","latitude":"\u003cnumber\u003e","longitude":"\u003cnumber\u003e","branch_id":"\u003cinteger\u003e"},"total_weight":{"value":"\u003cnumber\u003e","units":"\u003cstring\u003e"},"packages":[{"item_id":"\u003cinteger\u003e","external_id":"\u003cinteger\u003e","quantity":"\u003cinteger\u003e","weight":{"value":"\u003cnumber\u003e","units":"\u003cstring\u003e"}},{"item_id":"\u003cinteger\u003e","external_id":"\u003cinteger\u003e","quantity":"\u003cinteger\u003e","weight":{"value":"\u003cnumber\u003e","units":"\u003cstring\u003e"}}],"is_international":false,"meta":{"app_id":"\u003cstring\u003e","policy_options":{"boxes":"\u003cstring\u003e","dimensions":{"length":"\u003cstring\u003e","width":"\u003cstring\u003e","height":"\u003cstring\u003e"}}}}],"shipment_branch":{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","status":"\u003cstring\u003e","is_default":"\u003cboolean\u003e","type":"\u003cstring\u003e"},"customer":{"id":"\u003cnumber\u003e","first_name":"zWVwomGCN　oN　okikiTeoCc","last_name":"uQUOfR Ck WKvYC","mobile":"\u003cnumber\u003e","mobile_code":"\u003cstring\u003e","email":"\u003cstring\u003e","urls":{"customer":"\u003cstring\u003e","admin":"\u003cstring\u003e"},"avatar":"\u003cstring\u003e","gender":"\u003cstring\u003e","brithday":{"date":"\u003cstring\u003e","timezone_type":"\u003cinteger\u003e","timezone":"\u003cstring\u003e"},"city":"\u003cstring\u003e","country":"\u003cstring\u003e","country_code":"\u003cstring\u003e","currency":"\u003cstring\u003e","location":"\u003cstring\u003e","updated_at":{"date":"\u003cdateTime\u003e","timezone_type":"\u003cnumber\u003e","timezone":"\u003cstring\u003e"},"groups":["\u003cinteger\u003e","\u003cinteger\u003e"]},"items":[{"reservations":"\u003cstring\u003e","id":"\u003cnumber\u003e","name":"\u003cstring\u003e","sku":"\u003cstring\u003e","quantity":"\u003cinteger\u003e","currency":"\u003cstring\u003e","weight":"\u003cnumber\u003e","weight_label":"\u003cstring\u003e","amounts":{"price_without_tax":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"},"total_discount":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"},"tax":{"percent":"\u003cstring\u003e","amount":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"}},"total":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"}},"notes":"\u003cstring\u003e","product":{"id":"\u003cnumber\u003e","type":"group_products","promotion":{"title":"\u003cstring\u003e","sub_title":"\u003cstring\u003e"},"status":"\u003cstring\u003e","is_available":"\u003cboolean\u003e","sku":"\u003cstring\u003e","name":"\u003cstring\u003e","price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"sale_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"url":"\u003cstring\u003e","has_special_price":"\u003cboolean\u003e","regular_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"currency":"\u003cstring\u003e","thumbnail":"\u003cstring\u003e","calories":"\u003cstring\u003e","mpn":"\u003cstring\u003e","gtin":"\u003cstring\u003e","favorite":"\u003cstring\u003e","starting_price":"\u003cstring\u003e"},"options":[{"id":"\u003cnumber\u003e","product_option_id":"\u003cnumber\u003e","name":"\u003cstring\u003e","type":"checkbox","value":[{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","price":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"}},{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","price":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"}}]},{"id":"\u003cnumber\u003e","product_option_id":"\u003cnumber\u003e","name":"\u003cstring\u003e","type":"text","value":[{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","price":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"}},{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","price":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"}}]}],"images":[{"id":"\u003cnumber\u003e","image":"\u003cstring\u003e","type":"\u003cstring\u003e"},{"id":"\u003cnumber\u003e","image":"\u003cstring\u003e","type":"\u003cstring\u003e"}],"codes":[{"code":"\u003cstring\u003e","status":"\u003cstring\u003e"},{"code":"\u003cstring\u003e","status":"\u003cstring\u003e"}],"files":[{"url":"\u003cstring\u003e","name":"\u003cstring\u003e","size":"\u003cnumber\u003e"},{"url":"\u003cstring\u003e","name":"\u003cstring\u003e","size":"\u003cnumber\u003e"}]},{"reservations":"\u003cstring\u003e","id":"\u003cnumber\u003e","name":"\u003cstring\u003e","sku":"\u003cstring\u003e","quantity":"\u003cinteger\u003e","currency":"\u003cstring\u003e","weight":"\u003cnumber\u003e","weight_label":"\u003cstring\u003e","amounts":{"price_without_tax":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"},"total_discount":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"},"tax":{"percent":"\u003cstring\u003e","amount":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"}},"total":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"}},"notes":"\u003cstring\u003e","product":{"id":"\u003cnumber\u003e","type":"group_products","promotion":{"title":"\u003cstring\u003e","sub_title":"\u003cstring\u003e"},"status":"\u003cstring\u003e","is_available":"\u003cboolean\u003e","sku":"\u003cstring\u003e","name":"\u003cstring\u003e","price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"sale_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"url":"\u003cstring\u003e","has_special_price":"\u003cboolean\u003e","regular_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"currency":"\u003cstring\u003e","thumbnail":"\u003cstring\u003e","calories":"\u003cstring\u003e","mpn":"\u003cstring\u003e","gtin":"\u003cstring\u003e","favorite":"\u003cstring\u003e","starting_price":"\u003cstring\u003e"},"options":[{"id":"\u003cnumber\u003e","product_option_id":"\u003cnumber\u003e","name":"\u003cstring\u003e","type":"text","value":[{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","price":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"}},{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","price":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"}}]},{"id":"\u003cnumber\u003e","product_option_id":"\u003cnumber\u003e","name":"\u003cstring\u003e","type":"text area","value":[{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","price":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"}},{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","price":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"}}]}],"images":[{"id":"\u003cnumber\u003e","image":"\u003cstring\u003e","type":"\u003cstring\u003e"},{"id":"\u003cnumber\u003e","image":"\u003cstring\u003e","type":"\u003cstring\u003e"}],"codes":[{"code":"\u003cstring\u003e","status":"\u003cstring\u003e"},{"code":"\u003cstring\u003e","status":"\u003cstring\u003e"}],"files":[{"url":"\u003cstring\u003e","name":"\u003cstring\u003e","size":"\u003cnumber\u003e"},{"url":"\u003cstring\u003e","name":"\u003cstring\u003e","size":"\u003cnumber\u003e"}]}],"bank":{"id":"\u003cnumber\u003e","bank_name":"\u003cstring\u003e","bank_id":"\u003cnumber\u003e","account_name":"\u003cstring\u003e","account_number":"\u003cstring\u003e","iban_number":"\u003cstring\u003e","status":"\u003cstring\u003e"},"product_reservations":[{"id":"\u003cnumber\u003e","from":"\u003cstring\u003e","to":"\u003cstring\u003e","date":"\u003cstring\u003e"},{"id":"\u003cnumber\u003e","from":"\u003cstring\u003e","to":"\u003cstring\u003e","date":"\u003cstring\u003e"}],"tags":{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e"}}}