Skip to content

Parts

4 tools in this toolset, each with its tier, traits, description and arguments.

sevdesk_part_create 

Create a sevDesk part

Draftchanges statesupports dryRun

Create a part (Artikel anlegen) for invoice and offer positions: name, Artikelnummer (required, must be free), sales price net or gross (the other is computed with the tax rate and rounded to cents), tax rate (default 19), unit (default 1 = Stk), purchase price, stock and stock tracking (Lagerbestand), description and internal note. Tier write. Check existing parts with sevdesk_parts_list first; change the part later with sevdesk_part_update.

namerequiredstring
Part name (Artikelname) as printed on documents.
partNumberrequiredstring
Artikelnummer; must not be used by another part.
priceoptionalstring | number
Sales price (Verkaufspreis) in EUR, net or gross per priceMode; the other one is computed with the tax rate.
priceModeoptionalnet | gross
Whether price is the net (netto, default) or gross (brutto) price. Default: "net".
taxRateoptionalstring | number
Tax rate in percent, default 19.
unitIdoptionalinteger
Unit (Einheit) id, see sevdesk_reference_lookup kind=units (1 = Stk). Default: 1.
pricePurchaseoptionalstring | number
Purchase price (Einkaufspreis), net, EUR.
stockoptionalstring | number
Stock (Bestand).
stockEnabledoptionalboolean
Track stock (Lagerbestand) for the part. Default: false.
descriptionoptionalstring
Description (Beschreibung) printed on documents.
internalCommentoptionalstring
Internal note, not printed.
dryRunoptionalboolean
Preview only: check the action and return exactly what it would do, without changing anything in sevDesk and without asking the user. Defaults to false.

sevdesk_part_get 

Get a sevDesk part

Readread-onlyidempotent

Get one part (Artikel) by its sevDesk id: Artikelnummer, name, description (Beschreibung), unit, prices, tax rate, internal note and stock (Bestand), including the current stock from sevDesk's stock endpoint when stock tracking (Lagerbestand) is on. Use it after sevdesk_parts_list. Unit ids resolve with sevdesk_reference_lookup kind=units.

idrequiredinteger
Part id, e.g. from sevdesk_parts_list.

sevdesk_part_update 

Update a sevDesk part

Draftchanges statedestructiveidempotentsupports dryRun

Change a part (Artikel ändern): only the fields you give change, nothing is cleared. Name, Artikelnummer (must be free), sales price net or gross (the other is computed), tax rate (alone: the net price stays, the gross price is recomputed), unit, purchase price, stock, stock tracking, active/inactive, description, internal note. Existing documents keep their prices. Tier write. Reads the part first (sevdesk_part_get shows the current values) and fails when nothing would change.

idrequiredinteger
Part id, e.g. from sevdesk_parts_list.
nameoptionalstring
Part name (Artikelname) as printed on documents.
partNumberoptionalstring
Artikelnummer; must not be used by another part.
priceoptionalstring | number
Sales price (Verkaufspreis) in EUR, net or gross per priceMode; the other one is computed with the tax rate.
priceModeoptionalnet | gross
Whether price is the net (netto, default) or gross (brutto) price. Default: "net".
taxRateoptionalstring | number
Tax rate in percent.
unitIdoptionalinteger
Unit (Einheit) id, see sevdesk_reference_lookup kind=units (1 = Stk).
pricePurchaseoptionalstring | number
Purchase price (Einkaufspreis), net, EUR.
stockoptionalstring | number
Stock (Bestand).
stockEnabledoptionalboolean
Track stock (Lagerbestand) for the part.
activeoptionalboolean
false deactivates the part (inactive), true activates it.
descriptionoptionalstring
Description (Beschreibung) printed on documents.
internalCommentoptionalstring
Internal note, not printed.
dryRunoptionalboolean
Preview only: check the action and return exactly what it would do, without changing anything in sevDesk and without asking the user. Defaults to false.

sevdesk_parts_list 

List sevDesk parts

Readread-onlyidempotent

List parts (Artikel): the products and services of the account with Artikelnummer, name, unit, net and gross sales price, purchase price, tax rate, stock (Bestand) and active flag. Filter by part number (Artikelnummer) or name; both filters run in sevDesk, which may match them exactly, so try the full value if a part is missing. Paged: pass nextOffset as offset while hasMore is true. Use detail=summary to browse/find. Use sevdesk_part_get for the description and current stock.

detailoptionalsummary | full
Use summary to browse/find; full (default) or the matching get tool for details. Default: "full".
partNumberoptionalstring
Part number (Artikelnummer), e.g. 'ART-001'.
nameoptionalstring
Part name.
limitoptionalinteger
Page size, 1–100. Default: 25.
offsetoptionalinteger
Rows to skip, for paging: pass the previous result's nextOffset. Default: 0.