1. Sales
VasyOpenAPI
  • Branch
    • Branch List
      GET
  • Department
    • department
      GET
  • Category
    • category
      GET
    • subCategory
      GET
  • Brand
    • Brand
      GET
    • SubBrand
      GET
  • Contact
    • Get Customer List W Branch Id
      GET
    • Get Contact By Id
      GET
    • Get Contact By Mobile No
      GET
    • contactSave
      POST
    • Supplier(Party)
      GET
  • GST
    • Verify GST
      POST
  • Master
    • Get Country List
      GET
    • Get State List
      GET
    • Get City List
      GET
    • Get Tax List
      GET
    • Get Additional Charge List
      GET
  • Product
    • Get Product List
    • Get Product By ID
    • products with inventory
    • product details with Inventory By Product ID
    • Product Variant List ID & Name
    • Variant Details By Variant ID
  • Recipe
    • Get All Recipe
  • User
    • Created By
  • Report
    • Get Sales Item Register Data
    • Purchase Item Register Report
    • Stock Summary Report
    • Stock Transfer Item Register Report
    • Consumption Production Report
  • Sales
    • Get All Sales Data
      POST
    • Get Sales Data By Id
      GET
    • Order Create
      POST
    • Order Status
      GET
    • Shipping Details
      GET
    • Update Due Date
      POST
    • Update Order Status
      POST
  1. Sales

Update Order Status

POST
/api/v1/sales/30801778/update-order-status

Update Sales Order Status#

Purpose#

Update the status of an existing sales order.

Why would you use this?#

Use this API to manage the order lifecycle by updating the order status as it progresses from confirmation to delivery, cancellation, or return.

Information Returned#

Update Status
Success Message

Example Use Case#

After receiving an order, your system can update the status from Pending to Order Confirmed, then In Progress, Out for Delivery, and finally Delivered as the order moves through the fulfillment process.

Required Parameters#

ParameterDescription
salesIdSales Order ID whose status needs to be updated
orderStatusNew status of the order
reasonReason for status update (recommended for Cancelled or Return status)
branch_idBranch ID associated with the sales order

Request Body Highlights#

FieldDescription
orderStatusNew order status to be applied
reasonReason for status change

Allowed Order Status Values#

pending
Order confirmed
In progress
Out for delivery
Delivered
Cancelled
Return

Important Notes#

Use a valid salesId from the Sales APIs.
Status transitions may depend on your VasyERP order workflow settings.
Order confirmed status is available only when enabled in system settings.
Providing a reason is recommended when updating the status to Cancelled or Return.
This API only updates the order status and does not modify payment or delivery records.

Request

Query Params

Header Params

Body Params application/json

Examples

Responses

🟢200
application/json
Bodyapplication/json

🟠403Unauthorized
🟠429Too Many Request
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/v1/sales/30801778/update-order-status?branch_id=24448' \
--header 'api-token: a6f919n4-4370-47a6-ad48-d3d6f719e3b0' \
--header 'Content-Type: application/json' \
--data '{
    "orderStatus" : "Order confirmed", 
    "reason": "Test"  
}'
Response Response Example
200 - Example 1
{
    "status": true,
    "message": "Order status updated successfully",
    "code": "200",
    "response": null
}
Previous
Update Due Date
Built with