Time	Status	User Agent
Retrieving recent requests…

Time

Status

User Agent

Retrieving recent requests…

Return Part

Return a quantity of an existing part to inventory.

POST /ODataApi/v1/Parts('name')/Return

Endpoint

https://{sitename}.mvpplant.com/ODataApi/v1/Parts('{name}')/Return

Replace {sitename} with your MVP One site name and {name} with the part name or part ID.

Request body

Send the return details in the request body.

Field	Type	Required	Description
`WarehouseID`	String	Yes	Warehouse where the part is returned.
`StockLocation`	String	Yes	Stock location where the part is returned.
`Quantity`	Decimal	Yes	Quantity to return.
`PeopleID`	String	Yes	Person associated with the return transaction.
`ReturnFrom`	String	Yes	Entity or source returning the part.
`ReturnType`	String	Yes	Type of source returning the part.
`FromAccount`	String	Yes	Account used as the source for the return.
`ToAccount`	String	Yes	Account receiving the returned quantity.
`Notes`	String	Yes	Notes for the return transaction.
`DateTime`	String	Yes	Date and time of the return transaction.

Example request

{
  "WarehouseID": "MAIN",
  "StockLocation": "A-01",
  "Quantity": 1,
  "PeopleID": "JSMITH",
  "ReturnFrom": "WO-1001",
  "ReturnType": "WorkOrder",
  "FromAccount": "Maintenance",
  "ToAccount": "Inventory",
  "Notes": "Returned unused part from work order",
  "DateTime": "2026-06-22T10:30:00"
}

Example URL

https://company.mvpplant.com/ODataApi/v1/Parts('PART-1001')/Return

Response

Returns a Boolean value.

true

Notes

Use this endpoint to return a quantity of an existing part to inventory.
The part must already exist before you call this endpoint.
Use single quotes around the part name or part ID in the URL.
Quantity should be the amount returned.
DateTime should use the date and time format expected by your MVP One environment.