Freiberufler und kleine Unternehmen
Freiberufler und kleine Unternehmen können erwartete Rechnungszahlungen und überfällige Beträge prüfen, ohne jede Woche eine neue Forderungsliste aufzubauen.
Zahlungseingangsprognose aus offenen Rechnungen
Cashflow Forecast API für offene Rechnungen
Rufen Sie erwartete Zahlungseingänge, offene Forderungen und überfällige Rechnungen als strukturierte Daten für Dashboards und Automationen ab.
Die Vorschau basiert auf in QuoteCash gespeicherten Rechnungen, Fälligkeiten, offenen Beträgen und erfassten Zahlungen.
GET-EndpointGruppierung nach Woche oder MonatRechnungs-Drilldown
01QuoteCash
Erwartete Zahlungseingänge
Der Endpoint liefert erwartete Zahlungseingänge sowie offene und überfällige Beträge, gruppiert nach Woche oder Monat.
02QuoteCash
Rechnungs- und Zahlungsdaten
Die Antwort nutzt Rechnungssummen, Fälligkeiten, offene Beträge, erfasste Zahlungen und Teilzahlungsstatus. Endpunkte zur Dokumenterzeugung speichern Rechnungen nicht automatisch.
03QuoteCash
Rechnungsdetail
Mit include_invoices=true kommen paginierte Rechnungszeilen mit paymentState, isOverdue, openAmount sowie Mahn- und Erinnerungsmetadaten zurück.
API-Details
So funktioniert die rechnungsbasierte Cashflow-Vorschau
QuoteCash stellt GET /api/v1/cashflow/forecast als geschäftsbezogenen Endpoint bereit. Zurück kommen normalisierte Zeitraumdaten, aktive Filter, Summen sowie nach Woche oder Monat gruppierte Zeiträume für erwartete Zahlungseingänge, bezahlte Beträge, überfällige Forderungen und offene Beträge.
Für aktuelle und zukünftige Perioden gruppiert der öffentliche Endpoint verbleibende offene Rechnungsbeträge nach Fälligkeitsdatum. Er verwendet kein Machine Learning und verspricht kein kundenspezifisches Zahlungsdatum. Erfasste Zahlungen dienen dazu, bezahlte Beträge und vergangene Perioden abzubilden.
Das ist der gespeicherte Rechnungsbereich der API. POST /api/v1/invoices schreibt Rechnungen und Kundenzuordnungen in das Geschäft des API-Keys, während POST /api/v1/invoices/xrechnung, /peppol und /zugferd weiterhin Artefakte erzeugen und zurückgeben, ohne sie zu speichern.
Wird include_invoices=true übergeben, enthält die Antwort zusätzlich paginierte Rechnungszeilen. Jede Zeile enthält paymentState, Überfälligkeitsstatus, offenen Betrag sowie Mahn- und Erinnerungsmetadaten, sodass Dashboards und Automationen von der Vorschau direkt in eine Überfälligkeitsliste springen können.
Der Endpoint unterstützt Filter nach Zahlungsstatus und Erinnerungsstufe sowie Sortierung, Pagination und den Abgleich mit business_id. Alle Beträge werden derzeit in Euro (EUR) verarbeitet und ausgegeben. Eine Währungsumrechnung oder konsolidierte Mehrwährungsberichte sind nicht Bestandteil der API.
Zielgruppen
Für wen ist die API geeignet?
SaaS-Entwickler
Produkte für Abrechnung oder Finanzprozesse brauchen eine stabile API für Hintergrundjobs, Dashboards und interne Tools.
Agenturen und Automation-Partner
Make.com- oder n8n-Workflows profitieren von expliziten Filtern und stabilem JSON statt manuell gepflegter Zahlungseingangsberichte.
ERP-Integratoren
Integratoren brauchen eine klare Mandantentrennung und Drill-down-Daten. Der Abgleich mit business_id und der Reminder-Status reduzieren zusätzliche Logik.
Redaktioneller Hinweis
Zuletzt fachlich geprüft: 24. Juli 2026
Warum QuoteCash Zahlungseingänge als API-Daten abbildet
QuoteCash verwaltet Rechnungen, Zahlungsstatus, Fälligkeiten, offene Beträge und Erinnerungen. Diese operativen Daten bilden die Grundlage für Dashboards und automatisierte Forderungsprozesse.
Praxiswissen
Was diese Zahlungseingangsprognose abbildet
Die öffentliche API zeigt erwartete Zahlungseingänge aus gespeicherten Rechnungen. Für aktuelle und zukünftige Perioden werden verbleibende offene Beträge nach dem jeweiligen Fälligkeitsdatum in Wochen oder Monate gruppiert. Überfällige Forderungen, bezahlte Beträge und erfasste Teilzahlungen werden separat ausgewiesen.
Die Vorschau ersetzt keine vollständige Finanz- oder Liquiditätsplanung. Sie enthält keine zukünftigen Betriebsausgaben, Gehälter, Steuern, Mieten, Abonnements, geplanten Käufe, nicht fakturierten Umsätze oder Bankkontostände.
- Enthalten: Rechnungsbetrag, offener und bezahlter Betrag sowie Fälligkeit.
- Enthalten: offene, teilweise bezahlte, bezahlte und überfällige Zahlungsstatus.
- Optional: Rechnungszeilen und Reminder-Metadaten für Drill-downs.
- Nicht enthalten: Ausgabenplanung, Bankkontoprognose oder vollständige GuV- und Liquiditätsszenarien.
Praxiswissen
Anwendungsfälle für Forderungsmanagement und Automationen
Agenturen und Dienstleister können wöchentlich prüfen, welche Rechnungsbeträge laut Fälligkeit eingehen sollten und welche Forderungen bereits überfällig sind. SaaS- und ERP-Teams können offene Beträge mit eigenen Kunden- oder Vertragsdaten verbinden.
Mit optionalen Rechnungszeilen lassen sich Periodensummen bis zur einzelnen Rechnung erklären: Kunde, Betrag, Fälligkeitsdatum, Zahlungsstatus sowie Mahn- und Erinnerungsmetadaten. Das eignet sich für Forderungs-Dashboards, Mahnworkflows und regelmäßige Zahlungseingangsberichte.
Praxiswissen
Von Prognosesummen zum Rechnungsdetail
Mit include_invoices=true ergänzt die API Periodensummen um paginierte Rechnungszeilen mit paymentState, isOverdue, openAmount sowie Mahn- und Erinnerungsmetadaten. So lassen sich Auffälligkeiten direkt bis zur einzelnen Rechnung nachvollziehen.
Filter, Sortierung und reminder_stage unterstützen fokussierte Arbeitslisten – etwa für überfällige Rechnungen ab einer bestimmten Erinnerungsstufe.
Praxiswissen
API-orientierter Workflow
Ein geplanter Abruf kann offene und überfällige Beträge in Dashboards, BI-Tools oder internen Hinweisen aktualisieren. Teams kombinieren Zeitraum, Gruppierung und Zahlungsstatus passend zum jeweiligen Arbeitsablauf.
Beispiel
API-Beispiel: Prognose für offene und überfällige Rechnungen abrufen
Der Endpoint liefert nach Woche oder Monat gruppierte Summen und optional einzelne Rechnungszeilen.
GET /api/v1/cashflow/forecast?from=2026-07-01&to=2026-09-30&groupBy=week&payment_state=overdue&include_invoices=true
Authorization: Bearer <api_key>{
"range": { "groupBy": "week", "currency": "EUR" },
"summary": { "openAmount": 8400, "overdueAmount": 2200, "paidAmountInRange": 5100 },
"periods": [],
"invoices": [{ "invoiceNumber": "RE-2026-1042", "openAmount": 2200, "currency": "EUR", "paymentState": "overdue", "isOverdue": true }],
"pagination": { "page": 1, "perPage": 25, "totalItems": 1, "totalPages": 1 }
}- Dashboard: offene Beträge nach Woche oder Monat visualisieren.
- Automation: überfällige Rechnungen mit Reminder-Status zur Prüfung senden.
- SaaS-Backoffice: Daten zu offenen Forderungen mit internen Kundensegmenten verbinden.
Umsetzung
Implementierungs-Checkliste für Zahlungseingangsprognosen
- 1Definieren, welche Rechnungen in die Prognose einfließen sollen.
- 2Zahlungsstatus, offene Beträge und Teilzahlungen sauber pflegen.
- 3Zeitraum und Gruppierung für Dashboard oder Automation festlegen.
- 4Überfällige Rechnungen separat markieren und sortieren.
- 5Reminder-Status als Signal für nächste Aktion nutzen.
- 6Prognose regelmäßig abrufen statt manuelle Exporte zu verteilen.
Häufige Fragen
- Was ist eine Zahlungseingangsprognose?
- Sie ist eine rechnungsbasierte Vorschau auf erwartete Zahlungseingänge. QuoteCash gruppiert offene Rechnungsbeträge nach Fälligkeit und weist zusätzlich überfällige, bezahlte und offene Summen aus.
- Welche Daten verwendet die Cashflow Forecast API?
- Der öffentliche Endpoint nutzt gespeicherte Rechnungssummen, Fälligkeiten, offene und bezahlte Beträge, Zahlungsstatus, erfasste Zahlungen und Reminder-Metadaten. Bankkonto- und Ausgabendaten werden nicht verwendet.
- Berücksichtigt die Prognose auch zukünftige Ausgaben?
- Nein. Die Vorschau konzentriert sich auf erwartete Zahlungseingänge aus vorhandenen Rechnungen. Gehälter, Steuern, Miete, Abonnements, geplante Käufe und Bankkontostände sind nicht Bestandteil der Prognose.
- Werden Teilzahlungen und überfällige Rechnungen berücksichtigt?
- Ja. Offene Beträge berücksichtigen erfasste Zahlungen einschließlich Teilzahlungen, und überfällige Forderungen werden separat ausgewiesen. payment_state unterstützt open, partially_paid, paid und overdue.
- Unterstützt die API Rechnungsdetails?
- Ja. Mit include_invoices=true werden paginierte Rechnungszeilen zurückgegeben, sodass Dashboards Prognosesummen auf einzelne Rechnungen herunterbrechen können.
- Erscheinen erzeugte E-Rechnungen automatisch im Cashflow?
- Nein. POST /api/v1/invoices/xrechnung, /peppol und /zugferd geben temporäre XML- oder PDF-Artefakte zurück, ohne eine Rechnung oder Kundenbeziehung zu speichern. Nutzen Sie die App oder POST /api/v1/invoices, wenn QuoteCash die Rechnung dauerhaft speichern, den Kunden zuordnen und im Cashflow berücksichtigen soll.
- Kann ich die Prognose auf ein bestimmtes Geschäft begrenzen?
- Jeder API-Key ist einem Geschäft zugeordnet. Ein übergebenes business_id muss mit dieser Zuordnung übereinstimmen; bei einer Abweichung antwortet die API mit 403 und fremde Geschäftsdaten können nicht abgerufen werden.
- Ist der Endpoint für Make.com oder n8n geeignet?
- Ja. Es ist ein normaler GET-Endpoint mit Datumsfiltern, Gruppierung und optionalem Rechnungsdetail und passt daher gut zu regelmäßigen Abrufen und Synchronisationsabläufen.
- Ist die API eine vollständige Liquiditätsplanung?
- Nein. Sie ist eine Forderungs- und Zahlungseingangsprognose aus gespeicherten Rechnungsdaten. Für eine vollständige Liquiditätsplanung müssten zusätzlich zukünftige Ausgaben, nicht fakturierte Einnahmen und Bankkontostände einfließen.
- Ist eine Zahlungseingangsprognose dasselbe wie Buchhaltung?
- Nein. Die Vorschau zeigt operative Erwartungswerte aus Rechnungs- und Zahlungsdaten. Sie ersetzt weder Finanzbuchhaltung noch vollständige Finanz- oder Liquiditätsplanung.
- Welche Währung unterstützt die Cashflow Forecast API?
- Die Cashflow Forecast API unterstützt derzeit ausschließlich Euro (EUR). Eine Währungsumrechnung oder konsolidierte Mehrwährungsberichte sind aktuell nicht Bestandteil der API.
- Warum sollte ich dafür eine API statt CSV nutzen?
- Eine API kann regelmäßig, gefiltert und automatisiert abgerufen werden. Das reduziert manuelle Exporte und macht Daten zu erwarteten Zahlungseingängen direkt in Tools nutzbar.