Zum Inhalt springen

Artikel

4 Werkzeuge in dieser Gruppe, jedes mit Stufe, Eigenschaften, Beschreibung und Argumenten.

Die Beschreibung für das Modell und die Argumente stehen auf Englisch, so wie das Modell sie liest.

sevdesk_part_create 

Artikel anlegen

Entwerfenchanges statesupports dryRun

Legt einen Artikel mit Artikelnummer, Preis, Steuersatz und Einheit an.

Für das Modell, auf Englisch

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.

nameerforderlichstring
Part name (Artikelname) as printed on documents.
partNumbererforderlichstring
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 

Artikel abrufen

Lesenread-onlyidempotent

Zeigt einen Artikel mit Preisen, Steuersatz und Lagerbestand.

Für das Modell, auf Englisch

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.

iderforderlichinteger
Part id, e.g. from sevdesk_parts_list.

sevdesk_part_update 

Artikel ändern

Entwerfenchanges statedestructiveidempotentsupports dryRun

Ändert nur die Felder eines Artikels, die du angibst. Bestehende Dokumente behalten ihre Preise.

Für das Modell, auf Englisch

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.

iderforderlichinteger
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 

Artikel auflisten

Lesenread-onlyidempotent

Listet Artikel mit Nummer, Name, Preisen, Steuersatz und Bestand.

Für das Modell, auf Englisch

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.