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
Wenn wir eine Rechnung aufgrund eines nicht erkannten Kundenstandorts nicht finalisieren können, senden wir das Ereignis invoice.finalization_failed. Dabei ist die Rechnung last_finalization_error[code] auf customer_
gesetzt. Dies kann passieren, wenn Sie tax[validate_
beim Erstellen oder Aktualisieren einer Kundin/eines Kunden nicht angegeben haben.
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