Ir a contenido
Crea una cuenta o Inicia sesión
Logotipo de Stripe Docs
/
Crear una cuentaIniciar sesión
Resumen
Billing
ResumenAcerca de las API de facturación
Impuesto
Resumen
Elaboración de informes
ResumenInformes para varias cuentas
Datos
Resumen

API Revenue RecognitionVista previa pública

Accede a los informes de Stripe Revenue Recognition mediante programación para automatizar tu contabilidad de ejercicio.

Para la contabilidad de ejercicio, Stripe Revenue Recognition proporciona informes descargables, como un resumen mensual y un gráfico de cascada de ingresos. Puedes descargar estos informes en formato CSV a través del Dashboard 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

Precaución

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 .

En primer lugar, crea el objeto report run utilizando Crear un objeto Report Run.

Para obtener un informe de mayo de , establece los parámetros[interval_start] en 1 de mayo de y los parámetros[interval_end] en 1 de junio de .

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
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]"=1746057600 \
  -d "parameters[interval_end]"=1748736000

A continuación, verificar si el objeto Report Run es correcto recuperando dicho objeto:

El ID del objeto Report Run comienza con frr_.

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

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 confile_.

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

Parámetros de ejecución del informe

Tipo de informeParámetros de ejecución obligatoriosPará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. 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 columnaValor predeterminadoDescripción
accounting_periodEl período contable
open_accounting_periodEl período contable abierto; las inscripciones en períodos abiertos están sujetas a cambios
monedaEl código ISO de tres letras de la moneda del importe.
débitoLa cuenta debitada
créditoLa cuenta acreditada
importeCambio del importe, expresado en unidades principales de la moneda (por ejemplo, dólares para USD o pesos para MXN).
credit_gl_codeEl código acreditado del libro mayor
debit_gl_codeEl código debitado del libro mayor

Por precio

Tipo de informe de API: revenue_recognition.debit_credit_by_price.1

Nombre de la columnaValor predeterminadoDescripción
accounting_periodEl período contable
open_accounting_periodEl período contable abierto; las inscripciones en períodos abiertos están sujetas a cambios
monedaEl código ISO de tres letras de la moneda del importe.
price_idEl precio asociado a este cambio.
débitoLa cuenta debitada
créditoLa cuenta acreditada
importeCambio del importe, expresado en unidades principales de la moneda (por ejemplo, dólares para USD o pesos para MXN).
credit_gl_codeEl código acreditado del libro mayor
debit_gl_codeEl código debitado del libro mayor

Por producto

Tipo de informe de API: revenue_recognition.debit_credit_by_product.1

Nombre de la columnaValor predeterminadoDescripción
accounting_periodEl período contable
open_accounting_periodEl período contable abierto; las inscripciones en períodos abiertos están sujetas a cambios
monedaEl código ISO de tres letras de la moneda del importe.
product_idEl producto asociado con este cambio.
débitoLa cuenta debitada
créditoLa cuenta acreditada
importeCambio del importe, expresado en unidades principales de la moneda (por ejemplo, dólares para USD o pesos para MXN).
credit_gl_codeEl código acreditado del libro mayor
debit_gl_codeEl código debitado del libro mayor

Por cliente

Tipo de informe de API: revenue_recognition.debit_credit_by_customer.1

Nombre de la columnaValor predeterminadoDescripción
accounting_periodEl período contable
open_accounting_periodEl período contable abierto; las inscripciones en períodos abiertos están sujetas a cambios
monedaEl código ISO de tres letras de la moneda del importe.
customer_idEl cliente asociado con este cambio.
débitoLa cuenta debitada
créditoLa cuenta acreditada
importeCambio del importe, expresado en unidades principales de la moneda (por ejemplo, dólares para USD o pesos para MXN).
credit_gl_codeEl código acreditado del libro mayor
debit_gl_codeEl código debitado del libro mayor

Por factura

API tipo de informe: revenue_recognition.debit_credit_by_invoice.1

Nombre de la columnaValor predeterminadoDescripción
accounting_periodEl período contable
open_accounting_periodEl período contable abierto; las inscripciones en períodos abiertos están sujetas a cambios
monedaEl código ISO de tres letras de la moneda del importe.
transaction_model_idEl modelo en Stripe asociado a este cambio, ya sea una partida individual de factura, factura, partida individual de factura, aceptar pagos, etc.
débitoLa cuenta debitada
créditoLa cuenta acreditada
booked_dateLa fecha en que el movimiento en el libro mayor se agrega a los libros.
importeCambio del importe, expresado en unidades principales de la moneda (por ejemplo, dólares para USD o pesos para MXN).
debit_gl_codeEl código debitado del libro mayor
credit_gl_codeEl código acreditado del libro mayor
invoice_idLa factura asociada a este cambio. Los cargos independientes o las partidas de factura no asociados a una factura son null.
invoice_line_item_idEl ID de la line_item de factura.
invoice_item_idEl ID de la partida de factura
invoice_numberEl número único del cliente asociado a la factura.
subscription_item_idEl ID del subscription_item.
price_idEl precio asociado a este cambio. Los cargos independientes o las partidas de factura no asociados a un precio son null.
product_idEl producto asociado con este precio.
customer_idEl cliente asociado con este cambio.
subscription_idLa suscripción asociada con este cambio.
charge_idEl cargo asociado con este cambio.
refund_idEl reembolso asociado con este cambio.
dispute_idLa disputa asociada con este cambio.
presentment_currencyLa moneda de pago (de cara al cliente) de la transacción.
presentment_amountEl 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 columnaValor predeterminadoDescripción
accounting_periodEl período contable
open_accounting_periodEl período contable abierto; las inscripciones en períodos abiertos están sujetas a cambios
monedaEl código ISO de tres letras de la moneda del importe.
transaction_model_idEl modelo de Stripe asociado a este cambio: una partida individual de factura, una factura, una partida de factura, un cargo, etc.
débitoLa cuenta debitada
créditoLa cuenta acreditada
booked_dateLa fecha en que el movimiento en el libro mayor se agrega a los libros.
importeCambio del importe, expresado en unidades principales de la moneda (por ejemplo, dólares para USD o pesos para MXN).
debit_gl_codeEl código debitado del libro mayor
credit_gl_codeEl código acreditado del libro mayor
invoice_idLa factura asociada a este cambio. Los cargos independientes o las partidas de factura no asociados a una factura son null.
invoice_line_item_idEl ID de la line_item de factura.
invoice_item_idEl ID de la partida de factura
subscription_item_idEl ID del subscription_item.
price_idEl precio asociado a este cambio. Los cargos independientes o las partidas de factura no asociados a un precio son null.
product_idEl producto asociado con este precio.
customer_idEl cliente asociado con este cambio.
subscription_idLa suscripción asociada con este cambio.
charge_idEl cargo asociado con este cambio.
refund_idEl reembolso asociado con este cambio.
dispute_idLa disputa asociada con este cambio.
presentment_currencyLa moneda de pago (de cara al cliente) de la transacción.
presentment_amountEl importe de pago (de cara al cliente).

Si tienes algún problema, puedes ponerte en contacto con revenue-recognition-api-beta@stripe.com.