Import a vendor price list
POST/v1/materials/purchase-prices/import
Updates purchase prices for many products in one call, matching each row to a product by the vendor's article number first and the manufacturer article number second. Only active products match. Each matched row updates the product's purchase price from vendorName — or adds one when the product has no price from this vendor yet — records the vendor article number on it, so the next list matches directly, and makes it the product's current price. Rows are processed independently — one failing row does not roll back the others; the response says per row what happened. Use dryRun to see the matching before writing. Requires the write:materials scope.
Request
Responses
- 200
- 400
- 401
- 403
- 500
What happened to each row, and a count per outcome.
validation_error: the body, a path or a query parameter is not valid. message names each problem, e.g. firstName: Required.
missing_api_key or invalid_api_key: no API key was sent, or it is wrong, expired or revoked.
insufficient_scope: the API key does not have the scope this endpoint needs. required names it.
db_error: the database refused or failed the request. message has the details.