Steuerberichte

Ein Steuerbericht in xTool stellt regulatorische oder steuermelderelevante Daten für eine Organisation dar. Er ist eine eigenständige Entität und kann Daten aus mehreren Quellen aggregieren.

Steuerberichte werden typischerweise von der Plattform angelegt (z. B. während der Frankreich-Verarbeitung). Die öffentliche API ist nur lesend: Sie können Berichte auflisten und abrufen, aber nicht per API anlegen oder aktualisieren.

Quellen

Jeder Steuerbericht kann Quellen auflisten — die Geschäftsobjekte, aus denen er aufgebaut wurde.

Form der Quelle in der API:

So bleiben Rechnungen, Zahlungen und Berichte lose gekoppelt, während weiterhin sichtbar ist, wie ein Bericht zusammengesetzt wurde.

Bezug zu Dokumenten und Transaktionen

• Ein Steuerbericht ist kein Dokument und keine Transaktion.
• Ein Bericht kann später durch Dokumente repräsentiert werden (über Dokumentverbindungen), wenn eine Dateidarstellung benötigt wird.
• Wenn ein solches Dokument gesendet oder empfangen wird, nutzt diese Kommunikation ihre eigene Transaktion.
• Frankreich-Rechnungs-Transaktionen können den zugehörigen Steuerbericht-Lebenszyklus trotzdem als Transaktions-Events zeigen (z. B. france.tax_report.send), während die Steuerbericht-Entität selbst getrennt bleibt.

Siehe Transaktionen und Rechnungen senden und empfangen.

Wie Frankreich-Berichte erscheinen (Überblick)

Je nach Szenario kann xTool Steuerberichte anlegen, wenn:

• die rechnungsseitige Steuermeldung als Teil der Frankreich-Rechnungsverarbeitung läuft, oder
• periodische / ledger-basierte Meldung geeignete Rechnungen (und zugehörige Daten) später aggregiert

Grenzüberschreitendes B2B und B2C stützen sich oft stärker auf spätere Aggregation; die Inland-B2B-Meldung ist häufiger an die Rechnungsverarbeitung gekoppelt. Der genaue Zeitpunkt hängt von Konfiguration und Provider-Abläufen ab.

Bezug zu Zahlungen

Zahlungen, die Rechnungen zugeordnet sind, können Berichtsquellen werden, wenn e-Reporting neben Rechnungsdaten auch Zahlungsdaten benötigt.

API-Übersicht

Es gibt keine öffentlichen Create-/Update-/Delete-Endpunkte für Steuerberichte.

Beispiel Get-Antwort (Form):

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

{
  "id": "tax-report-uuid",
  "organisation_id": "organisation-uuid",
  "sources": [
    {
      "id": "source-uuid",
      "source_type": "document",
      "source_id": "document-uuid"
    }
  ],
  "created_at": "2026-08-10T08:00:00Z",
  "updated_at": "2026-08-10T08:00:00Z"
}