Weiter zum Inhalt
Konto erstellen
oder
anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellen
Anmelden
Jetzt starten
Zahlungen
Umsatz
Plattformen und Marktplätze
Geldmanagement
Entwicklerressourcen
Übersicht
Billing
ÜbersichtÜber die Billing APIs
Abonnements
Invoicing
Nutzungsbasierte Abrechnung
Angebote
Kundenverwaltung
Abrechnung mit anderen Produkten
Umsatzsicherung
Automatisierungen
Integration testen
Steuer
Übersicht
Stripe Tax verwenden
Compliance-Management
    Ihre Pflichten im Blick behalten
    Jetzt anmelden
    Steuererklärung und -abführung
    Transaktionen importieren
    Berichte
Berichte
Übersicht
Bericht auswählen
Berichte konfigurieren
API für Berichte
Berichte für mehrere Konten
Umsatzrealisierung
Daten
ÜbersichtSchema
Nutzerspezifische Berichte
Data Pipeline
Datenverwaltung
StartseiteUmsatzManage compliance

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:

  1. Sie exportieren Ihre Transaktionsdaten von externen Plattformen.
  2. Sie formatieren die Daten in einer CSV-Datei mit einer Zeile pro Posten (nicht pro Transaktion).
  3. Sie laden die CSV-Datei über das Dashboard in Stripe Tax hoch.
  4. Stripe Tax prüft und verarbeitet Ihre Daten.
  5. 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_transaction_id
Text Erforderlich
order_123abc
Eindeutige Kennung für die Transaktion
transaction_type
Entweder Sale, Refund oder Void Erforderlich
Sale
Art der Transaktion
transaction_version
Anzahl Optional
1, 1712863281 (Unix-Zeitstempel)
Numerisches Feld zur Angabe der neuesten Version der Transaktion
provider
Text Erforderlich
amazon, tax_jar, shopify
Externe Quelle der Transaktion
liable_transaction_id
Text Erforderlich für Rückerstattung oder Stornierung
order_abc123
Quellentransaktions-ID, die von dieser Rückerstattung oder Stornierung verarbeitet wird
tax_rules_at
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_at
Datum und Uhrzeit (Format yyyy-MM-dd HH:mm:ss z) Erforderlich
2024-02-22 18:42:47 UTC
Erstellungsdatum der Transaktion
posted_at
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_id
Text Optional
cus_123
Kunden-ID von Stripe
tax_exempt
Entweder exempt, none oder reverse Erforderlich
exempt
Steuerbefreiungsstatus der Transaktion
line_item.id
Text Erforderlich
item_123
Posten-ID
line_item.tax_behavior
Entweder Exclusive oder Inclusive Optional
Exclusive
Steuerverhalten für Posten
line_item.amount
Anzahl1 Optional
150.50
Betrag des Postens mit Steuer
line_item.product_id
Text Optional
prod_123
Stripe-Produkt-ID
line_item.product_name
Text Optional
Premium Widget
Durch Nutzer/in angegebener Produktname
line_item.product_description
Text Optional
High-quality widget for premium customers
Kostenloses Formular mit Produktbeschreibung
line_item.product_tax_code
Text Optional
txcd_99999999
Ein Produktsteuercode von Stripe, der diese Transaktion klassifiziert. Falls nicht angegeben, wird die Standard-Produktsteuer verwendet.
line_item.external_product_id
Text Optional
SKU123
Externe Produkt-ID (zum Beispiel Händler-SKUs)
line_item.external_tax_code
Text Optional
TX456
Externer Steuercode für Produkt
line_item.unit_amount
Nummer1 Erforderlich
50.12
Kosten für eine einzelne Einheit
line_item.quantity
Zahl (Dezimalwerte werden unterstützt) Erforderlich
1, 2, 3.5
Menge der Einheit
line_item.amount_discount
Anzahl1 Optional
10.00
Rabatt für bestimmten Posten
line_item.taxable_amount
Anzahl1 Optional
45.50
Steuerbemessungsgrundlagen für bestimmten Posten
line_item.tax_rate
Anzahl Optional
0.08
Auf Postenebene aggregierter Steuersatz
line_item.amount_tax
Nummer1 Erforderlich
12.18
Gesamtbetrag der für den angegebenen Posten erhobenen Steuer
shipping_line_item.id
Text Erforderlich bei Nutzung von Versand2
ship_123
Externe Versandposten-ID
shipping_line_item.tax_behavior
Entweder exclusive oder inclusive Erforderlich bei Nutzung von Versand
exclusive
Steuerverhalten für Versandposten
shipping_line_item.amount
Nummer1 Erforderlich bei Versandnutzung
5.99
Betrag der Versandposteneinheit
shipping_line_item.taxable_amount
Number1 Erforderlich, wenn `tax_rate` fehlt
5.99
Zu versteuernder Betrag für den Versand
shipping_line_item.tax_rate
Nummer Erforderlich, wenn `taxable_amount` fehlt
0.08
Steuersatz für Versand
shipping_line_item.amount_tax
Nummer1 Erforderlich bei Versandnutzung
0.48
Eingezogene Steuer für Versandposten
shipping_line_item.description
Text Optional
Express Shipping
Kostenloses Formular mit Beschreibung der Rechnungsposten
shipping_line_item.tax_code
Entweder txcd_00000000 oder txcd_92010001 Optional
txcd_92010001
Ein Produktsteuercode von Stripe, der den Versandposten klassifiziert.
shipping_line_item.external_tax_code
Text Optional
TX789
Externer Steuercode für den Versand
shipping_line_item.amount_discount
Anzahl1 Optional
2.00
Rabatt für Versandposten
merchant_address.city
Text Optional
San Francisco
Stadt der Händlerin/des Händlers
merchant_address.country
Ländercode (ISO 3166-1 alpha-2) Erforderlich
US
Land der Händlerin/des Händlers
merchant_address.line1
Text Optional
123 Commerce St
Zeile 1 der Händleradresse
merchant_address.line2
Text Optional
Suite 400
Zeile 2 der Händleradresse
merchant_address.postal_code
Text Erforderlich für USA/CA
94111
Postleitzahl der Händlerin/des Händlers
merchant_address.state
Text Optional
CA
Bundesland der Händlerin/des Händlers
tax_ids.type
Text Optional
EU_OSS_VAT, CA_QST
Typ der angegebenen Steueridentifikationsnummer
tax_ids.country
Ländercode (ISO 3166-1 alpha-2) Optional
US, CA
Zweistelliger Ländercode der Steueridentifikationsnummer
tax_ids.value
Text Optional
12-3456789
Wert der Steueridentifikationsnummer
buyer_address.city
Text3 Optional
Boston
Stadt des Käufers/der Käuferin
buyer_address.country
Ländercode (ISO 3166-1 alpha-2)3 Erforderlich
US
Land des Käufers/der Käuferin
buyer_address.line1
Text3 Optional
456 Main St
Zeile 1 der Käuferadresse
buyer_address.line2
Text3 Optional
Apt 789
Zeile 2 der Käuferadresse
buyer_address.postal_code
Text3 Erforderlich für US/CA
02108
Postleitzahl der Käuferin/des Käufers
buyer_address.state
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.00 in USD gleich $10.00.

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_type auf 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_ids.*-Felder
    • Alle shipping_line_item.*-Felder

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_type auf Refund oder Void festlegen
  • Setzen Sie liable_transaction_id auf die source_transaction_id der ursprünglichen Transaktion
  • 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_type auf Refund oder Void festlegen
  • Setzen Sie liable_transaction_id auf die source_transaction_id der ursprünglichen Transaktion
  • 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_ids.*-Felder
    • Alle shipping_line_item.*-Felder

Transaktionen korrigieren

So korrigieren Sie eine zuvor importierte Transaktion:

  1. Duplizieren Sie die Transaktion, die Sie korrigieren möchten, wie folgt:
    • source_transaction_id
    • transaction_type
    • provider
  2. Aktualisieren Sie alle Felder, die korrigiert werden müssen
  3. Erhöhen Sie den transaction_version-Wert (z. B. von 1 auf 2)

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_version-Wert.

Einschränkungen beim Import

EinschränkungDetails
Maximale Dateigröße50 MB
Unterstütztes DateiformatNur CSV
KopfzeileErforderlich (muss Spaltennamen enthalten, wie oben angegeben)
DateiverarbeitungDie Verarbeitung großer Dateien kann länger dauern
Auswirkungen von BerichtenDie 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:

  1. Gehen Sie zum Abschnitt Steuern im Stripe-Dashboard.
  2. Klicken Sie auf Schnelle Aktionen und wählen Sie dann Transaktionen importieren aus.
  3. Klicken Sie auf CSV importieren.
  4. Wählen Sie Ihre vorbereitete CSV-Datei aus und klicken Sie auf Datei importieren.
  5. Ü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_version verwenden, um Aktualisierungen ordnungsgemäß zu verarbeiten. Um Korrekturen an bereits importierten Transaktionen vorzunehmen, befolgen Sie diese Schritte:

  1. Nehmen Sie die erforderlichen Änderungen an Ihrer CSV-Datei vor.
  2. Importieren Sie die Transaktionen mit denselben Kennungen erneut.
  3. Legen Sie für die transaction_version eine höhere Zahl als für den ursprünglichen Import fest.

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_transaction_jurisdiction_details-Zeilen) sind für importierte Transaktionen in Sigma-Berichten nicht verfügbar.
  • 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.

Siehe auch

  • Steuerberichterstattung
  • Überwachung der Steuerpflichten
  • Steueranmeldung
War diese Seite hilfreich?
JaNein
  • Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
  • Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
  • Schauen Sie sich unser Änderungsprotokoll an.
  • Fragen? Sales-Team kontaktieren.
  • LLM? Lesen Sie llms.txt.
  • Unterstützt von Markdoc