Material catalog

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

📄️Find materials by key across all types

Look a product up without knowing its type: by manufacturer article number (add `manufacturerId` when two manufacturers share a number), by your internal article number, or by a vendor's article number (`vendorName` + `vendorArticleNumber`, matched against the current purchase price). Every material type is searched; matches carry their `type`. At least one article-number filter is required, `name` and `archived` narrow further. Requires `read:materials`.

📄️Import a vendor price list

Record new 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 writes a new purchase price for `vendorName` (carrying the vendor article number, 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 `write:materials`.