Gutschriften programmatisch erstellen

Generieren Sie eine Stornorechnung, um den Saldo einer open oder paid Rechnung zu korrigieren.

Beim Erstellen einer Stornorechnung stehen Ihnen drei Möglichkeiten zur Verfügung:

• Rabatt auf einen festen Betrag von einem Rechnungsposten.
• Rabatt auf eine Menge aus einem Rechnungsposten. Der Gesamtrabatt ergibt sich aus der Menge multipliziert mit dem Stückpreis dieses Postens.
• Wenden Sie einen Rabatt auf den gesamten Rechnungsbetrag an, indem Sie einen benutzerdefinierten Rabattposten mit einer Beschreibung, einer Menge und einem Stückpreis hinzufügen. Der Gesamtrabatt ergibt sich aus der Menge multipliziert mit dem Stückpreis.

Wir empfehlen, Rechnungsposten nach Möglichkeit zu rabattieren, da jede Gutschrift einem Posten zugeordnet wird. Das Hinzufügen eines benutzerdefinierten Rabattpostens kann die Berichterstattung und die Nachverfolgung erschweren, da die Gutschrift keinem echten Rechnungsposten zugeordnet ist.

Gutschriften für offene Rechnungen

Wenn Sie einen nutzerdefinierten Stornorechnungsposten für eine open Rechnung erstellen, wird der amount_due auf der Rechnung auf Grundlage der custom_line_items der Stornorechnung reduziert. Das geschieht zusätzlich zu den Anpassungen, die Sie an bestehenden invoice_line_items vorgenommen haben. Wenn der fällige Betrag einer open Rechnung beispielsweise 100 USD beträgt und Sie eine custom_line_item mit quantity=1 und unit_amount=2000 erstellen, beträgt der neue fällige Betrag auf der Rechnung 80 USD.

Stornorechnungen erscheinen als Positionen Anwendung von Rabatten und Steuern auf Rechnungen, d. h. es handelt sich um einen korrigierten Betrag nach Steuern. Wir berechnen den fälligen Rechnungsbetrag in der folgenden Reihenfolge:

1. Summe der Rechnungsposten
2. Rabatte
3. Rechnungsbetrag vor Steuern
4. Steuern
5. Kundenguthaben
6. Angewendete Stornorechnungen (auf fälligen Bruttobetrag)
7. Neuer fälliger Betrag

Ergibt sich aus einer Gutschriftanwendung ein Rechnungsbetrag von Null, wird die Rechnung automatisch als paid gebucht. Wenn Sie die Menge oder den Betrag eines vorhandenen Postens ändern möchten, geben Sie die Rechnungs-ID, die Posten-ID und die neue Menge oder den neuen Betrag an. Wenn ein Posten eine Menge und einen Betrag hat, können Sie nur die Menge aktualisieren. Andernfalls können Sie nur den Betrag ändern. Im folgenden Beispiel wird die Menge in zwei geändert:

curl https://api.stripe.com/v1/credit_notes \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d invoice={{INVOICE_ID}} \
  -d "lines[0][type]"=invoice_line_item \
  -d "lines[0][invoice_line_item]"={{INVOICE_LINE_ITEM}} \
  -d "lines[0][quantity]"=2

Um einen nutzerdefinierten Stornorechnungsposten zu erstellen, geben Sie die Rechnungs-ID, eine Beschreibung, die Menge und den Betrag (für die jeweilige Einheit) an. Sie können (optional) auch einen Steuersatz festlegen. In diesem Beispiel wird ein nutzerdefinierter Posten mit 10 USD erstellt:

curl https://api.stripe.com/v1/credit_notes \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d invoice={{INVOICE_ID}} \
  -d "lines[0][type]"=custom_line_item \
  -d "lines[0][description]"="Courtesy credit" \
  -d "lines[0][quantity]"=1 \
  -d "lines[0][unit_amount]"=1000

Stornorechnungen für bezahlte Rechnungen

Wenn Sie eine Stornorechnung für eine paid Rechnung erstellen, ändert sich der auf der Rechnung fällige Betrag nicht. Stattdessen können Nutzer/innen eine oder mehrere der folgenden Optionen wählen:

Im folgenden Beispiel führt die Stornorechnung zu einer Rückerstattung.

curl https://api.stripe.com/v1/credit_notes \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d invoice={{INVOICE_ID}} \
  -d "lines[0][type]"=invoice_line_item \
  -d "lines[0][invoice_line_item]"={{INVOICE_LINE_ITEM}} \
  -d "lines[0][quantity]"=2 \
  -d refund_amount=500

Hier erzeugt die Stornorechnung ein Guthaben für das Kundenguthaben:

curl https://api.stripe.com/v1/credit_notes \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d invoice={{INVOICE_ID}} \
  -d "lines[0][type]"=invoice_line_item \
  -d "lines[0][invoice_line_item]"={{INVOICE_LINE_ITEM}} \
  -d "lines[0][quantity]"=2 \
  -d credit_amount=500

Sie können auch mehrere Parameter kombinieren. Gelder, die nach Abzug der Rückerstattungs- und Stornorechnungsbeträge vom amount auf der Rechnung übrig bleibt, fließen in eine Stornorechnung außerhalb von Stripe, in der Regel in Form von Bargeld oder eines Schecks.

curl https://api.stripe.com/v1/credit_notes \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d invoice={{INVOICE_ID}} \
  -d "lines[0][type]"=invoice_line_item \
  -d "lines[0][invoice_line_item]"={{INVOICE_LINE_ITEM}} \
  -d "lines[0][quantity]"=2 \
  -d refund_amount=100 \
  -d credit_amount=200 \
  -d out_of_band_amount=200

Stornorechnungen annullieren

Sie können eine Stornorechnung nur dann annullieren, wenn sie sich auf einer offenen Rechnung befindet. Durch Stornieren einer Stornorechnung wird deren Anpassung rückgängig gemacht, wodurch sich der in der Rechnung fällige Betrag um den Betrag der Stornorechnung erhöht. So stornieren Sie eine Stornorechnung:

curl -X POST https://api.stripe.com/v1/credit_notes/{{CREDIT_NOTE_ID}}/void \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

Gutschrift negativer Posten

Sie können einen negativen Betrag für einen negativen invoice_line_item mit dem Parameter amount oder quantity gutschreiben.

Zum Beispiel, wenn Sie eine open Rechnung mit zwei Einzelposten haben:

• ein positiver Posten mit quantity=1 und unit_amount=10000
• und ein negativer Posten mit quantity=1 und unit_amount=-5000.

In diesem Beispiel wird der Parameter amount verwendet, um den vollen Betrag beider Posten gutzuschreiben:

curl https://api.stripe.com/v1/credit_notes \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d invoice={{INVOICE_ID}} \
  -d "lines[0][type]"=invoice_line_item \
  -d "lines[0][invoice_line_item]"={{POSITIVE_INVOICE_LINE_ITEM}} \
  -d "lines[0][amount]"=10000 \
  -d "lines[1][type]"=invoice_line_item \
  -d "lines[1][invoice_line_item]"={{NEGATIVE_INVOICE_LINE_ITEM}} \
  -d "lines[1][amount]"=-5000

In diesem Beispiel wird der Parameter quantity verwendet, um dasselbe zu tun:

curl https://api.stripe.com/v1/credit_notes \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d invoice={{INVOICE_ID}} \
  -d "lines[0][type]"=invoice_line_item \
  -d "lines[0][invoice_line_item]"={{POSITIVE_INVOICE_LINE_ITEM}} \
  -d "lines[0][quantity]"=1 \
  -d "lines[1][type]"=invoice_line_item \
  -d "lines[1][invoice_line_item]"={{NEGATIVE_INVOICE_LINE_ITEM}} \
  -d "lines[1][quantity]"=1

Es gelten die folgenden Einschränkungen:

• Der Gesamtbetrag der Stornorechnung muss positiv bleiben.
• Der Gesamtbetrag, der für einen negativen Posten gutgeschrieben wird, muss negativ sein.
• Der Gesamtbetrag, der für einen negativen Posten gutgeschrieben wird, darf nicht geringer sein als der Postenbetrag.

Sie können auch keinen negativen Betrag für einen custom_line_item gutschreiben. Wir unterstützen nur negative Beträge für invoice_line_items.