# API Revenue Recognition Accédez aux rapports de comptabilisation des revenus de Stripe de manière programmatique pour automatiser votre comptabilité d'exercice. Pour la comptabilité d’exercice, Stripe Revenue Recognition fournit des [rapports téléchargeables](https://docs.stripe.com/revenue-recognition/reports.md), tels qu’un [récapitulatif de la période](https://docs.stripe.com/revenue-recognition/reports/period-summary.md) et des [revenus en cascade](https://docs.stripe.com/revenue-recognition/reports/waterfall.md). Vous pouvez télécharger ces rapports au format CSV via le [Dashboard](https://dashboard.stripe.com/revenue-recognition) ou y accéder par voie 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` > 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 2025. Tout d’abord, [créez un objet Report Run](https://docs.stripe.com/api/reporting/report_run/create.md) (exécution de rapport). Pour obtenir un rapport pour le mois de mai 2025, définissez les `parameters[interval_start]` sur 1er mai 2025 et les `parameters[interval_end]` sur 1er juin 2025. ```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" ``` Ensuite, récupérez l’objet [Report Run](https://docs.stripe.com/api/reporting/report_run/object.md) pour vérifier s’il a réussi : L’ID de l’objet d’exécution de rapport commence par `frr_`. ```curl curl https://api.stripe.com/v1/reporting/report_runs/{{REPORT_RUN_OBJECT_ID}} \ -u "<>:" ``` 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_`. #### curl ```bash curl https://files.stripe.com/v1/files/{{REPORT_RUN_RESULT_ID}}/contents \ -u <>: ``` ## Paramètres d’exécution des rapports | Type de rapport | Paramètres d’exécution obligatoires | Paramè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](https://docs.stripe.com/reports/api.md#report-runs). 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 colonne | Par défaut | Description | | ---------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------- | | accounting_period | ✓ par défaut | La période comptable | | open_accounting_period | ✓ par défaut | La période comptable ouverte ; les écritures des périodes ouvertes sont sujettes à changement | | devise | ✓ par défaut | [Code ISO de la devise](https://docs.stripe.com/currencies.md) associée au montant. | | débit | ✓ par défaut | Le compte débité | | crédit | ✓ par défaut | Le compte crédité | | montant | ✓ par défaut | Variation 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_code | | Le code de compte du grand livre crédité | | debit_gl_code | | Le 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 colonne | Par défaut | Description | | ---------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------- | | accounting_period | ✓ par défaut | La période comptable | | open_accounting_period | ✓ par défaut | La période comptable ouverte ; les écritures des périodes ouvertes sont sujettes à changement | | devise | ✓ par défaut | [Code ISO de la devise](https://docs.stripe.com/currencies.md) associée au montant. | | price_id | ✓ par défaut | Le tarif associé à cette modification. | | débit | ✓ par défaut | Le compte débité | | crédit | ✓ par défaut | Le compte crédité | | montant | ✓ par défaut | Variation 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_code | | Le code de compte du grand livre crédité | | debit_gl_code | | Le 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 colonne | Par défaut | Description | | ---------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------- | | accounting_period | ✓ par défaut | La période comptable | | open_accounting_period | ✓ par défaut | La période comptable ouverte ; les écritures des périodes ouvertes sont sujettes à changement | | devise | ✓ par défaut | [Code ISO de la devise](https://docs.stripe.com/currencies.md) associée au montant. | | product_id | ✓ par défaut | Le produit associé à cette modification. | | débit | ✓ par défaut | Le compte débité | | crédit | ✓ par défaut | Le compte crédité | | montant | ✓ par défaut | Variation 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_code | | Le code de compte du grand livre crédité | | debit_gl_code | | Le 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 colonne | Par défaut | Description | | ---------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------- | | accounting_period | ✓ par défaut | La période comptable | | open_accounting_period | ✓ par défaut | La période comptable ouverte ; les écritures des périodes ouvertes sont sujettes à changement | | devise | ✓ par défaut | [Code ISO de la devise](https://docs.stripe.com/currencies.md) associée au montant. | | customer_id | ✓ par défaut | Le client associé à cette modification. | | débit | ✓ par défaut | Le compte débité | | crédit | ✓ par défaut | Le compte crédité | | montant | ✓ par défaut | Variation 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_code | | Le code de compte du grand livre crédité | | debit_gl_code | | Le 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 colonne | Par défaut | Description | | ---------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | accounting_period | ✓ par défaut | La période comptable | | open_accounting_period | ✓ par défaut | La période comptable ouverte ; les écritures des périodes ouvertes sont sujettes à changement | | devise | ✓ par défaut | [Code ISO de la devise](https://docs.stripe.com/currencies.md) associée au montant. | | transaction_model_id | ✓ par défaut | Le modèle associé à cette modification dans Stripe, qu’il s’agisse d’un sous-poste de facture, d’une facture, d’un élément de facture, d’un débit, etc. | | débit | ✓ par défaut | Le compte débité | | crédit | ✓ par défaut | Le compte crédité | | booked_date | ✓ par défaut | Date à laquelle l’écriture comptable est ajoutée aux livres. | | montant | ✓ par défaut | Variation 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_code | | Le code de compte du grand livre débité | | credit_gl_code | | Le code de compte du grand livre crédité | | invoice_id | | La 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_id | | L’ID du poste de facture line_item. | | invoice_item_id | | L’ID du poste de facture | | invoice_number | | Numéro unique du client associé à la facture. | | subscription_item_id | | L’ID du poste subscription_item. | | price_id | | Le tarif associé à cette modification. Les paiements isolés ou les postes de facture non associés à un tarif ont la valeur `null`. | | product_id | | Le produit associé à ce tarif. | | customer_id | | Le client associé à cette modification. | | subscription_id | | L’abonnement associé à cette modification. | | charge_id | | Le paiement associé à cette modification. | | refund_id | | Le remboursement associé à cette modification. | | dispute_id | | Le litige associé à cette modification. | | presentment_currency | | La devise de présentation (celle que voit le client) de la transaction. | | presentment_amount | | Le 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 colonne | Par défaut | Description | | ---------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------- | | accounting_period | ✓ par défaut | La période comptable | | open_accounting_period | ✓ par défaut | La période comptable ouverte ; les écritures des périodes ouvertes sont sujettes à changement | | devise | ✓ par défaut | [Code ISO de la devise](https://docs.stripe.com/currencies.md) associée au montant. | | transaction_model_id | ✓ par défaut | Modèle associé à cette modification dans Stripe (poste de facture, facture, paiement, etc.). | | débit | ✓ par défaut | Le compte débité | | crédit | ✓ par défaut | Le compte crédité | | booked_date | ✓ par défaut | Date à laquelle l’écriture comptable est ajoutée aux livres. | | montant | ✓ par défaut | Variation 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_code | | Le code de compte du grand livre débité | | credit_gl_code | | Le code de compte du grand livre crédité | | invoice_id | | La 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_id | | L’ID du poste de facture line_item. | | invoice_item_id | | L’ID du poste de facture | | subscription_item_id | | L’ID du poste subscription_item. | | price_id | | Le tarif associé à cette modification. Les paiements isolés ou les postes de facture non associés à un tarif ont la valeur `null`. | | product_id | | Le produit associé à ce tarif. | | customer_id | | Le client associé à cette modification. | | subscription_id | | L’abonnement associé à cette modification. | | charge_id | | Le paiement associé à cette modification. | | refund_id | | Le remboursement associé à cette modification. | | dispute_id | | Le litige associé à cette modification. | | presentment_currency | | La devise de présentation (celle que voit le client) de la transaction. | | presentment_amount | | Le montant de présentation (celui que voit le client). | Si vous rencontrez des problèmes, vous pouvez contacter [revenue-recognition-api-beta@stripe.com](mailto:revenue-recognition-api-beta@stripe.com).