Misc materials
Miscellaneous catalog items. They need no manufacturer and can be pre-selected onto offers.
List misc materials
List your misc catalog. Filter by `name`, `manufacturerId` or `archived`; sort and page with `limit`/`offset`. Type-specific attributes are returned under `specs`. Requires `read:materials`.
Create a misc material
Add a misc to your catalog. Include `purchasePrice` to set what you pay for it — the catalog's net and gross selling prices are derived from that and your margins. Requires `write:materials`.
Update a misc material by manufacturer article number
Same as updating by id, but the product is identified by `manufacturerArticleNumber` (plus `manufacturerId` when two manufacturers share a number) — the key a vendor price list carries, so a sync needs no id mapping of its own. Only active products are matched. Change a misc. Every field is optional; omitted fields keep their current value. Sending `purchasePrice` records a new purchase price and points the material at it. Requires `write:materials`.
Delete a misc material by manufacturer article number
Same as deleting by id, but the product is identified by `manufacturerArticleNumber` (plus `manufacturerId` when two manufacturers share a number). Only active products are matched. Remove a misc from your catalog. A product already used by an offer cannot be deleted — archive it instead (`archived: true`), which hides it from new offers while keeping existing ones intact. Requires `write:materials`.
Get a misc material
Fetch one misc from your catalog. To look it up by manufacturer article number, list with `?manufacturerArticleNumber=` (and `manufacturerId`) instead. Requires `read:materials`.
Update a misc material
Change a misc. Every field is optional; omitted fields keep their current value. Sending `purchasePrice` records a new purchase price and points the material at it. Requires `write:materials`. To address the product by manufacturer article number instead of id, use the same method on `/v1/materials/misc?manufacturerArticleNumber=…`.
Delete a misc material
Remove a misc from your catalog. A product already used by an offer cannot be deleted — archive it instead (`archived: true`), which hides it from new offers while keeping existing ones intact. Requires `write:materials`. To address the product by manufacturer article number instead of id, use the same method on `/v1/materials/misc?manufacturerArticleNumber=…`.