Auswertungen – API-Referenz

Exporte auflisten

GET/api/v1/exports

Query-Parameter

limitinteger
Anzahl Einträge (1–100)
1–100 · Standard: 25
cursorstring
`nextCursor` der vorherigen Seite
max. 500 Zeichen

Antwort 200

object"list"Pflicht
dataArray<Export>Pflicht
- idstringPflicht
- kind"datev"Pflicht
- fromstring (date)Pflicht
  Datum (YYYY-MM-DD)
- tostring (date)Pflicht
  Datum (YYYY-MM-DD)
- status"ready" | "failed"Pflicht
- includeobjectPflicht
  - bookingsbooleanPflicht
  - partnersbooleanPflicht
  - documentsbooleanPflicht
- countsobjectPflicht
  - entriesintegerPflicht
    -9007199254740991–9007199254740991
  - rowsintegerPflicht
    -9007199254740991–9007199254740991
  - partnersintegerPflicht
    -9007199254740991–9007199254740991
  - documentsintegerPflicht
    -9007199254740991–9007199254740991
- warningsArray<string>Pflicht
- fileNamestringPflicht
- sizeintegerPflicht
  -9007199254740991–9007199254740991
- errorstring | nullPflicht
- createdAtstring (date-time)Pflicht
  Zeitpunkt (ISO 8601)
hasMorebooleanPflicht
nextCursorstring | nullPflicht

Mögliche Fehler: 400, 401, 403, 429, 500

curl 'https://www.debt-flow.io/api/v1/exports' \
  -H "Authorization: Bearer $DEBTFLOW_API_KEY"

Antwort 200

{
  "object": "list",
  "data": [
    {
      "id": "string",
      "kind": "datev",
      "from": "2026-11-01",
      "to": "2026-11-01",
      "status": "ready",
      "include": {
        "bookings": false,
        "partners": false,
        "documents": false
      },
      "counts": {
        "entries": 0,
        "rows": 0,
        "partners": 0,
        "documents": 0
      },
      "warnings": [
        "string"
      ],
      "fileName": "string",
      "size": 0,
      "error": "string",
      "createdAt": "2026-11-01T09:30:00.000Z"
    }
  ],
  "hasMore": false,
  "nextCursor": "string"
}

Erzeugt ein ZIP mit DATEV-Buchungsstapel (EXTF, Formatversion 13), Debitoren/Kreditoren-Stammdaten und optional Belegbildern (document.xml, Verknüpfung über „Beleglink“). Zeitraum innerhalb eines Wirtschaftsjahres. Benötigt DATEV-Berater- und Mandantennummer in den Einstellungen. Ereignis export.ready.

Berechtigung: reports:read

Header

Idempotency-Keystring
Eindeutiger Schlüssel (8–255 Zeichen). Wiederholte Anfragen mit gleichem Schlüssel liefern 24 h lang dieselbe Antwort.
max. 255 Zeichen

Body (JSON) · ExportCreate

kind"datev"
Standard: "datev"
fromstring (date)Pflicht
Datum (YYYY-MM-DD)
tostring (date)Pflicht
Datum (YYYY-MM-DD)
includeobject
Standard: {"bookings":true,"partners":true,"documents":false}
- bookingsboolean
  Buchungsstapel
  Standard: true
- partnersboolean
  Debitoren/Kreditoren-Stammdaten
  Standard: true
- documentsboolean
  Belegbilder (PDF/Bilder) mit document.xml
  Standard: false

Antwort 201 · Export

idstringPflicht
kind"datev"Pflicht
fromstring (date)Pflicht
Datum (YYYY-MM-DD)
tostring (date)Pflicht
Datum (YYYY-MM-DD)
status"ready" | "failed"Pflicht
includeobjectPflicht
- bookingsbooleanPflicht
- partnersbooleanPflicht
- documentsbooleanPflicht
countsobjectPflicht
- entriesintegerPflicht
  -9007199254740991–9007199254740991
- rowsintegerPflicht
  -9007199254740991–9007199254740991
- partnersintegerPflicht
  -9007199254740991–9007199254740991
- documentsintegerPflicht
  -9007199254740991–9007199254740991
warningsArray<string>Pflicht
fileNamestringPflicht
sizeintegerPflicht
-9007199254740991–9007199254740991
errorstring | nullPflicht
createdAtstring (date-time)Pflicht
Zeitpunkt (ISO 8601)

Mögliche Fehler: 400, 401, 403, 409, 422, 429, 500

curl -X POST 'https://www.debt-flow.io/api/v1/exports' \
  -H "Authorization: Bearer $DEBTFLOW_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "kind": "datev",
  "from": "2026-11-01",
  "to": "2026-11-01",
  "include": {
    "bookings": true,
    "partners": true,
    "documents": false
  }
}'

Antwort 201

{
  "id": "string",
  "kind": "datev",
  "from": "2026-11-01",
  "to": "2026-11-01",
  "status": "ready",
  "include": {
    "bookings": false,
    "partners": false,
    "documents": false
  },
  "counts": {
    "entries": 0,
    "rows": 0,
    "partners": 0,
    "documents": 0
  },
  "warnings": [
    "string"
  ],
  "fileName": "string",
  "size": 0,
  "error": "string",
  "createdAt": "2026-11-01T09:30:00.000Z"
}

Export abrufen

GET/api/v1/exports/{id}

Berechtigung: reports:read

Pfadparameter

idstringPflicht
ID der Ressource
max. 128 Zeichen

Antwort 200 · Export

idstringPflicht
kind"datev"Pflicht
fromstring (date)Pflicht
Datum (YYYY-MM-DD)
tostring (date)Pflicht
Datum (YYYY-MM-DD)
status"ready" | "failed"Pflicht
includeobjectPflicht
- bookingsbooleanPflicht
- partnersbooleanPflicht
- documentsbooleanPflicht
countsobjectPflicht
- entriesintegerPflicht
  -9007199254740991–9007199254740991
- rowsintegerPflicht
  -9007199254740991–9007199254740991
- partnersintegerPflicht
  -9007199254740991–9007199254740991
- documentsintegerPflicht
  -9007199254740991–9007199254740991
warningsArray<string>Pflicht
fileNamestringPflicht
sizeintegerPflicht
-9007199254740991–9007199254740991
errorstring | nullPflicht
createdAtstring (date-time)Pflicht
Zeitpunkt (ISO 8601)

Mögliche Fehler: 400, 401, 403, 404, 429, 500

curl 'https://www.debt-flow.io/api/v1/exports/ID' \
  -H "Authorization: Bearer $DEBTFLOW_API_KEY"

Antwort 200

{
  "id": "string",
  "kind": "datev",
  "from": "2026-11-01",
  "to": "2026-11-01",
  "status": "ready",
  "include": {
    "bookings": false,
    "partners": false,
    "documents": false
  },
  "counts": {
    "entries": 0,
    "rows": 0,
    "partners": 0,
    "documents": 0
  },
  "warnings": [
    "string"
  ],
  "fileName": "string",
  "size": 0,
  "error": "string",
  "createdAt": "2026-11-01T09:30:00.000Z"
}

Exportdatei herunterladen (ZIP)

GET/api/v1/exports/{id}/download

Berechtigung: reports:read

Pfadparameter

idstringPflicht
ID der Ressource
max. 128 Zeichen

Antwort 200

Datei (application/zip).

Mögliche Fehler: 400, 401, 403, 404, 429, 500

curl 'https://www.debt-flow.io/api/v1/exports/ID/download' \
  -H "Authorization: Bearer $DEBTFLOW_API_KEY"

Einnahmenüberschussrechnung (Anlage EÜR)

GET/api/v1/reports/euer

Betriebseinnahmen und -ausgaben nach Kennzahlen der Anlage EÜR, ermittelt nach Zufluss/Abfluss (§ 11 EStG) – unabhängig von der Besteuerungsart. unmapped listet Erlös-/Aufwandskonten ohne Zuordnung.

Berechtigung: reports:read

Query-Parameter

yearintegerPflicht
2000–2100

Antwort 200 · EuerReport

kind"euer"Pflicht
yearintegerPflicht
-9007199254740991–9007199254740991
fromstring (date)Pflicht
Datum (YYYY-MM-DD)
tostring (date)Pflicht
Datum (YYYY-MM-DD)
labelstringPflicht
basis"cash" | "accrual"Pflicht
cash = Zahlungsbasis (Ist), accrual = Rechnungsbasis (Soll)
entryCountintegerPflicht
-9007199254740991–9007199254740991
closedbooleanPflicht
Zeitraum vollständig festgeschrieben
warningsArray<JournalIssue>Pflicht
- typeenumPflicht
  Werte: unbooked_receipt, unassigned_bank_transaction, unknown_category, payment_without_invoice, unsupported_tax, changed_after_closing, missing_after_closing
- sourceIdstringPflicht
- datestring (date)Pflicht
  Datum (YYYY-MM-DD)
- messagestringPflicht
- amountCentsinteger
  Betrag in Cent
  -100000000000–100000000000
linesArray<object>Pflicht
- kzstringPflicht
- labelstringPflicht
- sectionstringPflicht
- centsintegerPflicht
  Betrag in Cent
  -100000000000–100000000000
- sumbooleanPflicht
incomeCentsintegerPflicht
Betrag in Cent
-100000000000–100000000000
expenseCentsintegerPflicht
Betrag in Cent
-100000000000–100000000000
profitCentsintegerPflicht
Betrag in Cent
-100000000000–100000000000
unmappedArray<object>Pflicht
- accountstringPflicht
- labelstringPflicht
- centsintegerPflicht
  Betrag in Cent
  -100000000000–100000000000

Mögliche Fehler: 400, 401, 403, 429, 500

curl 'https://www.debt-flow.io/api/v1/reports/euer?year=2000' \
  -H "Authorization: Bearer $DEBTFLOW_API_KEY"

Antwort 200

{
  "kind": "euer",
  "year": 0,
  "from": "2026-11-01",
  "to": "2026-11-01",
  "label": "string",
  "basis": "cash",
  "entryCount": 0,
  "closed": false,
  "warnings": [
    {
      "type": "unbooked_receipt",
      "sourceId": "string",
      "date": "2026-11-01",
      "message": "string",
      "amountCents": 0
    }
  ],
  "lines": [
    {
      "kz": "string",
      "label": "string",
      "section": "string",
      "cents": 0,
      "sum": false
    }
  ],
  "incomeCents": 0,
  "expenseCents": 0,
  "profitCents": 0,
  "unmapped": [
    {
      "account": "string",
      "label": "string",
      "cents": 0
    }
  ]
}

EÜR als PDF

GET/api/v1/reports/euer/pdf

Berechtigung: reports:read

Query-Parameter

yearintegerPflicht
2000–2100

Antwort 200

Datei (application/pdf).

Mögliche Fehler: 400, 401, 403, 429, 500

curl 'https://www.debt-flow.io/api/v1/reports/euer/pdf?year=2000' \
  -H "Authorization: Bearer $DEBTFLOW_API_KEY"

Offene Posten

GET/api/v1/reports/open-items

Offene Forderungen (festgeschriebene Rechnungen abzüglich Zahlungen) oder offene Verbindlichkeiten (gebuchte, unbezahlte Belege) zum Stichtag, mit Altersstruktur nach Fälligkeit.

Berechtigung: reports:read

Query-Parameter

kind"receivables" | "payables"
Standard: "receivables"
asOfstring (date)
Stichtag (Standard: heute)

Antwort 200 · OpenItems

kind"receivables" | "payables"Pflicht
asOfstring (date)Pflicht
Datum (YYYY-MM-DD)
itemsArray<object>Pflicht
- idstringPflicht
- kind"receivable" | "payable"Pflicht
- numberstringPflicht
- namestringPflicht
- datestring (date)Pflicht
  Datum (YYYY-MM-DD)
- dueDatestring (date) | nullPflicht
  Datum (YYYY-MM-DD)
- grossCentsintegerPflicht
  Betrag in Cent
  -100000000000–100000000000
- openCentsintegerPflicht
  Betrag in Cent
  -100000000000–100000000000
- daysOverdueintegerPflicht
  -9007199254740991–9007199254740991
- bucket"not_due" | "d1_30" | "d31_60" | "d61_90" | "d90_plus"Pflicht
totalsobjectPflicht
- not_dueintegerPflicht
  Betrag in Cent
  -100000000000–100000000000
- d1_30integerPflicht
  Betrag in Cent
  -100000000000–100000000000
- d31_60integerPflicht
  Betrag in Cent
  -100000000000–100000000000
- d61_90integerPflicht
  Betrag in Cent
  -100000000000–100000000000
- d90_plusintegerPflicht
  Betrag in Cent
  -100000000000–100000000000
- totalCentsintegerPflicht
  Betrag in Cent
  -100000000000–100000000000

Mögliche Fehler: 400, 401, 403, 429, 500

curl 'https://www.debt-flow.io/api/v1/reports/open-items' \
  -H "Authorization: Bearer $DEBTFLOW_API_KEY"

Antwort 200

{
  "kind": "receivables",
  "asOf": "2026-11-01",
  "items": [
    {
      "id": "string",
      "kind": "receivable",
      "number": "string",
      "name": "string",
      "date": "2026-11-01",
      "dueDate": "2026-11-01",
      "grossCents": 0,
      "openCents": 0,
      "daysOverdue": 0,
      "bucket": "not_due"
    }
  ],
  "totals": {
    "not_due": 0,
    "d1_30": 0,
    "d31_60": 0,
    "d61_90": 0,
    "d90_plus": 0,
    "totalCents": 0
  }
}

Umsatz und Kosten

GET/api/v1/reports/summary

Erlöse und Aufwand (netto) je Monat und je Konto aus dem Buchungsjournal.

Berechtigung: reports:read

Query-Parameter

fromstring (date)Pflicht
Datum (YYYY-MM-DD)
tostring (date)Pflicht
Datum (YYYY-MM-DD)

Antwort 200 · AccountingSummary

fromstring (date)Pflicht
Datum (YYYY-MM-DD)
tostring (date)Pflicht
Datum (YYYY-MM-DD)
labelstringPflicht
basis"cash" | "accrual"Pflicht
cash = Zahlungsbasis (Ist), accrual = Rechnungsbasis (Soll)
entryCountintegerPflicht
-9007199254740991–9007199254740991
closedbooleanPflicht
Zeitraum vollständig festgeschrieben
warningsArray<JournalIssue>Pflicht
- typeenumPflicht
  Werte: unbooked_receipt, unassigned_bank_transaction, unknown_category, payment_without_invoice, unsupported_tax, changed_after_closing, missing_after_closing
- sourceIdstringPflicht
- datestring (date)Pflicht
  Datum (YYYY-MM-DD)
- messagestringPflicht
- amountCentsinteger
  Betrag in Cent
  -100000000000–100000000000
monthsArray<object>Pflicht
- monthstringPflicht
- revenueCentsintegerPflicht
  Betrag in Cent
  -100000000000–100000000000
- expenseCentsintegerPflicht
  Betrag in Cent
  -100000000000–100000000000
- resultCentsintegerPflicht
  Betrag in Cent
  -100000000000–100000000000
revenueByAccountArray<object>Pflicht
- accountstringPflicht
- labelstringPflicht
- centsintegerPflicht
  Betrag in Cent
  -100000000000–100000000000
expenseByAccountArray<object>Pflicht
- accountstringPflicht
- labelstringPflicht
- centsintegerPflicht
  Betrag in Cent
  -100000000000–100000000000
revenueCentsintegerPflicht
Betrag in Cent
-100000000000–100000000000
expenseCentsintegerPflicht
Betrag in Cent
-100000000000–100000000000
resultCentsintegerPflicht
Betrag in Cent
-100000000000–100000000000

Mögliche Fehler: 400, 401, 403, 429, 500

curl 'https://www.debt-flow.io/api/v1/reports/summary?from=2026-11-01&to=2026-11-01' \
  -H "Authorization: Bearer $DEBTFLOW_API_KEY"

Antwort 200

{
  "from": "2026-11-01",
  "to": "2026-11-01",
  "label": "string",
  "basis": "cash",
  "entryCount": 0,
  "closed": false,
  "warnings": [
    {
      "type": "unbooked_receipt",
      "sourceId": "string",
      "date": "2026-11-01",
      "message": "string",
      "amountCents": 0
    }
  ],
  "months": [
    {
      "month": "string",
      "revenueCents": 0,
      "expenseCents": 0,
      "resultCents": 0
    }
  ],
  "revenueByAccount": [
    {
      "account": "string",
      "label": "string",
      "cents": 0
    }
  ],
  "expenseByAccount": [
    {
      "account": "string",
      "label": "string",
      "cents": 0
    }
  ],
  "revenueCents": 0,
  "expenseCents": 0,
  "resultCents": 0
}

Summen- und Saldenliste

GET/api/v1/reports/trial-balance

Soll, Haben und Saldo je Konto (inkl. Steuer- und Personenkonten) für den Zeitraum.

Berechtigung: reports:read

Query-Parameter

fromstring (date)Pflicht
Datum (YYYY-MM-DD)
tostring (date)Pflicht
Datum (YYYY-MM-DD)

Antwort 200 · TrialBalance

fromstring (date)Pflicht
Datum (YYYY-MM-DD)
tostring (date)Pflicht
Datum (YYYY-MM-DD)
labelstringPflicht
basis"cash" | "accrual"Pflicht
cash = Zahlungsbasis (Ist), accrual = Rechnungsbasis (Soll)
entryCountintegerPflicht
-9007199254740991–9007199254740991
closedbooleanPflicht
Zeitraum vollständig festgeschrieben
warningsArray<JournalIssue>Pflicht
- typeenumPflicht
  Werte: unbooked_receipt, unassigned_bank_transaction, unknown_category, payment_without_invoice, unsupported_tax, changed_after_closing, missing_after_closing
- sourceIdstringPflicht
- datestring (date)Pflicht
  Datum (YYYY-MM-DD)
- messagestringPflicht
- amountCentsinteger
  Betrag in Cent
  -100000000000–100000000000
rowsArray<object>Pflicht
- accountstringPflicht
- labelstringPflicht
- typestringPflicht
- debitCentsintegerPflicht
  Betrag in Cent
  -100000000000–100000000000
- creditCentsintegerPflicht
  Betrag in Cent
  -100000000000–100000000000
- balanceCentsintegerPflicht
  Betrag in Cent
  -100000000000–100000000000

Mögliche Fehler: 400, 401, 403, 429, 500

curl 'https://www.debt-flow.io/api/v1/reports/trial-balance?from=2026-11-01&to=2026-11-01' \
  -H "Authorization: Bearer $DEBTFLOW_API_KEY"

Antwort 200

{
  "from": "2026-11-01",
  "to": "2026-11-01",
  "label": "string",
  "basis": "cash",
  "entryCount": 0,
  "closed": false,
  "warnings": [
    {
      "type": "unbooked_receipt",
      "sourceId": "string",
      "date": "2026-11-01",
      "message": "string",
      "amountCents": 0
    }
  ],
  "rows": [
    {
      "account": "string",
      "label": "string",
      "type": "string",
      "debitCents": 0,
      "creditCents": 0,
      "balanceCents": 0
    }
  ]
}

Umsatzsteuer-Voranmeldung (Kennzahlen)

GET/api/v1/reports/vat-return

Kennzahlen der USt-VA (u. a. Kz 81, 86, 35/36, 41, 43, 21, 45, 60, 46/47, 84/85, 89, 93, 66, 61, 62, 67, 39, 83) für Monat, Quartal oder Jahr aus dem Buchungsjournal (Soll- oder Ist-Versteuerung laut Einstellung). Bemessungsgrundlagen in vollen Euro. Keine Übermittlung an ELSTER.

Berechtigung: reports:read

Query-Parameter

yearintegerPflicht
2000–2100
periodenumPflicht
M01–M12 (Monat), Q1–Q4 (Quartal) oder Y (Jahr)
Werte: M01, M02, M03, M04, M05, M06, M07, M08, M09, M10, M11, M12, Q1, Q2, Q3, Q4, Y

Antwort 200 · VatReturn

kind"ustva"Pflicht
yearintegerPflicht
-9007199254740991–9007199254740991
periodenumPflicht
Werte: M01, M02, M03, M04, M05, M06, M07, M08, M09, M10, M11, M12, Q1, Q2, Q3, Q4, Y
fromstring (date)Pflicht
Datum (YYYY-MM-DD)
tostring (date)Pflicht
Datum (YYYY-MM-DD)
labelstringPflicht
basis"cash" | "accrual"Pflicht
cash = Zahlungsbasis (Ist), accrual = Rechnungsbasis (Soll)
entryCountintegerPflicht
-9007199254740991–9007199254740991
closedbooleanPflicht
Zeitraum vollständig festgeschrieben
warningsArray<JournalIssue>Pflicht
- typeenumPflicht
  Werte: unbooked_receipt, unassigned_bank_transaction, unknown_category, payment_without_invoice, unsupported_tax, changed_after_closing, missing_after_closing
- sourceIdstringPflicht
- datestring (date)Pflicht
  Datum (YYYY-MM-DD)
- messagestringPflicht
- amountCentsinteger
  Betrag in Cent
  -100000000000–100000000000
linesArray<object>Pflicht
- kzstringPflicht
- labelstringPflicht
- baseCentsinteger | nullPflicht
  Bemessungsgrundlage (volle Euro, in Cent)
  -100000000000–100000000000
- taxCentsinteger | nullPflicht
  Betrag in Cent
  -100000000000–100000000000
payableCentsintegerPflicht
Kz 83: positiv = Zahllast, negativ = Erstattung
-100000000000–100000000000
bookedOutputTaxCentsintegerPflicht
Betrag in Cent
-100000000000–100000000000
inputTaxCentsintegerPflicht
Betrag in Cent
-100000000000–100000000000
explanationArray<string>Pflicht
smallBusinessbooleanPflicht

Mögliche Fehler: 400, 401, 403, 429, 500

curl 'https://www.debt-flow.io/api/v1/reports/vat-return?year=2000&period=M01' \
  -H "Authorization: Bearer $DEBTFLOW_API_KEY"

Antwort 200

{
  "kind": "ustva",
  "year": 0,
  "period": "M01",
  "from": "2026-11-01",
  "to": "2026-11-01",
  "label": "string",
  "basis": "cash",
  "entryCount": 0,
  "closed": false,
  "warnings": [
    {
      "type": "unbooked_receipt",
      "sourceId": "string",
      "date": "2026-11-01",
      "message": "string",
      "amountCents": 0
    }
  ],
  "lines": [
    {
      "kz": "string",
      "label": "string",
      "baseCents": 0,
      "taxCents": 0
    }
  ],
  "payableCents": 0,
  "bookedOutputTaxCents": 0,
  "inputTaxCents": 0,
  "explanation": [
    "string"
  ],
  "smallBusiness": false
}

Umsatzsteuer-Voranmeldung als PDF

GET/api/v1/reports/vat-return/pdf

Kennzahlen mit Erläuterungen als PDF für die eigenen Unterlagen bzw. den Steuerberater.

Berechtigung: reports:read

Query-Parameter

yearintegerPflicht
2000–2100
periodenumPflicht
M01–M12 (Monat), Q1–Q4 (Quartal) oder Y (Jahr)
Werte: M01, M02, M03, M04, M05, M06, M07, M08, M09, M10, M11, M12, Q1, Q2, Q3, Q4, Y

Antwort 200

Datei (application/pdf).

Mögliche Fehler: 400, 401, 403, 429, 500

curl 'https://www.debt-flow.io/api/v1/reports/vat-return/pdf?year=2000&period=M01' \
  -H "Authorization: Bearer $DEBTFLOW_API_KEY"

Gespeicherte Auswertungen auflisten

GET/api/v1/tax-reports

Berechtigung: reports:read

Query-Parameter

limitinteger
Anzahl Einträge (1–100)
1–100 · Standard: 25
cursorstring
`nextCursor` der vorherigen Seite
max. 500 Zeichen

Antwort 200

object"list"Pflicht
dataArray<TaxReport>Pflicht
- idstringPflicht
- kind"ustva" | "euer"Pflicht
- yearintegerPflicht
  -9007199254740991–9007199254740991
- periodenum | nullPflicht
  Werte: M01, M02, M03, M04, M05, M06, M07, M08, M09, M10, M11, M12, Q1, Q2, Q3, Q4, Y
- labelstringPflicht
- fromstring (date)Pflicht
  Datum (YYYY-MM-DD)
- tostring (date)Pflicht
  Datum (YYYY-MM-DD)
- basis"cash" | "accrual"Pflicht
- linesArray<object>Pflicht
  - kzstringPflicht
  - labelstringPflicht
  - baseCentsinteger | nullPflicht
    Betrag in Cent
    -100000000000–100000000000
  - taxCentsinteger | nullPflicht
    Betrag in Cent
    -100000000000–100000000000
- resultCentsintegerPflicht
  USt-VA: Kz 83, EÜR: Gewinn/Verlust
  -100000000000–100000000000
- notestringPflicht
- contentHashstringPflicht
- createdByActorPflicht
  - type"user" | "api_key" | "oauth" | "system"Pflicht
  - idstringPflicht
  - labelstring
- createdAtstring (date-time)Pflicht
  Zeitpunkt (ISO 8601)
hasMorebooleanPflicht
nextCursorstring | nullPflicht

Mögliche Fehler: 400, 401, 403, 429, 500

curl 'https://www.debt-flow.io/api/v1/tax-reports' \
  -H "Authorization: Bearer $DEBTFLOW_API_KEY"

Antwort 200

{
  "object": "list",
  "data": [
    {
      "id": "string",
      "kind": "ustva",
      "year": 0,
      "period": "M01",
      "label": "string",
      "from": "2026-11-01",
      "to": "2026-11-01",
      "basis": "cash",
      "lines": [
        {
          "kz": "string",
          "label": "string",
          "baseCents": null,
          "taxCents": null
        }
      ],
      "resultCents": 0,
      "note": "string",
      "contentHash": "string",
      "createdBy": {
        "type": "user",
        "id": "string",
        "label": "string"
      },
      "createdAt": "2026-11-01T09:30:00.000Z"
    }
  ],
  "hasMore": false,
  "nextCursor": "string"
}

Auswertung unveränderbar speichern

POST/api/v1/tax-reports

Speichert die aktuelle USt-VA (kind: ustva, period) oder EÜR als unveränderbaren Stand mit Prüfsumme, z. B. nach Übertragung in ELSTER. Die Übermittlung an das Finanzamt erfolgt nicht durch DebtFlow.

Berechtigung: accounting:write

Header

Idempotency-Keystring
Eindeutiger Schlüssel (8–255 Zeichen). Wiederholte Anfragen mit gleichem Schlüssel liefern 24 h lang dieselbe Antwort.
max. 255 Zeichen

Body (JSON) · TaxReportCreate

kind"ustva" | "euer"Pflicht
yearintegerPflicht
2000–2100
periodenum
nur USt-VA
Werte: M01, M02, M03, M04, M05, M06, M07, M08, M09, M10, M11, M12, Q1, Q2, Q3, Q4, Y
notestring
z. B. „an ELSTER übermittelt am …, Transferticket …“
max. 500 Zeichen · Standard: ""

Antwort 201 · TaxReport

idstringPflicht
kind"ustva" | "euer"Pflicht
yearintegerPflicht
-9007199254740991–9007199254740991
periodenum | nullPflicht
Werte: M01, M02, M03, M04, M05, M06, M07, M08, M09, M10, M11, M12, Q1, Q2, Q3, Q4, Y
labelstringPflicht
fromstring (date)Pflicht
Datum (YYYY-MM-DD)
tostring (date)Pflicht
Datum (YYYY-MM-DD)
basis"cash" | "accrual"Pflicht
linesArray<object>Pflicht
- kzstringPflicht
- labelstringPflicht
- baseCentsinteger | nullPflicht
  Betrag in Cent
  -100000000000–100000000000
- taxCentsinteger | nullPflicht
  Betrag in Cent
  -100000000000–100000000000
resultCentsintegerPflicht
USt-VA: Kz 83, EÜR: Gewinn/Verlust
-100000000000–100000000000
notestringPflicht
contentHashstringPflicht
createdByActorPflicht
- type"user" | "api_key" | "oauth" | "system"Pflicht
- idstringPflicht
- labelstring
createdAtstring (date-time)Pflicht
Zeitpunkt (ISO 8601)

Mögliche Fehler: 400, 401, 403, 409, 422, 429, 500

curl -X POST 'https://www.debt-flow.io/api/v1/tax-reports' \
  -H "Authorization: Bearer $DEBTFLOW_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "kind": "ustva",
  "year": 2000,
  "period": "M01",
  "note": ""
}'

Antwort 201

{
  "id": "string",
  "kind": "ustva",
  "year": 0,
  "period": "M01",
  "label": "string",
  "from": "2026-11-01",
  "to": "2026-11-01",
  "basis": "cash",
  "lines": [
    {
      "kz": "string",
      "label": "string",
      "baseCents": 0,
      "taxCents": 0
    }
  ],
  "resultCents": 0,
  "note": "string",
  "contentHash": "string",
  "createdBy": {
    "type": "user",
    "id": "string",
    "label": "string"
  },
  "createdAt": "2026-11-01T09:30:00.000Z"
}

Gespeicherte Auswertung abrufen

GET/api/v1/tax-reports/{id}

Berechtigung: reports:read

Pfadparameter

idstringPflicht
ID der Ressource
max. 128 Zeichen

Antwort 200 · TaxReport

idstringPflicht
kind"ustva" | "euer"Pflicht
yearintegerPflicht
-9007199254740991–9007199254740991
periodenum | nullPflicht
Werte: M01, M02, M03, M04, M05, M06, M07, M08, M09, M10, M11, M12, Q1, Q2, Q3, Q4, Y
labelstringPflicht
fromstring (date)Pflicht
Datum (YYYY-MM-DD)
tostring (date)Pflicht
Datum (YYYY-MM-DD)
basis"cash" | "accrual"Pflicht
linesArray<object>Pflicht
- kzstringPflicht
- labelstringPflicht
- baseCentsinteger | nullPflicht
  Betrag in Cent
  -100000000000–100000000000
- taxCentsinteger | nullPflicht
  Betrag in Cent
  -100000000000–100000000000
resultCentsintegerPflicht
USt-VA: Kz 83, EÜR: Gewinn/Verlust
-100000000000–100000000000
notestringPflicht
contentHashstringPflicht
createdByActorPflicht
- type"user" | "api_key" | "oauth" | "system"Pflicht
- idstringPflicht
- labelstring
createdAtstring (date-time)Pflicht
Zeitpunkt (ISO 8601)

Mögliche Fehler: 400, 401, 403, 404, 429, 500

curl 'https://www.debt-flow.io/api/v1/tax-reports/ID' \
  -H "Authorization: Bearer $DEBTFLOW_API_KEY"

Antwort 200

{
  "id": "string",
  "kind": "ustva",
  "year": 0,
  "period": "M01",
  "label": "string",
  "from": "2026-11-01",
  "to": "2026-11-01",
  "basis": "cash",
  "lines": [
    {
      "kz": "string",
      "label": "string",
      "baseCents": 0,
      "taxCents": 0
    }
  ],
  "resultCents": 0,
  "note": "string",
  "contentHash": "string",
  "createdBy": {
    "type": "user",
    "id": "string",
    "label": "string"
  },
  "createdAt": "2026-11-01T09:30:00.000Z"
}

Gespeicherte Auswertung als PDF

GET/api/v1/tax-reports/{id}/pdf

Berechtigung: reports:read

Pfadparameter

idstringPflicht
ID der Ressource
max. 128 Zeichen

Antwort 200

Datei (application/pdf).

Mögliche Fehler: 400, 401, 403, 404, 429, 500

curl 'https://www.debt-flow.io/api/v1/tax-reports/ID/pdf' \
  -H "Authorization: Bearer $DEBTFLOW_API_KEY"