Steuereinstellungsberichte

Konfigurieren Sie Ihre Steuereinstellungsberichte, um die Übermittlung von Steuerberichten an die Steuerbehörde Ihres Landes zu ermöglichen. Sie können diese Einstellungen nach Bedarf auflisten, erstellen, aktualisieren und löschen.

Die B2Brouter API unterstützt derzeit Steuereinstellungsberichte für die folgenden Länder:

[BETA] Frankreich (DGFiP - Direction Générale des Finances Publiques)
Spanien (Verifactu und TicketBAI)
Italien (SDI - Sistema di Interscambio)
Malaysia (LHDN - Lembaga Hasil Dalam Negeri)

Steuereinstellungsberichte einrichten

B2Brouter erlaubt die Einrichtung von Steuereinstellungsberichten nur für Steuerbehörden innerhalb Ihres Landes. Sie müssen das Feld start_date festlegen, um zu konfigurieren, wann die Steuerberichterstattung beginnt. Wenn das Feld start_date nicht gesetzt ist, nimmt B2Brouter den aktuellen Tag an.

Automatisch generieren

Sie können Steuerberichte automatisch generieren lassen, nachdem die Rechnung gesendet wurde, indem Sie auto_generate über die JSON Payload konfigurieren. Einige Steuerbehörden verlangen aus rechtlichen Gründen, dass der Steuerbericht unmittelbar nach dem Versand der Rechnung erstellt wird. In diesem Fall können Sie die automatische Generierung des Steuerberichts nicht konfigurieren.

Wenn Sie jeden Steuerbericht manuell generieren möchten, setzen Sie auto_generate auf false.

Automatisch senden

Wenn Sie die automatische Generierung von Steuerberichten aktiviert haben, können Sie mit auto_send auch den Versandprozess automatisieren. Sobald der Steuerbericht erstellt wurde, wird er automatisch an die Steuerbehörde gesendet.

Besondere Anforderungen

Jede Steuerbehörde in jedem Land kann unterschiedliche besondere Einstellungen zur Einhaltung der Vorschriften verlangen.

[BETA] Frankreich

Das Erstellen einer DGFiP-Steuereinstellung löst den vollständigen Onboarding-Prozess für die französische E-Rechnungsreform aus. Wenn die Einstellung mit enabled: true erstellt wird, registriert B2Brouter Ihr Unternehmen automatisch im Annuaire (Verzeichnis) des PPF und erstellt einen Peppol-0225-Transport zum Empfang von Rechnungen.

Sie können den Parameter auto_generate nicht konfigurieren, da dieser aus rechtlichen Gründen automatisch auf true gesetzt wird. Ebenso ist auto_send standardmäßig auf true gesetzt.

Ausführliche Anweisungen zum vollständigen französischen E-Invoicing-Workflow finden Sie im Leitfaden [BETA] DGFiP e-Invoicing and e-Reporting.

Beispiel:

curl --request GET \
  --url https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/tax_report_settings \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json' \
  --data '{
    "tax_report_setting": {
      "code": "dgfip",
      "start_date": "2026-09-01",
      "type_operation": "services",
      "email": "tax-notifications@exemplar.fr",
      "enterprise_size": "pme",
      "naf_code": "62"
    }
  }'

Erklärung der Felder:

type_operation: Art Ihrer Geschäftstätigkeit (services, goods oder mixed). Bestimmt den im PPF-Flux verwendeten Prozesscode.
email: Kontakt-E-Mail für steuerbezogene Benachrichtigungen.
enterprise_size: Größe des Unternehmens. Zulässige Werte: ge (groß), eti (mittelgroß), pme (KMU), micro. Erforderlich, außer wenn annuaire_only auf true gesetzt ist.
naf_code: Zweistelliger französischer NAF-Aktivitätscode (z. B. 62 für IT-Dienstleistungen). Erforderlich, außer wenn annuaire_only auf true gesetzt ist.
annuaire_only (boolean, optional): Wenn true, registriert B2Brouter das Unternehmen nur im PPF-Annuaire und aktiviert den Peppol-Empfang, ohne Steuerberichte zu generieren.

Italien

SDI hat keine besonderen Anforderungen zur Einrichtung der Steuereinstellungen. Sie müssen lediglich die Einstellung erstellen und mit der Steuerberichterstattung beginnen.

Beispiel:

curl --request GET \
  --url https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/tax_report_settings \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json' \
  --data '{
    "tax_report_setting": {
      "code": "sdi",
      "start_date": "2024-06-06",
      "auto_generate": true,
      "auto_send": true
    }
  }'

Spanien

Verifactu

Verifactu akzeptiert mehrere besondere Einstellungen, die Standardwerte für bestimmte Elemente wie den special_regime_key definieren. Sie können den Parameter auto_generate nicht konfigurieren, da dieser aufgrund gesetzlicher Anforderungen von Verifactu automatisch auf true gesetzt wird und den Steuerbericht vor Ausstellung der Rechnung generiert.

Beispiel:

curl --request GET \
  --url https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/tax_report_settings \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json' \
  --data '{
    "tax_report_setting": {
      "code": "verifactu",
      "start_date": "2025-06-06",
      "auto_generate": true,
      "auto_send": true,
      "reason_vat_exempt": "E1",
      "special_regime_key": "01",
      "reason_no_subject": "N1",
      "credit_note_code": "R1",
      "type_operation": "services"
    }
  }'

TicketBAI

TicketBAI hat einige besondere Einstellungen. Beim Erstellen der Steuereinstellung müssen Sie die delegation angeben, an die Sie Ihre Steuern melden werden (Araba, Gipuzkoa, Bizkaia), und die speziellen Felder für TicketBAI setzen.

Sie können den Parameter auto_generate nicht konfigurieren, da dieser aufgrund gesetzlicher Anforderungen von TicketBAI automatisch auf true gesetzt wird und den Steuerbericht erstellt, sobald die Rechnung den Status „gesendet“ erreicht hat.

Außerdem hat jede baskische Provinzvertretung besondere Anforderungen:

Bizkaia: Sie müssen die epigraph Ihres Unternehmens angeben, um den korrekten Steuerbericht generieren zu können.
Gipuzkoa: Um Steuerberichte senden zu können, müssen Sie die folgenden Dokumente an die Provinzverwaltung von Gipuzkoa ausfüllen und senden:
- Provinzverordnung zur Genehmigung der Bedingungen der sozialen Zusammenarbeit beim Versand von TicketBAI-Dateien, die im Rahmen der TicketBAI-Verpflichtung erstellt werden. Download
- Genehmigung zum Versand der TicketBAI-Dateien, die zur Erfüllung der TicketBAI-Verpflichtung erstellt werden. Download
- Sie müssen die Daten aus diesen Formularen in die Computersysteme der Provinzsteuerbehörde integrieren. Wenn die angegebenen Daten nicht enthalten sind, werden die gesendeten Dokumente von der Provinzverwaltung von Gipuzkoa abgelehnt.

Beispiel:

curl --request GET \
  --url https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/tax_report_settings \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json' \
  --data '{
    "tax_report_setting": {
      "code": "tbai",
      "start_date": "2024-06-06",
      "auto_generate": true,
      "auto_send": true,
      "delegation": "gipuzkoa",
      "reason_vat_exempt": "E1",
      "special_regime_key": "01",
      "reason_no_subject": "OT",
      "credit_note_code": "R1",
      "type_operation": "services",
      "epigraph": "147410"
    }
  }'

Malaysia

Um Ihre Steuerberichte an LHDN zu senden, muss B2Brouter als Vermittler-ERP im MyInvois-Portal registriert werden. Diese Registrierung ist erforderlich, um uns zu autorisieren, Steuerberichte in Ihrem Namen einzureichen. Detaillierte Anweisungen finden Sie hier.

Sobald B2Brouter als Vermittler-ERP für Ihr Steuerprofil im MyInvois-Portal registriert ist, können Sie die LHDN-Steuerberichtseinstellungen in Ihrem B2Brouter-Konto aktivieren, um Rechnungen an LHDN zu melden.

Beispiel:

curl --request GET \
  --url https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/tax_report_settings \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json' \
  --data '{
    "tax_report_setting": {
      "code": "lhdn",
      "msic": "01111",
      "type_operation": "services",
      "classification_code": "001"
    }
  }'

Erklärung der Felder:

msic: Malaysischer Geschäftsklassifizierungscode, erforderlich von LHDN.
type_operation: Art Ihrer Geschäftstätigkeit (Dienstleistungen oder Waren). Wird standardmäßig verwendet, wenn dieser Wert nicht in Ihrer Rechnung angegeben ist.
classification_code: Spezifischer Code für Ihre Produktkategorie. Wird standardmäßig verwendet, wenn dieser Wert nicht in Ihrer Rechnung angegeben ist.

Steuereinstellungsberichte ändern

Sobald Sie Ihre Einstellungen eingerichtet haben, können Sie diese ändern, falls Sie einen Fehler gemacht haben oder bestimmte Parameter ändern möchten. Beachten Sie jedoch, dass Sie nach Erreichen des start_date einige Parameter nicht mehr ändern können.

TicketBAI

Wenn Ihr Steuerberichtszeitraum begonnen hat, können Sie die für TicketBAI konfigurierte delegation nicht mehr ändern.

Steuereinstellungsberichte löschen

Falls Sie Ihre Steuereinstellung aus irgendeinem Grund löschen möchten, beachten Sie bitte, dass Sie die Einstellungen nicht mehr löschen können, sobald der erste Steuerbericht aus einer Ihrer Rechnungen erstellt wurde. Diese Einschränkung gilt aufgrund gesetzlicher Anforderungen der Steuerbehörden. Beim Auflisten aller oder Abrufen einer einzelnen Steuereinstellung zeigt das Feld locked an, ob bereits Steuerberichte mit dieser Einstellung erstellt wurden.

Steuerberichte senden

Nach der Konfiguration Ihrer Steuereinstellungen können Sie ab dem Tag des start_date Steuerberichte generieren und senden. Weitere Informationen zu den einzelnen Steuerberichtstypen finden Sie in den entsprechenden Leitfäden: