Adressen der Kund/innen erfassen
Erfahren Sie mehr über die Erfassung von Kundenadressen zur Berechnung von Steuern.
Stripe Tax benötigt die Angabe des Kundenstandorts für die automatische Steuerberechnung. Diese Voraussetzung gilt auch, wenn Sie keine aktive Registrierung haben. In diesem Leitfaden erklären wir, wie Sie Adressen von Ihren Kundinnen und Kunden erfassen.
Checkout und Payment Links
Checkout kümmert sich um die Erfassung der Kundenadressen für Sie, einschließlich der von Payment Links erstellten.
Rechnungsstellung, Abonnements und benutzerdefinierte Zahlungsintegrationen
Wenn Sie weder Payment Links noch Checkout nutzen, müssen Sie sich selbst um die Erfassung der Kundenadressen kümmern.
- Erfassen Sie die beiden Felder country und postal_code in Ihren Kundenobjekten und legen Sie diese fest.
- Verwenden Sie zweistellige Ländercodes (ISO 3166-1 alpha-2).
- Legen Sie beim Erstellen oder Aktualisieren einer Kundin/eines Kunden tax[validate_location]=“immediately” fest, um spätere Fehler des Typs customer_tax_location_invalid zu vermeiden.
- Überwachen Sie Abonnement-Webhook-Ereignisse, da die meisten Aktivitäten asynchron ablaufen.
Regionale AspekteVereinigte Staaten
In den Vereinigten Staaten variieren die Regeln und Sätze für Verkaufssteuern von Bundesstaat zu Bundesstaat. In einigen Bundesstaaten gibt es Hunderte Distrikte, die ihre eigenen Steuersätze festlegen. Wir empfehlen Ihnen daher, eine vollständige Adresse (einschließlich Zeile 1, Stadt und Bundesstaat) von Ihren Kundinnen und Kunden in den USA einzuholen.
Fehler beim Rechnungsabschluss
Für die Finalisierung von Rechnungen mit Stripe Tax ist ein anerkannter Kundenstandort erforderlich. Standortangaben können fehlen oder ungültig sein, wenn Sie die Standardzahlungsmethode eines Kunden/einer Kundin aktualisieren oder entfernen oder wenn Sie beim Erstellen oder Aktualisieren eines Kunden/einer Kundin tax[validate_ nicht angegeben haben.
Wenn wir keinen anerkannten Kundenstandort haben, werden die Rechnungen für ein Abonnement weiterhin automatisch finalisiert, aber ohne Berechnung der Steuern. Dies hat folgende Auswirkungen:
- Der Parameter
automatic_ändert sich für das Abonnement und die Rechnung intax[enabled] false. - Der Parameter
Invoice[automatic_ändert sich intax][disabled_ reason] finalization_.requires_ location_ inputs - Der Parameter
Subscription[automatic_ändert sich intax][disabled_ reason] requires_.location_ inputs - Wenn das Abonnement einen Zeitplan hat, legen wir
automatic_für die aktuelle Phase und in dentax[enabled] default_aufsettings falsefest. Wir legen dendisabled_in beidem aufreason requires_fest.location_ inputs - Wir senden die Ereignisse
invoice.undupdated customer., um Ihre Integration über diese Änderungen zu informieren.subscription. updated - Wenn es einen Zeitplan gibt, senden wir auch einen
subscription_-Webhook.schedule. updated
- Wenn es einen Zeitplan gibt, senden wir auch einen
- Die Rechnung wird ohne Berechnung oder Erhebung von Steuern finalisiert. Sie enthält keine Steuerbeträge.
- Die Zahlung erfolgt wie gewohnt nach der Inkassomethode für die Rechnung.
Um Abonnements ohne automatische Steuerberechnungen in Ihrem Stripe-Dashboard zu überprüfen, rufen Sie die Seite „Abonnements“ auf und filtern Sie die Ansicht nach der Option Automatische Steuer nicht aktiviert. Um die automatische Steuer für diese Abonnements in Zukunft zu reaktivieren, stellen Sie sicher, dass Sie mindestens einen gültigen Kundenstandort haben, und aktivieren Sie die automatische Steuer über das Stripe Tax-Dashboard.
Ausnahmen von der automatischen Deaktivierung der Steuer
Stripe gibt einen Fehler zurück und lässt die Rechnung im Status draft, wenn sie mit der API oder im Dashboard ohne gültigen Kundenstandort finalisiert wird. In der API wird ein HTTP 400-Fehler mit dem code von customer_ zurückgegeben.
Ähnlich verhält es sich bei der automatischen Finalisierung von Einzelrechnungen ohne Abonnement: Die Rechnung bleibt ein Entwurf, wenn der Kundenstandort ungültig ist. Wir senden das Ereignis invoice.finalization_failed, wobei der last_finalization_error[code] der Rechnung customer_ ist.
Wie Sie mit dem Fehler customer_ umgehen, hängt davon ab, ob Ihnen eine Kundenadresse vorliegt oder ob Sie eine solche erfassen können.
- Wenn Ihnen eine Kundenadresse vorliegt oder Sie diese erfassen können, aktualisieren Sie die Kundin/den Kunden und finalisieren Sie die Rechnung manuell.
- Aktualisieren Sie die Kundin/den Kunden mit tax[validate_location]=“immediately”, um sicherzustellen, dass die neue Adresse gültig ist.
- Finalisieren Sie die Rechnung.
- Wenn Ihnen keine Kundenadresse vorliegt oder Sie diese nicht erfassen können, deaktivieren Sie Stripe Tax für die Rechnung und das Abonnement. Finalisieren Sie die Rechnung dann manuell.
- Aktualisieren Sie die betroffene Rechnung, sodass
automatic_ist.tax[enabled]=false - Aktualisieren Sie das betroffene Abonnement, sodass
automatic_ist.tax[enabled]=false - Finalisieren Sie die Rechnung.
- Aktualisieren Sie die betroffene Rechnung, sodass
OptionalWelche Kundenadresse wir verwenden
Stripe Tax verwendet bei der Berechnung der Steuern eine einzige Adresse als Kundenstandort. Wie wir diese Adresse ermitteln, hat nichts mit der Art des Produkts zu tun, das Sie verkaufen.
Welcher Ort für eine automatisch berechnete Steuerzahlung verwendet wurde, können Sie im Abschnitt „Automatische Steuerberechnung“ auf der Transaktionsdetailseite in Ihrem Dashboard sehen. Sie können auch den Steuerparameter des Customer API-Objekts überprüfen, um die tax-location-source zu sehen.
Checkout und Payment Links
Checkout und Payment Links verwenden die während der Sitzung erfasste Adresse.
Rechnungsstellung, Abonnements und benutzerdefinierte Zahlungsintegrationen
Wir verwenden das erste geeignete Element in der folgenden Liste, um den Standort Ihres/Ihrer Kund/in zu ermitteln:
- Wir verwenden die Versandadresse Ihrer Kundin/Ihres Kunden, falls diese vorhanden ist.
- Wenn eine Versandadresse vorhanden, aber ungültig ist, melden wir einen Fehler des Typs
customer_, anstatt die nächste Adresse in dieser Liste auszuprobieren.tax_ location_ invalid
- Wenn eine Versandadresse vorhanden, aber ungültig ist, melden wir einen Fehler des Typs
- Wir verwenden die Rechnungsadresse Ihrer Kundin/Ihres Kunden, falls diese vorhanden ist.
- Wenn eine Rechnungsadresse vorhanden, aber ungültig ist, melden wir einen Fehler des Typs
customer_, anstatt die nächste Adresse in dieser Liste auszuprobieren.tax_ location_ invalid
- Wenn eine Rechnungsadresse vorhanden, aber ungültig ist, melden wir einen Fehler des Typs
- Wir verwenden die Abrechnungsdetails der spezifischsten Zahlungsmethode, falls vorhanden.
- Standard-Zahlungsmethode der Rechnung, falls vorhanden.
- Standard-Zahlungsmethode für das Abonnement, falls vorhanden.
- Standard-Zahlungsmethode der Kundin/des Kunden, falls vorhanden.
- Wir verwenden die IP-Adresse Ihrer Kundin/Ihres Kunden, falls diese vorhanden ist.
Notiz
Wenn die mit einer Zahlungsmethode verknüpften Abrechnungsdetails unvollständig sind oder fehlen, versuchen wir die Rechnungsadresse zu vervollständigen. Wenn wir beispielsweise das Land des Kartenausstellers kennen, kombinieren wir dieses mit der Postleitzahl aus den Abrechnungsdetails.
Tax API
Für die Tax API folgt die Adresshierarchie einem vereinfachten Ansatz:
- Die in der API-Anfrage angegebene Adresse wird direkt für Steuerberechnungen verwendet.
- Es gibt keinen Rückgriff auf andere Adressquellen wie Versandadresse, Rechnungsadresse, Zahlungsmethode oder IP-Adressen.
Achtung
Wenn Sie die Tax API verwenden, müssen Sie in Ihren API-Anfragen eine gültige und vollständige Adresse angeben, andernfalls wird ein Fehler zurückgegeben. Geben Sie das Land und gegebenenfalls die Postleitzahl und den Bundesstaat an.
OptionalMinimale Adresserfassung
Jede Rechnungs- und Versandadresse besteht aus den Feldern line1, line2, city, state, postal_ und country. country muss ein zweistelliger ISO 3166-1-Code sein.
Verwenden Sie eines der obigen unterstützten Adressformate, um sicherzustellen, dass wir Ihre Kundenadressen durchgehend erkennen.
OptionalRegionale Aspekte
Vereinigte Staaten
Genauigkeit der IP-Adresse
In den meisten Fällen können wir eine IP-Adresse in einen physischen Bereich auflösen, aber ihre Genauigkeit variiert und spiegelt möglicherweise nicht den tatsächlichen Standort des Kunden/der Kundin wider. Da die USA lokale Steuern erheben, empfehlen wir nicht, sich auf die IP-Adresse eines Kunden/einer Kundin zu verlassen, um seine/ihre Adresse zu ermitteln.
Präzise Adresssuche
Stripe unterstützt die volle, „hausgenauen“ Adresssuche für Kundenadressen in den USA, d. h. der Standort der Kundin/des Kunden kann einem konkreten Haus oder Gebäude zugeordnet werden. So lässt sich eine Adresse viel genauer bestimmen, da in den USA zwei nebeneinander liegende Häuser in derselben Straße aufgrund komplexer Grenzen der Steuergebiete verschiedenen Steuersätzen unterliegen können.
Für Adressen außerhalb der USA verwendet Stripe die Felder für Land, Bundesstaat/Bundesland und Postleitzahl, um Steuerverpflichtungen zu ermitteln, ohne sie mit einer umfassenden Adressdatenbank abzugleichen. Weitere Informationen darüber, wann Bundesstaat/Bundesland und die Postleitzahl verwendet werden, finden Sie unter Besondere Zuständigkeiten und ausgenommene Gebiete.
Notiz
Stripe Tax verwendet die 5-stellige USA, wenn die Adresse keine ausreichenden Informationen enthält, Unstimmigkeiten aufweist oder anderweitig nicht mit einer Adresse aus der Adressdatenbank des USA Postal Service abgeglichen werden kann.
US-Militär- und Diplomatenadressen
Stripe Tax berechnet keine Steuern für USA und Diplomatenpost, die nach Übersee geht. Militär- und Diplomatenadressen in Übersee erhalten eine APO-, FPO- oder DPO-Postleitzahl, und der USPS behandelt sie wie Inlandspost, bevor sie an das Militär weitergeleitet wird. Da Verkäufe an diese speziellen Postleitzahlen ins Ausland gehen, fällt keine entsprechende Sales Tax an.
Postleitzahlen
In den Vereinigten Staaten unterstützt Stripe Tax die Berechnung der Verkaufssteuer mit der einfachen 5-stelligen US-Postleitzahl. Wir verwenden den Punkt in der geografischen Mitte des 5-stelligen Postleitzahlengebiets als Kundenstandort. Es ist möglich, dass sich dieser Steuersatz von dem Steuersatz der vollständigen Kundenadresse unterscheidet. Ob nur die Postleitzahl ausreicht, um den korrekten Steuersatz zu ermitteln, hängt vom Bundesstaat ab.
Wir empfehlen, dass Sie sich in den folgenden Staaten nicht allein auf eine Postleitzahl verlassen:
- Alabama
- Alaska
- Arizona
- Arkansas
- Kalifornien
- Colorado
- Illinois
- Kansas
- Louisiana
- Missouri
- Nebraska
- New Mexico
- North Dakota
- Oklahoma
- South Dakota
- Texas
- Utah
- Washington
- West Virginia
Notiz
Stripe Tax unterstützt auch 9-stellige Postleitzahlen (ZIP+4). Wir verwenden die vier zusätzlichen Ziffern jedoch nicht.
Europa
Zuverlässigkeit der IP-Adresse
In Regionen, in denen keine lokalen Steuern erhoben werden, wie in der EU, ist es wahrscheinlicher, dass eine IP-Adresse in eine genaue Adresse aufgelöst wird.
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.