Lexware Office

Firmenprofil des verbundenen Lexware-Office-Accounts: Firmenname, Steuernummern, Kleinunternehmer-Status, angemeldeter Nutzer. Guter erster Aufruf, um zu sehen, mit welchem Mandanten man spricht.

Kontakte suchen oder auflisten. Filter lassen sich kombinieren; ohne Filter kommen die ersten Kontakte. customer/vendor grenzen auf Kunden bzw. Lieferanten ein.

Ein Kontakt mit allen Adressen, Rollen und Bankdaten. Das Feld version braucht man, falls der Kontakt später geändert werden soll (Lexware sperrt optimistisch).

Der Arbeitspferd-Aufruf für alles Kaufmännische: listet Rechnungen, Angebote, Auftragsbestätigungen, Gutschriften, Lieferscheine und Mahnungen als Übersichtszeilen. Rechnungen haben KEINE eigene Listen-Route — sie laufen über diesen Aufruf. Ohne voucher_status wird ein sinnvoller Default gewählt (bei Rechnungen open,paid — Entwürfe und Stornos zählen nicht als Umsatz).

Ein Beleg mit allen Positionen, Steuerangaben und Beträgen. Nur hier stehen Netto-Beträge — die Übersichtszeilen aus list_vouchers haben nur Bruttowerte.

Erzeugt einen zeitlich begrenzten Download-Link auf das PDF eines Belegs. Lexware selbst kennt keine öffentlichen Links, deshalb liefert dieser Server die Datei über einen eigenen, nicht erratbaren Link aus. Funktioniert nur bei finalisierten Belegen — Entwürfe haben kein PDF.

Artikel- und Leistungsstamm mit Preisen und Einheiten.

Zahlungsinformationen zu einer Rechnung oder einem Beleg: offener Betrag, Zahlungsstatus und erfasste Zahlungen.

Debitoren-Offene-Posten: welche Rechnungen sind noch nicht bezahlt, wer hängt wie weit hinterher. Rechnet aus der Belegliste und sortiert nach Überfälligkeit. Hinweis: Rechnungen mit überschrittener Fälligkeit meldet Lexware als 'overdue' — sie zählen hier als offen.

Umsatz über einen Zeitraum, aus der Belegliste gerechnet. basis='gestellt' zählt alle gestellten Rechnungen (open,paid — periodengerecht), basis='bezahlt' nur die bezahlten (Zufluss). Entwürfe und Stornos zählen nie mit. Die Beträge sind BRUTTO — die Belegliste führt keine Nettowerte; für Netto die Belege einzeln über get_document holen.

Nachschlagelisten von Lexware: Buchungskategorien (für create_voucher nötig), Zahlungsbedingungen, Länder, Drucklayouts und wiederkehrende Rechnungen.

Kontakt anlegen — entweder als Firma (company_name) oder als Person (last_name). Mindestens eine Rolle ist Pflicht: Kunde und/oder Lieferant. Lexware dedupliziert NICHT: derselbe Aufruf zweimal erzeugt zwei Kontakte.

Artikel oder Leistung in den Stamm aufnehmen. leading_price bestimmt, ob der Netto- oder der Bruttopreis führend ist; den jeweils anderen rechnet Lexware aus.

Rechnung, Angebot, Auftragsbestätigung, Gutschrift oder Lieferschein anlegen. ⚠ finalize=true macht den Beleg verbindlich, vergibt die Belegnummer und erzeugt das PDF — das lässt sich nicht zurücknehmen. Ohne finalize entsteht ein Entwurf, den man in Lexware Office noch bearbeiten kann; ein Entwurf hat aber kein PDF.

Mahnung zu einer bestehenden Rechnung anlegen. Die Rechnung ist Pflicht — eine Mahnung ohne Bezugsrechnung lehnt Lexware ab. Hinweis: Lexware meldet für Mahnungen auch bei finalize=true den Status 'draft' zurück, erzeugt das PDF aber trotzdem sofort.

Buchungsbeleg (z. B. Eingangsrechnung) für die Buchhaltung anlegen. Jede Position braucht eine categoryId aus reference_data(kind='posting-categories') — ohne die lehnt Lexware ab.

Datei nach Lexware hochladen (z. B. einen Beleg als PDF oder Foto) und optional direkt an einen Buchungsbeleg hängen. Inhalt entweder als url (wird geladen) oder als content_base64.