Transaktionen in Stripe Tax importierenÖffentliche Vorschau
Importieren Sie Transaktionsdaten von externen Plattformen in Stripe Tax.
Notiz
Melden Sie sich an oder registrieren Sie sich für Stripe, um Stripe Tax zu aktivieren.
Importieren Sie Transaktionsdaten von Drittanbieterplattformen mithilfe von CSV-Dateien in Stripe Tax. Konsolidieren Sie Verkaufsdaten von mehreren Plattformen, um einen einheitlichen Überblick über Ihre Steuerpflichten zu erhalten, die Einhaltung von Vorschriften zu vereinfachen und fundierte Entscheidungen über steuerliche Registrierungsanforderungen zu treffen.
Der Import Ihrer Transaktionsdaten von externen Plattformen in Stripe Tax hat mehrere Vorteile:
- Einheitliche Überwachung der Steuerpflichten: Überwachen Sie Schwellenwerte für alle Vertriebskanäle, einschließlich Transaktionen außerhalb von Stripe.
- Vereinfachte Konformität: Vermeiden Sie den manuellen Abgleich und die Aggregation von Daten aus verschiedenen Plattformen.
- Genauere Überwachung von Schwellenwerten: Ermitteln Sie, wo Sie sich für die Steuererhebung registrieren müssen, indem Sie Transaktionsdaten an einem Ort konsolidieren.
- Daten flexibel verwalten: Importieren Sie historische Daten für vergangene Verpflichtungen oder verwenden Sie regelmäßige Importe für die laufende Überwachung.
Funktionsweise
Wenn Sie Transaktionsdaten in Stripe Tax importieren:
- Sie exportieren Ihre Transaktionsdaten von externen Plattformen.
- Sie formatieren die Daten in einer CSV-Datei mit einer Zeile pro Posten (nicht pro Transaktion).
- Sie laden die CSV-Datei über das Dashboard in Stripe Tax hoch.
- Stripe Tax prüft und verarbeitet Ihre Daten.
- Greifen Sie auf importierte Transaktionen in Berichten, in der Überwachung von Verpflichtungen sowie in der Einreichung und Abführung zu.
Anforderungen an das CSV-Dateiformat
Ihre CSV-Datei muss ein bestimmtes Format mit erforderlichen Spalten aufweisen. Fügen Sie jeder Datei eine Kopfzeile hinzu. Jede Zeile stellt einen Einzelposten dar, keine vollständige Transaktion. Wenn eine einzelne Transaktion aus mehreren Produkten oder Posten besteht, führen Sie jeden Posten als separate Zeile in der CSV-Datei auf.
Spaltenverweis
Spaltenname | Typ | Beispiel |
source_ | Text Erforderlich | order_ |
Eindeutige Kennung für die Transaktion | ||
transaction_ | Entweder Sale , Refund oder Void Erforderlich | Sale |
Art der Transaktion | ||
transaction_ | Anzahl Optional | 1 , 1712863281 (Unix-Zeitstempel) |
Numerisches Feld zur Angabe der neuesten Version der Transaktion | ||
provider | Text Erforderlich | amazon , tax_ , shopify |
Externe Quelle der Transaktion | ||
liable_ | Text Erforderlich für Rückerstattung oder Stornierung | order_ |
Quellentransaktions-ID, die von dieser Rückerstattung oder Stornierung verarbeitet wird | ||
tax_ | Datum und Uhrzeit (Format yyyy-MM-dd HH:mm:ss z ) Erforderlich | 2024-02-22 18:42:47 UTC |
Datum, an dem die Steuerpflicht entsteht | ||
created_ | Datum und Uhrzeit (Format yyyy-MM-dd HH:mm:ss z ) Erforderlich | 2024-02-22 18:42:47 UTC |
Erstellungsdatum der Transaktion | ||
posted_ | Datum und Uhrzeit (Format yyyy-MM-dd HH:mm:ss z ) Erforderlich | 2024-02-22 18:42:47 UTC |
Das Datum, an dem die Haftung übernommen oder reduziert wird | ||
currency | Währungscode (ISO 4217) Erforderlich | USD , EUR , GBP |
Abrechnungswährung der Transaktion | ||
customer_ | Text Optional | cus_ |
Kunden-ID von Stripe | ||
tax_ | Entweder exempt , none oder reverse Erforderlich | exempt |
Steuerbefreiungsstatus der Transaktion | ||
line_ | Text Erforderlich | item_ |
Posten-ID | ||
line_ | Entweder Exclusive oder Inclusive Optional | Exclusive |
Steuerverhalten für Posten | ||
line_ | Anzahl1 Optional | 150. |
Betrag des Postens mit Steuer | ||
line_ | Text Optional | prod_ |
Stripe-Produkt-ID | ||
line_ | Text Optional | Premium Widget |
Durch Nutzer/in angegebener Produktname | ||
line_ | Text Optional | High-quality widget for premium customers |
Kostenloses Formular mit Produktbeschreibung | ||
line_ | Text Optional | txcd_ |
Ein Produktsteuercode von Stripe, der diese Transaktion klassifiziert. Falls nicht angegeben, wird die Standard-Produktsteuer verwendet. | ||
line_ | Text Optional | SKU123 |
Externe Produkt-ID (zum Beispiel Händler-SKUs) | ||
line_ | Text Optional | TX456 |
Externer Steuercode für Produkt | ||
line_ | Nummer1 Erforderlich | 50. |
Kosten für eine einzelne Einheit | ||
line_ | Zahl (Dezimalwerte werden unterstützt) Erforderlich | 1 , 2 , 3. |
Menge der Einheit | ||
line_ | Anzahl1 Optional | 10. |
Rabatt für bestimmten Posten | ||
line_ | Anzahl1 Optional | 45. |
Steuerbemessungsgrundlagen für bestimmten Posten | ||
line_ | Anzahl Optional | 0. |
Auf Postenebene aggregierter Steuersatz | ||
line_ | Nummer1 Erforderlich | 12. |
Gesamtbetrag der für den angegebenen Posten erhobenen Steuer | ||
shipping_ | Text Erforderlich bei Nutzung von Versand2 | ship_ |
Externe Versandposten-ID | ||
shipping_ | Entweder exclusive oder inclusive Erforderlich bei Nutzung von Versand | exclusive |
Steuerverhalten für Versandposten | ||
shipping_ | Nummer1 Erforderlich bei Versandnutzung | 5. |
Betrag der Versandposteneinheit | ||
shipping_ | Number1 Erforderlich, wenn `tax_rate` fehlt | 5. |
Zu versteuernder Betrag für den Versand | ||
shipping_ | Nummer Erforderlich, wenn `taxable_amount` fehlt | 0. |
Steuersatz für Versand | ||
shipping_ | Nummer1 Erforderlich bei Versandnutzung | 0. |
Eingezogene Steuer für Versandposten | ||
shipping_ | Text Optional | Express Shipping |
Kostenloses Formular mit Beschreibung der Rechnungsposten | ||
shipping_ | Entweder txcd_ oder txcd_ Optional | txcd_ |
Ein Produktsteuercode von Stripe, der den Versandposten klassifiziert. | ||
shipping_ | Text Optional | TX789 |
Externer Steuercode für den Versand | ||
shipping_ | Anzahl1 Optional | 2. |
Rabatt für Versandposten | ||
merchant_ | Text Optional | San Francisco |
Stadt der Händlerin/des Händlers | ||
merchant_ | Ländercode (ISO 3166-1 alpha-2) Erforderlich | US |
Land der Händlerin/des Händlers | ||
merchant_ | Text Optional | 123 Commerce St |
Zeile 1 der Händleradresse | ||
merchant_ | Text Optional | Suite 400 |
Zeile 2 der Händleradresse | ||
merchant_ | Text Erforderlich für USA/CA | 94111 |
Postleitzahl der Händlerin/des Händlers | ||
merchant_ | Text Optional | CA |
Bundesland der Händlerin/des Händlers | ||
tax_ | Text Optional | EU_ , CA_ |
Typ der angegebenen Steueridentifikationsnummer | ||
tax_ | Ländercode (ISO 3166-1 alpha-2) Optional | US , CA |
Zweistelliger Ländercode der Steueridentifikationsnummer | ||
tax_ | Text Optional | 12-3456789 |
Wert der Steueridentifikationsnummer | ||
buyer_ | Text3 Optional | Boston |
Stadt des Käufers/der Käuferin | ||
buyer_ | Ländercode (ISO 3166-1 alpha-2)3 Erforderlich | US |
Land des Käufers/der Käuferin | ||
buyer_ | Text3 Optional | 456 Main St |
Zeile 1 der Käuferadresse | ||
buyer_ | Text3 Optional | Apt 789 |
Zeile 2 der Käuferadresse | ||
buyer_ | Text3 Erforderlich für US/CA | 02108 |
Postleitzahl der Käuferin/des Käufers | ||
buyer_ | Text3 Optional | MA |
Bundesland der Käuferin/des Käufers |
1 Beträge werden als Währung in der Primärwährung in Dezimalform dargestellt. Beispielsweise ist 10.
in USD gleich $10.
.
2 Versandposten sind optional, aber wenn sie enthalten sind, werden bestimmte Felder zu Pflichtfeldern.
3 Für Kundenadressen gelten die Adressanforderungen von Stripe Tax.
Beispiel-CSV-Datei
Beispiel einer CSV-Datei mit mehreren Posten und verschiedenen häufig genutzten Feldern:
source_transaction_id,transaction_type,provider,liable_transaction_id,transaction_version,tax_rules_at,created_at,posted_at,currency,customer_id,tax_exempt,line_item.id,line_item.tax_behavior,line_item.amount,line_item.product_id,line_item.product_name,line_item.product_description,line_item.product_tax_code,line_item.external_product_id,line_item.external_tax_code,line_item.unit_amount,line_item.quantity,line_item.amount_discount,line_item.taxable_amount,line_item.tax_rate,line_item.amount_tax,shipping_line_item.id,shipping_line_item.tax_behavior,shipping_line_item.description,shipping_line_item.tax_code,shipping_line_item.external_tax_code,shipping_line_item.amount,shipping_line_item.amount_discount,shipping_line_item.taxable_amount,shipping_line_item.tax_rate,shipping_line_item.amount_tax,merchant_address.city,merchant_address.country,merchant_address.line1,merchant_address.line2,merchant_address.postal_code,merchant_address.state,tax_ids.type,tax_ids.country,tax_ids.value,buyer_address.city,buyer_address.country,buyer_address.line1,buyer_address.line2,buyer_address.postal_code,buyer_address.state 1935a6-Sale,Sale,tax_jar,,1,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,USD,cus_9s6XKzkNRiz8i3,none,LineItem-1,inclusive,42.54,,,Pepperoni Pizza,txcd_40060003,tax_product_id_56,tax_code_99,55.05,1,12.51,,,9.67,ShippingLineItem-8ab3,inclusive,Shipping description 69,txcd_92010001,shipping_tax_code_3,10.33,,,,0,San Francisco,US,510 Townsend St,,94103,CA,us_ein,US,12-3456789,Seattle,US,9205th Ave,,98104,WA 8a54a0-Refund,Refund,tax_jar,1935a6-Sale,1,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,USD,cus_9s6XKzkNRiz8i3,none,LineItem-1,inclusive,-42.54,,,Pepperoni Pizza,txcd_40060003,tax_product_id_56,tax_code_99,-55.05,1,-12.51,,,-9.67,ShippingLineItem-8ab3,inclusive,Shipping description 69,txcd_92010001,shipping_tax_code_3,-10.33,,,,0,San Francisco,US,510 Townsend St,,94103,CA,us_ein,US,12-3456789,Seattle,US,9205th Ave,,98104,WA 1860e6-Sale,Sale,tax_jar,,1,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,USD,cus_9s6XKzkNRiz8i3,none,LineItem-1,inclusive,172.58,,,Pepperoni Pizza,txcd_40060003,tax_product_id_56,tax_code_99,45.37,4,8.9,,,7.43,ShippingLineItem-e936,inclusive,Shipping description 69,txcd_92010001,shipping_tax_code_3,8.14,,,,0,San Francisco,US,510 Townsend St,,94103,CA,us_ein,US,12-3456789,Seattle,US,9205th Ave,,98104,WA e7f7a1-Void,Void,tax_jar,1860e6-Sale,1,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,USD,cus_9s6XKzkNRiz8i3,none,LineItem-1,inclusive,-172.58,,,Pepperoni Pizza,txcd_40060003,tax_product_id_56,tax_code_99,-45.37,4,-8.9,,,-7.43,ShippingLineItem-e936,inclusive,Shipping description 69,txcd_92010001,shipping_tax_code_3,-8.14,,,,0,San Francisco,US,510 Townsend St,,94103,CA,us_ein,US,12-3456789,Seattle,US,9205th Ave,,98104,WA 6b8059-Sale,Sale,tax_jar,,1,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,USD,cus_9s6XKzkNRiz8i3,none,LineItem-1,inclusive,195.72,,,Pepperoni Pizza,txcd_40060003,tax_product_id_56,tax_code_99,69.17,3,11.79,,,5.51,ShippingLineItem-3218,inclusive,Shipping description 69,txcd_92010001,shipping_tax_code_3,9.41,,,,0,San Francisco,US,510 Townsend St,,94103,CA,us_ein,US,12-3456789,Seattle,US,9205th Ave,,98104,WA
Leitfaden für jeden Transaktionstyp
Verkaufstransaktionen
Befolgen Sie beim Importieren von Verkaufstransaktionen diese Richtlinien, um eine ordnungsgemäße Verarbeitung zu gewährleisten. Sie können nur einen Versandposten pro Transaktion hinzufügen.
Für Transaktionen mit einem einzelnen Posten:
- Erstellen Sie eine Zeile mit allen Pflichtfeldern
transaction_
auftype Sale
setzen
Für Transaktionen mit mehreren Posten:
- Erstellen Sie für jeden Posten eine eigene Zeile
- Stellen Sie sicher, dass diese Felder für alle Posten derselben Transaktion genau übereinstimmen:
source_
transaction_ id transaction_
type provider
tax_
rules_ at currency
- Alle
tax_
-Felderids. * - Alle
shipping_
-Felderline_ item. *
Transaktionen zurückerstatten und stornieren
Beim Importieren von Rückerstattungen oder Stornierungen müssen Sie sich auf die ursprüngliche Transaktion beziehen:
Für Transaktionen mit einem einzelnen Posten:
- Erstellen Sie eine Zeile mit allen Pflichtfeldern
transaction_
auftype Refund
oderVoid
festlegen- Setzen Sie
liable_
auf dietransaction_ id source_
der ursprünglichen Transaktiontransaction_ id - Verwenden Sie die negativen Werte für Betragsfelder (fügen Sie ein Minuszeichen hinzu)
- Stellen Sie sicher, dass
currency
mit der ursprünglichen Transaktion übereinstimmt.
Für Transaktionen mit mehreren Posten:
- Erstellen Sie für jeden Posten eine eigene Zeile
transaction_
auftype Refund
oderVoid
festlegen- Setzen Sie
liable_
auf dietransaction_ id source_
der ursprünglichen Transaktiontransaction_ id - Verwenden Sie die negativen Werte für alle Betragsfelder
- Stellen Sie sicher, dass diese Felder für alle Posten derselben Rückerstattungs-/Stornierungstransaktion genau übereinstimmen:
source_
transaction_ id transaction_
type provider
tax_
rules_ at currency
- Alle
tax_
-Felderids. * - Alle
shipping_
-Felderline_ item. *
Transaktionen korrigieren
So korrigieren Sie eine zuvor importierte Transaktion:
- Duplizieren Sie die Transaktion, die Sie korrigieren möchten, wie folgt:
source_
transaction_ id transaction_
type provider
- Aktualisieren Sie alle Felder, die korrigiert werden müssen
- Erhöhen Sie den
transaction_
-Wert (z. B. vonversion 1
auf2
)
Bei diesem Ansatz werden die ursprünglichen Transaktionsdaten in Ihren Steuerberechnungen ersetzt, anstatt sie umzukehren. Stripe Tax verwendet die Version mit dem höchsten transaction_
-Wert.
Einschränkungen beim Import
Einschränkung | Details |
---|---|
Maximale Dateigröße | 50 MB |
Unterstütztes Dateiformat | Nur CSV |
Kopfzeile | Erforderlich (muss Spaltennamen enthalten, wie oben angegeben) |
Dateiverarbeitung | Die Verarbeitung großer Dateien kann länger dauern |
Auswirkungen von Berichten | Die importierten Transaktionen haben keine Auswirkungen auf Ihre Berechnungen oder Berichte für Transaktionen, die über Stripe verarbeitet werden. |
Importieren Ihrer Transaktionsdaten
So importieren Sie Ihre Transaktionsdaten von Drittanbietern:
- Gehen Sie zum Abschnitt Steuern im Stripe-Dashboard.
- Klicken Sie auf Schnelle Aktionen und wählen Sie dann Transaktionen importieren aus.
- Klicken Sie auf CSV importieren.
- Wählen Sie Ihre vorbereitete CSV-Datei aus und klicken Sie auf Datei importieren.
- Überwachen Sie den Importstatus in der angezeigten Schublade. Sie können diese Schublade schließen und später zurückkehren, um den Fortschritt zu überprüfen oder die Validierungsergebnisse anzuzeigen.
Wenn beim Import Fehler auftreten, können Sie eine CSV-Datei aller Zeilen mit Problemen und den spezifischen aufgetretenen Fehlern herunterladen.
Testen Sie Ihre importierten Daten anhand der Validierungsschritte unter Stripe Tax testen.
Vorsicht
Sie können importierte Transaktionen nicht entfernen. Der Import einer neuen Transaktionsversion ermöglicht die Korrektur zuvor importierter Transaktionen. Für Transaktionen, die unbeabsichtigt importiert wurden, wird durch den Import einer ungültigen Transaktion jegliche Steuerpflicht beseitigt.
Versionierung von Transaktionen
Sie können zuvor importierte Transaktionen korrigieren, indem Sie das Feld transaction_
verwenden, um Aktualisierungen ordnungsgemäß zu verarbeiten. Um Korrekturen an bereits importierten Transaktionen vorzunehmen, befolgen Sie diese Schritte:
- Nehmen Sie die erforderlichen Änderungen an Ihrer CSV-Datei vor.
- Importieren Sie die Transaktionen mit denselben Kennungen erneut.
- Legen Sie für die
transaction_
eine höhere Zahl als für den ursprünglichen Import fest.version
Stripe Tax führt Aufzeichnungen über diese Versionen und verwendet die neueste Version für seine Berechnungen und Berichte.
Weitere Informationen
Nutzungsbeschränkungen
Die Verwendung des Tools zum Importieren von Transaktionen ist eingeschränkt:
- Umfang der Daten: Das Tool dient zum Importieren externer Verkaufsdaten, um Steuerverpflichtungen zu überwachen. Verwenden Sie es nicht für den Import von USt.-pflichtigen Käufen. Durch den Import von umsatzsteuerpflichtigen Einkäufen werden die Bruttoumsatzzahlen ungenau aufgebläht und die Steuerschuld nicht richtig angepasst.
- Nur externe Transaktionen: Dieses Tool unterstützt ausschließlich den Import von Transaktionsdaten aus externen Quellen. Verwenden Sie sie nicht, um Transaktionen zu korrigieren oder zu ändern, die ursprünglich über Stripe abgewickelt wurden.
Umgang mit Steuerberechnungen
Stripe berechnet die Steuer für importierte Transaktionen nicht automatisch neu. Importierte Transaktionen werden mit dem Steuerbetrag gemeldet, den Sie in der CSV-Datei angeben, unabhängig davon, ob Sie für diesen Standort über eine aktive Stripe Tax-Registrierung verfügen.
Während in den Berichten und Oberflächen von Stripe Tax für importierte Transaktionen Steuerbeträge, nicht steuerpflichtige Beträge, Steuersätze und Steuergründe erscheinen können, sollten diese Werte nur als Schätzungen oder Näherungswerte behandelt werden.
Eingeschränkte Sichtbarkeit
Importierte Transaktionsdaten sind in einigen Berichten und Schnittstellen von Stripe Tax nur eingeschränkt sichtbar:
- Transaktionsexporte: Aufgeschlüsselte und zusammengefasste Exporte schließen Informationen zu Steuersätzen, Steuerbeträgen und Steuergründen für jeden Zuständigkeitsbereich für importierte Transaktionen aus.
- Sigma: Details zu Steuerzuständigkeitsbereichen (
tax_
-Zeilen) sind für importierte Transaktionen in Sigma-Berichten nicht verfügbar.transaction_ jurisdiction_ details - Seite „Steuerübersicht“: Das Steuerübersicht-Dashboard berücksichtigt importierte Transaktionen weder in den Berechnungen noch in der Anzeige.
- Standortberichte: Standortberichte zeigen keine importierten Transaktionen an.
Sie können importierte Transaktionsdetails weiterhin in den Steuerberichten und in der Überwachung der Verpflichtungen anzeigen.
Sichtbarkeit in anderen Stripe-Produkten
Mit dem Import-Tool importierte Transaktionen erscheinen nur in den Berichten und Schnittstellen von Stripe Tax. Um Transaktionen von Drittanbietern in andere Produkte wie Revenue Recognition aufzunehmen, müssen Sie ein separates produktspezifisches Import-Tool verwenden.
Datenverarbeitung
Historische Transaktionsdaten
Sie können historische Transaktionsdaten für jeden Zeitraum am oder nach dem 1. Oktober 2023 importieren.
Verarbeitungszeit
Es kann bis zu 24 Stunden dauern, bis die entsprechenden verarbeiteten Transaktionen in einigen Berichten und Schnittstellen von Stripe Tax angezeigt werden.