# Facturas de suscripciones Aprende a gestionar facturas de suscripciones. If your integration uses [customer-configured Accounts](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-customer), replace `Customer` and event references in the code examples with the equivalent Accounts v2 API references. For more information, see [Represent customers with Account objects](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md). *Las facturas* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) son recursos básicos en Stripe, que representan el importe que debe un cliente. Stripe genera una factura por cada período de facturación de suscripciones. También puedes generar facturas de forma manual desde el Dashboard o la API para pagos fuera del período o únicos. Obtén más información sobre el ciclo de vida de las [facturas independientes](https://docs.stripe.com/invoicing/overview.md#invoice-lifecycle) y las [facturas generadas por suscripción](https://docs.stripe.com/billing/invoices/subscription.md#sub-invoice-lifecycle). ## Ciclo de vida de la factura de la suscripción Las siguientes secciones describen cómo Stripe gestiona una factura durante el ciclo de vida de una suscripción. ### Nuevas facturas de suscripciones Cuando creas una suscripción para un cliente, Stripe: - Crea una factura. - [Finaliza](https://docs.stripe.com/invoicing/integration/workflow-transitions.md#finalized) la factura inmediatamente cuando [collection_method](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-collection_method) se establece en `charge_automatically`, o [una hora](https://docs.stripe.com/billing/subscriptions/webhooks.md#successful-invoice-finalization) después cuando se establece en `send_invoice`. Si el pago se efectúa correctamente en la primera factura de la suscripción o la factura no requiere pago, la factura cambia a [status=paid](https://docs.stripe.com/api/invoices/object.md#invoice_object-status) y se activa la suscripción. Hasta que no se efectúe el pago, el [status](https://docs.stripe.com/api/invoices/object.md#invoice_object-status) de la factura es `open` y [auto_advance](https://docs.stripe.com/invoicing/integration/automatic-advancement-collection.md#toggle-auto-advance) permanece en `false`. El [status](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-status) de la suscripción es `incomplete`. Obtén información sobre cómo resolver los errores de pago de las facturas de suscripciones nuevas que [exigen un método de pago](https://docs.stripe.com/billing/subscriptions/overview.md#requires-payment-method). En algunos casos, también se crea una nueva factura cuando se cambia de categoría de suscripción. En estas facturas, [auto_advance](https://docs.stripe.com/invoicing/integration/automatic-advancement-collection.md#toggle-auto-advance) está deshabilitado desde el comienzo. > Stripe no genera una factura cuando creas una suscripción `billing_mode=flexible` que contiene solo ítems de consumo medido. La suscripción se activa de inmediato. Stripe genera una factura en el momento de la creación solo si la suscripción es antedatada con consumo acumulado previamente o si existen ítems de factura pendientes. Cuando se finaliza una factura, no puedes agregar ítems de factura ni hacer ninguna otra modificación que afecte el importe adeudado. Sin embargo, puedes agregarle ítems de factura al cliente. Los ítems agregados se aplicarán a la próxima factura. ### Facturas por renovación de suscripciones Cuando se renuevan suscripciones, Stripe: - Crea una factura. - Mantiene el estado de la factura en `draft` alrededor de una hora. - Intenta finalizar y pagar la factura con el método de pago predeterminado. - Cambia el estado de la factura a `paid` si el pago se efectúa con éxito. Cuando Stripe crea una factura, recibes un evento `invoice.created` en el [punto de conexión del webhook configurado](https://docs.stripe.com/billing/subscriptions/webhooks.md). En este caso, el atributo del [estado](https://docs.stripe.com/api/invoices/object.md#invoice_object-status) es `draft`, lo que significa que las partidas de la factura están abiertas a modificaciones. ### Cobrar pagos Cuando vence una factura, Stripe intenta cobrar el pago mediante un [cargo automático](https://docs.stripe.com/invoicing/automatic-charging.md) al [método de pago](https://docs.stripe.com/payments/payment-methods/integration-options.md) guardado o a través del [envío de la factura por correo electrónico](https://docs.stripe.com/invoicing/integration.md#accept-invoice-payment) a los clientes. Cuando se intenta cobrar una factura, Stripe utiliza el primer método de pago disponible de esta lista, en el siguiente orden: | Prioridad | Método de pago | Atributo API | | --------- | ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | 1 | Método de pago predeterminado de la factura | [invoice.default_payment_method](https://docs.stripe.com/api/invoices/object.md#invoice_object-default_payment_method) | | 2 | Método de pago predeterminado de la suscripción | [subscription.default_payment_method](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-default_payment_method) | | 3 | Método de pago predeterminado de la factura del cliente | [customer.invoice_settings.default_payment_method](https://docs.stripe.com/api/customers/object.md#customer_object-invoice_settings-default_payment_method) | | 4 | (Legacy) Fuente de pago predeterminada del cliente | [customer.default_source](https://docs.stripe.com/api/customers/object.md#customer_object-default_source) | #### Reintentar pagos Stripe ofrece varias opciones para administrar los [pagos fallidos](https://docs.stripe.com/invoicing/automatic-collection.md), entre ellas la funcionalidad [Smart Retries](https://docs.stripe.com/invoicing/automatic-collection.md#smart-retries) que trabaja con machine learning. ## Gestiona las facturas de suscripciones #### Dashboard En las siguientes secciones, se describe cómo realizar [acciones básicas sobre las facturas](https://docs.stripe.com/invoicing/dashboard/manage-invoices.md) en el Dashboard. ### Crear una factura Stripe crea automáticamente una [factura](https://docs.stripe.com/invoicing/dashboard.md#create-invoice) para las suscripciones al final de cada ciclo de facturación. Finalizamos y enviamos la factura en una hora. Puedes editar la factura antes de que se finalice. Obtén más información sobre cómo modificar las facturas en la [página de datos de la factura](https://docs.stripe.com/invoicing/dashboard/manage-invoices.md#invoice-details-page). ### Previsualizar próximas facturas La API para [Recuperar una factura](https://docs.stripe.com/api.md#retrieve_invoice) proporciona un mecanismo para ver una factura existente. Stripe también proporciona un punto de conexión para [crear una vista previa de la factura](https://docs.stripe.com/api/invoices/create_preview.md). Esta vista previa refleja el precio base, las partidas de factura pendientes, los descuentos y los saldos de crédito del cliente existentes. Al acceder a la vista previa, también puedes modelar el aspecto que tendría la factura si cambiaras la suscripción de alguna de las siguientes maneras: - Intercambiando el precio subyacente. - Alterando la cantidad. - Aplicando un período de prueba. - Agregando un cupón. #### API Para facturar a un cliente un cargo único, como el costo de instalación, crea una [partida de factura](https://docs.stripe.com/api.md#invoiceitems) especificando la ID del cliente, la moneda y el precio: ```curl curl https://api.stripe.com/v1/invoiceitems \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ -d "pricing[price]={{PRICE_ID}}" ``` Ahora podrás crear una factura para el cliente, y el ítem de factura se agregará automáticamente: ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" ``` ## Actualiza la primera factura de una suscripción La forma de editar la primera factura de una suscripción depende de la configuración del método de pago del cliente para esa suscripción. Si tienes dudas, puedes consultar la configuración del método de pago en la API o en el Dashboard. Para comprobar el método de pago de la suscripción con la API, comprueba el valor de [collection_method](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-collection_method) en el objeto `Subscriptions` del cliente. Un valor de `send_invoice` significa que Stripe envía un correo electrónico al cliente con su factura. Un valor de `charge_automatically` significa que Stripe cobra al cliente en tu nombre usando su método de pago predeterminado. Para comprobar el método de pago de la suscripción en el Dashboard, abre la [página de suscripciones](https://dashboard.stripe.com/subscriptions). Luego, haz clic en la suscripción que deseas verificar para abrir la vista detallada. En la sección **Datos de suscripción**, el valor del campo **Método de facturación** define el método de pago: **Cargar método de pago predeterminado** o **Enviar factura**. #### Enviar la factura Para los clientes que reciben facturas, tienes un período de una hora a partir de que esta se creó para que Stripe finalice la suscripción. En ese período, puedes realizar los cambios necesarios en la suscripción, por ejemplo, cambiar el importe o los ítems de factura, agregar una descripción o metadatos y más. Después de la hora inicial, ya no podrás hacer actualizaciones. Stripe envía la factura por correo electrónico al cliente para cobrar el pago de la suscripción. #### Cargar método de pago predeterminado Stripe completa inmediatamente la factura inicial y cobra al cliente. En consecuencia, no hay un período de una hora en el que puedas actualizar la factura inicial antes de que se complete. Hay algunas opciones disponibles para hacer cambios en la factura inicial: - Crea la suscripción con `trial_end` definida varios segundos más adelante. La suscripción genera primero una factura de USD 0.00 y, después de finalizar la prueba, Stripe crea una factura distinta de cero con un período de una hora donde figura como borrador. El estado inicial de esta suscripción es `trialing` y pasa a `active` o `past_due`, según el resultado del pago. - Crea la suscripción a través de un [calendario de suscripciones](https://docs.stripe.com/billing/subscriptions/subscription-schedules.md#start-subscription-future). Cuando se inicia la programación, el estado inicial de la suscripción figura como `active`, y el borrador inicial de la factura está programado para finalizar en una hora. En función de si el pago de la factura inicial se efectúa correctamente o no, la suscripción permanece `active` o pasa a `past_due`. ## Personaliza las facturas Puedes personalizar facturas de varias maneras, lo que incluye: - [Agregar ítems de factura adicionales a una factura futura](https://docs.stripe.com/billing/invoices/subscription.md#adding-upcoming-invoice-items) - [Aumentar la frecuencia de las facturas](https://docs.stripe.com/billing/invoices/subscription.md#pending-items-frequently) - [Agregar ítems de factura a la primera factura de un cliente](https://docs.stripe.com/billing/invoices/subscription.md#first-invoice-extra) - [Agregar ítems al borrador de una factura de suscripción](https://docs.stripe.com/billing/invoices/subscription.md#adding-draft-invoice-items) - [Genera una factura fuera del período de servicio de suscripción](https://docs.stripe.com/billing/invoices/subscription.md#generating-invoices). - [Suspender la factura de una suscripción para revisarla](https://docs.stripe.com/billing/invoices/subscription.md#holding-review) - [Emitir una factura de suscripción con precios de ítems configurables](https://docs.stripe.com/billing/invoices/subscription.md#invoice-item-prices) ### Agregar ítems de factura adicionales a una factura futura En una factura, puedes agregar hasta 250 partidas de factura. Para [agregar otras partidas de factura](https://docs.stripe.com/api/invoiceitems/create.md) a la próxima factura del ciclo: ```curl curl https://api.stripe.com/v1/invoiceitems \ -u "<>:" \ -d "pricing[price]=price_CBb6IXqvTLXp3f" \ -d customer=cus_4fdAW5ftNQow1a ``` Estos ítems puntuales se agregan a la próxima factura creada para el cliente. Para cerciorarse de que se agregarán a una determinada suscripción, usa el parámetro opcional `subscription` para aplicarlos a esa suscripción. #### Facturar ítems pendientes con más frecuencia Aparte de [cambiar el período de facturación](https://docs.stripe.com/billing/subscriptions/billing-cycle.md), hay algunas formas de facturar estas partidas sin ajustar el período normal de servicio de la suscripción: - Crea una [factura puntual](https://docs.stripe.com/invoicing/dashboard.md) para el cliente. - Cobra la suscripción cada vez que el importe adeudado alcance un [umbral](https://docs.stripe.com/billing/subscriptions/usage-based/thresholds.md). - Usa [pending_invoice_item_interval](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-pending_invoice_item_interval) para especificar con qué frecuencia se facturarán las partidas de factura pendientes. Esto equivale a hacer que Stripe cree una [factura puntual](https://docs.stripe.com/invoicing/dashboard.md) para la suscripción de forma recurrente. ### Agrega un cargo adicional a la primera factura de una suscripción Incluye un cargo único en la primera factura de la suscripción usando `add_invoice_items`: ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -d customer={{CUSTOMER_ID}} \ -d "items[0][price]={{RECURRING_PRICE_ID}}" \ -d "add_invoice_items[0][price]={{PRICE_ID}}" \ -d payment_behavior=default_incomplete ``` > Si usas [Checkout](https://docs.stripe.com/payments/checkout.md) para crear suscripciones, agrega cargos adicionales especificando [line_items](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-line_items) con la [integración de cliente y de servidor](https://docs.stripe.com/billing/subscriptions/build-subscriptions.md). ### Agregar ítems al borrador de una factura de suscripción Cuando una suscripción se renueva y se crea una factura, Stripe envía el evento de *webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) `invoice.created`. Stripe [espera aproximadamente una hora](https://docs.stripe.com/billing/subscriptions/webhooks.md#understand) antes de finalizar la factura e intentar el pago o enviar un correo electrónico. Durante la espera, la factura está en estado [borrador](https://docs.stripe.com/api/invoices/object.md#invoice_object-status) y es editable. Puedes [crear partidas de factura](https://docs.stripe.com/api/invoiceitems/create.md) para esa factura. Asegúrate de proporcionar el parámetro [invoice](https://docs.stripe.com/api/invoiceitems/create.md#create_invoiceitem-invoice) al crear estas partidas de factura. De lo contrario, se agregan como partidas pendientes y se incluyen en el siguiente período de suscripción. Estos ítems de factura se comportan de una forma un poco diferente de los ítems de factura generados automáticamente por Stripe: - Los ítems de factura pendientes siempre se cobran cuando finaliza el período de facturación de la suscripción que se cancela. Cancelar la suscripción de un cliente evita que se le facture otra vez *si no hay ítems de factura*. - Los ítems de factura pendientes no se prorratean si se modifica la suscripción de un cliente. Si existen ítems de factura pendientes después de cancelar una suscripción, Stripe genera una factura e intenta facturarle al cliente estos ítems al final del siguiente período de facturación. Estos ítems de factura tampoco se prorratean si la suscripción se modifica. #### Gestionar ítems de factura pendientes Puedes ver los ítems de factura pendientes de un cliente en la [página Clientes](https://dashboard.stripe.com/customers), haciendo click en su nombre. Si el cliente tiene un ítem de factura pendiente, aparecerá debajo de **Ítems de factura pendientes**. Un ítem de factura está pendiente si no está asociado a ninguna factura. En **Ítems de factura pendientes** también puedes crear un ítem nuevo o facturar de inmediato todos los ítems enumerados. Al hacer click en **Facturar ahora**, aparece un cuadro de diálogo que te permite seleccionar si quieres cobrarle a la fuente predeterminada o enviarle la factura al cliente por correo electrónico. Además, el cuadro de diálogo te da la opción de calcular los impuestos automáticamente. ### Genera una factura para los ítems de suscripción fuera del período de facturación. Puedes facturar las partidas de factura pendientes fuera del período de facturación habitual [generando una factura](https://docs.stripe.com/invoicing/dashboard.md) única. En la factura única generada se incorporan las partidas de factura pendientes que se hubieran agregado a la factura programada con regularidad. > Cuando generas una factura manualmente, Stripe no aplica las [tasas impositivas](https://docs.stripe.com/tax/tax-rates.md) que puedes haber establecido en la suscripción. Si se deben aplicar impuestos, debes [agregar las tasas impositivas](https://docs.stripe.com/invoicing/taxes/tax-rates.md) a la factura de manera explícita. ### Suspender la factura de una suscripción para revisarla En lugar de intentar el pago al final del período de facturación automáticamente, puedes suspender la factura para hacer revisiones o correcciones. Para suspender la factura: 1. Suspende el cobro automático dentro de la hora posterior a recibir el evento `invoice.created`. Puedes hacerlo estableciendo el parámetro `auto_advance=false` en la API o haciendo click en [Suscripciones y correos electrónicos](https://dashboard.stripe.com/settings/billing/automatic) en el Dashboard. Una vez que encuentres la sección de suspensión de cobros, haz click en **Configurar** para aplicar los cambios. Esta funcionalidad impide que Stripe intente de manera automática el pago del cliente por el importe de la factura y que la envíe por correo electrónico. 1. Revisa la factura. 1. Una vez que tengas todo listo para cobrarle al cliente, reanuda el cobro automático. Para hacerlo, establece [auto_advance=true](https://docs.stripe.com/api/invoices/update.md#update_invoice-auto_advance) o actualiza las opciones de suspensión de cobros en el Dashboard. ### Emitir una factura de suscripción con precios de ítems configurables Puedes emitir facturas con precios de ítem de factura que no incluyan los impuestos. Los precios con impuestos no incluidos solo se muestran en la factura en PDF. Es decir que, al usar impuestos incluidos, la página alojada de facturas y las facturas enviadas por correo electrónico mostrarán los precios con impuestos incluidos. Puedes configurar los precios netos en el Dashboard o mediante la API. - **Incluir impuestos**: La factura en PDF muestra los precios de los ítems de factura más el impuesto incluido. (Esta es la opción predeterminada). - **Excluir impuestos**: La factura en PDF muestra los precios de los ítems de factura sin contar los impuestos. > #### Prioridad de los pedidos > > Si configuras un precio predeterminado para los precios de ítems de facturas de los clientes, estos tienen prioridad sobre los ajustes de la cuenta. ## Anular una factura generada por una suscripción ### Anular la primera factura de una suscripción Cuando anula la primera factura de una suscripción, Stripe aplica la siguiente lógica establecida en el estado de la suscripción: - Si la suscripción está `incomplete`, el estado de la suscripción cambia a `incomplete_expired`. - Si la suscripción está `past_due`, el estado de la suscripción cambia a `active`. - Si la suscripción está `active`, el estado de la suscripción no cambia. ### Anular la factura más reciente de una suscripción Cuando anula la factura más reciente de una suscripción activa, y la factura no es la primera, Stripe aplica la siguiente lógica a cada factura, empezando de la más reciente a la más antigua, hasta que cumpla una de las siguientes condiciones: - Si la factura se encuentra en estado `paid` o `uncollectible`, el estado de la suscripción cambia a `active`. - Si el [método de cobro](https://docs.stripe.com/api/invoices/object.md#invoice_object-collection_method) (collection_method) está establecido en `carga automáticamente` (charge_automatically) en la factura y Stripe ha detenido la reclamación de pagos de la factura debido a los límites de reintentos, el estado de la suscripción cambia a `cancelada` (canceled), `no pagada` (unpaid) o `vencida` (past_due) en función de tu [configuración de cobro automático](https://dashboard.stripe.com/settings/billing/automatic). - Si el [collection_method](https://docs.stripe.com/api/invoices/object.md#invoice_object-collection_method) está configurado como `send_invoice`, y la factura está vencida, el estado de la suscripción cambia a `past_due`. - Si la factura no se encuentra en uno de estos estados, se ejecutarán los mismos pasos en la siguiente factura más reciente. Si ninguna factura coincide con alguno de estos criterios, el estado de la suscripción cambia a `activa`. ## Metadatos de la suscripción Después de que una suscripción crea una factura, en esta se incluyen los `metadata` de la suscripción de las siguientes maneras: - El atributo [subscription_details.metadata](https://docs.stripe.com/api/invoices/object.md#invoice_object-subscription_details-metadata) de la factura siempre contiene los `metadata` de la suscripción en el momento de la creación de la factura, incluso si los `metadata` de la suscripción se modifican posteriormente. - El atributo [metadatos](https://docs.stripe.com/api/invoice/line_item.md#invoice_line_item_object-metadata) de las [partidas individuales de factura](https://docs.stripe.com/api/invoice-line-item/object.md) con [parent.type=“subscription_item_details”](https://docs.stripe.com/api/invoices/object.md#invoice_object-lines-data-parent-type) refleja los `metadatos` de la suscripción más recientes cuando se recupera la factura, lo que significa que podría diferir de los `metadatos` en el momento de creación de la factura. - Las partidas individuales de factura con [parent.type=“invoice_item_details”](https://docs.stripe.com/api/invoices/object.md#invoice_object-lines-data-parent-type) no contienen `metadata` de la suscripción. Cuando modificas directamente los `metadatos` de una partida individual de factura de la suscripción, ya sea con el punto de conexión de la [actualización de la partida de factura](https://docs.stripe.com/api/invoice-line-item/update.md) o de la [actualización masiva de partidas de factura](https://docs.stripe.com/invoicing/bulk-update-line-item.md), la solicitud de actualización declara los `metadatos` de la partida de factura. Los `metadatos` de las suscripciones «heredadas» no se conservan de manera implícita. El valor [Subscription item metadata](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-items-data-metadata) no se propaga automáticamente a ningún otro objeto de Stripe.