# API Revenue Recognition Accede a los informes de Stripe Revenue Recognition mediante programación para automatizar tu contabilidad de ejercicio. Para contabilidad de ejercicio, Stripe Revenue Recognition proporciona [informes descargables](https://docs.stripe.com/revenue-recognition/reports.md), como un [resumen del período](https://docs.stripe.com/revenue-recognition/reports/period-summary.md) y una [cascada de ingresos](https://docs.stripe.com/revenue-recognition/reports/waterfall.md). Puedes descargar estos informes en formato CSV a través del [Dashboard](https://dashboard.stripe.com/revenue-recognition) o puedes acceder a ellos mediante programación a través de la API. Stripe Revenue Recognition admite seis tipos de informes: - `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` > Los campos de datos pueden cambiar porque esta funcionalidad está en versión beta. ## Descargar un informe En el siguiente ejemplo, se descargan los débitos y créditos por resumen de mayo de 2025. En primer lugar, crea el objeto report run utilizando [Crear un objeto Report Run](https://docs.stripe.com/api/reporting/report_run/create.md). Para obtener un informe de mayo de 2025, establece los `parámetros[interval_start]` en 1 de mayo de 2025 y los `parámetros[interval_end]` en 1 de junio de 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" ``` A continuación, verificar si el objeto [Report Run](https://docs.stripe.com/api/reporting/report_run/object.md) es correcto recuperando dicho objeto: El ID del objeto Report Run comienza con `frr_`. ```curl curl https://api.stripe.com/v1/reporting/report_runs/{{REPORT_RUN_OBJECT_ID}} \ -u "<>:" ``` Cuando el `status` del objeto es `succeeded`, puedes descargar el archivo CSV usando su valor `result.id`, como en el siguiente ejemplo: El ID del resultado de la ejecución del informe comienza con`file_`. #### curl ```bash curl https://files.stripe.com/v1/files/{{REPORT_RUN_RESULT_ID}}/contents \ -u <>: ``` ## Parámetros de ejecución del informe | Tipo de informe | Parámetros de ejecución obligatorios | Parámetros de ejecución opcionales | | ------------------------------------------------------- | ------------------------------------- | ----------------------------------------------------------------------- | | 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` | ## Columnas de ejecución del informe De forma predeterminada, los informes se ejecutan con el conjunto predeterminado de columnas. Puedes personalizar la selección y el orden de las columnas en el resultado si incluyes el parámetro opcional columns con una [lista de nombres de columnas](https://docs.stripe.com/reports/api.md#report-runs). A continuación, encontrarás las columnas aceptadas para cada tipo de informe. ### Resumen Tipo de informe de API: `revenue_recognition.debit_credit_summary.1` | Nombre de la columna | Valor predeterminado | Descripción | | ---------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------- | | accounting_period | ✓ predeterminada | El período contable | | open_accounting_period | ✓ predeterminada | El período contable abierto; las inscripciones en períodos abiertos están sujetas a cambios | | moneda | ✓ predeterminada | El [código ISO de tres letras de la moneda](https://docs.stripe.com/currencies.md) del importe. | | débito | ✓ predeterminada | La cuenta debitada | | crédito | ✓ predeterminada | La cuenta acreditada | | importe | ✓ predeterminada | Cambio del importe, expresado en unidades principales de la moneda (por ejemplo, dólares para USD o pesos para MXN). | | credit_gl_code | | El código acreditado del libro mayor | | debit_gl_code | | El código debitado del libro mayor | ### Por precio Tipo de informe de API: `revenue_recognition.debit_credit_by_price.1` | Nombre de la columna | Valor predeterminado | Descripción | | ---------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------- | | accounting_period | ✓ predeterminada | El período contable | | open_accounting_period | ✓ predeterminada | El período contable abierto; las inscripciones en períodos abiertos están sujetas a cambios | | moneda | ✓ predeterminada | El [código ISO de tres letras de la moneda](https://docs.stripe.com/currencies.md) del importe. | | price_id | ✓ predeterminada | El precio asociado a este cambio. | | débito | ✓ predeterminada | La cuenta debitada | | crédito | ✓ predeterminada | La cuenta acreditada | | importe | ✓ predeterminada | Cambio del importe, expresado en unidades principales de la moneda (por ejemplo, dólares para USD o pesos para MXN). | | credit_gl_code | | El código acreditado del libro mayor | | debit_gl_code | | El código debitado del libro mayor | ### Por producto Tipo de informe de API: `revenue_recognition.debit_credit_by_product.1` | Nombre de la columna | Valor predeterminado | Descripción | | ---------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------- | | accounting_period | ✓ predeterminada | El período contable | | open_accounting_period | ✓ predeterminada | El período contable abierto; las inscripciones en períodos abiertos están sujetas a cambios | | moneda | ✓ predeterminada | El [código ISO de tres letras de la moneda](https://docs.stripe.com/currencies.md) del importe. | | product_id | ✓ predeterminada | El producto asociado con este cambio. | | débito | ✓ predeterminada | La cuenta debitada | | crédito | ✓ predeterminada | La cuenta acreditada | | importe | ✓ predeterminada | Cambio del importe, expresado en unidades principales de la moneda (por ejemplo, dólares para USD o pesos para MXN). | | credit_gl_code | | El código acreditado del libro mayor | | debit_gl_code | | El código debitado del libro mayor | ### Por cliente Tipo de informe de API: `revenue_recognition.debit_credit_by_customer.1` | Nombre de la columna | Valor predeterminado | Descripción | | ---------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------- | | accounting_period | ✓ predeterminada | El período contable | | open_accounting_period | ✓ predeterminada | El período contable abierto; las inscripciones en períodos abiertos están sujetas a cambios | | moneda | ✓ predeterminada | El [código ISO de tres letras de la moneda](https://docs.stripe.com/currencies.md) del importe. | | customer_id | ✓ predeterminada | El cliente asociado con este cambio. | | débito | ✓ predeterminada | La cuenta debitada | | crédito | ✓ predeterminada | La cuenta acreditada | | importe | ✓ predeterminada | Cambio del importe, expresado en unidades principales de la moneda (por ejemplo, dólares para USD o pesos para MXN). | | credit_gl_code | | El código acreditado del libro mayor | | debit_gl_code | | El código debitado del libro mayor | ### Por factura API tipo de informe: `revenue_recognition.debit_credit_by_invoice.1` | Nombre de la columna | Valor predeterminado | Descripción | | ---------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | accounting_period | ✓ predeterminada | El período contable | | open_accounting_period | ✓ predeterminada | El período contable abierto; las inscripciones en períodos abiertos están sujetas a cambios | | moneda | ✓ predeterminada | El [código ISO de tres letras de la moneda](https://docs.stripe.com/currencies.md) del importe. | | transaction_model_id | ✓ predeterminada | El modelo en Stripe asociado a este cambio, ya sea una partida individual de factura, factura, partida individual de factura, aceptar pagos, etc. | | débito | ✓ predeterminada | La cuenta debitada | | crédito | ✓ predeterminada | La cuenta acreditada | | booked_date | ✓ predeterminada | La fecha en que el movimiento en el libro mayor se agrega a los libros. | | importe | ✓ predeterminada | Cambio del importe, expresado en unidades principales de la moneda (por ejemplo, dólares para USD o pesos para MXN). | | debit_gl_code | | El código debitado del libro mayor | | credit_gl_code | | El código acreditado del libro mayor | | invoice_id | | La factura asociada a este cambio. Los cargos independientes o las partidas de factura no asociados a una factura son `null`. | | invoice_line_item_id | | El ID de la line_item de factura. | | invoice_item_id | | El ID de la partida de factura | | invoice_number | | El número único del cliente asociado a la factura. | | subscription_item_id | | El ID del subscription_item. | | price_id | | El precio asociado a este cambio. Los cargos independientes o las partidas de factura no asociados a un precio son `null`. | | product_id | | El producto asociado con este precio. | | customer_id | | El cliente asociado con este cambio. | | subscription_id | | La suscripción asociada con este cambio. | | charge_id | | El cargo asociado con este cambio. | | refund_id | | El reembolso asociado con este cambio. | | dispute_id | | La disputa asociada con este cambio. | | presentment_currency | | La moneda de pago (de cara al cliente) de la transacción. | | presentment_amount | | El importe de pago (de cara al cliente). | ### Por partida individual de factura API tipo de informe: `revenue_recognition.debit_credit_by_invoice_line_item.1` | Nombre de la columna | Valor predeterminado | Descripción | | ---------------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | accounting_period | ✓ predeterminada | El período contable | | open_accounting_period | ✓ predeterminada | El período contable abierto; las inscripciones en períodos abiertos están sujetas a cambios | | moneda | ✓ predeterminada | El [código ISO de tres letras de la moneda](https://docs.stripe.com/currencies.md) del importe. | | transaction_model_id | ✓ predeterminada | El modelo de Stripe asociado a este cambio: una partida individual de factura, una factura, una partida de factura, un cargo, etc. | | débito | ✓ predeterminada | La cuenta debitada | | crédito | ✓ predeterminada | La cuenta acreditada | | booked_date | ✓ predeterminada | La fecha en que el movimiento en el libro mayor se agrega a los libros. | | importe | ✓ predeterminada | Cambio del importe, expresado en unidades principales de la moneda (por ejemplo, dólares para USD o pesos para MXN). | | debit_gl_code | | El código debitado del libro mayor | | credit_gl_code | | El código acreditado del libro mayor | | invoice_id | | La factura asociada a este cambio. Los cargos independientes o las partidas de factura no asociados a una factura son `null`. | | invoice_line_item_id | | El ID de la line_item de factura. | | invoice_item_id | | El ID de la partida de factura | | subscription_item_id | | El ID del subscription_item. | | price_id | | El precio asociado a este cambio. Los cargos independientes o las partidas de factura no asociados a un precio son `null`. | | product_id | | El producto asociado con este precio. | | customer_id | | El cliente asociado con este cambio. | | subscription_id | | La suscripción asociada con este cambio. | | charge_id | | El cargo asociado con este cambio. | | refund_id | | El reembolso asociado con este cambio. | | dispute_id | | La disputa asociada con este cambio. | | presentment_currency | | La moneda de pago (de cara al cliente) de la transacción. | | presentment_amount | | El importe de pago (de cara al cliente). | Si tienes algún problema, puedes ponerte en contacto con [revenue-recognition-api-beta@stripe.com](mailto:revenue-recognition-api-beta@stripe.com).