Accéder directement au contenu
Créez un compte
ou
connecter-vous
Logo de la documentation Stripe
/
Demander à l'assistant IA
Créez un compte
Connectez-vous
Démarrer
Paiements
Revenus
Plateformes et places de marché
Gestion de fonds
Ressources pour les développeurs
Aperçu
Billing
PrésentationÀ propos des API Billing
Abonnements
Invoicing
Facturation à la consommation
Devis
Gestion des clients
Facturation avec d'autres produits
Recouvrement de revenus
Automatisations
Tester votre intégration
Tax
Présentation
Utiliser Stripe Tax
Gérer la conformité
Rapports
Présentation
Sélectionner un rapport
Configurer des rapports
API de rapport
Rapports sur plusieurs comptes
Comptabilisation des revenus
    Présentation
    Démarrer
    Fonctionnement de Revenue Recognition
    Actualisation des données
    Tarifs
    Multi-devises
    Plateformes Connect
    Comptabilisation des revenus pour la facturation à l'usage
    Contrats Revenue Recognition
    Rapports
    Remplacements
    Vérifier vos chiffres
    Exemples
    Règles de comptabilisation des revenus
    Paramètres de comptabilisation des revenus
    Mapper à votre plan comptable
    API Performance Obligations
    Importation de données dans Stripe
    Exportation de données depuis Stripe
Données
PrésentationSchéma
Rapports personnalisés
Data Pipeline
Gestion des données
AccueilRevenusRevenue recognition

API Revenue RecognitionVersion bêta publique

Accédez aux rapports de comptabilisation des revenus de Stripe de manière programmatique pour automatiser votre comptabilité d'exercice.

Si vous utilisez une comptabilité d’exercice, Stripe Revenue Recognition fournit des rapports téléchargeables, notamment un récapitulatif mensuel et un rapport de revenus en cascade. Vous pouvez télécharger ces rapports au format CSV via le Dashboard ou y accéder de manière programmatique via l’API.

La comptabilisation des revenus de Stripe prend en charge six types de rapports :

  • 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

Mise en garde

Cette fonctionnalité étant en version bêta, les champs de données sont susceptibles de changer.

Télécharger un rapport

Dans l’exemple suivant, nous téléchargeons les débits et les crédits par résumé pour le mois de mai 2021.

Tout d’abord, créez un objet Report Run (exécution de rapport).

Afin d’obtenir un rapport pour le mois de mai 2023, définissez parameters[interval_start] sur la date du 1er mai 2023 et parameters[interval_end] sur la date du 1er juin 2023.

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

Ensuite, récupérez l’objet Report Run pour vérifier s’il a réussi :

L’ID de l’objet d’exécution de rapport commence par 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
:"

Lorsque l’attribut status (état) de l’objet est succeeded (réussi), vous pouvez le télécharger au format CSV à l’aide de sa valeur result.id, comme illustré ci-dessous :

L’ID du résultat de l’exécution de rapport commence par file_.

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

Paramètres d’exécution des rapports

Type de rapportParamètres d’exécution obligatoiresParamètres d’exécution facultatifs
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

Colonnes d’exécution des rapports

Par défaut, les rapports sont exécutés avec la sélection de colonnes par défaut. Vous pouvez personnaliser la sélection et l’ordre des colonnes générées en incluant le paramètre de colonnes facultatives avec une liste de noms de colonnes. Vous trouverez ci-dessous les colonnes prises en charge pour chaque type de rapport.

Récapitulatif

Type de rapport d’API : revenue_recognition.debit_credit_summary.1

Nom de la colonnePar défautDescription
accounting_periodLa période comptable
open_accounting_periodLa période comptable ouverte ; les écritures des périodes ouvertes sont sujettes à changement
deviseCode ISO de la devise associée au montant.
débitLe compte débité
créditLe compte crédité
montantVariation du montant, exprimée dans l’unité principale de la devise (par exemple en dollars pour l’USD ou en pesos pour le MXN).
credit_gl_codeLe code de compte du grand livre crédité
debit_gl_codeLe code de compte du grand livre débité

Par tarif

Type de rapport d’API : revenue_recognition.debit_credit_by_price.1

Nom de la colonnePar défautDescription
accounting_periodLa période comptable
open_accounting_periodLa période comptable ouverte ; les écritures des périodes ouvertes sont sujettes à changement
deviseCode ISO de la devise associée au montant.
price_idLe tarif associé à cette modification.
débitLe compte débité
créditLe compte crédité
montantVariation du montant, exprimée dans l’unité principale de la devise (par exemple en dollars pour l’USD ou en pesos pour le MXN).
credit_gl_codeLe code de compte du grand livre crédité
debit_gl_codeLe code de compte du grand livre débité

Par produit

Type de rapport d’API : revenue_recognition.debit_credit_by_product.1

Nom de la colonnePar défautDescription
accounting_periodLa période comptable
open_accounting_periodLa période comptable ouverte ; les écritures des périodes ouvertes sont sujettes à changement
deviseCode ISO de la devise associée au montant.
product_idLe produit associé à cette modification.
débitLe compte débité
créditLe compte crédité
montantVariation du montant, exprimée dans l’unité principale de la devise (par exemple en dollars pour l’USD ou en pesos pour le MXN).
credit_gl_codeLe code de compte du grand livre crédité
debit_gl_codeLe code de compte du grand livre débité

Par client

Type de rapport d’API : revenue_recognition.debit_credit_by_customer.1

Nom de la colonnePar défautDescription
accounting_periodLa période comptable
open_accounting_periodLa période comptable ouverte ; les écritures des périodes ouvertes sont sujettes à changement
deviseCode ISO de la devise associée au montant.
customer_idLe client associé à cette modification.
débitLe compte débité
créditLe compte crédité
montantVariation du montant, exprimée dans l’unité principale de la devise (par exemple en dollars pour l’USD ou en pesos pour le MXN).
credit_gl_codeLe code de compte du grand livre crédité
debit_gl_codeLe code de compte du grand livre débité

Par facture

Type de rapport d’API : revenue_recognition.debit_credit_by_invoice.1

Nom de la colonnePar défautDescription
accounting_periodLa période comptable
open_accounting_periodLa période comptable ouverte ; les écritures des périodes ouvertes sont sujettes à changement
deviseCode ISO de la devise associée au montant.
transaction_model_idLe modèle associé à cette modification dans Stripe (poste de facture, facture, paiement, etc.).
débitLe compte débité
créditLe compte crédité
booked_dateDate à laquelle l’écriture comptable est ajoutée aux livres.
montantVariation du montant, exprimée dans l’unité principale de la devise (par exemple en dollars pour l’USD ou en pesos pour le MXN).
debit_gl_codeLe code de compte du grand livre débité
credit_gl_codeLe code de compte du grand livre crédité
invoice_idLa facture associée à cette modification. Les paiements isolés ou les postes de facture non associés à une facture ont la valeur null.
invoice_line_item_idL’ID du poste de facture line_item.
invoice_item_idL’ID du poste de facture
invoice_numberNuméro unique du client associé à la facture.
subscription_item_idL’ID du poste subscription_item.
price_idLe tarif associé à cette modification. Les paiements isolés ou les postes de facture non associés à un tarif ont la valeur null.
product_idLe produit associé à ce tarif.
customer_idLe client associé à cette modification.
subscription_idL’abonnement associé à cette modification.
charge_idLe paiement associé à cette modification.
refund_idLe remboursement associé à cette modification.
dispute_idLe litige associé à cette modification.
presentment_currencyLa devise de présentation (celle que voit le client) de la transaction.
presentment_amountLe montant de présentation (celui que voit le client).

Par poste de facture

Type de rapport d’API : revenue_recognition.debit_credit_by_invoice_line_item.1

Nom de la colonnePar défautDescription
accounting_periodLa période comptable
open_accounting_periodLa période comptable ouverte ; les écritures des périodes ouvertes sont sujettes à changement
deviseCode ISO de la devise associée au montant.
transaction_model_idModèle associé à cette modification dans Stripe (poste de facture, facture, paiement, etc.).
débitLe compte débité
créditLe compte crédité
booked_dateDate à laquelle l’écriture comptable est ajoutée aux livres.
montantVariation du montant, exprimée dans l’unité principale de la devise (par exemple en dollars pour l’USD ou en pesos pour le MXN).
debit_gl_codeLe code de compte du grand livre débité
credit_gl_codeLe code de compte du grand livre crédité
invoice_idLa facture associée à cette modification. Les paiements isolés ou les postes de facture non associés à une facture ont la valeur null.
invoice_line_item_idL’ID du poste de facture line_item.
invoice_item_idL’ID du poste de facture
subscription_item_idL’ID du poste subscription_item.
price_idLe tarif associé à cette modification. Les paiements isolés ou les postes de facture non associés à un tarif ont la valeur null.
product_idLe produit associé à ce tarif.
customer_idLe client associé à cette modification.
subscription_idL’abonnement associé à cette modification.
charge_idLe paiement associé à cette modification.
refund_idLe remboursement associé à cette modification.
dispute_idLe litige associé à cette modification.
presentment_currencyLa devise de présentation (celle que voit le client) de la transaction.
presentment_amountLe montant de présentation (celui que voit le client).

Si vous rencontrez des problèmes, vous pouvez contacter revenue-recognition-api-beta@stripe.com.

Cette page vous a-t-elle été utile ?
OuiNon
  • Besoin d'aide ? Contactez le service Support.
  • Rejoignez notre programme d'accès anticipé.
  • Consultez notre log des modifications.
  • Des questions ? Contactez l'équipe commerciale.
  • LLM ? Lire llms.txt.
  • Propulsé par Markdoc