Funktionen · Konto-Schnittstelle

Ihre Belege abrufen, ohne Abtippen

Ist ein Postfach für die Beleg-Erfassung eingerichtet, etwa eine Rechnungs-Erfassung, zieht es aus eingehenden Mails die wichtigen Felder als strukturierten Beleg heraus: bei einer Rechnung etwa Absender, Betrag und Datum. Diese Belege müssen Sie nicht von Hand abtippen. Ihr eigenes System kann sie direkt abholen, als maschinenlesbare Datei.

Das ist die Konto-Schnittstelle: ein einfacher, abgesicherter Weg, die Belege eines Erfassungs-Postfachs in Ihre Buchhaltung, Ihr Warenwirtschaftssystem oder eine eigene Tabelle zu holen. Ein Postfach, das nur Anfragen beantwortet, legt keine Belege ab, dort gibt es nichts abzurufen.

Wofür Sie sie nutzen

  • Eingehende Rechnungen in Ihre Buchhaltung oder eine Tabelle übernehmen, ohne Abtippen.
  • Prüfen, ob eine erwartete Rechnung schon eingegangen ist.
  • Belege in ein eigenes Skript oder das HTTP-Modul eines Tools wie Make laden und dort weiterverarbeiten.

So funktioniert es

Sie richten in Ihrer Console einen Zugangs-Token ein (Tab „API"). Damit fragt Ihr System die Schnittstelle ab und bekommt eine Liste Ihrer Belege als JSON zurück, jeweils mit einem Link zur einzelnen Datei. Eine Adresse je Konto, nur Ihre eigenen Daten.

Kein Zusatzdienst, keine Middleware. Ein einfacher Abruf genügt, auch aus einem kurzen Skript oder dem HTTP-Modul eines Automatisierungstools.

Beleg-Abruf Konto-Schnittstelle Read-only JSON, nur Ihre Daten
GET /api/v1/<ihr-konto>/recordsListe Ihrer extrahierten Belege als JSON, je Beleg ein Download-Link.
Token im Tab „API"Sie erstellen den Zugangs-Token selbst und können ihn jederzeit sofort widerrufen.

Was heute geht, und was nicht

Heute holen Sie die Liste Ihrer Belege ab und laden einzelne Belege herunter. Sie fragen ab, wann Ihr System möchte. Ein Postfach für die Beleg-Erfassung richten wir heute gemeinsam mit Ihnen ein, es ist noch kein Selbstbedienungs-Schritt.

Was bewusst nicht dabei ist: ein automatischer Push, der bei jedem neuen Beleg von selbst in Ihr System schreibt. Die Schnittstelle ist ein Abruf (Sie holen), kein Zuruf (wir schieben). Auch fertige Konnektoren für DATEV, Lexoffice oder SAP gehören nicht dazu, den Abruf binden Sie mit dem HTTP-Baustein Ihres Tools selbst ein. Das Ausstellen einer XRechnung aus einem PDF ist nicht Teil der Schnittstelle.

Der Unterschied zu Form-Parsern und Automatisierern

Dienste wie Mailparser oder ein selbst gebauter Make-Ablauf lesen eine Mail und versuchen, die Daten herauszuziehen. Bei mailorga hat das Postfach das schon getan, die Belege liegen strukturiert bereit. Ihr System holt sie nur noch ab. Make, Zapier oder ein eigenes Skript können Sie als HTTP-Client trotzdem nutzen, wenn Sie den Abruf orchestrieren möchten. Die Extraktion macht das Fach-Postfach.