Parts
4 tools in this toolset, each with its tier, traits, description and arguments.
sevdesk_part_create
Create a sevDesk part
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_lookupkind=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
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
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_lookupkind=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
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.