Steuerbericht

Steuern-Attribute (`taxes_attributes`)

Dieser Leitfaden erklärt, wie Sie das Array taxes_attributes beim Erstellen von Rechnungen über die API korrekt ausfüllen, damit Integratoren wissen, welche Steuernamen und -kategorien pro Land erwartet werden.

Wichtig

Die angezeigten Prozentsätze sind B2Brouter-Standards, um die Integration zu erleichtern; Steuersätze können sich ändern. Validieren Sie immer gegen das aktuelle Recht des jeweiligen Landes.

Steuernamen müssen den in diesem Leitfaden erwarteten Werten entsprechen. Erfinden Sie keine neuen Namen (z. B. "Exento", "Umsatzsteuer", "Sales tax").

Viele Formate verwenden comment als Befreiungsgrund/“nicht steuerpflichtig”. Füllen Sie es aus, wenn Sie 0%/befreit/Reverse Charge festlegen, es sei denn, Ihr Konto hat bereits den richtigen Standardgrund.

Verwenden Sie diesen Leitfaden zusammen mit:

Wichtige Punkte

Verwenden Sie in jedem taxes_attributes-Objekt nur diese Felder: name (Zeichenkette), category (Zeichenkette, Enum), percent (Float), comment (Zeichenkette oder null). Keine anderen Schlüssel wie amount, base, type usw.
Prozentsätze sind Standards, die wir erwarten; Gesetze ändern sich. Wenn Ihr Geschäftsfall einen anderen Satz verwendet, senden Sie diesen Satz, behalten Sie aber den korrekten name und category.
Verwenden Sie für Quellensteuer/Abzüge negative percent und den entsprechenden Steuernamen (IRPF, IRNR, IRPEF usw.).
comment wird in vielen Formaten als Befreiungsgrund/“nicht steuerpflichtig” verwendet (Facturae/Verifactu, Peppol-Kategorien usw.). Geben Sie einen Grund an, wenn percent 0 ist und der Vorgang befreit/nicht steuerpflichtig/Reverse Charge ist (Beispiel: comment: "E2").
Kontoeinstellungen wirken sich auf die Berechnung aus: apply_taxes_per_line (Boolean) steuert, ob Steuern pro Zeile oder auf die Summe angewendet werden; rounding_method steuert die Rundung.

Struktur von `taxes_attributes`

Jede Rechnungszeile (invoice_lines_attributes) kann ein Array von Steuern enthalten:

"taxes_attributes": [
  {
    "name": "USt",
    "category": "S",
    "percent": 19.0,
    "comment": "Standardumsatzsteuer"
  }
]

Für jedes Steuerobjekt:

name (erforderlich): Steuername (muss einem der erwarteten Werte für das Land des Unternehmens entsprechen, siehe Länderreferenz).
category (empfohlen): Steuerkategorie-Code (siehe Steuerkategorien).
percent (erforderlich): Steuerprozentsatz. Verwenden Sie negative Werte für Quellensteuer oder Abzüge.
comment (optional, aber empfohlen für 0%/Befreiung/Reverse Charge): Freier Text-Grund, der von mehreren Formaten und Steuerbehörden verwendet wird.

Mehrere Steuern können auf dieselbe Zeile angewendet werden, indem mehrere Objekte zu taxes_attributes hinzugefügt werden.

Nur diese Felder sind gültig. Fügen Sie nicht amount, base oder andere benutzerdefinierte Felder ein; diese werden intern berechnet, um Inkonsistenzen zu vermeiden.

Feld	Typ	Erforderlich	Beschreibung
`name`	Zeichenkette	ja	Steuername (muss den Länderstandards entsprechen)
`category`	Zeichenkette, Enum	empfohlen	Steuerkategorie-Code (siehe Liste unten)
`percent`	Float	ja	Steuerprozentsatz (negativ für Quellensteuer)
`comment`	Zeichenkette oder null	optional	Grund/Erklärung, erforderlich für viele befreite/nicht steuerpflichtige Fälle

Kontoebene-Steuerzeieinstellungen, die sich auf Berechnungen auswirken

apply_taxes_per_line (Boolean): Bei true werden Steuern pro Zeile angewendet und dann summiert; bei false werden Basen summiert und Steuern auf die Summe angewendet.
rounding_method: Rundungsstrategie (half_up standardmäßig). Siehe Rechnungsberechnung.

Steuerkategorien

B2Brouter verwendet Steuerkategorien, die mit der PEPPOL/UNCL5305-Codeliste übereinstimmen, und für einige Länder zusätzliche Codes, die von der lokalen Steuerbehörde erforderlich sind.

Häufig verwendete Kategoriecodes:

S – Standardsatz.
H – Hoher Satz.
AA – Ermäßigter Satz.
AAA – Sehr ermäßigter Satz.
Z – Nullsatz (0%, aber steuerpflichtig).
E – Befreit (0% und von der Umsatzsteuer befreit).
AE – Reverse Charge / “Inversión del sujeto pasivo”.
G – Exportware, Umsatzsteuer nicht berechnet.
K – Innergemeinschaftliche Lieferung von Waren/Dienstleistungen (im EWR von der Umsatzsteuer befreit).
NS – Nicht steuerpflichtig.
O – Außerhalb des Steuerrahmens / andere Operationen.

Nur diese Kategoriewerte werden akzeptiert; andere Codes werden abgelehnt.

Singapur verwendet zusätzliche GST-Kategoriecodes (siehe Singapur), und Italien verwendet FatturaPA N.. “natura”-Codes (siehe Italien).

Allgemeine Empfehlungen

Verwenden Sie die Steuernamen des Landes aus den folgenden Tabellen (sie stimmen mit der Standardkonfiguration von B2Brouter überein, die bei der Erstellung eines Unternehmens verwendet wird). Behalten Sie Namen/Codes bei, auch wenn sich Ihre Rate unterscheidet.
Verwenden Sie für Standard-Umsatzsteuer den Hauptsteuernamen und category: "S" mit dem entsprechenden percent.
Für ermäßigte Sätze verwenden Sie category: "AA" oder category: "AAA" gemäß den angezeigten Standards.
Für Nullsatz- oder befreite Operationen:
- Verwenden Sie percent: 0.
- Wählen Sie category basierend auf der rechtlichen Situation:
  - Z: steuerpflichtig, aber 0%.
  - E: befreit.
  - AE: Reverse Charge.
  - Lokale Codes für spezifische Regime (Italien N.., Singapur GST-Kategorien usw.).
Für Quellensteuer/Abzüge verwenden Sie negative Prozentsätze (z. B. -19 für spanisches IRPF) und den Steuernamen für die Quellensteuer (z. B. IRPF, IRNR, IRPEF).
Bei der Integration mit Steuererklärung (Verifactu, TicketBAI, LHDN usw.) stellen Sie sicher, dass Ihre taxes_attributes mit dem entsprechenden Leitfaden kompatibel sind.

Länderreferenz – gültige Steuernamen und Standardsätze

Die folgenden Tabellen listen die erwarteten Steuernamen pro Land mit den Standardsätzen und Kategorien auf, die wir vorbeladen. Verwenden Sie sie als Referenz für Namensvergabe und Kategorien; passen Sie percent an, wenn die Gesetzgebung oder Ihr Szenario dies erfordert.

Prozentsätze können sich im Laufe der Zeit ändern; überprüfen Sie immer die aktuelle lokale Gesetzgebung. Sätze und Kategorien sind nach Position in jeder Zeile ausgerichtet (erster Satz → erste Kategorie usw.).

Andorra (`ad`)

Name	Prozentsatz	Kategorie	Anmerkungen
IGI	4.5, 2.5, 1, 0	S, AA, AAA, Z	Umsatzsteuer (Standard/Ermäßigt/0%).
IRNR	10, 5, 1.5, -20	S, AA, AAA, S	Einkommensteuer für Nichtansässige (bei negativ Quellensteuer).

Österreich (`at`)

Name	Prozentsatz	Kategorie	Anmerkungen
MwSt	20, 10, 13, 0	S, AA, AA, Z	Umsatzsteuer.

Australien (`au`)

Name	Prozentsatz	Kategorie	Anmerkungen
GST	10, 0	S, E	Güter- und Dienstleistungssteuer.

Belgien (`be`)

Name	Prozentsatz	Kategorie	Anmerkungen
TVA	21, 6, 12, 0	S, AA, AA, Z, E, AE	Umsatzsteuer (Standard, Ermäßigt, Befreit, Reverse Charge).

Bulgarien (`bg`)

Name	Prozentsatz	Kategorie	Anmerkungen
ДДС	20, 9, 0	S, AA, Z	Umsatzsteuer.

Schweiz (`ch`)

Name	Prozentsatz	Kategorie	Anmerkungen
VAT	8.1, 2.6, 3.8, 0	S, AA, AA, E	Umsatzsteuer; 0% typischerweise Exporte.

Zypern (`cy`)

Name	Prozentsatz	Kategorie
ΦΠΑ	19, 5, 9, 0	S, AA, AA, Z

Tschechische Republik (`cz`)

Name	Prozentsatz	Kategorie
DPH	21, 12, 0	S, AA, Z

Deutschland (`de`)

Name	Prozentsatz	Kategorie	Anmerkungen
USt	19, 7, 0	S, AA, Z	Umsatzsteuer.

Dänemark (`dk`)

Name	Prozentsatz	Kategorie
VAT	25, 0	S, Z, E

Estland (`ee`)

Name	Prozentsatz	Kategorie
km	22, 9, 0	S, AA, Z

Spanien (`es`)

Spanien hat je nach Postleitzahl des Unternehmens mehrere Umsatzsteuer-Regime:

Festland/Balearen: IVA.
Kanarische Inseln: IGIC.
Ceuta/Melilla: IPSI.

comment wird für die Befreiung/nicht steuerpflichtig Grund in Facturae/Verifactu verwendet. Wenn Sie percent: 0 für eine befreite oder nicht steuerpflichtige Operation senden, fügen Sie den Grund in comment hinzu (Beispiel: comment: "E2"). Wenn Ihr Konto bereits den Standardgrund festlegt, können Sie ihn weglassen.

Festland/Balearen (Standard)

Name	Prozentsatz	Kategorie	Anmerkungen
IVA	21, 10, 7.5, 5, 4, 2, 0	S, AA, AA, AA, AAA, AAA, Z/E/AE	Umsatzsteuer.
IRPF	-19, -15, -7	S	Quellensteuer auf Einkommen.

Kanarische Inseln (`IGIC`) / Ceuta & Melilla (`IPSI`)

Beispiele (postleitzahlabhängig):

Name	Prozentsatz	Kategorie	Anmerkungen
IGIC	15, 9.5, 7, 3, 1.5, 0	H, H, S, AA, AA, Z	Umsatzsteueräquivalent der Kanarischen Inseln.
IPSI	10, 8, 4, 2, 1, 0.5	H, H, S, AA, AA, S	Lokale indirekte Steuer für Ceuta/Melilla.
IRPF	-19, -15, -7	S	Quellensteuer.

Anmerkungen (Spanien)

Verwenden Sie IVA/IGIC/IPSI mit percent: 0 und der richtigen category (E, Z oder AE) plus einen comment-Grund für befreit/nicht steuerpflichtig (z. B. E2).

Verwenden Sie negative percent für IRPF-Quellensteuern.

Siehe auch: Verifactu und TicketBAI.

Finnland (`fi`)

Name	Prozentsatz	Kategorie
ALV	25.5, 10, 14, 0	S, AA, AA, Z/E

Frankreich (`fr`)

Name	Prozentsatz	Kategorie
TVA	20, 5.5, 10, 2.1, 0	S, AA, AA, AAA, Z/AE

Vereinigtes Königreich (`gb`)

Name	Prozentsatz	Kategorie
VAT	20, 5, 0	S, AA, Z

Griechenland (`gr`)

Name	Prozentsatz	Kategorie
ΦΠΑ	24, 6, 13, 0	S, AA, AA, Z

Kroatien (`hr`)

Name	Prozentsatz	Kategorie
PDV	25, 5, 13, 0	S, AA, AA, Z

Ungarn (`hu`)

Name	Prozentsatz	Kategorie
ÁFA	27, 5, 18, 0	S, AA, AA, Z

Irland (`ie`)

Name	Prozentsatz	Kategorie
VAT	23, 9, 13.5, 4.8, 0	S, AA, AA, AA, Z

Island (`is`)

Name	Prozentsatz	Kategorie
VSK	24, 11, 0	S, AA, Z/E

Italien (`it`)

Name	Prozentsatz	Kategorie	Anmerkungen
IVA	22, 10, 5, 4, 0	S, AA, AA, AAA, `N..` / E / Z / AE	Umsatzsteuer.
IRPEF	Negativ (z. B. -20)	S	Quellensteuer (wenn anwendbar über FatturaPA).

Für FatturaPA verwenden nicht steuerpflichtige Operationen Kategoriecodes wie N1, N2.1, N2.2, N3.1, N3.2, N3.3, N3.4, N3.5, N3.6, N4, N5, N6.1… (siehe Ihre FatturaPA-Konfiguration). Sie müssen als 0% Umsatzsteuer mit name: "IVA" und category: "N.." gesendet werden.

Empfehlung (Italien)

Für Standard-Operationen: name: "IVA", category: "S", percent: 22.

Für nicht steuerpflichtige Operationen: name: "IVA", percent: 0 und der entsprechende N..-Code in category.

Siehe auch: Rechnung über SDI versenden.

Japan (`jp`)

Name	Prozentsatz	Kategorie	Anmerkungen
VAT	10, 8, 0	S, AA, E/G/O	Japanische Verbrauchssteuer.

Litauen (`lt`)

Name	Prozentsatz	Kategorie
PVM	21, 5, 9, 0	S, AA, AA, Z

Luxemburg (`lu`)

Name	Prozentsatz	Kategorie
TVA	17, 3, 8, 14, 0	S, AA, AA, AA, Z

Lettland (`lv`)

Name	Prozentsatz	Kategorie
PVM	21, 5, 12, 0	S, AA, AA, Z

Monaco (`mc`)

Name	Prozentsatz	Kategorie
TVA	20, 5.5, 10, 2.1, 0	S, AA, AA, AAA, Z/AE

Malta (`mt`)

Name	Prozentsatz	Kategorie
VAT	18, 5, 7, 0	S, AA, AA, Z

Malaysia (`my`)

Name	Prozentsatz	Kategorie	Anmerkungen
SST	10, 8, 6, 5, 0	T, T, T, T, E/O	Verkaufs- und Servicesteuer.

Siehe auch: Steuerbericht bei LHDN einreichen.

Niederlande (`nl`)

Name	Prozentsatz	Kategorie
BTW	21, 9, 0	S, AA, Z/AE

Norwegen (`no`)

Name	Prozentsatz	Kategorie
MVA	25, 15, 12, 0	S, AA, AA, Z/E

Neuseeland (`nz`)

Name	Prozentsatz	Kategorie
GST	15, 0	S, Z/E

Polen (`pl`)

Name	Prozentsatz	Kategorie
PTU	23, 5, 8, 0	S, AA, AA, Z

Portugal (`pt`)

Name	Prozentsatz	Kategorie
IVA	23, 6, 13, 0	S, AA, AA, Z

Rumänien (`ro`)

Name	Prozentsatz	Kategorie
TVA	19, 9, 5, 0	S, AA, AA, Z

Schweden (`se`)

Name	Prozentsatz	Kategorie
Moms	25, 6, 12, 0	S, AA, AA, Z/E

Saudi-Arabien (`sa`)

Name	Prozentsatz	Kategorie
ضريبة القيمة المضافة	15, 0	S, Z/E/O

Singapur (`sg`)

Singapur verwendet spezifische GST-Kategorien, die von der IRAS vorgeschrieben sind. Der Steuername ist immer GST; die Kategorie codiert die GST-Behandlung.

Name	Prozentsatz	Kategorie	Anmerkungen
GST	9	SR	Standard-Lieferung.
GST	0	ZR	Nullsatz-Lieferung.
GST	0 / 9	SRCA-S	Kundenkontoführung – Verkauf.
GST	9	SRCA-C	Kundenkontoführung – Kauf.
GST	9	SRRC	Reverse Charge.
GST	9	SROVR-RS	Ausländische Anbieterregistrierung – Remote-Services.
GST	9	SROVR-LVG	Ausländische Anbieterregistrierung – niedrigwertige Waren.
GST	9	SRLVG	Lokale niedrigwertige Waren.
GST	0	ES33	Befreit: Verordnung 33.
GST	0	ESN33	Befreit: Nicht-Verordnung 33.
GST	9	DS	Missachtete Lieferungen.
GST	0	OS	Außerhalb des Geltungsbereichs.
GST	0	NG	Keine GST-Gebühr.

Empfehlung (Singapur)

Verwenden Sie immer name: "GST".

Verwenden Sie die entsprechende IRAS GST-Kategorie in category und setzen Sie percent entsprechend (normalerweise 9 oder 0).

Slowenien (`si`)

Name	Prozentsatz	Kategorie
DDV	22, 9.5, 0	S, AA, Z

Slowakei (`sk`)

Name	Prozentsatz	Kategorie
DPH	20, 10, 0	S, AA, Z

Vereinigte Staaten (`us`)

Name	Prozentsatz	Kategorie	Anmerkungen
VAT	0	O	Wird verwendet, um “keine Umsatzsteuer” anzugeben.

Empfehlung (USA)

Für Unternehmen ohne Umsatzsteuer-ID verwenden Sie eine einzelne Steuer mit name: "VAT", percent: 0, category: "O" und optional comment: "Unternehmen ohne Umsatzsteuer-ID".

Erstellen Sie keine lokalen Umsatzsteuernamen in taxes_attributes; Umsatzsteuerbehandlung wird als 0% außerhalb des Geltungsbereichs modelliert.

Beispiele

Beispiel – Spanische Rechnungszeile mit Umsatzsteuer und IRPF

"taxes_attributes": [
  {
    "name": "IVA",
    "category": "S",
    "percent": 21.0
  },
  {
    "name": "IRPF",
    "category": "S",
    "percent": -15.0
  }
]

Beispiel – Deutsche befreite Lieferung innerhalb der EU (Reverse Charge)

"taxes_attributes": [
  {
    "name": "USt",
    "category": "AE",
    "percent": 0.0,
    "comment": "Innergemeinschaftliche Lieferung – Reverse Charge"
  }
]

Beispiel – Singapur Standard-GST

"taxes_attributes": [
  {
    "name": "GST",
    "category": "SR",
    "percent": 9.0
  }
]

Steuerbericht

Steuern-Attribute (taxes_attributes)

Wichtige Punkte

Struktur von taxes_attributes

Kontoebene-Steuerzeieinstellungen, die sich auf Berechnungen auswirken

Steuerkategorien

Allgemeine Empfehlungen

Länderreferenz – gültige Steuernamen und Standardsätze

Andorra (ad)

Österreich (at)

Australien (au)

Belgien (be)

Bulgarien (bg)

Schweiz (ch)

Zypern (cy)

Tschechische Republik (cz)

Deutschland (de)

Dänemark (dk)

Estland (ee)

Spanien (es)

Festland/Balearen (Standard)

Kanarische Inseln (IGIC) / Ceuta & Melilla (IPSI)

Finnland (fi)

Frankreich (fr)

Vereinigtes Königreich (gb)

Griechenland (gr)

Kroatien (hr)

Ungarn (hu)

Irland (ie)

Island (is)

Italien (it)

Japan (jp)

Litauen (lt)

Luxemburg (lu)

Lettland (lv)

Monaco (mc)

Malta (mt)

Malaysia (my)

Niederlande (nl)

Norwegen (no)

Neuseeland (nz)

Polen (pl)

Portugal (pt)

Rumänien (ro)

Schweden (se)

Saudi-Arabien (sa)

Singapur (sg)

Slowenien (si)

Slowakei (sk)

Vereinigte Staaten (us)