Skip to main content
Glama

MaxRechnung

Server Details

Create and manage German invoices from your AI assistant: drafts, finalizing with mandatory-field checks (§ 14 UStG), XRechnung and ZUGFeRD e-invoices, customers, payments and DATEV export. Requires a MaxRechnung API key (Business plan).

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-06-18
URL
ChatGPT
–
Claude
–

TDQS

B3.2/5.0

Scored across 55 tools

Disambiguation4/5

Most tools map to a distinct resource+action (customers, invoices/drafts, sales documents, payments, webhooks, templates), and the three VAT-check tools are separated by clear semantics (stateless, persist-to-customer, persist-to-invoice). A few boundaries are fuzzy: get_invoice also returns corrections/cancellations while get_sales_document covers quotes/AB/delivery notes, and update_invoice_status versus update_invoice_draft could initially be confused.

Naming Consistency4/5

The set overwhelmingly follows a predictable verb_noun snake_case convention (create_/get_/list_/update_/delete_ + resource, plus well-named actions like cancel_invoice, record_payment, convert_sales_document). Exceptions are minor oddities such as whoami and a few long compound names (add_invoice_items_from_template, download_invoice_xrechnung), but nothing breaks the pattern.

Tool Count2/5

55 tools is far beyond the 3-15 sweet spot and, while the domain is genuinely broad (invoicing, templates, payments, e-invoicing formats, DATEV export, webhooks), much of it could be consolidated. The sheer surface makes discovery and selection heavy for an agent even if every tool earns its place operationally.

Completeness4/5

Coverage is strong: full CRUD for customers, invoices/drafts, sales documents, and webhooks; payment lifecycle (record, amend, cancel, get, list); template listing/creation; DATEV/e-invoicing exports; audit, summary, girocode, and job polling. Minor gaps exist — item templates and invoice templates only have list/create (no get/update/delete), and webhooks lack an update operation — but these are workarounds, not dead ends.

Available Tools

55 tools
add_invoice_items_from_templateVorlage in Rechnungsentwurf einfügenAInspect

Tarif: ab Pro (darunter antwortet die API mit plan_required).

Vorlage in Rechnungsentwurf einfügen

Hängt eine Positions-Vorlage (item_template_id, optional mit abweichender quantity) oder ein Set (item_template_set_id) an den Entwurf an. Der Preis wird wie im Editor in den Preismodus der Rechnung umgerechnet (netto ⇄ brutto mit dem USt.-Satz der Position; ohne USt.-Ausweis gilt netto). Eine einzelne leere Startposition wird ersetzt. Wie im Editor: eine archivierte Positions-Vorlage lässt sich nicht einzeln einfügen (in Sets bleibt sie); eine Vorlage oder ein Set mit Kundenbindung (customer_ids) nur, wenn der Empfänger des Entwurfs genau einem dieser Kunden entspricht. Braucht invoices:draft und templates:read. Ohne Idempotency-Key hängt jeder Aufruf erneut an.

Inputs: id (required), body, _idempotency_key.

amend_paymentZahlungseingang berichtigenA
Destructive
Inspect

Tarif: ab Business (darunter antwortet die API mit plan_required).

Zahlungseingang berichtigen

Berichtigt Betrag, paid_on oder Notiz eines Zahlungseingangs – nur am Erfassungstag (deutsche Zeitzone) und nur solange nicht storniert. Danach 409; dann stornieren und neu erfassen. Ein Skonto-Ausgleich (kind: skonto) wird nicht berichtigt, nur storniert (409). Die Berichtigung wird als payment_edited protokolliert.

Inputs: id (required), body.

cancel_invoiceRechnung stornierenA
Destructive
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

Rechnung stornieren

Stellt eine Stornorechnung (Nummernkreis ST-) aus, die {id} 1:1 mit umgekehrten Vorzeichen neutralisiert. Die Ursprungsrechnung erhält den Status void. Erhaltene Zahlungen bleiben ihr zugeordnet, amount_open wird negativ (Erstattung offen); die Rückzahlung erfasst POST /payments mit negativem Betrag. Ein Skonto-Ausgleich war kein Geld und wird mit dem Storno storniert (payment.cancelled). Anders als bei der Korrektur ist keine weitere Bearbeitung nötig. Die Antwort ist der Stornobeleg: type: cancellation, ebenfalls status: void (beide Belege sind abgeschlossen), negierte Einzelpreise, corrected_invoice verweist auf die Ursprungsrechnung.

Inputs: id (required), _idempotency_key.

cancel_paymentZahlungseingang stornierenA
Destructive
Inspect

Tarif: ab Business (darunter antwortet die API mit plan_required).

Zahlungseingang stornieren

Storniert den Zahlungseingang (setzt voided_at). Die Zeile bleibt in der Historie erhalten, zählt aber nicht mehr zum bezahlten Betrag; der Rechnungsstatus wird neu berechnet.

Inputs: id (required).

check_customer_vat_idUSt-IdNr. des Kunden prüfen und festhaltenAInspect

Tarif: ab Business (darunter antwortet die API mit plan_required).

USt-IdNr. des Kunden prüfen und festhalten

Prüft vat_id serverseitig (qualifiziert per BZSt, wenn die eigene USt-IdNr. aus dem Firmenprofil deutsch ist, sonst VIES) und schreibt das verifizierte Ergebnis nach vat_id_check. Bodylos. Antwort ist der aktualisierte Kunde.

Inputs: id (required), _idempotency_key.

check_ibanIBAN prüfen + BanknameA
Read-only
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

IBAN prüfen + Bankname

Zustandslos. Scope checks:read. Prüft Zeichen und Länge nach ISO 13616 (keine Mod-97-Prüfsumme) und liefert für gültige deutsche IBANs den Banknamen aus der vierteljährlichen Bundesbank-BLZ-Datei sowie die achtstellige blz. Für Nicht-DE-IBANs bleiben bank_name leer und blz null.

Inputs: iban.

check_invoice_recipient_vat_idEmpfänger-USt-IdNr. prüfen und festhaltenAInspect

Tarif: ab Business (darunter antwortet die API mit plan_required).

Empfänger-USt-IdNr. prüfen und festhalten

Prüft recipient.vat_id serverseitig (qualifiziert per BZSt, wenn sender.tax_id eine deutsche USt-IdNr. ist, sonst VIES) und schreibt das Ergebnis inkl. Prüf-Schnappschuss nach recipient.vat_id_check. Bodylos. Nur am Entwurf — festgeschriebene Belege frieren die Empfängerangaben ein (dafür GET /check/vat). Antwort ist die aktualisierte Rechnung.

Inputs: id (required), _idempotency_key.

check_vat_idUSt-IdNr. prüfen (VIES oder qualifiziert per BZSt)A
Read-only
Inspect

Tarif: ab Business (darunter antwortet die API mit plan_required).

USt-IdNr. prüfen (VIES oder qualifiziert per BZSt)

Zustandslos — speichert nichts. Scope checks:read.

Ohne weitere Parameter: EU-weite VIES-Abfrage — method: "vies", status valid / invalid / not_eu / unavailable (reason nennt den Grund).

Mit requester_vat_id = deutscher USt-IdNr. plus name und city: qualifizierte BZSt-Bestätigung (§ 18e UStG) — method: "bzst", status valid / invalid / not_eligible (Problem mit der Absender-USt-IdNr.) / unavailable; bei valid liefert matches die Abgleichcodes A/B/C/D für Firmenname / Straße / PLZ / Ort.

Um das Ergebnis an einer Rechnung / einem Kunden festzuhalten: POST /invoices/{id}/vat-check bzw. POST /customers/{id}/vat-check.

Inputs: city, name, street, vat_id, +2 more.

convert_sales_documentBeleg umwandelnAInspect

Tarif: ab Pro (darunter antwortet die API mit plan_required).

Beleg umwandeln

Erzeugt den Folgebeleg: order_confirmation oder delivery_note (neuer Beleg in derselben Kette, Antwort SalesDocument) oder invoice (Rechnungsentwurf mit nächster RE-Nummer, Zahlungsziel aus dem Profil, Antwort Invoice, feuert invoice.created). Angebot → AB/Lieferschein/Rechnung, AB → Lieferschein/Rechnung, Lieferschein → Rechnung. Ab Pro: Angebot → Rechnung; jedes Weiterführen in eine oder aus einer Auftragsbestätigung bzw. einem Lieferschein ab Business (403 plan_required). Der Ausgangsbeleg rückt im Status weiter; der Rechnungsentwurf zählt ins Monatskontingent. Steht der Beleg unter § 19 UStG (Kleinunternehmer), die Rechnungsvorgaben des Kontos inzwischen auf Umsatzsteuer, weist die Rechnung Umsatzsteuer aus; price_basis legt fest, ob der Preis als Brutto gilt (gross, Vorgabe — der Gesamtbetrag bleibt) oder als netto zuzüglich USt (net). Scope invoices:draft. Ohne Idempotency-Key erzeugt jeder Aufruf einen weiteren Beleg.

Inputs: id (required), body, _idempotency_key.

create_correctionRechnungskorrektur anlegenA
Destructive
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

Rechnungskorrektur anlegen

Erstellt einen Korrektur-Entwurf (Nummernkreis KR-) mit Pflichtbezug auf die festgeschriebene Rechnung {id}. Positionen werden übernommen — für eine Gutschrift die Einzelpreise negativ setzen (PATCH), dann festschreiben.

Inputs: id (required), _idempotency_key.

create_customerKunde anlegenCInspect

Tarif: ab Pro (darunter antwortet die API mit plan_required).

Kunde anlegen

Inputs: body, _idempotency_key.

create_invoice_draftRechnung anlegen (Entwurf)AInspect

Tarif: in jedem Tarif (Free, Pro, Business).

Rechnung anlegen (Entwurf)

Legt immer einen Entwurf an. Zum Festschreiben anschließend PATCH /invoices/{id}/status. Scope invoices:draft (oder invoices:write).

Inputs: body, _idempotency_key.

create_invoice_from_templateRechnung aus Vorlage erstellenAInspect

Tarif: ab Business (darunter antwortet die API mit plan_required).

Rechnung aus Vorlage erstellen

Legt einen Entwurf an: nächste freie Nummer, Rechnungs- und Leistungsdatum heute (oder invoice_date), Absender aus dem Firmenprofil. Ist die Vorlage an einen Kunden gebunden, kommen die Empfängerdaten aktuell aus dem Kunden. Braucht invoices:draft und templates:read; zählt wie jede neue Rechnung ins Monatskontingent. Antwort ist die neue Rechnung.

Inputs: id (required), body, _idempotency_key.

create_item_templatePositions-Vorlage anlegenCInspect

Tarif: ab Pro (darunter antwortet die API mit plan_required).

Positions-Vorlage anlegen

Positions-Vorlagen sind ab Pro, Positions-Sets und Rechnungsvorlagen ab Business; darunter antwortet der jeweilige Endpunkt mit 403 plan_required.

Inputs: body, _idempotency_key.

create_sales_documentBeleg anlegenAInspect

Tarif: ab Pro (darunter antwortet die API mit plan_required).

Beleg anlegen

Legt ein Angebot (ab Pro), eine Auftragsbestätigung oder einen Lieferschein (beide ab Business) als Entwurf an. Felder wie bei der Rechnung; der Beleg kennt kein Zahlungsziel und keine E-Rechnung. Scope invoices:draft. Angebote sind ab Pro, Auftragsbestätigungen und Lieferscheine ab Business: unter Pro antwortet jeder /sales-documents-Endpunkt mit 403 plan_required; in Pro ebenso, wer eine Auftragsbestätigung oder einen Lieferschein anlegt, deren Status setzt oder dorthin weiterführt (details nennt type bzw. target).

Inputs: body, _idempotency_key.

create_webhookWebhook-Endpunkt registrierenAInspect

Tarif: ab Business (darunter antwortet die API mit plan_required).

Webhook-Endpunkt registrieren

Antwortet einmalig mit secret (whsec_…) zum Verifizieren der Signatur. Scope webhooks:write.

Inputs: body, _idempotency_key.

delete_customerKunde löschenC
Destructive
Inspect

Tarif: ab Pro (darunter antwortet die API mit plan_required).

Kunde löschen

Inputs: id (required).

delete_invoice_draftEntwurf löschenA
Destructive
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

Entwurf löschen

Löscht einen Entwurf endgültig und feuert invoice.deleted. Festgeschriebene Belege lehnen das mit 409 ab — die werden storniert (POST /invoices/{id}/cancellations). Scope invoices:draft (oder invoices:write).

Inputs: id (required).

delete_sales_documentBeleg löschenB
Destructive
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

Beleg löschen

Löscht den Beleg endgültig; eine daraus entstandene Rechnung bleibt bestehen (Bezug darauf entfällt). Scope invoices:draft.

Inputs: id (required).

delete_webhookWebhook-Endpunkt löschenC
Destructive
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

Webhook-Endpunkt löschen

Inputs: id (required).

download_invoice_pdfPDF der RechnungB
Read-only
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

PDF der Rechnung

Serverseitig gerendertes PDF (DIN 5008). Entwürfe tragen das ENTWURF-Wasserzeichen.

Inputs: id (required).

download_invoice_xrechnungE-Rechnung (XRechnung 3.0.2 / CII-XML)A
Read-only
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

E-Rechnung (XRechnung 3.0.2 / CII-XML)

XRechnung 3.0.2 (CII-XML nach EN 16931, XRechnung-CIUS 3.0.2 der KoSIT; gegen den KoSIT-Validator geprüft). Ohne Accept-Header: das XML als Datei-Download. Mit Accept: application/json: { filename, warnings, xml } — warnings listet offene Punkte (z. B. fehlende Leitweg-ID/BT-49). Das XML wird beim Festschreiben eingefroren und danach unverändert ausgeliefert.

Inputs: id (required).

download_invoice_zugferdZUGFeRD 2.5.2 / Factur-X 1.09.2 (PDF/A-3 mit eingebettetem XML)A
Read-only
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

ZUGFeRD 2.5.2 / Factur-X 1.09.2 (PDF/A-3 mit eingebettetem XML)

Das Rechnungs-PDF als PDF/A-3 (ISO 19005-3) mit eingebettetem CII-XML (factur-x.xml) nach ZUGFeRD 2.5.2 / Factur-X 1.09.2. Profil je Rechnung: BASIC, EN 16931 (COMFORT, Vorgabe) oder EXTENDED. Mit Accept: application/json: { filename, warnings }. Gegen den Mustang-Validator (veraPDF + Profil-Schematron) geprüft; abwärtskompatibel bis ZUGFeRD 2.0.1 (BMF-Untergrenze § 14 UStG). Das eingebettete XML wird beim Festschreiben eingefroren.

Asynchron. Die Wandlung läuft in einer Warteschlange; bereits erzeugte Dateien kommen sofort (Cache nach Inhalt, festgeschriebene Belege werden beim Festschreiben vorab erzeugt). Ist die Datei nicht binnen wait Sekunden fertig, antwortet der Endpunkt mit 202 + Job-Objekt und Location: /api/v1/jobs/{id} — dort pollen oder auf das Webhook-Event invoice.zugferd_ready warten, danach diesen Endpunkt erneut abrufen. Höchstens 100 offene Aufträge je Konto (sonst 429).

Inputs: id (required), wait.

download_sales_document_pdfPDF des BelegsB
Read-only
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

PDF des Belegs

Serverseitig gerendertes PDF (DIN 5008) — Lieferscheine ohne Preise, mit Unterschriftszeile. Kein ENTWURF-Wasserzeichen.

Inputs: id (required).

export_datevDATEV-Buchungsstapel (EXTF-CSV)B
Read-only
Inspect

Tarif: ab Business (darunter antwortet die API mit plan_required).

DATEV-Buchungsstapel (EXTF-CSV)

Buchungsstapel im DATEV-Format (EXTF, Formatversion 13, Kategorie 21: 31-Feld-Verwaltungssatz, 125 Spalten, CP1252, Dateiname EXTF_Buchungsstapel_…csv). direction=out (Default): Erlösbuchungen aller ausgestellten Belege (sent/partial/paid/void — stornierte Ursprungsrechnung und Stornobeleg gemeinsam als S/H-Paar), je USt.-Satz eine Zeile gegen den Debitor des Kunden (Sammel-Debitor aus den Stammdaten, Vorgabe 10000, plus laufende Nummer je Kunde; Kunde = Kundennummer, sonst USt-IdNr., sonst Name; ist das in den Stammdaten ausgeschaltet oder fehlt eine Kennung, der Sammel-Debitor selbst); Soll/Haben aus dem Vorzeichen (Stornobelege wahlweise als Generalumkehr, Feld 118 = 1, Stammdaten), § 19/§ 13b/ig. Lieferung/Ausfuhr/§ 4-Befreiung auf eigene Erlöskonten, Fälligkeit in Feld 117. Storno, Korrektur und ihre Zahlungen tragen in Belegfeld 1 die Nummer der Ursprungsrechnung (OPOS-Ausgleich), die eigene Nummer in Belegfeld 2 (bis 12 Zeichen) und im Buchungstext. direction=in: Eingangsrechnungen (alle außer ignored; mit disputed=0 auch ohne „In Klärung“) als Aufwandsbuchung gegen den Kreditor des Lieferanten (Sammel-Kreditor aus den Stammdaten, Vorgabe 70000, plus laufende Nummer je Lieferant; Stammdaten dazu: GET /exports/datev/creditors; ist das in den Stammdaten ausgeschaltet oder fehlt eine Kennung, der Sammel-Kreditor selbst), je Zeile der Steueraufschlüsselung (BG-23) eine Buchung mit Vorsteuer-Schlüssel (9 = 19 %, 8 = 7 %; anderer oder unklarer Satz ohne Schlüssel), Reverse-Charge-Leistungen (Kategorie AE) eines Lieferanten aus dem Ausland netto auf die § 13b-Automatikkonten (EU: 5923/3123, sonst 5925/3125; 19 %), Reverse-Charge im Inland und innergemeinschaftlicher Erwerb ohne Steuerbuchung; Gutschriften (381 und die übrige Gutschrift-Gruppe) und Storno (458) mindern den Aufwand, Rechnung, korrigierte Rechnung (384) und 457 buchen nach dem Vorzeichen ihrer Beträge. Ohne Vorsteuerabzug (Stammdaten; Vorgabe aus den Rechnungsvorgaben: Kleinunternehmer oder steuerbefreit = ohne) brutto ohne Schlüssel und Reverse-Charge auf die § 13b-Konten ohne Vorsteuer (5943/3143, 5945/3145). Eingangsrechnungen in fremder Währung fehlen (kein Kurs gespeichert), ebenso eigene Belege: Gutschriften im Gutschriftverfahren (389, 261, 527) und Rechnungen mit eigener USt-IdNr., Steuernummer oder eigenem Namen als Verkäufer — Erlös, kein Aufwand. Bei einer Anzahlung (BT-113) bucht die Zahlung höchstens Brutto − Anzahlung. Konten in der Sachkontenlänge der Stammdaten (rechts mit Nullen aufgefüllt). direction=both: beides. Export-Marken und Nachbuchung: jeder Download vermerkt an Erlös-, Aufwands- und Bankbuchung den Export-Zeitpunkt und schreibt eine Zeile ins Protokoll (/app/datev, „Bisherige Downloads“: Zeitpunkt, Auswahl, Zeilen, Festschreibung, Quelle App/API). pending=1 („nur seit dem letzten Export“) liefert nur, was im Zeitraum noch in keinem Download war — Belege ohne Marke (nachgetragen, rückdatiert, geklärt), mit payments=1 die noch nicht exportierten Zahlungen auch zu schon exportierten Belegen und als Gegenbuchung („Storno Zahlung“, zum ursprünglichen Zahldatum) Zahlungen, die nach ihrem Export storniert wurden; Stapel-Kennung mit Zusatz -NB. Ein normaler Export des Zeitraums enthält alles; die Vorschau nennt, wie viele Buchungen der Auswahl schon in einem früheren Download standen. Mit payments=1 zusätzlich je Zahlung eine Bankbuchung zum Zahldatum (immer Bank, keine Zahlungsart), ein Skonto-Ausgleich als „Gewährte Skonti an Debitor“ (anteilig je Satz: 4736/8736 bzw. 4731/8731, steuerfreie Anteile 4730/8730) und im Eingang ein Skonto als „Kreditor an Erhaltene Skonti“ (5736/3736, 5731/3731, sonst 5730/3730); maßgeblich ist das Zahldatum, nicht das Belegdatum: enthalten sind genau die Zahlungen im Zeitraum, auch zu Belegen von außerhalb (für die dann keine Erlös-/Aufwandsbuchung entsteht). Berater-/Mandante

Inputs: to, skr, from, lock, +8 more.

export_datev_creditorsDATEV-Stammdaten der Personenkonten (Debitoren und Kreditoren)A
Read-only
Inspect

Tarif: ab Business (darunter antwortet die API mit plan_required).

DATEV-Stammdaten der Personenkonten (Debitoren und Kreditoren)

Stammdaten im DATEV-Format (EXTF, Kategorie 16 „Debitoren/Kreditoren“, Formatversion 5, 254 Spalten, CP1252, Dateiname EXTF_Debitoren_Kreditoren_…csv): Sammel-Debitor und Sammel-Kreditor mit Namen; je Kunde der ausgestellten Rechnungen sein Debitor — Sammel-Debitor aus den Kanzlei-Stammdaten plus laufende Nummer, die sich nie ändert (10001, 10002 …) — mit Name, USt-IdNr., Anschrift und E-Mail aus der jüngsten Rechnung (Kunde = Kundennummer, sonst USt-IdNr., sonst Name); je Lieferant im Eingang (ohne ignorierte, eigene und Fremdwährungsbelege) sein Kreditor — Sammel-Kreditor plus laufende Nummer (70001, 70002 …) — mit Name, Kurzbezeichnung, USt-IdNr., Steuernummer, Anschrift, E-Mail und IBAN aus dem jüngsten Beleg (Lieferant = USt-IdNr., sonst Steuernummer, sonst Name). Ist eine Art in den Stammdaten ausgeschaltet, fehlen ihre Einzelkonten. Die Kanzlei importiert die Datei vor dem ersten Buchungsstapel. Scope datev:read, Limit wie GET /exports/datev.

Inputs: no named parameters.

get_customerKunde abrufenC
Read-only
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

Kunde abrufen

Inputs: id (required).

get_invoiceBeleg abrufenA
Read-only
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

Beleg abrufen

Liefert den Beleg zu {id} — Rechnung, Korrektur (KR-) oder Storno (ST-). type im Body unterscheidet sie; eigene Abruf-Endpunkte für Korrektur/Storno gibt es nicht.

Inputs: id (required).

get_invoice_auditÄnderungshistorie (GoBD)C
Read-only
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

Änderungshistorie (GoBD)

Inputs: id (required).

get_invoice_girocodeGiroCode (EPC069-12) für den RechnungsbetragA
Read-only
Inspect

Tarif: ab Pro (darunter antwortet die API mit plan_required).

GiroCode (EPC069-12) für den Rechnungsbetrag

EPC-QR-Code (GiroCode) über den Brutto-Rechnungsbetrag auf die Absender-IBAN. Standard: JSON { object, invoice_id, payload, data_uri } — payload ist die BCD-Nutzlast, data_uri ein PNG als data:-URI. ?format=png gibt das PNG direkt zurück. 409, wenn im Absender keine IBAN hinterlegt ist oder kein positiver Betrag zu zahlen ist. Kein Betragslimit unterhalb des EPC-Maximums (999.999.999,99 €); Entwurf oder fehlende Kundendaten sind kein Hindernis. Scope invoices:read.

Inputs: id (required), format.

get_invoice_summarySummen je Kunde, Status oder MonatA
Read-only
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

Summen je Kunde, Status oder Monat

Serverseitig gerechnete Summen über die Belege (Rechnungen, Korrekturen, Stornos): Anzahl, netto, USt., brutto, bezahlt, offen und überfällig je Gruppe und gesamt. Gruppen nach Netto absteigend (Monate chronologisch) — so beantwortet man „Welcher Kunde brachte am meisten Umsatz?“ ohne selbst zu addieren. Stornierte Belege zählen nie, Entwürfe nur mit include_drafts=true; beide stehen gezählt in excluded. Korrekturen (KR-) mindern mit negativen Beträgen die Summe ihres Kunden.

Inputs: to, from, type, status, +2 more.

get_jobStand eines asynchronen Auftrags (ZUGFeRD-Erzeugung)A
Read-only
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

Stand eines asynchronen Auftrags (ZUGFeRD-Erzeugung)

Liefert den Stand eines Jobs aus 202-Antworten (bisher nur type: zugferd). status: queued → processing → done (dann download_url) oder failed. Wiederholungen nach Fehlern laufen automatisch und zeigen sich als queued.

Inputs: id (required).

get_paymentZahlungseingang abrufenA
Read-only
Inspect

Tarif: ab Business (darunter antwortet die API mit plan_required).

Zahlungseingang abrufen

Ein einzelner Zahlungseingang, auch ein stornierter (voided_at gesetzt). Business-Tarif.

Inputs: id (required).

get_sales_documentBeleg lesenC
Read-only
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

Beleg lesen

Inputs: id (required).

get_webhookWebhook-Endpunkt abrufenC
Read-only
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

Webhook-Endpunkt abrufen

Inputs: id (required).

list_customersKunden auflistenC
Read-only
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

Kunden auflisten

Inputs: limit, offset, custom_fields.

list_custom_fieldsEigene Felder auflistenA
Read-only
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

Eigene Felder auflisten

Alle eigenen Felder des Kontos in der Reihenfolge der App: Schlüssel, Typ, Auswahlwerte und Bereiche. Angelegt und geändert werden sie in der App unter Einstellungen → Eigene Felder. Ohne Blättern (höchstens 50 Felder).

Inputs: no named parameters.

list_invoicesBelege auflistenB
Read-only
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

Belege auflisten

Listet alle Belegarten: Rechnungen, Korrekturen (KR-) und Stornos (ST-). Mit type auf eine Art einschränken.

Inputs: type, limit, number, offset, +2 more.

list_invoice_templatesRechnungsvorlagen auflistenB
Read-only
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

Rechnungsvorlagen auflisten

Gespeicherte Rechnungen ohne Nummer und Daten: Empfänger, Positionen, Steuerregelung, Zahlungsziel, Hinweis. Neue Rechnung daraus: POST /invoice-templates/{id}/invoices.

Inputs: limit, offset.

list_item_templatesPositions-Vorlagen auflistenA
Read-only
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

Positions-Vorlagen auflisten

Gespeicherte Positionen (Beschreibung, Einheit, Menge, Preis, USt.-Satz). Mit customer_id nur die für diesen Kunden sinnvollen: die ihm zugeordneten plus die allgemeinen.

Inputs: limit, offset, customer_id.

list_item_template_setsSets auflistenB
Read-only
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

Sets auflisten

Ein Set bündelt mehrere Positions-Vorlagen mit eigener Menge; eingefügt wird in der gespeicherten Reihenfolge.

Inputs: limit, offset.

list_paymentsZahlungseingänge auflistenA
Read-only
Inspect

Tarif: ab Business (darunter antwortet die API mit plan_required).

Zahlungseingänge auflisten

Erfasste Zahlungseingänge, neueste zuerst. Mit invoice_id auf eine Rechnung einschränken.

Inputs: limit, offset, invoice_id.

list_sales_documentsBelege auflistenA
Read-only
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

Belege auflisten

Angebote, Auftragsbestätigungen und Lieferscheine, neueste zuerst. Filter nach Belegart, Status, Nummer und Kette. Angebote sind ab Pro, Auftragsbestätigungen und Lieferscheine ab Business: unter Pro antwortet jeder /sales-documents-Endpunkt mit 403 plan_required; in Pro ebenso, wer eine Auftragsbestätigung oder einen Lieferschein anlegt, deren Status setzt oder dorthin weiterführt (details nennt type bzw. target).

Inputs: type, limit, number, offset, +3 more.

list_webhooksWebhook-Endpunkte auflistenC
Read-only
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

Webhook-Endpunkte auflisten

Inputs: no named parameters.

merge_sales_documentsSammelrechnung aus BelegenA
Destructive
Inspect

Tarif: ab Business (darunter antwortet die API mit plan_required).

Sammelrechnung aus Belegen

Eine Rechnung aus mehreren Belegen desselben Empfängers und derselben Währung (z. B. alle Lieferscheine eines Monats): je Beleg eine Überschriftszeile, dann dessen Positionen; alle Bezüge in der Bezugszeile. Reihenfolge der Positionen = Reihenfolge der ids. Kopf, Steuer und Rabatt kommen aus dem ersten Beleg — deshalb müssen Preismodus (netto/brutto), Steuerregelung und Rabatt bei allen gleich sein (ein Rabatt nur als gleicher Prozentsatz). Kein Beleg darf schon abgerechnet sein, keiner Vorbeleg eines anderen (etwa AB und ihr Lieferschein). Die Belege gelten danach als erledigt und verweisen auf die Rechnung; Vorbelege der Kette rücken mit. Antwort Invoice (Entwurf). Ab Business. Scope invoices:draft.

Inputs: body, _idempotency_key.

record_paymentZahlungseingang erfassenAInspect

Tarif: ab Business (darunter antwortet die API mit plan_required).

Zahlungseingang erfassen

Erfasst eine (Teil-)Zahlung zu invoice_id: einer Rechnung oder einer Korrektur mit positivem Betrag (Nachberechnung, Grenze ist ihr eigener Betrag). Der Status wird abgeleitet: sent → partial → paid. Ein negativer Betrag ist eine Rückzahlung, höchstens bis zur erhaltenen Summe (sonst 409); zu einer Minus-Korrektur lässt sich nur die Erstattung an den Kunden erfassen. Übersteigt der Betrag den offenen Rest (Rechnungsbetrag nach Minus-Korrekturen minus erfasste Zahlungen), entscheidet overpayment wie der Zahlungsdialog der App: credit erfasst den vollen Betrag und weist das Guthaben aus (amount_open der Rechnung wird negativ, die Zahlung trägt overpayment: true), ignore erfasst nur den offenen Rest und vermerkt den Mehrbetrag in note. Ohne overpayment lehnt die API eine Überzahlung mit 422 ab (Feldfehler an amount und overpayment); ist bei ignore nichts mehr offen, 409. Kommt eine gleichzeitige Zahlung dazwischen, lehnt die Datenbank ab (409). Eine stornierte Rechnung (void) nimmt nur noch Rückzahlungen bis zur erhaltenen Summe an, sonst 409; der Status bleibt void. kind: skonto gleicht den offenen Rest als Skonto aus, ohne amount und note: nur bei einer Rechnung mit Skonto in den Zahlungsbedingungen, Status sent oder partial, und höchstens bis zum Skonto-Abzug (sonst 409). Die Rechnung steht dann auf paid; der DATEV-Stapel bucht den Rest auf „Gewährte Skonti“ statt auf die Bank. Business-Tarif.

Inputs: body, _idempotency_key.

revise_quoteNeue Fassung eines AngebotsAInspect

Tarif: ab Pro (darunter antwortet die API mit plan_required).

Neue Fassung eines Angebots

Für ein versendetes (sent) oder abgelehntes (declined) Angebot: legt eine Kopie als Entwurf an (neue Angebotsnummer, heutiges Datum) und setzt am alten Angebot superseded_by. Das alte Angebot gilt damit als ersetzt; sein Annahme-Link bleibt erreichbar, nimmt aber keine Antwort mehr an. Den Annahme-Link erzeugt nur der Mailversand aus der App; die API legt keinen an und gibt keinen aus. Entwürfe (direkt änderbar), angenommene, erledigte und bereits ersetzte Angebote: 409 conflict. Ab Pro. Scope invoices:draft. Ohne Idempotency-Key legt jeder Aufruf eine weitere Fassung an.

Inputs: id (required), _idempotency_key.

send_webhook_testTest-Zustellung sendenAInspect

Tarif: ab Business (darunter antwortet die API mit plan_required).

Test-Zustellung senden

Schickt sofort (nicht über die Queue) einen signierten POST mit type:"webhook.test" und gültigem X-Webhook-Signature-Header an den Endpunkt — zum Verifizieren der Signaturprüfung. Rührt die last_delivery_*-Statistik nicht an. Antwort: { object:"webhook_test", endpoint_id, delivered, status | error } (immer 200, auch wenn der Endpunkt nicht erreichbar war). Scope webhooks:write.

Inputs: id (required).

update_customerKunde ändernCInspect

Tarif: ab Pro (darunter antwortet die API mit plan_required).

Kunde ändern

Inputs: id (required), body.

update_invoice_draftEntwurf bearbeitenAInspect

Tarif: in jedem Tarif (Free, Pro, Business).

Entwurf bearbeiten

Ändert Felder an einem Entwurf. Festgeschriebene Belege lehnen das mit 409 ab – außer der Body enthält nur custom_fields (eigene Felder gehören nicht zum Beleg). Scope invoices:draft (oder invoices:write). Statuswechsel (Festschreiben, Bezahlt-Markieren): PATCH /invoices/{id}/status.

Inputs: id (required), body.

update_invoice_statusBeleg festschreibenA
Destructive
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

Beleg festschreiben

Statusänderung, { "status": … } — keine weiteren Felder. sent: § 14-UStG-Pflichtcheck, danach unveränderlich (Korrekturen über POST /invoices/{id}/corrections). paid gibt es nur in Free und Pro, also mit den Keys des KI-Agenten: Im Business-Tarif ergibt sich der Status aus den Zahlungseingängen, paid wird dort mit 409 abgelehnt, die Zahlung erfasst POST /payments. Öffentliche Keys laufen immer im Business-Tarif. Scope invoices:write.

Inputs: id (required), body.

update_sales_documentBeleg ändernAInspect

Tarif: ab Pro (darunter antwortet die API mit plan_required).

Beleg ändern

Ändert Felder; die Belegart steht fest (Umwandeln über POST /sales-documents/{id}/convert). Statuswechsel: PATCH /sales-documents/{id}/status. Auftragsbestätigungen und Lieferscheine bleiben in jedem Status änderbar — auch vorhandene in Pro. Angebote sind nur als Entwurf (draft) änderbar: ab sent antwortet der Aufruf mit 409 conflict; Änderungen an einem versendeten oder abgelehnten Angebot laufen über POST /sales-documents/{id}/revise (neue Fassung), ein angenommenes Angebot bleibt, wie es ist. Ein Body nur mit custom_fields ändert die eigenen Felder in jedem Status. Scope invoices:draft.

Inputs: id (required), body.

update_sales_document_statusBelegstatus setzenAInspect

Tarif: ab Pro (darunter antwortet die API mit plan_required).

Belegstatus setzen

Angebot: draft, sent, accepted, declined; AB und Lieferschein: draft, sent, done. Abgelaufene Angebote (valid_until überschritten, Status sent) zeigt die Liste als „abgelaufen“ an, gespeichert bleibt sent. Ein Angebot kehrt nicht zu draft zurück, und ein ersetztes Angebot (superseded_by) ändert seinen Status nicht mehr (409 conflict). Angebote ab Pro; der Status einer Auftragsbestätigung oder eines Lieferscheins ab Business (403 plan_required). Scope invoices:draft.

Inputs: id (required), body.

verify_webhook_signatureEmpfangene Signatur prüfenA
Read-only
Inspect

Tarif: ab Business (darunter antwortet die API mit plan_required).

Empfangene Signatur prüfen

Prüft eine empfangene Zustellung: Request-Body = der exakte rohe Payload. Mit Header X-Webhook-Signature-V2 (t=<unix>,v1=<hex>) wird zeitgebunden geprüft (scheme: "v2", ?tolerance= Sekunden, Vorgabe 300; reason = malformed | expired | mismatch), sonst klassisch über X-Webhook-Signature (mit oder ohne sha256=-Präfix) oder ?signature= (scheme: "v1"). Vergleich konstantzeitig gegen das Secret des Endpunkts. Kein Seiteneffekt. Scope webhooks:read. So verifiziert man auch selbst: V2 HMAC_SHA256(t + "." + rawBody, secret) als Hex gegen v1, dazu t im Fenster; klassisch HMAC_SHA256(rawBody, secret) als Hex mit sha256=-Präfix.

Inputs: id (required), body, signature, tolerance.

whoamiAPI-Key prüfen (Whoami)A
Read-only
Inspect

Tarif: in jedem Tarif (Free, Pro, Business).

API-Key prüfen (Whoami)

Validiert den API-Key und gibt das zugehörige Konto (ID, E-Mail, Firma, Tarif) sowie den Key selbst (Präfix, Name, Scopes, Zeitstempel) zurück. Kein Scope nötig — nur ein gültiger Key. Gedacht als Verbindungstest und für das Konto-Label in Integrationen (n8n, Make, MCP …); label ist bereits fertig formatiert (Firma, sonst E-Mail). account.plan ist der Tarif, an dem x-min-plan jeder Operation gemessen wird; account.upgrade_url führt zum Tarifwechsel.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Remote MCP server that lets AI assistants read tracked competitive intelligence — competitor news, reviews, website changes, social posts and ads — and act on it by managing projects, competitors, battle cards, reports and canvases. Every answer carries a source and a date, and write actions only publish when explicitly shared.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables brand visibility monitoring across major AI platforms like ChatGPT, Claude, Gemini, and Perplexity. It allows users to track visibility scores, analyze competitor data, and receive actionable insights to improve AI-generated brand recommendations.
      16
      11 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Browse IndustryLens's published competitive-intelligence reports and head-to-head competitor comparisons from any AI agent — real, source-backed data.
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources