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
    Übersicht
    API-Quickstart
    Integration mit der API
    Rechnungsstellung ohne Code
    Lebenszyklus einer Rechnung
    Rechnungsvorschau
    Rechnungen bearbeiten
    Rechnungsfinalisierung planen
    Statusübergänge und Finalisierung
    Kunden-E-Mails senden
    Erstellen Sie Gutschriften
    Den Kundinnen/Kunden Rechnungen stellen
    Kund/innen
    Kundenguthaben
    Steuer-IDs von Kund/innen
    Bezahlung von Rechnungen
    Gehostete Rechnungsseite
    Zahlungspläne für Rechnungen erstellen
    Teilzahlungen akzeptieren
    Zahlungsmethoden für Rechnungen
    Automatisierte Sammlungen
    Anpassung von Rechnungen
    Rechnungen anpassen
    Vorlagen zum Darstellen von Rechnungen
    Rechnungsposten gruppieren
    Einzelposten zusammenfassen
    Rechnungsstellung weltweit
    Best Practices
    Kund/innen mit mehreren Währungen
    Sonstige Rechnungsfunktionen
    Produkte und Preise
    Mehrere Rechnungsposten auf einmal verwalten
    Steuern
Nutzungsbasierte Abrechnung
Angebote
Kundenverwaltung
Billing with other products
Umsatzsicherung
Automatisierungen
Umsatzrealisierung
Integration testen
Steuer
Übersicht
Use Stripe tax
Manage compliance
Berichte
Übersicht
Bericht auswählen
Configure reports
API für Berichte
Berichte für mehrere Konten
Umsatzrealisierung
Daten
ÜbersichtSchema
Nutzerspezifische Berichte
Data Pipeline
Datenverwaltung
StartseiteUmsatzInvoicing

Gutschriften programmatisch erstellen

Verwenden Sie die Invoicing-API, um Beträge von abgeschlossenen Rechnungen mithilfe von Stornorechnungen anzupassen oder zurückzuerstatten.

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

Notiz

Informationen zum Arbeiten mit Stornorechnungen über das Dashboard finden Sie unter Stornorechnungen ausstellen.

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.

Notiz

Sie können keine Rabattarten für einen Rechnungsposten kombinieren. Wenn Sie beispielsweise die Menge eines Postens ermäßigen, kann eine zukünftige Stornorechnung diesen Posten nur nach Menge, nicht nach Betrag, ermäßigen. Wenn Sie einen Rabatt für einen Einzelposten einlegen, kann eine zukünftige Stornorechnung diesen Posten nur nach Betrag und nicht nach Menge ermäßigen.

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:

Command Line
cURL
curl https://api.stripe.com/v1/credit_notes \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -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:

Command Line
cURL
curl https://api.stripe.com/v1/credit_notes \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -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:

AktionBeschreibung
Rückerstattung erstellenErstatten Sie den Betrag der Rechnung über die Zahlungsmethode der Kundin/des Kunden zurück.
Rückerstattung verknüpfenVerknüpfen Sie eine bestehende Rückerstattung für den Rechnungsbetrag.
Kundenguthaben gutschreibenSchreiben Sie das Kundenguthaben gut, sodass es automatisch auf zukünftige Rechnungen angerechnet wird.
Guthaben außerhalb von StripeSchreiben Sie der Rechnung einen Betrag gut, der durch eine Korrektur außerhalb von Stripe entstanden ist.

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

Command Line
cURL
curl https://api.stripe.com/v1/credit_notes \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -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:

Command Line
cURL
curl https://api.stripe.com/v1/credit_notes \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -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.

Command Line
cURL
curl https://api.stripe.com/v1/credit_notes \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -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:

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

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:

Command Line
cURL
curl https://api.stripe.com/v1/credit_notes \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -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:

Command Line
cURL
curl https://api.stripe.com/v1/credit_notes \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -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.

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