# Crear facturas con Connect Con Connect, puedes crear facturas para cuentas conectadas y tienes la opción de cobrar una comisión en el proceso. ¿No tienes suficiente información sobre *Connect* (Connect is Stripe's solution for multi-party businesses, such as marketplace or software platforms, to route payments between sellers, customers, and other recipients)? Consulta nuestro artículo de [Resumen](https://docs.stripe.com/connect.md). Puedes crear *invoices* (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) para cuentas conectadas que usen [cargos Direct](https://docs.stripe.com/connect/direct-charges.md) o [cargos a un destino](https://docs.stripe.com/connect/destination-charges.md). También puedes cobrar una comisión de la plataforma por estas facturas. > Las transacciones de facturas se basan en las [tarifas de Invoicing](https://stripe.com/invoicing/pricing). ## Crear una factura usando cargos Direct Para generar una factura que haga el cobro directamente en una cuenta conectada, [crea una factura](https://docs.stripe.com/api.md#create_invoice) al mismo tiempo que se [autentica](https://docs.stripe.com/connect/authentication.md#stripe-account-header) como la cuenta conectada. Para que funcione, el customer debe definirse en la cuenta conectada. #### curl ```bash curl https://api.stripe.com/v1/invoices \ -u <>: \ -d customer={{CUSTOMER_ID}} \ -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" ``` Al igual que cuando [creas un cargo Direct](https://docs.stripe.com/connect/direct-charges.md#collect-fees) en una cuenta conectada, puedes crear una customer en una cuenta conectada con la clave publicable de la plataforma o la clave publicable de la cuenta conectada. También puedes crear un token con [clientes compartidos](https://docs.stripe.com/connect/cloning-customers-across-accounts.md). Si se usan cargos Direct, la cuenta conectada es responsable del costo de las comisiones, los reembolsos y los contracargos de Stripe. ## Crear una factura usando cargos a un Destino Para generar una factura que cobre en la plataforma y cree envíos de fondos automáticos a una cuenta conectada, [crea una factura](https://docs.stripe.com/api.md#create_invoice) y especifica el ID de la cuenta conectada como [valor](https://docs.stripe.com/api/invoices/object.md#invoice_object-transfer_data) `transfer_data[destination]`. #### curl ```bash curl https://api.stripe.com/v1/invoices \ -u <>: \ -d customer={{CUSTOMER_ID}} \ -d "transfer_data[destination]"="{{CONNECTED_ACCOUNT_ID}}" ``` Para que funcione, customer debe definirse en la cuenta de la plataforma y debes crear el token de la cuenta conectada con la clave publicable de la plataforma. Si se usan transferencias automáticas, la plataforma es la empresa registrada. ## Muestra las ID fiscales y los datos de la empresa de las cuentas conectadas en tus facturas Algunas regiones tienen requisitos normativos para que las empresas muestren sus identificaciones fiscales y otros datos de la empresa en los documentos para el cliente. En algunos casos, puedes cumplir estos requisitos mostrando información sobre una cuenta conectada en lugar de información sobre tu plataforma. Los siguientes pasos muestran cómo representar la identificación fiscal y los detalles de la empresa de una cuenta conectada en correos electrónicos de facturas, facturas en PDF, páginas de facturas alojadas y recibos de facturas: 1. Crea identificaciones fiscales para tus cuentas conectadas. 1. Establece las identificaciones fiscales predeterminadas para tu cuenta conectada. 1. Especifica la cuenta conectada usando el [parámetro `on_behalf_of`](https://docs.stripe.com/connect/invoices.md#on-behalf-of) o como `issuer` en facturas, suscripciones y calendarios de suscripciones nuevos o existentes. ### Crea identificaciones fiscales para tus cuentas conectadas En el siguiente ejemplo se crea un solo número de identificación fiscal para la cuenta conectada. Stripe almacena la identificación fiscal en la cuenta conectada. Para crear identificaciones fiscales adicionales, llama al punto de conexión nuevamente. ```curl curl https://api.stripe.com/v1/tax_ids \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d type=eu_vat \ -d value=DE123456789 ``` ### Establece identificaciones fiscales predeterminadas para tu cuenta conectada Stripe obtiene automáticamente las identificaciones fiscales predeterminadas de la cuenta del `issuer` de la factura durante la finalización, a menos que `account_tax_ids` ya esté establecido en las facturas. Puedes establecer las identificaciones fiscales almacenadas en la cuenta conectada como identificaciones fiscales predeterminadas para esa cuenta. En el siguiente ejemplo, se establecen las identificaciones fiscales existentes como identificaciones fiscales predeterminadas: ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" \ -d "settings[invoices][default_account_tax_ids][0]"=atxi_123 \ -d "settings[invoices][default_account_tax_ids][1]"=atxi_456 ``` ### Establece al emisor en facturas, suscripciones y calendarios de suscripciones nuevos o existentes como la cuenta conectada En el siguiente ejemplo se establece `issuer` en una suscripción existente. Durante la finalización de la factura de suscripción, las facturas de suscripción obtienen las identificaciones fiscales predeterminadas del emisor: ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -d "invoice_settings[issuer][type]"=account \ -d "invoice_settings[issuer][account]"="{{CONNECTEDACCOUNT_ID}}" ``` En el siguiente ejemplo, se establece `issuer` durante la creación de la factura: ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d customer="{{CUSTOMER_ID}}" \ -d "issuer[type]"=account \ -d "issuer[account]"="{{CONNECTEDACCOUNT_ID}}" \ -d "transfer_data[destination]"="{{CONNECTEDACCOUNT_ID}}" ``` Alternativamente, el parámetro `on_behalf_of` también muestra los detalles de una cuenta conectada en el correo electrónico de la factura, la factura en PDF, la página de facturas alojadas y el recibo de la factura. ### Define identificaciones fiscales de la cuenta en facturas, suscripciones y calendarios de suscripciones nuevos o existentes Puedes especificar `account_tax_ids` para facturas, suscripciones y calendarios de suscripciones para reemplazar las identificaciones fiscales predeterminadas. En el siguiente ejemplo se establece `account_tax_ids` en una suscripción existente: ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -d "invoice_settings[issuer][type]"=account \ -d "invoice_settings[issuer][account]"="{{CONNECTEDACCOUNT_ID}}" \ -d "invoice_settings[account_tax_ids][]"=txi_123 \ -d "invoice_settings[account_tax_ids][]"=txi_456 ``` En el siguiente ejemplo se establece `account_tax_ids` durante la creación de la factura: ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d customer="{{CUSTOMER_ID}}" \ -d "issuer[type]"=account \ -d "issuer[account]"="{{CUSTOMERACCOUNT_ID}}" \ -d "transfer_data[destination]"="{{CUSTOMERACCOUNT_ID}}" \ -d "account_tax_ids[]"=txi_123 \ -d "account_tax_ids[]"=txi_456 ``` ### Crea identificaciones fiscales almacenadas en la plataforma para tu cuenta conectada La identificación fiscal que crees se almacenará en la cuenta de la plataforma en lugar de en la cuenta conectada. En el siguiente ejemplo se crea un solo número de identificación fiscal para la cuenta conectada sin usar el encabezado `Stripe-Account`: ```curl curl https://api.stripe.com/v1/tax_ids \ -u "<>:" \ -d type=eu_vat \ -d value=DE123456789 \ -d "owner[type]"=account \ -d "owner[account]"="{{CONNECTEDACCOUNT_ID}}" ``` ## Cobrar comisiones de la aplicación En la factura, tienes la opción de retener una comisión de la aplicación. El siguiente ejemplo muestra un [application_fee_amount](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-application_fee_percent) para una factura con un cargo Direct en la cuenta conectada: #### curl ```bash curl https://api.stripe.com/v1/invoices \ -u <>: \ -d customer={{CUSTOMER_ID}} \ -d application_fee_amount="10" \ -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" ``` Este ejemplo muestra un `application_fee_amount` para una factura con un cargo a un Destino: #### curl ```bash curl https://api.stripe.com/v1/invoices \ -u <>: \ -d customer={{CUSTOMER_ID}} \ -d application_fee_amount="10" \ -d "transfer_data[destination]"="{{CONNECTED_ACCOUNT_ID}}" ``` ## Configurar métodos de pago de facturas Gestiona los [métodos de pago](https://docs.stripe.com/connect/payment-methods.md) de facturas que pueden usar tus cuentas conectadas. Para habilitar una lista predeterminada de métodos de pago: 1. Dirígete a **Configuración** > **Facturación** >[Factura](https://dashboard.stripe.com/settings/billing/invoice). 1. En la sección **Métodos de pago predeterminados**, haz clic en el menú desplegable **Configuración del método de pago de cuentas conectadas**. 1. Selecciona **Predeterminado** para permitir que Stripe proporcione la configuración predeterminada de los métodos de pago. Tus cuentas conectadas aún tienen la posibilidad de habilitar y deshabilitar métodos de pago particulares después de habilitar la configuración predeterminada. También puedes administrar los métodos de pago de cuentas conectadas particulares mediante la API de [configuración de métodos de pago](https://docs.stripe.com/api/payment_method_configurations/create.md). Si tu integración utiliza [métodos de pago dinámicos](https://docs.stripe.com/connect/dynamic-payment-methods.md), puedes crear tu propia configuración de método de pago. Para obtener más información, consulta [Configuraciones múltiples para tus cuentas Connect](https://docs.stripe.com/connect/multiple-payment-method-configurations.md). Si creas una configuración personalizada de método de pago, esta aparecerá como una opción en el menú desplegable **Configuración de métodos de pago de cuentas conectadas**. ## Determinar que la cuenta conectada sea el comerciante a cargo del cobro Para que la cuenta conectada sea el comerciante a cargo del cobro, cobra a la customer usando el parámetro `on_behalf_of` cuando crees o actualices la factura. Debes definir `on_behalf_of` en la API antes de finalizar la factura. El Dashboard no tiene una interfaz para las facturas que envías en nombre de las cuentas conectadas. Al definir el parámetro `on_behalf_of`, la imagen de marca, la información de contacto y el número de identificación fiscal de la cuenta conectada se aplican al correo electrónico de la factura, a la factura en PDF, a la página de facturas alojadas y al recibo de la factura. Sin embargo, cuando usas `on_behalf_of` en un *entorno de prueba* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes), no se envían correos electrónicos, como ocurre con las facturas estándar enviadas con la API. Mientras haces la prueba en un entorno de prueba, puedes verificar que Stripe haya creado una factura consultando la [página Facturas](https://dashboard.stripe.com/test/invoices) del Dashboard. Para cobrar pagos en nombre de la cuenta conectada, la cuenta conectada también debe tener [funcionalidades de cuenta](https://docs.stripe.com/connect/account-capabilities.md) habilitadas para los métodos de pago correspondientes. Puedes transferir automáticamente los pagos de facturas creadas en nombre de la cuenta conectada usando cargos a un destino. Para obtener más información acerca del parámetro `on_behalf_of​`, consulta la documentación pertinente de Connect: - Para obtener información sobre envíos de fondos automáticos a la cuenta conectada, consulta la información relacionada con los parámetros `on_behalf_of` en la guía [Crear un cargo](https://docs.stripe.com/connect/charges.md#on_behalf_of). - Para obtener información sobre cómo transferir pagos manualmente, consulta [Disponibilidad de transferencias](https://docs.stripe.com/connect/separate-charges-and-transfers.md#transfer-availability). - Para obtener una lista de las funcionalidades de cuenta necesarias para cobrar pagos en nombre de la cuenta conectada, consulta [Funcionalidades para métodos de pago](https://docs.stripe.com/connect/account-capabilities.md#payment-methods). El siguiente ejemplo muestra cómo utilizar el parámetro `on_behalf_of` para una factura nueva usando cargos y envíos de fondos separados: ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d on_behalf_of="{{CONNECTEDACCOUNT_ID}}" \ -d customer="{{CUSTOMER_ID}}" ``` Como ocurre con los cargos a un destino estándar, se puede definir un `application_fee_amount` en las facturas. En este ejemplo, se indica cómo usar `on_behalf_of` con cargos a un destino y una comisión de la plataforma. ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d on_behalf_of="{{CONNECTEDACCOUNT_ID}}" \ -d application_fee_amount=10 \ -d "transfer_data[destination]"="{{CONNECTEDACCOUNT_ID}}" \ -d customer="{{CUSTOMER_ID}}" ``` Las facturas creadas en nombre de una cuenta conectada no son compatibles con los métodos de pago transferencias bancarias, como transferencia de crédito ACH y cheques impresos. ## Integra el cálculo y cobro de impuestos Primero debes determinar qué entidad es responsable del pago de impuestos. La entidad responsable de los impuestos puede ser tu cuenta conectada o la plataforma, en función de tu modelo de negocio. Para obtener más información, consulta [Stripe Tax con Connect](https://docs.stripe.com/tax/connect.md). ## Ver también - [Crear cargos](https://docs.stripe.com/connect/charges.md) - [Comparte clientes entre cuentas](https://docs.stripe.com/connect/cloning-customers-across-accounts.md) - [Varias monedas](https://docs.stripe.com/connect/currencies.md)