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
    Rechnungsstellung: Ein genauer Blick auf den Prozess
    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
Abrechnung mit anderen Produkten
Umsatzsicherung
Automatisierungen
Integration testen
Steuer
Übersicht
Stripe Tax verwenden
Compliance-Management
Berichte
Übersicht
Bericht auswählen
Berichte konfigurieren
API für Berichte
Berichte für mehrere Konten
Umsatzrealisierung
Daten
ÜbersichtSchema
Nutzerspezifische Berichte
Data Pipeline
Datenverwaltung
StartseiteUmsatzInvoicing

Mehrere Rechnungsposten auf einmal verwaltenÖffentliche Vorschau

Mit der Invoices API können Sie mehrere Rechnungsposten auf einmal hinzufügen, aktualisieren und entfernen.

Sie können mehrere Einzelposten auf einer Rechnung bearbeiten, indem Sie Einzelposten mit der Invoices API hinzufügen, aktualisieren und entfernen.

Rechnung erstellen

Um eine Rechnung zu aktualisieren, müssen Sie zunächst eine erstellen. Rechnungen erstellen Sie im Dashboard oder über die Invoices API. Sie können nur Rechnungen aktualisieren, die sich im Entwurfsstatus befinden.

Posten hinzufügen

Um mehrere Posten auf derselben Rechnung zu erstellen, verweisen Sie auf die Rechnungs-ID. Sie können auch einen bereits vorhandenen, nicht zugewiesenen Rechnungsposten mit der Rechnungsposten-ID zuweisen. So erstellen Sie zwei neue Posten und weisen dieser Rechnung einen vorhandenen Rechnungsposten zu.

Command Line
curl https://api.stripe.com/v1/invoices/
{{INVOICE_ID}}
/add_lines
\ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d "lines[0][amount]"=7500 \ -d "lines[0][currency]"="usd" \ -d "lines[1][price]"={{PRICE_ID}} \ -d "lines[1][description]"="New line item" \ -d "lines[2][invoice_item]"={{INVOICE_ITEM_1}}

Häufiger Fehler

Achten Sie unbedingt darauf, die Rechnungsartikel-ID zu verwenden. Die Verwendung einer Posten-ID führt hier zu einem Fehler.

Posten aktualisieren

Von hier aus können Sie mehrere Posten derselben Rechnung basierend auf der Rechnungs-ID und Posten-IDs wie den folgenden aktualisieren:

Command Line
curl https://api.stripe.com/v1/invoices/
{{INVOICE_ID}}
/update_lines
\ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d "lines[0][id]"={{LINE_ITEM_1}} \ -d "lines[0][description]"="New description" \ -d "lines[0][metadata][key]"="new value" \ -d "lines[1][id]"={{LINE_ITEM_2}} \ -d "lines[1][price]"={{PRICE_ID}} \ -d "lines[2][id]"={{LINE_ITEM_3}} \ -d "lines[2][discountable]"=true

Im obigen Beispiel werden die Beschreibung und die Metadaten für Posten 1, der Preis für Posten 2 und die Angabe, ob für Posten 3 ein Rabatt möglich ist, aktualisiert.

Posten entfernen

Sie können mehrere Posten auf derselben Rechnung löschen oder deren Zuweisung aufheben, indem Sie auf die Rechnungs-ID und die Posten-IDs verweisen und mit dem Schlüssel behavior zwischen verschiedenen Arten der Löschung unterscheiden. So löschen Sie LINE_ITEM_1 dauerhaft und heben die Zuweisung von LINE_ITEM_2 auf. Sie können LINE_ITEM_2 in einer anderen Anfrage einer anderen Rechnung zuweisen.

Command Line
curl https://api.stripe.com/v1/invoices/
{{INVOICE_ID}}
/remove_lines
\ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d "lines[0][id]"={{LINE_ITEM_1}} \ -d "lines[0][behavior]"="delete" \ -d "lines[1][id]"={{LINE_ITEM_2}} \ -d "lines[1][behavior]"="unassign"

Einschränkungen

Bei der Verwendung dieser Funktion gibt es einige Einschränkungen

  • Die Rechnung muss sich noch im Entwurfsstatus befinden
  • Es gibt zwei Arten von Rechnungsposten
    1. type: invoiceitem: Wird generiert, wenn ein Rechnungsposten zu einer Rechnung hinzugefügt wird.
    2. type: subscription: Wird automatisch für eine Abonnementrechnung aus jedem Abonnementartikel generiert. Dies ist die vollständige Liste der verfügbaren Felder, die für jeden Posten aktualisiert werden soll. Während bei invoiceitem-Posten alle Felder unterstützt werden, können Sie bei subscription-Posten nur eine kleine Teilmenge aktualisieren. Felder, die für subscription-Posten unterstützt werden, sind tax_rates oder discounts .
  • Sie können maximal 50 Posten in einem API-Aufruf aktualisieren. Dieses Limit kann sich ändern und erhöht oder verringert werden.

Rechnungs-Metadaten

Sie können Rechnungsmetadaten in derselben Anfrage für einen der oben genannten Endpoints festlegen. Hier ist ein Beispiel, das update_lines abruft.

Command Line
curl https://api.stripe.com/v1/invoices/
{{INVOICE_ID}}
/update_lines
\ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d "lines[0][id]"={{LINE_ITEM_1}} \ -d "lines[0][description]"="New description" \ -d "lines[1][id]"={{LINE_ITEM_1}} \ -d "lines[2][description]"="Another description" \ -d "invoice_metadata[is_processed]"="true"
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