# Auf Stripe Tax umsteigen So migrieren Sie bestehende Abonnements zu Stripe Tax. Mit [Stripe Tax](https://docs.stripe.com/tax.md) können Sie die für Ihre Transaktionen einzuziehende Steuer berechnen. Die Steuern werden anhand des verkauften Produkts und des Kundenstandorts berechnet und automatisch zur Zahlung hinzugefügt. Bei einer Integration mit Stripe Tax müssen Sie bestehende Abonnements aktualisieren, um sicherzustellen, dass Steuern künftig automatisch berechnet werden. Stripe stellt Tools zur Verfügung, mit denen Sie Ihre Abonnements aktualisieren können. Sie können Abonnements auch manuell aktualisieren, wenn Sie mehr Kontrolle über bestimmte Optionen wünschen. ## Bestehende Abonnements mithilfe automatisierter Tools aktualisieren Zunächst müssen Sie Stripe Tax aktivieren. Lesen Sie den [Einrichtungsleitfaden](https://docs.stripe.com/tax/set-up.md), um zu erfahren, wie das geht. Gehen Sie folgendermaßen vor, um die Tools zu verwenden: 1. Gehen Sie zum [Dashboard](https://dashboard.stripe.com/tax/migrations). 2. Überprüfen Sie, welche Abonnements Sie aktualisieren müssen. 3. Informieren Sie sich über die empfohlenen Maßnahmen. 4. Wählen Sie aus, ob Abonnements ohne Rechnungsadresse einbezogen werden sollen, bei denen Stripe einen [abgeleiteten Standort](https://docs.stripe.com/billing/taxes/migration.md#inferred-locations) bereitstellt. Stripe aktiviert diese Option standardmäßig. Sie können sie jedoch deaktivieren, um diese Abonnements auszuschließen. 5. Überprüfen Sie die Aufschlüsselung der prognostizierten Ergebnisse: Abonnements, für die mithilfe einer Rechnungsadresse Steuern erhoben werden können, Abonnements, für die mithilfe eines abgeleiteten Standorts Steuern erhoben werden können, und Abonnements, die nicht aufgelöst werden können. 6. Bestätigen Sie die Aktualisierung. 7. Nehmen Sie alle erforderlichen manuellen Aktualisierungen für die verbleibenden Abonnements vor. Stripe entfernt manuelle [Steuersätze](https://docs.stripe.com/tax/tax-rates.md) aus den Abonnements. Sobald der Prozess abgeschlossen ist, benachrichtigen wir Sie per E-Mail. > Die Steueränderungen werden nicht anteilmäßig verrechnet. Die Aktualisierungen werden zu Beginn des nächsten Abrechnungszeitraums wirksam. Sie können die Tools verwenden, um Abonnements zu aktualisieren, die die folgenden Kriterien erfüllen: - Sie sind aktiv - Steuern werden nicht automatisch eingezogen - Über ausreichende [Adressinformationen](https://docs.stripe.com/tax/customer-locations.md#address-hierarchy-other) zur Steuerberechnung oder einen abgeleiteten Standort verfügen - [Steuerverhalten](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#set-tax-behavior-on-price) für den Preis festlegen lassen Sie müssen die folgenden Arten von Abonnements aktualisieren: - Abonnements mit Zeitplänen. Weitere Informationen finden Sie im Abschnitt [Abonnements mit Abonnementplänen aktualisieren](https://docs.stripe.com/billing/taxes/migration.md#existing-subscription-schedules). - Abonnements, die die [Zahlungstypen](https://docs.stripe.com/connect/charges.md#types), Destination Charges oder separate Zahlungen und Überweisungen verwenden. Das automatisierte Tool kann möglicherweise einige Abonnements nicht aktualisieren. Dies kann darauf hindeuten, dass das Tool aus folgenden Gründen keinen Standort für eine [ungültige Kundenadresse](https://docs.stripe.com/tax/customer-locations.md#other) ableiten kann: - Der Kunde/Die Kundin hat keine E-Mail-Adresse hinterlegt. - Die E-Mail-Adresse stimmt mit keiner früheren Transaktion im Stripe-Netzwerk überein. > Das automatisierte Tool funktioniert nicht mit Test-Abonnements. Nachdem Sie das automatisierte Tool verwendet haben, müssen Sie einige Tage warten, bevor Sie es erneut ausführen können. Überprüfen und korrigieren Sie in dieser Zeit die Abonnements, die beim ersten Versuch fehlgeschlagen sind. ## Bestehende Abonnements manuell aktualisieren - [Überprüfen Sie Kundenstandorte](https://docs.stripe.com/billing/taxes/migration.md#customer-locations) und nehmen Sie erforderliche Aktualisierungen vor. - [Aktualisieren Sie Produkte und Preise](https://docs.stripe.com/billing/taxes/migration.md#products-prices) mit Steuercodes und Steuerverhalten. - [Aktualisieren Sie Abonnements](https://docs.stripe.com/billing/taxes/migration.md#subs), um Steuern für zukünftige Rechnungen automatisch zu berechnen. - [Vergewissern Sie sich](https://docs.stripe.com/billing/taxes/migration.md#confirm), dass Sie die Abonnements korrekt aktualisiert haben. ## Kundenstandorte überprüfen Um die Steuer korrekt berechnen zu können, müssen wir den Status des Steuerstandorts des Kunden/der Kundin kennen. Das Migrationstool verwendet unsere [Hierarchie für die Standortzuweisung](https://docs.stripe.com/tax/monitoring.md#location-attribution), um den Steuerstandort eines Kunden/einer Kundin zu ermitteln. Sie können diesen im Dashboard oder in exportierten Daten überprüfen oder die Informationen über die API abrufen. #### Dashboard Um den Status des Steuerstandorts einer Kundin/eines Kunden über das Dashboard zu überprüfen, rufen Sie die [Kundenseite](https://dashboard.stripe.com/customers) auf, wählen Sie die Kundin/den Kunden aus und blenden Sie die zugehörigen Details ein. Der Status des Steuerstandorts (`automatic_tax`) hat vier mögliche Werte: | Status | Beschreibung | Mögliche Aktion | | --- | --- | --- | | Gültig (`supported`) | Die automatische Steuerberechnung wird vollständig unterstützt. | Sie müssen nichts weiter tun. | | Nicht erkannter Standort (`unrecognized_location`) | Die Adresse ist für die Ermittlung eines Steuerstandorts nicht gültig. | Bitten Sie den Kunden/die Kundin um eine aktualisierte Adresse und legen Sie [customer.address](https://docs.stripe.com/api/customers/update.md#update_customer-address) auf den neuen Wert fest. Sie können den Wert über die API oder das Dashboard aktualisieren, indem Sie die Details des Kunden/der Kundin bearbeiten. | | Nicht registriert (`not_collecting`) | Die Adresse wird erkannt und in einen Standort aufgelöst, für den Sie keinen Inkassostandort eingerichtet haben. | Die erforderliche Aktion hängt von Ihren [steuerlichen Verpflichtungen](https://docs.stripe.com/tax/monitoring.md) ab. Wenn Sie fortfahren, setzt Stripe Tax keine Steuern fest. Wenn Sie eine Festsetzung der Steuern wünschen, [fügen Sie eine aktive Registrierung](https://docs.stripe.com/tax/registering.md) für den Zuständigkeitsbereich hinzu, in dem die Kundin/der Kunde ansässig ist. | | `failed` | Bei den Servern von Stripe ist ein [Fehler](https://docs.stripe.com/error-codes.md) aufgetreten. Dies kommt nur selten vor. | Führen Sie die Anfrage erneut durch oder wenden Sie sich an den Stripe-Support, um weitere Unterstützung zu erhalten. | Wenn `status=unrecognized_location` ist, müssen Sie den Kundenstandort mit [einer Adresse aktualisieren, die Stripe Tax verwenden kann](https://docs.stripe.com/tax/customer-locations.md). Im Dashboard können Sie auf die [Kundenseite](https://dashboard.stripe.com/customers) gehen, den Kunden/die Kundin auswählen und seine/ihre Rechnungs- oder Lieferadresse unter Details ändern. ### Status des Steuerstandorts durch Exporte überprüfen Um den Status des Kundensteuerstandorts über Dashboard Exporte zu überprüfen, gehen Sie zur Seite [Kunden](https://dashboard.stripe.com/customers), klicken Sie auf **Exportieren** und wählen Sie **Alle Spalten** aus. Die CSV-Datei enthält eine boolesche Spalte mit dem Titel **Steuerstandort erkannt**. Anhand dieser können Sie ermitteln, ob die Kundin/der Kunde eine [gültige](https://docs.stripe.com/tax/customer-locations.md#supported-formats) Adresse hinterlegt hat. #### API Um den Status des Steuerstandors eines Kunden/einer Kundin mithilfe der API zu überprüfen, rufen Sie das [Kundenobjekt](https://docs.stripe.com/api/customers/object.md) ab und [erweitern](https://docs.stripe.com/api/expanding_objects.md) die Antwort, indem Sie `expand: ['tax']` zu Ihrer Anfrage hinzufügen. Sie müssen `expand` verwenden, da die Standardantwort das Feld [Steuer](https://docs.stripe.com/api/customers/object.md#customer_object-tax) nicht enthält. ```curl curl -G https://api.stripe.com/v1/customers/{{CUSTOMER_ID}} \ -u "<>:" \ -d "expand[]=tax" ``` Die Antwort enthält die erweiterten Steuerfelder, die den ermittelten Steuerstandort anzeigen und angeben, ob Sie mit dieser Kundin/diesem Kunden die automatische Steuerberechnung verwenden können. ```json { "tax": { "automatic_tax": "supported", "ip_address": null, "location": {"country": "US", "state": "CA", "source": "billing_address"} }, "id": "cus_JvecILHjNPGKSI", "object": "customer", "address": null, "balance": 0, "created": 1627380831, "currency": null, "default_source": "src_0JHnP4507O8KAxCGgDurDgoS", "delinquent": false, "description": "1st Deposit", "discount": null, "email": "jenny.rosen@example.com", "invoice_prefix": "66CD4DB9", "invoice_settings": { "custom_fields": null, "default_payment_method": null, "footer": null }, "livemode": false, "metadata": { }, "name": "Jenny Rosen", "next_invoice_sequence": 1, "phone": null, "preferred_locales": [ ], "shipping": null, "tax_exempt": "none" } ``` Der Wert von `automatic_tax` (im Dashboard **Status des Steuerstandorts**) hat vier mögliche Status: | Status | Beschreibung | Mögliche Aktion | | --- | --- | --- | | Gültig (`supported`) | Die automatische Steuerberechnung wird vollständig unterstützt. | Sie müssen nichts weiter tun. | | Nicht erkannter Standort (`unrecognized_location`) | Die Adresse ist für die Ermittlung eines Steuerstandorts nicht gültig. | Bitten Sie den Kunden/die Kundin um eine aktualisierte Adresse und legen Sie [customer.address](https://docs.stripe.com/api/customers/update.md#update_customer-address) auf den neuen Wert fest. Sie können den Wert über die API oder das Dashboard aktualisieren, indem Sie die Details des Kunden/der Kundin bearbeiten. | | Nicht registriert (`not_collecting`) | Die Adresse wird erkannt und in einen Standort aufgelöst, für den Sie keinen Inkassostandort eingerichtet haben. | Die erforderliche Aktion hängt von Ihren [steuerlichen Verpflichtungen](https://docs.stripe.com/tax/monitoring.md) ab. Wenn Sie fortfahren, setzt Stripe Tax keine Steuern fest. Wenn Sie eine Festsetzung der Steuern wünschen, [fügen Sie eine aktive Registrierung](https://docs.stripe.com/tax/registering.md) für den Zuständigkeitsbereich hinzu, in dem die Kundin/der Kunde ansässig ist. | | `failed` | Bei den Servern von Stripe ist ein [Fehler](https://docs.stripe.com/error-codes.md) aufgetreten. Dies kommt nur selten vor. | Führen Sie die Anfrage erneut durch oder wenden Sie sich an den Stripe-Support, um weitere Unterstützung zu erhalten. | Wenn `status=unrecognized_location` ist, müssen Sie den Kundenstandort mit [einer Adresse aktualisieren, die Stripe Tax zur Berechnung der Steuer verwenden kann](https://docs.stripe.com/tax/customer-locations.md). Sie können [den Kunden/die Kundin über die API aktualisieren](https://docs.stripe.com/api/customers/update.md#update_customer-address): ```curl curl https://api.stripe.com/v1/customers/{{CUSTOMER_ID}} \ -u "<>:" \ -d "address[line1]=27 Fredrick Ave" \ -d "address[city]=Brothers" \ -d "address[postal_code]=97712" \ -d "address[state]=OR" \ -d "address[country]=US" \ -d "expand[]=tax" ``` Weitere Informationen darüber, welche Kundenadresse gültig ist, wie sie verwendet wird oder wie mit Fehlern umzugehen ist, finden Sie unter [Erfassen von Kundenadressen](https://docs.stripe.com/tax/customer-locations.md). ### Abgeleitete Standorte Wenn für eine/n Kunden/Kundin keine Rechnungsadresse hinterlegt ist, kann Stripe die E-Mail-Adresse mit Standortdaten aus einer früheren Transaktion im Stripe-Netzwerk abgleichen. Ein abgeleiteter Standort kann je nach den verfügbaren Daten das Land, die Postleitzahl und die erste Adresszeile umfassen. Dadurch können für Abonnements, bei denen die Migration ansonsten fehlschlagen würde, Steuern erhoben werden. Für abgeleitete Standorte gilt Folgendes: - Sie kommen nur zur Anwendung, wenn die Alternative darin besteht, überhaupt keine Steuern zu erheben. - Sie umfassen die verfügbaren Daten zu Land, Postleitzahl und erster Adresszeile. - Sie müssen innerhalb des First-Party-Netzwerks von Stripe übereinstimmen. - Sie haben die niedrigste Priorität. Jede Rechnungs- oder Versandadresse führt automatisch zur Überschreibung des abgeleiteten Standorts. Die Verwendung abgeleiteter Standorte erfordert ein aktives [Kundenportal](https://docs.stripe.com/customer-management.md) mit aktivierten Adressaktualisierungen, damit Ihre Kundinnen und Kunden jederzeit eine vollständige Adresse angeben können, um eine genauere Steuerberechnung zu ermöglichen. Wenn ein abgeleiteter Standort keine Straßenangabe enthält, spiegelt die entsprechende Postleitzahl für Kundinnen und Kunden in Gebieten, in denen die Steuersätze innerhalb einer Postleitzahlenregion variieren, möglicherweise nicht den korrekten steuerlichen Zuständigkeitsbereich wider. Für die meisten Steuerberechnungen in den USA ist die Auflösung auf Postleitzahlenebene ausreichend. Stripe gewährleistet den Datenschutz, indem E-Mail-Adressen und Standortdaten ausschließlich innerhalb seines First-Party-Netzwerks abgeglichen werden. Um zu sehen, ob ein Abonnement einen abgeleiteten Standort verwendet, überprüfen Sie die Seite mit den Kundendetails oder die Transaktionsdetails. Abgeleitete Standorte sind mit **Abgeleitet** gekennzeichnet. ## Produkte und Preise aktualisieren Für Ihre Produkte und Preise wird das Standard-Steuer-Verhalten verwendet, das Sie bei der Aktivierung von Stripe Tax zugewiesen haben. Wenn Sie es vorziehen, aktive Produkte und Preise zu aktualisieren, um die Steuer unabhängig zu berechnen, legen Sie einen tax_code und ein tax_behavior fest. Hier finden Sie die vollständige Liste der[verfügbaren Steuercodes](https://docs.stripe.com/tax/tax-codes.md) und die[Anleitung zum Einrichten](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md) von Steuercodes und Steuerverhalten für weitere Informationen. ### Produkte aktualisieren Aktualisieren Sie zuerst alle vorhandenen Produkte mit einem `tax_code`. Wenn Sie keinen expliziten `tax_code` für Ihr Produkt definieren, verwendet Stripe Tax den voreingestellten Produktsteuercode aus Ihren Einstellungen. #### Dashboard Um ein Produkt mit einem `tax_code` im Dashboard zu aktualisieren, rufen Sie die Seite [Produkte](https://dashboard.stripe.com/products?active=true) auf, wählen Sie ein zu bearbeitendes Produkt aus und wählen Sie auf der Produktinformationsseite den Steuercode aus dem Dropdown-Menü aus. #### API So aktualisieren Sie ein Produkt mit einem `tax_code` mithilfe der API: ```curl curl https://api.stripe.com/v1/products/{{PRODUCT_ID}} \ -u "<>:" \ -d "tax_code={{TAXCODE_ID}}" ``` ### Preise aktualisieren Aktualisieren Sie als Nächstes das Steuerverhalten für Ihre Preise. > Sie können `tax_behavior` nicht mehr ändern, nachdem es auf `exclusive` oder `inclusive` festgelegt wurde. Wenn Sie das Steuerverhalten eines Preises ändern möchten, müssen Sie einen neuen Preis mit dem gewünschten Verhalten erstellen und den alten Preis archivieren. #### Dashboard So aktualisieren Sie einen Preis über das Dashboard: 1. Rufen Sie die [Produktseite](https://dashboard.stripe.com/products) auf. 2. Wählen Sie das Produkt mit dem Preis aus, den Sie aktualisieren möchten. 3. Wählen Sie im Abschnitt „Preisinformationen“ zusätzliche Optionen aus. 4. Wählen Sie in Dropdown-Menü **Steuer im Preis berücksichtigen** das Verhalten aus, das Sie mit dem Preis verknüpfen möchten. #### API So aktualisieren Sie einen Preis mithilfe der API: ```curl curl https://api.stripe.com/v1/prices/{{PRICE_ID}} \ -u "<>:" \ -d tax_behavior=exclusive ``` ## Abonnements aktualisieren Nachdem Ihre Kund/innen, Produkte und Preise aktualisiert wurden, können Sie bestehende Abonnements aktualisieren. Die Liste der Abonnements, die aktualisiert werden müssen, finden Sie auf der [Abonnementseite im Dashboard](https://dashboard.stripe.com/subscriptions). Um nur Abonnements anzuzeigen, bei denen die automatische Besteuerung nicht aktiviert ist, klicken Sie auf **Filter**, aktivieren Sie **Automatische Steuer** und wählen Sie **Deaktiviert** aus. Alternativ können Sie alle gefilterten Abonnements exportieren, um sie als CSV-Datei anzuzeigen. Klicken Sie dazu auf **Exportieren** und wählen Sie **Alle** als **Datumsbereich** aus. Der Ablauf zum Aktualisieren von Abonnements hängt von ihrem Status ab: - Wenn Ihre Abonnements [keine bestehenden Steuersätze haben](https://docs.stripe.com/billing/taxes/migration.md#no-tax-rates), müssen Sie nur die automatische Steuerberechnung aktivieren. - Wenn Ihre Abonnements (entweder auf Abonnement- oder auf Postenebene) [bestehende Steuersätze](https://docs.stripe.com/billing/taxes/migration.md#existing-tax-rates) haben, müssen Sie alle bestehenden Steuersätze löschen und die automatische Steuerberechnung aktivieren. Um zu verhindern, dass anteilig verrechnete Posten erstellt werden, können Sie diese Aktualisierung planen. - Wenn für Ihre Abonnements [Abonnementpläne](https://docs.stripe.com/billing/taxes/migration.md#existing-subscription-schedules) vorhanden sind, müssen Sie Instanzen von `automatic_tax[enabled]=false` in den Abonnementplänen entfernen. ### Abonnements ohne bestehende Steuersätze aktualisieren #### Dashboard Um Abonnements ohne vorhandene Steuersätze über das Dashboard zu aktualisieren, aktualisieren Sie das Abonnement und aktivieren die Option **Steuer automatisch berechnen**. #### API Um [Abonnements zu aktualisieren](https://docs.stripe.com/api/subscriptions/update.md), für die Sie keine [Steuersätze](https://docs.stripe.com/tax/tax-rates.md) konfiguriert haben, setzen Sie [automatic_tax.enabled](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-automatic_tax) auf `true`. ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -d "automatic_tax[enabled]=true" ``` Durch Festlegen von `automatic_tax.enabled=true` wird die automatische Steuerberechnung für alle nachfolgenden Rechnungen aktiviert, die für dieses Abonnement erstellt wurden. ### Abonnements mit vorhandenen Steuersätzen aktualisieren #### Dashboard Um Abonnements mit [Steuersätzen](https://docs.stripe.com/tax/tax-rates.md) zu aktualisieren, bearbeiten Sie das Abonnement und aktivieren dann die Option **Steuer automatisch berechnen**. Das Dashboard entfernt alle bestehenden Steuersätze und berechnet die Steuer künftig automatisch. Falls Sie Ihre Preise nicht aktualisiert haben, um `tax_behavior` festzulegen, fordert Sie das Dashboard dazu auf, alle fehlenden Informationen anzugeben. Erst dann können Sie das Abonnement aktualisieren. #### API Um Abonnements mit auf [Abonnementebene](https://docs.stripe.com/billing/taxes/collect-taxes.md?tax-calculation=tax-rates#static-configuration) festgelegten [Steuersätzen](https://docs.stripe.com/tax/tax-rates.md) zu aktualisieren, müssen Sie die Steuersätze entfernen und dann `automatic_tax` aktivieren. Wenn Sie die Aktualisierung vornehmen: - Übergeben Sie in den Feldern [default_tax_rates](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-default_tax_rates) und [tax_rates](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-items-data-tax_rates) eine leere Zeichenfolge für jeden [Abonnementposten](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-items). Dadurch werden die Steuersätze sowohl auf Abonnementebene (`default_tax_rates`) als auch auf Postenebene (`tax_rates`) gelöscht. - Legen Sie [automatic_tax.enabled](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-automatic_tax) auf `true` fest. - Setzen Sie [proration_behavior](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-proration_behavior) auf `none`. #### Ruby ```ruby # Don't put any keys in code. See https://docs.stripe.com/keys-best-practices. # Find your keys at https://dashboard.stripe.com/apikeys. client = Stripe::StripeClient.new('<>') subscription = client.v1.subscriptions.retrieve('{{SUBSCRIPTION_ID}}') client.v1.subscriptions.update( subscription.id, { automatic_tax: { enabled: true }, # Removes existing tax_rates for each item in the subscription items: subscription.items.data.map {|item| {id: item.id, tax_rates: ''}}, default_tax_rates: '', proration_behavior: 'none' } ) ``` ### Abonnements mit Abonnementplänen aktualisieren Wenn Sie Steuern erheben müssen und eines Ihrer Abonnements einen Abonnementplan enthält, mit dem `automatic_tax[enabled]=false` festgelegt wird, müssen Sie diesen Parameter entfernen. Aktualisieren Sie dazu alle Phasen des Abonnements, indem Sie `automatic_tax[enabled]=false` entfernen und `default_settings[automatic_tax][enabled]=true` festlegen. Wenn Sie einen Abonnementplan aktualisieren, müssen Sie alle aktuellen und zukünftigen Phasen übergeben. Überprüfen Sie dazu die festgelegten Parameter und aktivieren Sie dann Stripe Tax im Abonnementplan. ```curl curl https://api.stripe.com/v1/subscription_schedules/{{SUBSCRIPTIONSCHEDULE_ID}} \ -u "<>:" ``` Um den Abonnement-Zeitplan zu aktualisieren, nachdem Sie ihn erhalten haben, entfernen Sie den Parameter `automatic_tax[enabled]=false` und übergeben Sie die anderen Phasen und Parameter: ```curl curl https://api.stripe.com/v1/subscription_schedules/{{SUBSCRIPTIONSCHEDULE_ID}} \ -u "<>:" \ -d "phases[0][items][0][price]={{PRICE_ID}}" \ -d "phases[0][items][0][quantity]=1" \ -d "phases[0][start_date]=1577865600" \ -d "phases[0][end_date]=1578038400" \ -d "phases[1][items][0][price]={{PRICE_ID}}" \ -d "phases[1][items][0][quantity]=2" \ -d "phases[1][start_date]=1578038400" \ -d "phases[1][end_date]=1580544000" \ -d "default_settings[automatic_tax][enabled]=true" ``` #### Aktualisierung planen Wenn Sie verhindern möchten, dass ein anteilig verrechneter Posten erstellt wird, können Sie die Aktualisierung für den Beginn des nächsten Zyklus planen. Derzeit können Abonnement-Aktualisierungen nur über die API geplant werden: #### Ruby ```ruby # Don't put any keys in code. See https://docs.stripe.com/keys-best-practices. # Find your keys at https://dashboard.stripe.com/apikeys. client = Stripe::StripeClient.new('<>') subscription = client.v1.subscriptions.retrieve( '{{SUBSCRIPTION_ID}}', ) schedule = client.v1.subscription_schedules.create({ from_subscription: subscription.id }) client.v1.subscription_schedules.update( schedule.id, { end_behavior: 'release', phases: [ # The first phase contains items for the # latest subscription invoice { items: [ # Prices and tax_rates for each item { price: '{{PRICE_ID}}', tax_rates: [ '{{TAX_RATE_ID}}' ] } ], default_tax_rates: ['{{TAX_RATE_ID}}'], start_date: subscription.items.data[0].current_period_start, end_date: subscription.items.data[0].current_period_end }, # The second phase removes manual tax rates and enables # automatic tax calculation { items: [ # Prices for each item with tax_rates: [] { price: '{{PRICE_ID}}', tax_rates: [] } ], default_tax_rates: [], automatic_tax: {enabled: true}, iterations: 1 } ] } ) ``` ## Aktualisierungen überprüfen Um sicherzustellen, dass Sie Ihre Abonnements korrekt aktualisiert haben, erstellen Sie für jedes Abonnement eine [Rechnungsvorschau](https://docs.stripe.com/api/invoices/create_preview.md) und überprüfen Sie die Ergebnisse der Steuerberechnung. Sie können die Steuerbeträge aus den Feldern [tax](https://docs.stripe.com/api/invoices/object.md#invoice_object-tax) und [total_tax_amounts](https://docs.stripe.com/api/invoices/object.md#invoice_object-total_tax_amounts) auf der Rechnungsvorschau und aus den postenbezogenen Feldern [tax_amounts](https://docs.stripe.com/api/invoice-line-item/object.md#invoice_line_item_object-tax_amounts) abrufen. Die Rechnung verfügt über ein Feld [automatic_tax](https://docs.stripe.com/api/invoices/object.md#invoice_object-automatic_tax), das den Status der Berechnung als einen von drei möglichen Status anzeigt: | Status | Beschreibung | Mögliche Aktion | | --- | --- | --- | | `complete` | Stripe Tax hat die Steuern für die Zahlung erfolgreich festgesetzt. | Sie können die Steuerbeträge aus den Feldern „tax“ und `total_tax_amounts` auf der letzten Rechnung und aus den Feldern `tax_amounts` für die einzelnen Posten abrufen. | | `requires_location_inputs`1 | Stripe Tax konnte keine Steuern festsetzen, da nicht genügend Informationen zur Bestimmung des Kundenstandorts zur Verfügung standen. | Erfassen Sie weitere Informationen von einer Kundin/einem Kunden (z. B. eine vollständige Adresse) und aktualisieren Sie das [customer.address](https://docs.stripe.com/api/customers/update.md#update_customer-address)-Feld. | | `failed` | Interner Fehler bei Stripe. | Führen Sie die Anfrage erneut durch oder wenden Sie sich an den Support von Stripe, um weitere Unterstützung zu erhalten. | 1 Wenn Sie abgeleitete Standorte aktivieren, werden Abonnements, die zuvor `requires_location_inputs` zurückgegeben haben, möglicherweise aktualisiert und abgeschlossen, wobei die Steuer basierend auf dem [abgeleiteten Standort](https://docs.stripe.com/billing/taxes/migration.md#inferred-locations) berechnet wird. ## See also - [Steuern für wiederkehrende Zahlungen einziehen](https://docs.stripe.com/billing/taxes/collect-taxes.md?tax-calculation=stripe-tax) - [Produkte, Preise, Steuercodes und Steuerverhalten](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md)