Rechnungen bearbeiten

Zum Starten des Überarbeitungsvorgangs nach der Finalisierung verwenden Sie den Endpoint zum Erstellen mit dem Parameter from_invoice. Durch diese Anfrage wird ein neuer Rechnungsentwurf erstellt, der mit dem Original verknüpft ist und als Revision fungiert. Außerdem werden alle mit der Rechnung verknüpften Rechnungsposten dupliziert. Es werden jedoch keine Stornorechnungen dupliziert, was zu einer Änderung des fälligen Betrags führen könnte. Außerdem werden bei dieser Anfrage keine ausstehenden Rechnungsposten herangezogen, wie es bei der Rechnungserstellung der Fall ist.

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "from_invoice[invoice]"={{ORIGINAL_INVOICE_ID}} \
  -d "from_invoice[action]"=revision

Nachdem Sie eine Anfrage zum Erstellen einer Rechnung mit dem Parameter from_invoice übermittelt haben, antwortet Stripe wie folgt:

{
  "id": "{{FIRST_REVISION_INVOICE_ID}}",
  "status": "draft",
  "from_invoice": {
    "invoice": "{{ORIGINAL_INVOICE_ID}}",
    "action": "revision",
  },
}

Dieser neue Rechnungsentwurf enthält bis auf wenige Ausnahmen größtenteils die gleichen Felder wie die ursprüngliche Rechnung:

• Wenn Sie den Kunden/die Kundin der Rechnung aktualisiert haben, nachdem Sie die ursprüngliche Rechnung finalisiert haben, werden in der neuen Rechnung die aktualisierten Kundeninformationen verwendet. Beachten Sie, dass dies bei Verwendung der automatischen Steuer zu einer Neuberechnung des Steuerbetrags führen kann.
• Wenn die ursprüngliche Rechnung auto_advance == true lautete, wurde sie in der Überarbeitungsrechnung auf false gesetzt.
• Der starting_balance und der amount_due der überarbeiteten Rechnung geben einen Kundensaldo wider, der auf die ursprüngliche Rechnung angewandt wurde, zuzüglich einem etwaigen Saldo, der für das Kundenobjekt verfügbar ist.

Von hier aus können Sie wie an jedem beliebigen Entwurf weitere Änderungen an der Rechnung vornehmen. Im folgenden Beispiel wird die Beschreibung der Rechnung aktualisiert:

curl https://api.stripe.com/v1/invoices/{{FIRST_REVISION_INVOICE_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d description="Updated maintenance contract"

So fügen Sie der überarbeiteten Rechnung einen neuen Posten hinzu:

curl https://api.stripe.com/v1/invoiceitems \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d invoice={{FIRST_REVISION_INVOICE_ID}} \
  -d price=
{{PRICE_ID}} \
  -d quantity=100 \
  --data-urlencode description="Additional Stripe swag!"

Mit Rechnungsrevisionen können Sie Kundeninformationen aktualisieren und in den PDF-Dateien und auf den gehosteten Rechnungsseiten finalisierter Rechnungen anzeigen:

curl https://api.stripe.com/v1/customers/{{CUSTOMER_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d name="John Doe"

Nachdem Sie alle gewünschten Änderungen vorgenommen haben, finalisieren Sie die überarbeitete Rechnung:

curl -X POST https://api.stripe.com/v1/invoices/{{FIRST_REVISION_INVOICE_ID}}/finalize \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

Durch Finalisieren der überarbeiteten Rechnung wird ihr Status in open geändert und der Parameter finalized_at wird auf den aktuellen Zeitstempel gesetzt (anstelle des finalized_at-Zeitstempels der ursprünglichen Rechnung). Wenn Sie eine Rechnung finalisieren, geht Stripe wie folgt vor:

• Storniert die ursprüngliche Rechnung.
• Fügt der ursprünglichen Rechnung den Parameter latest_revision hinzu.

In einigen Fällen müssen Sie eine Rechnung möglicherweise öfter überarbeiten. Das Verfahren ist das gleiche wie bei der ersten Überarbeitung, außer dass Stripe den Parameter latest_revision für alle vorherigen Überarbeitungen aktualisiert. Wir aktualisieren den Parameter latest_revision nur bei Finalisierung, nicht wenn Sie die überarbeitete Rechnung erstellen.

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "from_invoice[invoice]"={{FIRST_REVISION_INVOICE_ID}} \
  -d "from_invoice[action]"=revision

Nachdem Sie eine Anfrage mit dem Parameter from_invoice übermittelt haben, erhalten Sie eine Antwort ähnlich der folgenden:

{
  "id": "{{LATEST_REVISION_INVOICE_ID}}",
  "status": "draft",
  "from_invoice": {
    "invoice": "{{FIRST_REVISION_INVOICE_ID}}",
    "action": "revision",
  },
  # ... more fields
}

Finalisieren Sie die neue Rechnung, um die Überarbeitung abzuschließen:

curl -X POST https://api.stripe.com/v1/invoices/{{LATEST_REVISION_INVOICE_ID}}/finalize \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

Wenn Sie versuchen, die Originalrechnung abzurufen, werden Sie als ungültig gemeldet. Stripe storniert die Originalrechnung, sobald die erste Überarbeitung abgeschlossen ist.

{
  "id": "{{ORIGINAL_INVOICE_ID}}",
  "status": "void",
  "latest_revision": "{{LATEST_REVISION_INVOICE_ID}}", # This has changed from "{{FIRST_REVISION_INVOICE_ID}".
}

Stripe erzwingt mehrere Einschränkungen für Rechnungsrevisionen:

• Rechnungen können höchstens einen Überarbeitungsentwurf haben – Wenn Sie ein POST an den Endpoint /v1/invoices senden und ein anderer Rechnungs-draft mit dem gleichen Parameter from_invoice[invoice] existiert, antwortet Stripe mit einem Statuscode 400.

• Sie können nur eine Überarbeitung für Rechnungen mit dem Status „offen“ oder „uneinbringlich“ erstellen – Wenn Sie ein POST an den Endpoint /v1/invoices senden und from_invoice[invoice] einer Rechnung mit einem anderen Status als open oder uncollectible entspricht, antworten wir mit einem Statuscode 400.

• Wenn eine Rechnung offen oder uneinbringlich ist, aber ein Payment Intent mit dem Status „Wird verarbeitet“ vorliegt, können Sie keine Überarbeitungen erstellen oder finalisieren. – Wenn ein/e Kund/in eine Zahlungsmethode verwendet, bei der der Rechnungsstatus nicht auf paid aktualisiert wird, wenn ein Zahlungsversuch eingeleitet wird (z. B. us_bank_account), antworten wir mit einem Statuscode 400.

• Wenn eine offene oder uneinbringliche Rechnung in den Status „Bezahlt“ oder „Storniert“ übergeht oder ein Payment Intent mit dem Status „Wird verarbeitet“ vorhanden ist, während ein Überarbeitungsentwurf für die Rechnung vorhanden ist, können Sie die Überarbeitung nicht finalisieren. – Stripe erzwingt dies über einen Statuscode 400 für jeden Endpoint, der zu einer Rechnungsfinalisierung führen könnte, einschließlich /v1/invoices/:id/finalize, /v1/invoices/:id/pay und /v1/invoices/:id/send.

• Rechnungen, die an ein Abonnement angehängt sind, können nicht überarbeitet werden. – Nach der Finalisierung können Sie Rechnungen mit einer Abonnement-ID nicht mehr bearbeiten. Für diese Arten von Rechnungen sendet Stripe 1 Stunde vor der Finalisierung den Webhook invoice.created für alle Rechnungen nach der ersten. Außerdem können Sie keine Einzelrechnungen mit Abonnementposten bearbeiten. Diese Einzelrechnungen werden in der Regel erstellt, indem ausstehende anteilmäßig verrechnete Posten eingezogen werden.

• Sie können keine Rechnungen überarbeiten, die Gutschriften enthalten. – Sie können keine Überarbeitung für eine Rechnung erstellen, die eine Gutschrift enthält.