1. Sales
VasyOpenAPI
  • Branch
    • Branch List
      GET
  • Department
    • department
      GET
  • Category
    • category
      GET
    • subCategory
      GET
  • Brand
    • Brand
      GET
    • SubBrand
      GET
  • Contact
    • Transporter Contact List
      GET
    • 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 State List
    • Get City List
    • Get Tax List
    • Get Additional Charge List
  • 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
    • Update Shipping Detail
      POST
    • Update Payment Status
      POST
    • Update Order Status
      POST
    • 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 Shipping Detail

POST
/api/v1/sales/{salesId}/update-shipping-details

Update Shipping Details#

Purpose#

Update the shipping and transportation details of an existing sales voucher in the specified branch.

Why would you use this?#

Use this API when your system needs to update shipment-related information for a sales transaction after the sales voucher has been created. This is useful when transportation details such as transporter, vehicle number, shipping date, or reference number become available later.

Information Required#

Headers#

FieldRequiredDescription
api-tokenYesAuthentication token provided by VasyERP
Content-TypeYesMust be application/json

Path Parameters#

FieldRequiredDescription
salesIdYesUnique ID of the sales voucher whose shipping details need to be updated

Query Parameters#

FieldRequiredDescription
branch_idYesBranch ID in which the sales voucher exists

Request Body#

FieldRequiredDescriptionValidation
shippingDateYesDate and time when the shipment is dispatchedMust be in ISO 8601 format (e.g., 2026-08-04T18:30:00Z)
transportDateYesDate and time of transportationMust be in ISO 8601 format (e.g., 2026-08-14T18:30:00Z)
transporterIdYesUnique Contact ID of the transporterMust be a positive number
vehicleNoYesVehicle number used for transportationMaximum 15 characters. Only letters, numbers, and hyphen (-) are allowed. Spaces are not permitted.
referenceNoNoReference number related to the shipmentMaximum 20 characters
modeOfTransportNoMode of transportation (e.g., Road, Air, Rail, Water)Maximum 20 characters
weightNoWeight of the shipmentMaximum 20 characters

Example Use Case#

A logistics or third-party ERP application updates the shipping information of a sales voucher after dispatch. Once the transporter, vehicle number, shipping date, and transportation details are finalized, the application calls this API to keep the shipment information synchronized with VasyERP.

Important Notes#

The specified sales voucher must exist in the provided branch.
A valid api-token is required to authenticate the request.
shippingDate and transportDate must be provided in ISO 8601 format.
transporterId must be a valid Contact ID of an existing transporter.
vehicleNo accepts only alphanumeric characters and hyphens (-). Spaces and special characters are not allowed.
This API updates only the shipping details of the sales voucher. All other voucher information remains unchanged.
Invalid input values or missing required fields will result in a validation error response.

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Bodyapplication/json

🟠403Unauthorized
🟠429Too Many Request
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/v1/sales/5313756/update-shipping-details' \
--header 'api-token: {{.in-api-token}}' \
--header 'Content-Type: application/json' \
--data '{
    "shippingDate": "2026-08-04T18:30:00Z",
    "transportDate": "2026-08-14T18:30:00Z",
    "transporterId": 13851674,
    "vehicleNo": "GJ-21-2001",
    "referenceNo": "51234",
    "modeOfTransport": "Via Water",
    "weight": "120"
}'
Response Response Example
200 - Example 1
{
    "status": true,
    "message": "Shipping details updated successfully",
    "code": "200",
    "response": null
}
Previous
Consumption Production Report
Next
Update Payment Status
Built with