Material catalog

Across all material types: find a product by article number without knowing its type, and import a vendor's price list in one call.

📄️Find materials by key across all types

Finds products by article number without knowing their type: by manufacturer article number (add `manufacturerId` when two manufacturers use the same number), by your own article number, or by a vendor's article number (`vendorName` and `vendorArticleNumber`, matched against the current purchase price). All material types are searched, and each match says its `type`. Send at least one of the three article numbers; `name` and `archived` narrow the result. Requires the `read:materials` scope.

📄️Import a vendor price list

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.