Product Purchase Prices

Name	Type	Path
GetProductPurchasePrices	GET	/api/Product/{idOrCode}/PurchasePrice
		Get a list of purchase prices for a product.
GetProductPurchasePrice	GET	/api/Product/{idOrCode}/PurchasePrice/{id}
		Get a purchase price for a product.
CreateProductPurchasePrice	POST	/api/Product/{idOrCode}/PurchasePrice
		Create a purchase price for a product product.
UpdateProductPurchasePrice	PATCH	/api/Product/{idOrCode}/PurchasePrice/{id}
		Update a purchase price on a product.
LockProductPurchasePrice	POST	/api/Product/{idOrCode}/PurchasePrice/{id}/lock
		Lock a purchase price for a product.
UnlockProductPurchasePrice	POST	/api/Product/{idOrCode}/PurchasePrice/{id}/unlock
		Unlock a purchase price for a product.
DeleteProductPurchasePrice	DELETE	/api/Product/{idOrCode}/PurchasePrice/{id}
		Permanently delete a purchase price for a product.

Retrieve all purchase prices for a given product

All existing purchase prices for a product can be retrieved using GET /api/Product/{idOrCode}/PurchasePrice.

Reference: GET /api/Product/{idOrCode}/PurchasePrice

Load a single purchase price

An individual purchase price and be retrieved by its id:

• GET /api/Product/PROD_PUR_CODE/PurchasePrice/e7b08c3e-877c-4d6e-1647-08dd347da426

Reference: GET /api/Product/{productRef}/PurchasePrice/{priceId}

---

• Creating a purchase price
• Updating a purchase price
• Locking
• Unlocking
• Deleting

This is the minimal example to create a cost centre:

POST /api/Product/{idOrCode}/PurchasePrice/

{
  "quantityFrom": 1,
  "unitPrice": 5.00
}

This creates a new product purchase price against the selected purchase product.

If not provided as part of the create request the following values will be defaulted:

• currency will default to the value set in the environment defaults.
• unitOfMeasureRef will default to the unit selected on the parent product.
• effectiveDate will default to todays date.

Complete example:

This is a complete example that contains all supported fields.

Note the codes might vary in your environment so be sure to consult the available reference catalogs in Iplicit or via the catalogs endpoints

The unitOfMeasureRef must be a valid reference to a unit of measure as part of the unit group set on the parent product.

POST /api/Product/{idOrCode}/PurchasePrice/

{
  "currency": "GBP",
  "unitPrice": 10.00,
  "effectiveDate": "2025-01-01",
  "quantityFrom": 1,
  "quantityTo": 20,
  "unitOfMeasureRef": "Units.EA",
  "supplierRef": "SUPP1",
  "projectRef": "PROJ1"
}

Reference: POST /api/Product/{idOrCode}/PurchasePrice/

Updated September 2025