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
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
    Übersicht
    Jetzt starten
    Funktionsweise von Revenue Recognition
    Datenaktualität
    Preisinformationen
    Mehrere Währungen
    Connect-Plattformen
    Revenue Recognition für die nutzungsbasierte Abrechnung
    Verträge für Umsatzrealisierungen
    Berichte
    Überschreibungen
    Audits für Ihre Zahlen
    Beispiele
    Umsatzrealisierungsregeln
    Einstellungen für die Umsatzrealisierung
    Verknüpfung mit dem Kontenplan
    Performance Obligations API
    Daten in Stripe importieren
    Daten aus Stripe exportieren
Daten
ÜbersichtSchema
Nutzerspezifische Berichte
Data Pipeline
Datenverwaltung
StartseiteUmsatzRevenue recognition

Umsatzrealisierungs-APIÖffentliche Vorschau

Greifen Sie programmgesteuert auf die Umsatzrealisierungsberichte von Stripe zu, um Ihre Periodenrechnung zu automatisieren.

Für die Periodenrechnung bietet Stripe Revenue Recognition herunterladbare Berichte wie eine Monatsübersicht und ein Wasserfalldiagramm zum Umsatz. Sie können diese Berichte im CSV-Format über das Dashboard herunterladen oder programmgesteuert über die API abrufen.

Stripe Revenue Recognition verfügt über sechs unterstützte Berichtstypen:

  • revenue_recognition.debit_credit_summary.1
  • revenue_recognition.debit_credit_by_price.1
  • revenue_recognition.debit_credit_by_product.1
  • revenue_recognition.debit_credit_by_customer.1
  • revenue_recognition.debit_credit_by_invoice.1
  • revenue_recognition.debit_credit_by_invoice_line_item.1

Vorsicht

Da sich diese Funktion in der Betaphase befindet, können sich die Datenfelder ändern.

Bericht herunterladen

Im folgenden Beispiel werden die Belastungen und Gutschriften als Zusammenfassung für Mai 2021 heruntergeladen.

Erstellen Sie zuerst eine Berichtsausführung mithilfe der Angaben unter Einen Berichtsverlauf erstellen.

Um einen Bericht für Mai 2023 zu erhalten, legen Sie parameters[interval_start] auf 1. Mai 2023 und parameters[interval_end] auf 1. Juni 2023 fest.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node
Go
.NET
No results
curl https://api.stripe.com/v1/reporting/report_runs \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d report_type="revenue_recognition.debit_credit_summary.1" \ -d "parameters[interval_start]"=1682899200 \ -d "parameters[interval_end]"=1685577600

Prüfen Sie als Nächstes, ob das Report Run-Objekt erfolgreich ist, indem Sie das Berichtsausführungs-Objekt abrufen:

Die Objekt-ID für die Berichtsausführung beginnt mit frr_.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node
Go
.NET
No results
curl https://api.stripe.com/v1/reporting/report_runs/{{REPORT_RUN_OBJECT_ID}} \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Wenn der status des Objekts succeeded ist, können Sie die CSV-Datei mit ihren result.id-Wert herunterladen, wie im folgenden Beispiel:

Die Ergebnis-ID der Berichtsausführung beginnt mit file_.

Command Line
Curl
No results
curl https://files.stripe.com/v1/files/{{REPORT_RUN_RESULT_ID}}/contents \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

Parameter für die Berichtsausführung

BerichtstypErforderliche AusführungsparameterOptionale Ausführungsparameter
revenue_recognition.debit_credit_summary.1
  • interval_start
  • interval_end
  • decimal_format
revenue_recognition.debit_credit_by_price.1
  • interval_start
  • interval_end
  • customer
  • decimal_format
revenue_recognition.debit_credit_by_product.1
  • interval_start
  • interval_end
  • customer
  • decimal_format
revenue_recognition.debit_credit_by_customer.1
  • interval_start
  • interval_end
  • decimal_format
revenue_recognition.debit_credit_by_invoice.1
  • interval_start
  • interval_end
  • customer
  • invoice
  • invoice_line_item
  • decimal_format
revenue_recognition.debit_credit_by_invoice_line_item.1
  • interval_start
  • interval_end
  • customer
  • invoice
  • invoice_line_item
  • decimal_format

Spalten für die Report Run

Standardmäßig werden Berichte mit den Standardspalten ausgeführt. Sie können die Auswahl und Reihenfolge der Spalten in der Ausgabe anpassen, indem Sie den optionalen Parameter Spalten mit einer Liste von Spaltennamen hinzufügen. Unten finden Sie die unterstützten Spalten für jeden Berichtstyp.

Übersicht

API-Berichtstyp: revenue_recognition.debit_credit_summary.1

SpaltennameStandardBeschreibung
accounting_periodDer Abrechnungszeitraum
open_accounting_periodDer offene Abrechnungszeitraum; Einträge in offenen Zeiträumen können sich ändern
WährungDreistelliger ISO-Code für die Währung des Betrags.
DebitDas belastete Konto
GutschriftDas gutgeschriebene Konto
BetragÄnderungsbetrag, ausgedrückt in den wichtigsten Währungseinheiten (zum Beispiel Dollar für USD oder Pesos für MXN).
credit_gl_codeDer gutgeschriebene Hauptbuchcode
debit_gl_codeDer belastete Hauptbuchcode

Nach Preis

API-Berichtstyp: revenue_recognition.debit_credit_by_price.1

SpaltennameStandardBeschreibung
accounting_periodDer Abrechnungszeitraum
open_accounting_periodDer offene Abrechnungszeitraum; Einträge in offenen Zeiträumen können sich ändern
WährungDreistelliger ISO-Code für die Währung des Betrags.
price_idDer mit dieser Änderung verknüpfte Preis.
DebitDas belastete Konto
GutschriftDas gutgeschriebene Konto
BetragÄnderungsbetrag, ausgedrückt in den wichtigsten Währungseinheiten (zum Beispiel Dollar für USD oder Pesos für MXN).
credit_gl_codeDer gutgeschriebene Hauptbuchcode
debit_gl_codeDer belastete Hauptbuchcode

Nach Produkt

API-Berichtstyp: revenue_recognition.debit_credit_by_product.1

SpaltennameStandardBeschreibung
accounting_periodDer Abrechnungszeitraum
open_accounting_periodDer offene Abrechnungszeitraum; Einträge in offenen Zeiträumen können sich ändern
WährungDreistelliger ISO-Code für die Währung des Betrags.
product_idDas mit dieser Änderung verknüpfte Produkt.
DebitDas belastete Konto
GutschriftDas gutgeschriebene Konto
BetragÄnderungsbetrag, ausgedrückt in den wichtigsten Währungseinheiten (zum Beispiel Dollar für USD oder Pesos für MXN).
credit_gl_codeDer gutgeschriebene Hauptbuchcode
debit_gl_codeDer belastete Hauptbuchcode

Nach Kund/in

API-Berichtstyp: revenue_recognition.debit_credit_by_customer.1

SpaltennameStandardBeschreibung
accounting_periodDer Abrechnungszeitraum
open_accounting_periodDer offene Abrechnungszeitraum; Einträge in offenen Zeiträumen können sich ändern
WährungDreistelliger ISO-Code für die Währung des Betrags.
customer_idDer/die mit dieser Änderung verknüpfte/r Kund/in.
DebitDas belastete Konto
GutschriftDas gutgeschriebene Konto
BetragÄnderungsbetrag, ausgedrückt in den wichtigsten Währungseinheiten (zum Beispiel Dollar für USD oder Pesos für MXN).
credit_gl_codeDer gutgeschriebene Hauptbuchcode
debit_gl_codeDer belastete Hauptbuchcode

NachRechnung

API-Berichtstyp: revenue_recognition.debit_credit_by_invoice.1

SpaltennameStandardBeschreibung
accounting_periodDer Abrechnungszeitraum
open_accounting_periodDer offene Abrechnungszeitraum; Einträge in offenen Zeiträumen können sich ändern
WährungDreistelliger ISO-Code für die Währung des Betrags.
transaction_model_idDas mit dieser Änderung verknüpfte Modell in Stripe – entweder ein Rechnungseinzelposten, eine Rechnung, ein Rechnungsposten, eine Zahlung usw.
DebitDas belastete Konto
GutschriftDas gutgeschriebene Konto
booked_dateDas Datum, an dem der Hauptbucheintrag zu den Büchern hinzugefügt wird.
BetragÄnderungsbetrag, ausgedrückt in den wichtigsten Währungseinheiten (zum Beispiel Dollar für USD oder Pesos für MXN).
debit_gl_codeDer belastete Hauptbuchcode
credit_gl_codeDer gutgeschriebene Hauptbuchcode
invoice_idDie mit dieser Änderung verknüpfte Rechnung. Eigenständige Zahlungen oder Rechnungsposten, die keiner Rechnung zugeordnet sind, sind null.
invoice_line_item_idDie ID des Rechnung-line_item.
invoice_item_idDie ID des Rechnungspostens
invoice_numberDie mit der Rechnung verknüpfte eindeutige Kundennummer.
subscription_item_idDie ID des subscription_item.
price_idDer mit dieser Änderung verknüpfte Preis. Eigenständige Zahlungen oder Rechnungsposten, die keinem Preis zugeordnet sind, sind null.
product_idDas mit diesem Preis verknüpfte Produkt.
customer_idDer/die mit dieser Änderung verknüpfte/r Kund/in.
subscription_idDas mit dieser Änderung verknüpfte Abonnement.
charge_idDer mit dieser Änderung verknüpfte Zahlung.
refund_idDie mit dieser Änderung verknüpfte Rückerstattung.
dispute_idDie mit dieser Änderung verknüpfte Anfechtung.
presentment_currencyDie (kundenseitige) Darstellungswährung der Transaktion.
presentment_amountDer (kundenseitige) Darstellungsbetrag.

Nach Rechnungsposten

API-Berichtstyp: revenue_recognition.debit_credit_by_invoice_line_item.1

SpaltennameStandardBeschreibung
accounting_periodDer Abrechnungszeitraum
open_accounting_periodDer offene Abrechnungszeitraum; Einträge in offenen Zeiträumen können sich ändern
WährungDreistelliger ISO-Code für die Währung des Betrags.
transaction_model_idDas mit dieser Änderung verknüpfte Modell in Stripe – ein Rechnungseinzelposten, eine Rechnung, ein Rechnungsposten, eine Abbuchung usw.
DebitDas belastete Konto
GutschriftDas gutgeschriebene Konto
booked_dateDas Datum, an dem der Hauptbucheintrag zu den Büchern hinzugefügt wird.
BetragÄnderungsbetrag, ausgedrückt in den wichtigsten Währungseinheiten (zum Beispiel Dollar für USD oder Pesos für MXN).
debit_gl_codeDer belastete Hauptbuchcode
credit_gl_codeDer gutgeschriebene Hauptbuchcode
invoice_idDie mit dieser Änderung verknüpfte Rechnung. Eigenständige Zahlungen oder Rechnungsposten, die keiner Rechnung zugeordnet sind, sind null.
invoice_line_item_idDie ID des Rechnung-line_item.
invoice_item_idDie ID des Rechnungspostens
subscription_item_idDie ID des subscription_item.
price_idDer mit dieser Änderung verknüpfte Preis. Eigenständige Zahlungen oder Rechnungsposten, die keinem Preis zugeordnet sind, sind null.
product_idDas mit diesem Preis verknüpfte Produkt.
customer_idDer/die mit dieser Änderung verknüpfte/r Kund/in.
subscription_idDas mit dieser Änderung verknüpfte Abonnement.
charge_idDer mit dieser Änderung verknüpfte Zahlung.
refund_idDie mit dieser Änderung verknüpfte Rückerstattung.
dispute_idDie mit dieser Änderung verknüpfte Anfechtung.
presentment_currencyDie (kundenseitige) Darstellungswährung der Transaktion.
presentment_amountDer (kundenseitige) Darstellungsbetrag.

Bei Problemen wenden Sie sich bitte an revenue-recognition-api-beta@stripe.com.

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