# Umsatzrealisierungs-API Greifen Sie programmgesteuert auf die Umsatzrealisierungsberichte von Stripe zu, um Ihre Periodenrechnung zu automatisieren. Zur Periodenrechnung bietet Stripe Revenue Recognition [herunterladbare Berichte](https://docs.stripe.com/revenue-recognition/reports.md) wie eine [Zusammenfassung des Zeitraums](https://docs.stripe.com/revenue-recognition/reports/period-summary.md) und eine [Umsatzstaffelung](https://docs.stripe.com/revenue-recognition/reports/waterfall.md). Sie können diese Berichte im CSV-Format über das [Dashboard](https://dashboard.stripe.com/revenue-recognition) herunterladen oder programmgesteuert über die API darauf zugreifen. 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` > 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 1 heruntergeladen [Error: Invalid unit "Jahr"]. Erstellen Sie zuerst eine Berichtsausführung mithilfe der Angaben unter [Einen Berichtsverlauf erstellen](https://docs.stripe.com/api/reporting/report_run/create.md). Um einen Bericht für Mai zu erhalten [Error: Invalid unit "Jahr"], setzen Sie `parameters[interval_start]` auf den 1. Mai [Error: Invalid unit "Jahr"] and `parameters[interval_end]` auf den 1. Juni [Error: Invalid unit "Jahr"]. ```curl curl https://api.stripe.com/v1/reporting/report_runs \ -u "<>:" \ -d "report_type=revenue_recognition.debit_credit_summary.1" \ -d "parameters[interval_start]=1746057600" \ -d "parameters[interval_end]=1748736000" ``` Prüfen Sie als Nächstes, ob das [Report Run](https://docs.stripe.com/api/reporting/report_run/object.md)-Objekt erfolgreich ist, indem Sie das Berichtsausführungs-Objekt abrufen: Die Objekt-ID für die Berichtsausführung beginnt mit `frr_`. ```curl curl https://api.stripe.com/v1/reporting/report_runs/{{REPORT_RUN_OBJECT_ID}} \ -u "<>:" ``` 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_`. #### Curl ```bash curl https://files.stripe.com/v1/files/{{REPORT_RUN_RESULT_ID}}/contents \ -u <>: ``` ## Parameter für die Berichtsausführung | Berichtstyp | Erforderliche Ausführungsparameter | Optionale 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](https://docs.stripe.com/reports/api.md#report-runs) hinzufügen. Unten finden Sie die unterstützten Spalten für jeden Berichtstyp. ### Übersicht API-Berichtstyp: `revenue_recognition.debit_credit_summary.1` | Spaltenname | Standard | Beschreibung | | ---------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------- | | accounting_period | ✓ Standard | Der Abrechnungszeitraum | | open_accounting_period | ✓ Standard | Der offene Abrechnungszeitraum; Einträge in offenen Zeiträumen können sich ändern | | Währung | ✓ Standard | Dreistelliger [ISO-Code für die Währung](https://docs.stripe.com/currencies.md) des Betrags. | | Debit | ✓ Standard | Das belastete Konto | | Gutschrift | ✓ Standard | Das gutgeschriebene Konto | | Betrag | ✓ Standard | Änderungsbetrag, ausgedrückt in den wichtigsten Währungseinheiten (zum Beispiel Dollar für USD oder Pesos für MXN). | | credit_gl_code | | Der gutgeschriebene Hauptbuchcode | | debit_gl_code | | Der belastete Hauptbuchcode | ### Nach Preis API-Berichtstyp: `revenue_recognition.debit_credit_by_price.1` | Spaltenname | Standard | Beschreibung | | ---------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------- | | accounting_period | ✓ Standard | Der Abrechnungszeitraum | | open_accounting_period | ✓ Standard | Der offene Abrechnungszeitraum; Einträge in offenen Zeiträumen können sich ändern | | Währung | ✓ Standard | Dreistelliger [ISO-Code für die Währung](https://docs.stripe.com/currencies.md) des Betrags. | | price_id | ✓ Standard | Der mit dieser Änderung verknüpfte Preis. | | Debit | ✓ Standard | Das belastete Konto | | Gutschrift | ✓ Standard | Das gutgeschriebene Konto | | Betrag | ✓ Standard | Änderungsbetrag, ausgedrückt in den wichtigsten Währungseinheiten (zum Beispiel Dollar für USD oder Pesos für MXN). | | credit_gl_code | | Der gutgeschriebene Hauptbuchcode | | debit_gl_code | | Der belastete Hauptbuchcode | ### Nach Produkt API-Berichtstyp: `revenue_recognition.debit_credit_by_product.1` | Spaltenname | Standard | Beschreibung | | ---------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------- | | accounting_period | ✓ Standard | Der Abrechnungszeitraum | | open_accounting_period | ✓ Standard | Der offene Abrechnungszeitraum; Einträge in offenen Zeiträumen können sich ändern | | Währung | ✓ Standard | Dreistelliger [ISO-Code für die Währung](https://docs.stripe.com/currencies.md) des Betrags. | | product_id | ✓ Standard | Das mit dieser Änderung verknüpfte Produkt. | | Debit | ✓ Standard | Das belastete Konto | | Gutschrift | ✓ Standard | Das gutgeschriebene Konto | | Betrag | ✓ Standard | Änderungsbetrag, ausgedrückt in den wichtigsten Währungseinheiten (zum Beispiel Dollar für USD oder Pesos für MXN). | | credit_gl_code | | Der gutgeschriebene Hauptbuchcode | | debit_gl_code | | Der belastete Hauptbuchcode | ### Nach Kund/in API-Berichtstyp: `revenue_recognition.debit_credit_by_customer.1` | Spaltenname | Standard | Beschreibung | | ---------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------- | | accounting_period | ✓ Standard | Der Abrechnungszeitraum | | open_accounting_period | ✓ Standard | Der offene Abrechnungszeitraum; Einträge in offenen Zeiträumen können sich ändern | | Währung | ✓ Standard | Dreistelliger [ISO-Code für die Währung](https://docs.stripe.com/currencies.md) des Betrags. | | customer_id | ✓ Standard | Der/die mit dieser Änderung verknüpfte/r Kund/in. | | Debit | ✓ Standard | Das belastete Konto | | Gutschrift | ✓ Standard | Das gutgeschriebene Konto | | Betrag | ✓ Standard | Änderungsbetrag, ausgedrückt in den wichtigsten Währungseinheiten (zum Beispiel Dollar für USD oder Pesos für MXN). | | credit_gl_code | | Der gutgeschriebene Hauptbuchcode | | debit_gl_code | | Der belastete Hauptbuchcode | ### NachRechnung API-Berichtstyp: `revenue_recognition.debit_credit_by_invoice.1` | Spaltenname | Standard | Beschreibung | | ---------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | accounting_period | ✓ Standard | Der Abrechnungszeitraum | | open_accounting_period | ✓ Standard | Der offene Abrechnungszeitraum; Einträge in offenen Zeiträumen können sich ändern | | Währung | ✓ Standard | Dreistelliger [ISO-Code für die Währung](https://docs.stripe.com/currencies.md) des Betrags. | | transaction_model_id | ✓ Standard | Das mit dieser Änderung verknüpfte Modell in Stripe – entweder ein Rechnungseinzelposten, eine Rechnung, ein Rechnungsposten, eine Zahlung und so weiter | | Debit | ✓ Standard | Das belastete Konto | | Gutschrift | ✓ Standard | Das gutgeschriebene Konto | | booked_date | ✓ Standard | Das Datum, an dem der Hauptbucheintrag zu den Büchern hinzugefügt wird. | | Betrag | ✓ Standard | Änderungsbetrag, ausgedrückt in den wichtigsten Währungseinheiten (zum Beispiel Dollar für USD oder Pesos für MXN). | | debit_gl_code | | Der belastete Hauptbuchcode | | credit_gl_code | | Der gutgeschriebene Hauptbuchcode | | invoice_id | | Die mit dieser Änderung verknüpfte Rechnung. Eigenständige Zahlungen oder Rechnungsposten, die keiner Rechnung zugeordnet sind, sind `null`. | | invoice_line_item_id | | Die ID des Rechnung-line_item. | | invoice_item_id | | Die ID des Rechnungspostens | | invoice_number | | Die mit der Rechnung verknüpfte eindeutige Kundennummer. | | subscription_item_id | | Die ID des subscription_item. | | price_id | | Der mit dieser Änderung verknüpfte Preis. Eigenständige Zahlungen oder Rechnungsposten, die keinem Preis zugeordnet sind, sind `null`. | | product_id | | Das mit diesem Preis verknüpfte Produkt. | | customer_id | | Der/die mit dieser Änderung verknüpfte/r Kund/in. | | subscription_id | | Das mit dieser Änderung verknüpfte Abonnement. | | charge_id | | Der mit dieser Änderung verknüpfte Zahlung. | | refund_id | | Die mit dieser Änderung verknüpfte Rückerstattung. | | dispute_id | | Die mit dieser Änderung verknüpfte Anfechtung. | | presentment_currency | | Die (kundenseitige) Darstellungswährung der Transaktion. | | presentment_amount | | Der (kundenseitige) Darstellungsbetrag. | ### Nach Rechnungsposten API-Berichtstyp: `revenue_recognition.debit_credit_by_invoice_line_item.1` | Spaltenname | Standard | Beschreibung | | ---------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | accounting_period | ✓ Standard | Der Abrechnungszeitraum | | open_accounting_period | ✓ Standard | Der offene Abrechnungszeitraum; Einträge in offenen Zeiträumen können sich ändern | | Währung | ✓ Standard | Dreistelliger [ISO-Code für die Währung](https://docs.stripe.com/currencies.md) des Betrags. | | transaction_model_id | ✓ Standard | Das mit dieser Änderung verknüpfte Modell in Stripe – ein Rechnungseinzelposten, eine Rechnung, ein Rechnungsposten, eine Abbuchung usw. | | Debit | ✓ Standard | Das belastete Konto | | Gutschrift | ✓ Standard | Das gutgeschriebene Konto | | booked_date | ✓ Standard | Das Datum, an dem der Hauptbucheintrag zu den Büchern hinzugefügt wird. | | Betrag | ✓ Standard | Änderungsbetrag, ausgedrückt in den wichtigsten Währungseinheiten (zum Beispiel Dollar für USD oder Pesos für MXN). | | debit_gl_code | | Der belastete Hauptbuchcode | | credit_gl_code | | Der gutgeschriebene Hauptbuchcode | | invoice_id | | Die mit dieser Änderung verknüpfte Rechnung. Eigenständige Zahlungen oder Rechnungsposten, die keiner Rechnung zugeordnet sind, sind `null`. | | invoice_line_item_id | | Die ID des Rechnung-line_item. | | invoice_item_id | | Die ID des Rechnungspostens | | subscription_item_id | | Die ID des subscription_item. | | price_id | | Der mit dieser Änderung verknüpfte Preis. Eigenständige Zahlungen oder Rechnungsposten, die keinem Preis zugeordnet sind, sind `null`. | | product_id | | Das mit diesem Preis verknüpfte Produkt. | | customer_id | | Der/die mit dieser Änderung verknüpfte/r Kund/in. | | subscription_id | | Das mit dieser Änderung verknüpfte Abonnement. | | charge_id | | Der mit dieser Änderung verknüpfte Zahlung. | | refund_id | | Die mit dieser Änderung verknüpfte Rückerstattung. | | dispute_id | | Die mit dieser Änderung verknüpfte Anfechtung. | | presentment_currency | | Die (kundenseitige) Darstellungswährung der Transaktion. | | presentment_amount | | Der (kundenseitige) Darstellungsbetrag. | Bei Problemen wenden Sie sich bitte an [revenue-recognition-api-beta@stripe.com](mailto:revenue-recognition-api-beta@stripe.com).