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
APIs und SDKsHilfe
Übersicht
Versionierung
Änderungsprotokoll
Aktualisieren Sie Ihre API-Version
Ihre SDK-Version aktualisieren
Essentials
SDKs
API
Tests
Stripe-CLI
Beispiel-Projekte
Tools
Stripe Dashboard
Workbench
Entwickler-Dashboard
Stripe Shell
Stripe für Visual Studio Code
Funktionen
Arbeitsabläufe
Ereignisziele
Stripe-StatuswarnungenHochgeladene Dateien
KI-Lösungen
Agent-Toolkit
Model Context ProtocolAgentische KI-SaaS-Billing-Workflows aufbauen
Sicherheit und Datenschutz
Sicherheit
Stripebot-Webcrawler
Datenschutz
Extend Stripe
Erstellen Sie Stripe-Apps
Verwenden Sie Apps von Stripe
    Übersicht
    Von Stripe entwickelte Apps
    Adobe Commerce
      Cookbooks
        Zusätzliche Metadaten zu Zahlungen hinzufügen
        Nutzerdefinierte Ereignisse zu Stripe-Webhooks hinzufügen
        Externe Zahlungsmethoden zum Zahlungsformular hinzufügen
        Einzelne Versandmethoden aus Express-Checkout-Modals entfernen
        Manuelle Erfassung aktivieren
        Die im PaymentElement-Formular angezeigten Bedingungen ausblenden
        Integrieren Sie eine nutzerdefinierte Gebühr in die Steuerberechnung
        Zahlungsformular beim Bezahlvorgang gestalten
        Testen, warum eine bestimmte Zahlungsmethode nicht angezeigt wird
      Payments- und Tax-App für Adobe Commerce
      Eigenständige Tax-App für Adobe Commerce
    Cegid
    Commercetools
    Guidewire
    Mirakl
    NetSuite
    Oracle Opera
    Oracle Simphony
    Oracle Xstore
    PrestaShop
    Salesforce
    SAP
    Shopware 6
    Stripe Tax for BigCommerce
    Stripe Tax für WooCommerce
    Partner-Apps
    Entwickeln Sie Ihre eigenen Apps
Partner
Partner-Ecosystem
Partner-Zertifizierung
Vereinigte Staaten
Deutsch
StartseiteEntwicklerressourcenUse apps from StripeAdobe CommerceCookbooks

Integrieren Sie eine nutzerdefinierte Gebühr in die Steuerberechnung

Fügen Sie den verkauften Produkten zusätzliche steuerpflichtige Gebühren hinzu.

Möglicherweise müssen Sie bei der Berechnung der Steuer zusätzliche Gebühren zu den Produkten hinzufügen und die Steuer für diese Gebühren berechnen.

Nutzerdefinierte Gebühr hinzufügen

Das Stripe Tax-Modul erstellt Anfragen zum Zeitpunkt der Erstellung von Bestellungen, Rechnungen und Gutschriften und sendet sie an die Stripe Tax Calculation API. Das Modul durchläuft die Positionen des Angebots, der Rechnung oder der Gutschrift, um die Details der Positionen oder der gesamten Bestellung zur Berechnungsanforderung hinzuzufügen.

Wenn Sie eine nutzerdefinierte Gebühr hinzufügen, die eine Steuerberechnung erfordert, müssen Sie die Details im Stripe Tax-Modul angeben, damit sie bei der Anfrage zur Steuerberechnung hinzugefügt werden kann.

Bei dieser Integration stellt der/die Entwickler/in der nutzerdefinierten Gebühr den Gesamtwert der nutzerdefinierten Gebühr über eine Überwachung bereit. Diese wird zur Tax Calculation API-Anfrage hinzugefügt und zur Berechnung an Stripe gesendet.

So funktioniert das Stripe Tax-Modul

Das Stripe Tax-Modul fügt die zusätzlichen Gebühren hinzu, je nachdem, wo die Gebühren anfallen:

  • Auf Positionsebene (die Steuer wird auf jede Position des Angebots, der Rechnung und der Gutschrift angewendet)
  1. Auf Angebots-, Bestell-, Rechnungs- oder Gutschriftebene (die Steuer wird für den gesamten Warenkorb und darüber hinaus festgelegt)

Der Drittentwickler muss die folgenden drei Details übermitteln:

  • Der Gesamtpreis der nutzerdefinierten Gebühr (wenn ein Artikel eine nutzerdefinierte Steuer von 3 hat und die Menge des Artikels 2 beträgt, beträgt der gesendete Wert 6)
  • Die Steuerklasse für die nutzerdefinierte Gebühr
  • Der Code der nutzerdefinierten Gebühr

Diese drei Komponenten werden in einem Array mit folgender Struktur weitergeleitet:

Sie müssen diese Array-Struktur basierend auf der ausgeführten Aktion (Angebotsberechnung, Rechnungserstellung oder Gutschriftserstellung) und dem Ort, an dem die nutzerdefinierte Gebühr anfällt (Artikel-, Angebots-, Rechnungs- oder Gutschriftsstufe), senden.

Nach der Überprüfung werden die Informationen an das Steuermodul gesendet und ein Objekt bereitgestellt, dem die Informationen hinzugefügt werden. Bei der Überprüfung muss je nach Phase des Bestellvorgangs und dem Ort, an dem die nutzerdefinierte Gebühr erhoben werden muss, eines der folgenden sechs Ereignisse berücksichtigt werden:

  • stripe_tax_additional_fee_item gilt für die Artikel einer Bestellung
  • stripe_tax_additional_fee_quote gilt für das Angebot
  • stripe_tax_additional_fee_invoice_item gilt für Rechnungspositionen
  1. stripe_tax_additional_fee_invoice gilt für die gesamte Rechnung
  2. stripe_tax_additional_fee_creditmemo_item gilt für Gutschriftspositionen
  3. stripe_tax_additional_fee_creditmemo gilt für die gesamte Gutschrift

Jedes der Ereignisse enthält ein Magento-Datenobjekt mit dem Namen additional_fees_container, in dem Sie die Details dessen hinzufügen können, was vom Stripe Tax-Modul berechnet werden muss. Um die Details der Steuerberechnung hinzuzufügen, rufen Sie die Methode ->addAdditionalFee() mit dem Details-Array als Parameter auf:

In Fällen, in denen diese zusätzlichen Gebühren entweder für einen übergeordneten oder untergeordneten Artikel (zum Beispiel ein gebündeltes dynamisches Produkt) hinzugefügt werden können, senden wir Ereignisse sowohl für das gebündelte Produkt als auch für die darin enthaltenen Produkte.

Wenn Sie gebündelte Produkte oder andere Arten von Produkten verwenden, bei denen Sie die Menge des übergeordneten Produkts und des Unterprodukts separat angeben können, senden Sie den Betrag der zusätzlichen Gebühr und berücksichtigen Sie die Menge der übergeordneten und untergeordneten Artikel. Menge der übergeordneten und untergeordneten Artikel.

Nachdem Stripe die Steuer für die Rechnungen berechnet hat, erhalten Sie eine Reihe von Steuer- und Basissteuerbeträgen. Sie können diese Informationen verwenden, um bei Bedarf nutzerdefinierte Felder in der Datenbank festzulegen. Das Array enthält den Gebührencode als Schlüssel und die dafür eingestellten berechneten Werte. Sie können über die getAdditionalFeesTax()-Methode darauf zugreifen, die im Artikel oder auf der Rechnung aufgerufen wird.

Beispiel für die Anwendung der Steuer auf den Artikel auf Angebotsebene

Fügen Sie innerhalb Ihrer Ereignisdatei (app/code/Vendor/YourModule/etc/events.xml) das folgende Ereignis hinzu:

Die Daten, die zusätzlich zum additional_fees_container für das Ereignis bereitgestellt werden, sind:

  • item: Der Artikel, für den die Steuer berechnet wird
  • quote: Das Angebot, zu dem der Artikel gehört

Fügen Sie in Ihrer Überwachungsdatei (app/code/Vendor/YourModule/Observer/AddAdditionalFeeForQuoteItem.php) den Code zum Erstellen der Details für die Berechnung wie im folgenden Beispiel hinzu:

Beispiel für die Anwendung der Steuer auf Angebotsebene

Fügen Sie innerhalb Ihrer Ereignisdatei (app/code/Vendor/YourModule/etc/events.xml) das folgende Ereignis hinzu:

Die Daten, die zusätzlich zum additional_fees_container für das Ereignis bereitgestellt werden, sind:

  1. quote: Das Angebot, für das die Steuer berechnet wird
  2. total: Die gesammelten Summen bis zu diesem Punkt

Fügen Sie innerhalb Ihrer Überwachungsdatei app/code/Vendor/YourModule/Observer/AddAdditionalFeeForQuote.php den Code zum Erstellen der Details für die Berechnung wie im folgenden Beispiel hinzu:

Beispiel für die Anwendung der Steuer auf den Artikel auf Rechnungsebene

Fügen Sie innerhalb Ihrer Ereignisdatei (app/code/Vendor/YourModule/etc/events.xml) das folgende Ereignis hinzu:

Die Daten, die zusätzlich zum additional_fees_container für das Ereignis bereitgestellt werden, sind:

  • item: Die Position, für die die Steuer berechnet wird. Sie können andere Details wie die Auftragsposition für diese Position einmalig in der Überwachung abrufen.
  1. invoice: Das Angebot, zu dem der Artikel gehört. Sie können Informationen wie die Bestellung des Artikels aus der Rechnung abrufen.

Fügen Sie innerhalb Ihrer Überwachungsdatei app/code/Vendor/YourModule/Observer/AddAdditionalFeeForInvoiceItem.php den Code zum Erstellen der Details für die Berechnung wie im folgenden Beispiel hinzu:

Beispiel für die Anwendung von Steuern auf Rechnungsebene

Fügen Sie innerhalb Ihrer Ereignisdatei (app/code/Vendor/YourModule/etc/events.xml) das folgende Ereignis hinzu:

Bei den Daten, die dem Ereignis zur Verfügung gestellt werden, handelt es sich abgesehen von additional_fees_container um:

  1. invoice: Die Rechnung, auf der die nutzerdefinierte Gebühr erhoben wird
  2. order: Der Auftrag, zu dem die Rechnung gehört

Fügen Sie innerhalb Ihrer Überwachungsdatei app/code/Vendor/YourModule/Observer/AddAdditionalFeeForInvoice.php den Code zum Erstellen der Details für die Berechnung. Hier ein Beispiel:

Änderungen an Gutschriften

Beim Erstellen von Gutschriften ändert sich die Struktur des Arrays, das an das Stripe Tax-Modul zurückgegeben werden muss. Die tax_class_id wird aus dem Array entfernt und Sie erhalten ein neues Feld namens amount_tax, das den Steuerbetrag enthalten muss, den Sie für die nutzerdefinierte Gebühr zurückerstatten möchten.

Notiz

Die code-Komponente des Detail-Arrays muss dieselbe Codekomponente sein, die im Rechnungsschritt angegeben wurde. Dadurch wird sichergestellt, dass Stripe weiß, von welcher Komponente die erstatteten Beträge abgezogen werden sollen.

Beträge von.

Beispiel für die Anwendung der Steuer auf die Position auf Gutschriftebene

Fügen Sie innerhalb Ihrer Ereignisdatei (app/code/Vendor/YourModule/etc/events.xml) das folgende Ereignis hinzu:

Die Daten, die zusätzlich zum additional_fees_container für das Ereignis bereitgestellt werden, sind:

  • item: Die Position, für die die Steuer berechnet wird. Sie können andere Details wie die Auftragsposition für diese Position einmalig in der Überwachung abrufen.
  • creditmemo: Das Angebot, zu dem der Artikel gehört
  1. invoice: Das Angebot, zu dem der Artikel gehört
  2. order: Das Angebot, zu dem der Artikel gehört

Fügen Sie in Ihrer Überwachungsdatei (app/code/Vendor/YourModule/Observer/AddAdditionalFeeForCreditmemoItem.php) den Code zum Erstellen der Details für die Berechnung wie im folgenden Beispiel hinzu:

Beispiel für die Anwendung von Steuern auf Gutschriftebene

Fügen Sie innerhalb Ihrer Ereignisdatei (app/code/Vendor/YourModule/etc/events.xml) das folgende Ereignis hinzu:

Die Daten, die zusätzlich zum additional_fees_container für das Ereignis bereitgestellt werden, sind:

  • creditmemo: Das Angebot, zu dem der Artikel gehört
  • invoice: Das Angebot, zu dem der Artikel gehört
  • order: Das Angebot, zu dem der Artikel gehört

Fügen Sie in Ihrer Überwachungsdatei (app/code/Vendor/YourModule/Observer/AddAdditionalFeeForCreditmemo.php) den Code zum Erstellen der Details für die Berechnung wie im folgenden Beispiel hinzu:

War diese Seite hilfreich?
JaNein
  • Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
  • Schauen Sie sich unser Änderungsprotokoll an.
  • Fragen? Sales-Team kontaktieren.
  • LLM? Lesen Sie llms.txt.
  • Unterstützt von Markdoc