sevdesk

Zeigt, mit welchem sevdesk-Konto gesprochen wird und in welcher Buchhaltungswelt es lebt. Das ist kein Beiwerk: seit dem sevdesk-Update 2.0 heißt die Steuerregel taxRule und nicht mehr taxType. Wer beim Anlegen die falsche schickt, bekommt 422 oder einen Beleg mit falscher Steuerregel. Guter erster Aufruf. Nennt außerdem die Bankkonten und die nächste freie Kundennummer.

Kontakte auflisten oder suchen. Wichtig zu wissen: sevdesk dokumentiert für die Kontaktliste nur den Filter customerNumber. Eine Namenssuche gibt es dort nicht — dieser Server holt deshalb Seiten und filtert den Namen selbst. Bei großen Adressbeständen also lieber die Kundennummer nehmen oder limit erhöhen. Das Ergebnis sagt, wie gefiltert wurde.

Ein Kontakt mit Adressen und Kommunikationswegen. Adressen und Telefon/E-Mail sind bei sevdesk eigene Objekte und stehen NICHT am Kontakt — dieser Aufruf holt sie mit.

Ausgangsrechnungen suchen. Nach Status filtern geht nur mit 100 (Entwurf), 200 (offen/verschickt) und 1000 (bezahlt) — die Rechnungen selbst können auch 50 und 750 (teilweise bezahlt) haben, danach lässt sich aber nicht filtern. Die Kundennamen werden mitgeholt; ohne das stünde an jeder Rechnung nur eine ID.

Eine Rechnung mit allen Positionen, Steuerangaben und Beträgen. Die Positionen sind ein eigener Aufruf bei sevdesk und werden hier mitgeholt.

Erzeugt einen zeitlich begrenzten Download-Link auf das PDF einer Rechnung, eines Auftrags oder einer Gutschrift. sevdesk liefert PDFs nur als base64 gegen den Token, deshalb stellt dieser Server die Datei über einen eigenen, nicht erratbaren Link bereit. Der Abruf setzt bewusst preventSendBy — ein Download darf den Beleg nicht als versendet markieren. Eingangsbelege (Voucher) haben kein PDF über die API.

Belege (Voucher) sind bei sevdesk die Eingangsseite: Lieferantenrechnungen, Quittungen, Kassenbons. creditDebit trennt Einnahme (C) von Ausgabe (D). Status: 50 Entwurf, 100 offen/fällig, 1000 bezahlt.

Ein Beleg mit seinen Positionen. Die Positionen tragen das Buchungskonto — die eigentlich interessante Information an einem Eingangsbeleg.

Aufträge sind bei sevdesk drei Dinge zugleich: Angebot (AN), Auftragsbestätigung (AB) und Lieferschein (LI) — unterschieden über orderType. Status: 100 Entwurf, 200 verschickt, 300 abgelehnt, 500 angenommen, 750 teilweise berechnet, 1000 berechnet.

Ein Angebot, eine Auftragsbestätigung oder ein Lieferschein mit allen Positionen.

Artikel und Leistungen aus dem Stamm. Name und Artikelnummer filtert sevdesk selbst. Der Lagerbestand ist ein eigener Aufruf pro Artikel und wird nur auf Wunsch geholt.

Die Bankkonten des Mandanten. Der Kontostand zu einem Stichtag ist ein eigener Aufruf und wird nur geholt, wenn ein Datum mitgegeben wird.

Umsätze auf den Bankkonten. isBooked=false zeigt genau das, was noch keinem Beleg zugeordnet ist — der übliche Einstieg für „was ist noch offen in der Buchhaltung?".

Umsatz über einen Zeitraum, aus den Rechnungen gerechnet und nach Monat aufgeteilt. 'gestellt' zählt alles, was verschickt oder bezahlt ist; 'bezahlt' nur Bezahltes. Entwürfe zählen nie mit — sie sind kein Umsatz.

Rechnungen, die noch nicht vollständig bezahlt sind, nach Überfälligkeit sortiert. Teilzahlungen zählen mit: offen ist Brutto minus paidAmount, nicht der ganze Betrag.

Welche Buchungskonten es gibt und welche Steuerregeln und Steuersätze dazu passen. Vor jedem create_voucher der richtige Aufruf: sevdesk lehnt eine unpassende Kombination aus Konto, Steuerregel und Steuersatz mit 422 ab, und die Meldung von dort erklärt nicht, welche Kombination gegangen wäre. Der Wert hängt vom Mandanten ab (Kleinunternehmer sehen andere Regeln).

Legt einen Kunden, Lieferanten oder Partner an. Entweder 'firma' (dann ist es eine Organisation) oder 'vorname'/'nachname' (dann eine Person) — sevdesk entscheidet den Typ genau daran. Die Kategorie ist Pflicht und lässt sich später nicht über diesen Server ändern.

Legt einen Artikel oder eine Leistung im Stamm an. Die Einheit ist bei sevdesk ein eigenes Objekt, für das es keinen Endpunkt zum Nachschlagen gibt — sie wird deshalb aus einem vorhandenen Artikel übernommen, oder man gibt einheit_id mit. Erlaubte Steuersätze sind 0, 7 und 19.

Legt eine Ausgangsrechnung als ENTWURF an (Status 100). Verschickt oder gebucht wird nichts — das bleibt bewusst in sevdesk. sevdesk verlangt beim Anlegen mehrere IDs, für die es keinen Endpunkt zum Nachschlagen gibt (Kontaktperson, Einheit, Land); die werden aus vorhandenen Belegen des Kontos gelesen. Die Antwort sagt, was tatsächlich in der Rechnung gelandet ist — eine verworfene Position meldet sevdesk sonst nicht.

Legt einen Eingangsbeleg an (Lieferantenrechnung, Quittung, Kassenbon) — als Entwurf oder als offen, nie als bezahlt. Jede Position braucht ein Buchungskonto; welche es gibt und welche Steuerregeln und -sätze dazu passen, zeigt booking_accounts. Passt die Kombination nicht, antwortet sevdesk mit 422. Eine bereits hochgeladene Datei lässt sich über 'datei' anhängen.

Lädt einen Scan oder ein PDF in den Zwischenspeicher von sevdesk. Der zurückgegebene Dateiname gehört anschließend als 'datei' in create_voucher — erst dadurch hängt die Datei am Beleg. Ohne diesen zweiten Schritt verfällt der Upload.