Inverters

The inverters in your catalog, with their MPP trackers (mppTrackers), which offers wire the module strings to.

📄️List inverters

Returns the inverters in your catalog, most recently changed first. Filter with `name`, `manufacturerId`, `archived` or one of the article numbers, sort with `sort` and page with `limit` and `offset`. The technical data is in `specs`. Requires the `read:materials` scope.

📄️Create an inverter

Adds an inverter to your catalog. Send `purchasePrice` with what you pay for it; the selling prices (`sellingPrices`) follow from it and the margins of your company sites. Send its MPP trackers in `mppTrackers`, without ids: offers wire the module strings to them. Requires the `write:materials` scope.

📄️Update an inverter by manufacturer article number

Same as updating by id, but the product is found by its `manufacturerArticleNumber` (add `manufacturerId` when two manufacturers use the same number). Handy for syncing a price list, which carries these numbers but not our ids. Only active products are considered.

📄️Delete an inverter by manufacturer article number

Same as deleting by id, but the product is found by its `manufacturerArticleNumber` (add `manufacturerId` when two manufacturers use the same number). Only active products are considered.

📄️Get an inverter

Returns one inverter. To find it by manufacturer article number, use the list with `?manufacturerArticleNumber=`. Requires the `read:materials` scope.

📄️Update an inverter

Changes an inverter. Send only the fields to change; the others keep their value. For a new purchase price send `purchasePrice` with `pricePerPiece` and `vendorName`: the price this vendor already has for the product is updated (a new vendor gets one) and becomes the current price. To change the MPP trackers, send `mppTrackers` with all of them: a tracker with an `id` is changed, one without is added, and the others are deleted. To take the product off new offers without deleting it, send `archived: true`. Requires the `write:materials` scope. To find the product by its manufacturer article number instead of the id, call the same method on `/v1/materials/inverters?manufacturerArticleNumber=…`.

📄️Delete an inverter

Deletes an inverter from your catalog. A product that is on an offer cannot be deleted; archive it instead with `archived: true`: it stays on existing offers but can no longer be added to new ones. Requires the `write:materials` scope. To find the product by its manufacturer article number instead of the id, call the same method on `/v1/materials/inverters?manufacturerArticleNumber=…`.