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)
- 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_
gilt für die Artikel einer Bestellungtax_ additional_ fee_ item stripe_
gilt für das Angebottax_ additional_ fee_ quote stripe_
gilt für Rechnungspositionentax_ additional_ fee_ invoice_ item
stripe_
gilt für die gesamte Rechnungtax_ additional_ fee_ invoice stripe_
gilt für Gutschriftspositionentax_ additional_ fee_ creditmemo_ item stripe_
gilt für die gesamte Gutschrifttax_ additional_ fee_ creditmemo
Jedes der Ereignisse enthält ein Magento-Datenobjekt mit dem Namen additional_
, 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.
) das folgende Ereignis hinzu:
Die Daten, die zusätzlich zum additional_
für das Ereignis bereitgestellt werden, sind:
item
: Der Artikel, für den die Steuer berechnet wirdquote
: Das Angebot, zu dem der Artikel gehört
Fügen Sie in Ihrer Überwachungsdatei (app/code/Vendor/YourModule/Observer/AddAdditionalFeeForQuoteItem.
) 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.
) das folgende Ereignis hinzu:
Die Daten, die zusätzlich zum additional_
für das Ereignis bereitgestellt werden, sind:
quote
: Das Angebot, für das die Steuer berechnet wirdtotal
: Die gesammelten Summen bis zu diesem Punkt
Fügen Sie innerhalb Ihrer Überwachungsdatei app/code/Vendor/YourModule/Observer/AddAdditionalFeeForQuote.
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.
) das folgende Ereignis hinzu:
Die Daten, die zusätzlich zum additional_
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.
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.
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.
) das folgende Ereignis hinzu:
Bei den Daten, die dem Ereignis zur Verfügung gestellt werden, handelt es sich abgesehen von additional_
um:
invoice
: Die Rechnung, auf der die nutzerdefinierte Gebühr erhoben wirdorder
: Der Auftrag, zu dem die Rechnung gehört
Fügen Sie innerhalb Ihrer Überwachungsdatei app/code/Vendor/YourModule/Observer/AddAdditionalFeeForInvoice.
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_
wird aus dem Array entfernt und Sie erhalten ein neues Feld namens amount_
, 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.
) das folgende Ereignis hinzu:
Die Daten, die zusätzlich zum additional_
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
invoice
: Das Angebot, zu dem der Artikel gehörtorder
: Das Angebot, zu dem der Artikel gehört
Fügen Sie in Ihrer Überwachungsdatei (app/code/Vendor/YourModule/Observer/AddAdditionalFeeForCreditmemoItem.
) 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.
) das folgende Ereignis hinzu:
Die Daten, die zusätzlich zum additional_
für das Ereignis bereitgestellt werden, sind:
creditmemo
: Das Angebot, zu dem der Artikel gehörtinvoice
: Das Angebot, zu dem der Artikel gehörtorder
: Das Angebot, zu dem der Artikel gehört
Fügen Sie in Ihrer Überwachungsdatei (app/code/Vendor/YourModule/Observer/AddAdditionalFeeForCreditmemo.
) den Code zum Erstellen der Details für die Berechnung wie im folgenden Beispiel hinzu: