Adressen der Kund/innen erfassen
Stripe Tax benötigt die Angabe des Standorts Ihrer Kund/innen für die automatische Steuerberechnung. Diese Voraussetzung gilt auch, wenn Sie sich nicht für die Erhebung von Steuern registrieren. Dieser Leitfaden hilft Ihnen bei der Entscheidung, welche Adressdaten Sie von Ihren Kund/innen erfassen und wie Sie mit regionalen Unterschieden umgehen.
Unterstützte Adressformate
Jede Rechnungs- und Versandadresse hat die Felder line1
, line2
, city
, state
, postal_code
und country
. In den folgenden Tabellen sind die Adressformate beschrieben, die bei der Berechnung von Steuern unterstützt werden.
Verwenden Sie eines der obigen Adressformate, um sicherzustellen, dass wir Ihre Kundenadressen einheitlich erkennen können. Das Länderfeld muss immer einer gültiger ISO-Ländercode sein.
Welche Kundenadresse verwenden wir
Stripe Tax verwendet bei der Berechnung der Steuern eine einzige Adresse als Standort Ihres/Ihrer Kund/in. Wir wählen dieselbe Adresse aus, gleich ob Sie ein digitales Produkt, eine Dienstleistung oder eine versandte Ware kaufen.
Wir verwenden das erste geeignete Element in der folgenden Liste, um den Standort Ihres/Ihrer Kund/in zu ermitteln:
- Wir verwenden die Versandadresse Ihres/Ihrer Kund/in, sofern das Feld nicht leer ist. Bei Nutzung einer Adresse, die für die Berechnung der Steuern nicht präzise genug ist, wird der Status
requires_location_inputs
zurückgegeben. - Wir verwenden die Rechnungsadresse Ihres/Ihrer Kund/in, sofern das Feld nicht leer ist. Bei Nutzung einer Adresse, die für die Berechnung der Steuern nicht präzise genug ist, wird der Status
requires_location_inputs
zurückgegeben. - Wenn die Transaktion an eine Zahlungsmethode mit vollständigen Abrechnungsdetails gebunden ist, verwenden wir diese Rechnungsadresse.
- Wenn die mit der Zahlungsmethode verknüpften Abrechnungsdetails unvollständig sind oder fehlen, stellen wir die Rechnungsadresse anhand der bereitgestellten Informationen in Kombination mit den Angaben zur Zahlungsmethode selbst zusammen (z. B. anhand des Ländercodes des/der Kreditkartenausstellers/in, um das Land zu ermitteln, falls der/die Kund/in es nicht angibt).
- Andernfalls geolokalisieren wir die IP-Adresse des Kunden/der Kundin und verwenden diesen Standort dann als Standort Ihres Kunden/Ihrer Kundin. Wir speichern das Ergebnis dieser Geolokalisierung und verwenden es für zukünftige Transaktionen mit demselben Kunden/derselben Kundin.
Die mit der Transaktion verknüpfte Zahlungsmethode ist die erste, die in dieser Liste angegeben ist:
- Die Standard-Zahlungsmethode der Rechnung
- Die Standard-Zahlungsmethode des Abonnements
- Die Standard-Zahlungsmethode des/der Kund/in
Umgang mit nicht erkannten Standorten
Wenn der Kundenstandort nicht erkannt wird, schlägt die Finalisierung der Rechnung fehl, und es wird nicht versucht, eine Zahlung für Rechnungen mit automatic_tax[enabled]=true
durchzuführen. Wenn die Finalisierung während einer API-Anforderung, zum Beispiel beim Erstellen eines Abonnements oder beim Versand einer Rechnung erfolgt, gibt Stripe den Fehler customer_tax_location_invalid
zurück. Erfolgt die Finalisierung asynchron, zum Beispiel wenn ein Abonnement verlängert wird, sendet Stripe den Webhook invoice.finalization_failed
, und die Rechnung verbleibt im Entwurfsstatus.
Rechnungen mit Abschlussfehlern finalisieren
Wie Sie den Fehler customer_tax_location_invalid
korrigieren, hängt davon ab, ob Sie einen erkannten Kundenstandort erfassen. Ist dies der Fall, lassen Sie Stripe Tax aktiviert. Andernfalls deaktivieren Sie Stripe Tax für die betroffenen Rechnungen und Abonnements.
So erfassen Sie einen erkannten Kundenstandort:
- Aktualisieren Sie die Adresse des/der betroffenen Kund/in. Geben Sie ausreichend Details zum Standort Ihres/Ihrer Kund/in an. Der Code eines Landes und eines Bundesstaats allein ist zum Beispiel nicht ausreichend, um die Steuern in den USA zu berechnen.
- Vergewissern Sie sich, dass der Kundenstandort erkannt wird, indem Sie sicherstellen, dass der Wert von
customer.tax.automatic_tax
supported
odernot_collecting
ist. - Finalisieren Sie die betroffene Rechnung.
Alternativ können Sie wie folgt ohne einen erkannten Kundenstandort fortfahren:
- Aktualisieren Sie die betroffene Rechnung, sodass
automatic_tax[enabled]=false
ist. - Aktualisieren Sie das betroffene Abonnement, sodass
automatic_tax[enabled]=false
ist. - Finalisieren Sie die betroffene Rechnung.
Fehler bei der asynchronen Rechnungsfinalisierung erkennen
Wenn eine Rechnung aufgrund eines nicht erkannten Kundenstandorts nicht finalisiert werden kann, sendet Stripe den Webhook invoice.finalization_failed
mit automatic_tax[status] = 'requires_location_inputs'
. Wenn Abonnements verwendet werden, empfehlen wir abonnement- und rechnungsbezogene Ereignisse zu überwachen, da die meisten Aktivitäten asynchron erfolgen.
Fehler bei der Rechnungsfinalisierung verhindern
So verhindern Sie Fehler bei der Rechnungsfinalisierung aufgrund eines nicht erkannten Kundenstandorts:
- Vor der Aktualisierung eines bestehenden Abonnements von
automatic_tax[enabled]=false
aufautomatic_tax[enabled]=true
müssen Sie überprüfen, ob der/die Kund/in einen erkannten Standort hat. Wenn der Kundenstandort nicht erkannt wurde, müssen Sie ihn aktualisieren und verifizieren, bevor Sie Stripe Tax für das Abonnement aktivieren. - Nach der Aktualisierung eines/einer Kund/in, der/die über ein Abonnement mit
automatic_tax[enabled]=true
verfügt, müssen Sie überprüfen, ob der Wert voncustomer.tax.automatic_tax
supported
odernot_collecting
ist.
Notiz
Wir empfehlen Ihnen, die vollständige Adresse Ihrer Kund/innen zu erfassen, um eine möglichst genaue Steuerberechnung zu erhalten und die Anzahl der Fälle, in denen Sie keine Steuern einziehen können, möglichst gering zu halten.
Regionsspezifische Überlegungen
Die Komplexität der Steuern ist je nach Region sehr unterschiedlich. In den meisten Ländern gelten Steuerregeln für das ganze Land. In den Vereinigen Staaten variieren die Regeln und Sätze für Verkaufssteuern von Bundesstaat zu Bundesstaat, wobei es in einigen Bundesstaaten Hunderte Distrikte gibt, die ihre eigenen Steuersätze festlegen. In Kanada variieren die Art der Steuer und der Steuersatz je nach Provinz.
Vereinigte Staaten (USA)
Postleitzahlen
Stripe Tax unterstützt die Berechnung der Verkaufssteuer nur mit einer grundlegenden 5-stelligen US-Postleitzahl. Das Länderfeld muss der ISO-Ländercode „US“ sein. Als Standort Ihres Kunden/Ihrer Kundin verwenden wir die Stelle am geografischen Mittelpunkt des Postleitzahlengebiets, die den durchschnittlichen Standort der Adressen innerhalb des Postleitzahlengebiets darstellt. Der Steuersatz an dieser Stelle kann sich von dem Steuersatz an der vollständigen Adresse Ihres Kunden/Ihrer Kundin unterscheiden. Ob eine Postleitzahl allein ausreicht, um die richtigen Steuersätze zu ermitteln, ist von Staat zu Staat unterschiedlich.
Wir empfehlen, in den folgenden Staaten nicht nur allein die Postleitzahl zu verwenden: Arizona, Colorado, Oklahoma, Alabama, Missouri, Texas, Illinois, Washington, Kansas, New Mexico, Louisiana, Arkansas, Kalifornien, Alaska, South Dakota, North Dakota, Utah, Nebraska und West Virginia.
Notiz
Wir empfehlen, in Bundesstaaten, in denen Sie für die Erhebung lokaler Verkaufssteuern registriert sind, eine vollständige Adresse zu erfassen.
IP-Adressen
Da der Standort einer IP-Adresse weit vom tatsächlichen Standort Ihres Kunden/Ihrer Kundin entfernt sein kann, sollten Sie nicht nur die IP-Adresse verwenden, um die Höhe der zu erhebenden Steuer zu bestimmen. Verwenden Sie stattdessen den Endpoint der anstehenden Rechnung, um dem Kunden/der Kundin eine Schätzung der zu zahlenden Steuer anzuzeigen, bevor Sie eine Rechnungs- oder Lieferadresse erfassen.
Europa und die Europäische Union (EU)
Ausgenommene Gebiete
In Europa erheben die Steuerbehörden der einzelnen Länder die Steuern, nicht die staatlichen oder lokalen Behörden. In einigen wenigen Gebieten gilt der Steuersatz des Landes nicht, auch wenn diese sich in einem Land befinden, das Steuern erhebt. Die italienische Postleitzahl „00120“ steht beispielsweise für die Vatikanstadt, in der die italienische Mehrwertsteuer nicht gilt.
Erfassen Sie die Postleitzahl oder das Bundesland Ihres/Ihrer Kund/in, damit Stripe Tax feststellen kann, ob sich Ihr/e Kund/in in einem ausgenommenen Gebiet befindet.
Siehe die Liste der ausgenommenen Gebiete, die von Stripe Tax unterstützt werden.
Kanada
Damit Stripe Tax den geltenden Steuersatz ermitteln und die Steuern in Kanada erheben kann, müssen Sie die Provinz oder die Postleitzahl des/der Kund/in erfassen.