Ir a contenido
Crea una cuenta
o
Inicia sesión
Logotipo de Stripe Docs
/
Pregúntale a la IA
Crear una cuenta
Iniciar sesión
Empieza ahora
Pagos
Ingresos
Plataformas y marketplaces
Gestión del dinero
Recursos para desarrolladores
Resumen
Billing
ResumenAcerca de las API de facturación
Suscripciones
Invoicing
Cobro por consumo
Presupuestos
Gestión de clientes
Gestión de cobros con otros productos
Recuperación de ingresos
Automatizaciones
Prueba tu integración
Impuesto
Resumen
Usa Stripe Tax
Gestiona el cumplimiento de la normativa
Elaboración de informes
Resumen
Seleccionar un informe
Configura informes
API de informes
Informes para varias cuentas
Reconocimiento de ingresos
    Resumen
    Empieza ahora
    Cómo funciona el reconocimiento de ingresos
    Actualidad de los datos
    Tarifas
    Varias monedas
    Plataformas Connect
    Revenue Recognition para el modelo de cobro por consumo
    Contratos de reconocimiento de ingresos
    Informes
    Anulaciones
    Audita tus cifras
    Ejemplos
    Reglas del reconocimiento de ingresos
    Configuración del reconocimiento de ingresos
    Asignación a tu plan de cuentas
    API de obligaciones de rendimiento
    Importar datos a Stripe
    Exportar datos desde Stripe
Datos
ResumenEsquema
Informes personalizados
Data Pipeline
Gestión de datos
InicioIngresosRevenue recognition

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

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

Para obtener un informe de mayo de 2023, establece parameters[interval_start] en 1 de mayo de 2023 y parameters[interval_end] en 1 de junio de 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

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
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 de Stripe asociado con este cambio, ya sea una partida de factura, factura, ítem de factura, 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
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.

¿Te fue útil esta página?
SíNo
  • ¿Necesitas ayuda? Ponte en contacto con soporte.
  • Únete a nuestro programa de acceso anticipado.
  • Echa un vistazo a nuestro registro de cambios.
  • ¿Tienes alguna pregunta? Contacto.
  • ¿LLM? Lee llms.txt.
  • Con tecnología de Markdoc