# Personalizar facturas Obtén información sobre cómo personalizar el contenido y la imagen de marca de tus facturas. Puedes personalizar el contenido de una *factura* de las siguientes maneras: - A través de la API - A través del editor de facturas - A través del editor de suscripciones - A través de [plantillas de facturas](https://docs.stripe.com/invoicing/invoice-rendering-template.md) - A través de la [configuración de factura](https://dashboard.stripe.com/settings/billing/invoice) de la cuenta También puedes establecer un idioma preferido para el cliente e incluir información pública en los [datos de la cuenta](https://dashboard.stripe.com/settings/account/?support_details=true). Dado que conoces más sobre tus clientes y tu empresa que Stripe, asegúrate de que las facturas incluyan toda la información necesaria. Tus facturas deben ser precisas, cobrar el impuesto correspondiente y cumplir con todas las leyes y normativas vigentes en tu región. > #### Usa la API Accounts v2 para representar a los clientes > > La API Accounts v2 suele estar disponible para usuarios Connect y en versión preliminar pública para otros usuarios de Stripe. Si eres parte de la versión preliminar Accounts v2, debes especificar una [versión preliminar](https://docs.stripe.com/api-v2-overview.md#sdk-and-api-versioning) en tu código. > > Para solicitar el acceso a la versión preliminar Accounts v2, > > Para la mayoría de los casos de uso, te recomendamos que[modeles a tus clientes como objetos Account configurados por el cliente](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md) en lugar de usar objetos [Customer](https://docs.stripe.com/api/customers.md). ## Imagen de marca Stripe te permite personalizar (y previsualizar) los recibos enviados por correo electrónico, las facturas alojadas, las facturas en PDF, etc., en tu [configuración de imagen de marca](https://dashboard.stripe.com/account/branding). Los íconos y logotipos deben estar en formato JPG o PNG, pesar menos de 512 kB y tener una resolución superior o igual a 128 px por 128 px. - **Ícono**: un ícono o logotipo cuadrado adaptable a un entorno digital. - **Logotipo**: un logotipo no cuadrado para reemplazar algunos usos del ícono. - **Color de la marca**: para recibos, facturas y el portal de clientes. - **Color de énfasis**: para el fondo de los correos electrónicos y las páginas. ### Aplicar la configuración de marca La configuración de marca se aplica a toda la cuenta y tiene efecto en muchos lugares. | Configuración | Correos electrónicos | Checkout y Payment Links | Portal de clientes | Página de facturas alojadas | Facturas en PDF | | -------------------- | ------------------------ | ------------------------ | ------------------ | --------------------------- | --------------- | | **Ícono** | Sí | Sí | Sí | Sí | Sí | | **Logotipo** | No | Sí | No | No | Sí | | **Color de marca** | Sí | No | Sí | Sí | Sí | | **Color de énfasis** | Sí (como color de fondo) | Sí | Sí | Sí | No | ## Numeración de las facturas Stripe genera automáticamente números de factura para ayudarte a hacer el seguimiento y la conciliación de las facturas. Los números de factura tienen un prefijo y un sufijo, por ejemplo, `586A2E-0139` o `MYSHOP-1203`. (El número completo de la factura siempre es uno solo para toda la cuenta en ambos esquemas). Stripe acepta dos esquemas de numeración de facturas: - **En secuencia para cada cliente (por cliente)**: utiliza un prefijo exclusivo para cada cliente y asigna números de factura secuenciales por cliente. - **En secuencia en toda la cuenta (por cuenta)**: utiliza el mismo prefijo para todos los clientes y asigna los números de factura secuencialmente en toda la cuenta. Stripe elige un comportamiento predeterminado conforme al país en que está establecida tu cuenta de Stripe. Los países miembros de la [Unión Europea](https://ec.europa.eu/taxation_customs/business/vat/eu-vat-rules-topic/vat-invoicing-rules_en) y el [Reino Unido](https://www.gov.uk/invoicing-and-taking-payment-from-customers/invoices-what-they-must-include), por lo general, exigen la secuencia por cuenta. Todos los demás países usan, de forma predeterminada, la secuencia por cliente porque no revela la cantidad total de facturas. Cuando cambies entre esquemas o actualices prefijos, solo las facturas futuras usarán la nueva configuración, ya que el cambio no modificará las facturas existentes. > Los requisitos de las facturas varían según la jurisdicción. Consulta a un profesional para que te asesore sobre tu caso de uso específico. Eres responsable de verificar que las facturas emitidas cumplan con los requisitos fiscales locales. ### Prefijos a nivel del cliente Cuando configuras una factura para usar la numeración por cliente, cada número de factura comienza con el prefijo exclusivo del cliente. Por ejemplo, si uno de tus clientes es una empresa llamada Typographic, podrías definir el prefijo `TYPGRA`. El primer número de factura para Typographic sería `TYPGRA-0001`, el segundo sería `TYPGRA-0002` y así sucesivamente. Los prefijos deben tener entre 3 y 12 caracteres y no pueden coincidir con ningún otro prefijo de cliente, incluidos los prefijos que ya no están en uso. Puedes establecer prefijos en la [página Clientes](https://dashboard.stripe.com/customers) en el Dashboard o con la API. Si modelas clientes como objetos `Cuenta` configurada como cliente, usa el parámetro [configuration.client.billing.factura.prefix](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-customer-billing-invoice-prefix). Si modelas clientes como objetos `Cliente`, usa el parámetro [invoice_prefix](https://docs.stripe.com/api/customers/create.md#create_customer-invoice_prefix). ### Prefijos a nivel de la cuenta Cuando configuras una factura para usar la numeración por cuenta, cada número de factura comienza con un prefijo común y un número consecutivo. Por ejemplo, si tu empresa se llama Rocket Rides, podrías definir el prefijo `RKTRIDE`. Tu primera factura sería `RKTRIDE-0001`; la segunda factura, emitida para otro cliente, sería `RKTRIDE-0002`; la tercera factura, emitida para el primer cliente, sería `RKTRIDE-0003`, y así sucesivamente. Stripe asigna automáticamente el prefijo para toda la cuenta, pero puedes reemplazarlo para que quede más claro que son facturas de tu empresa. Si deseas modificar el prefijo de tu cuenta, puedes modificarlo en la [Configuración de facturas](https://dashboard.stripe.com/settings/billing/invoice). Para ello, la versión de API predeterminada de tu cuenta debe ser, como mínimo, [2020-03-02](https://docs.stripe.com/upgrades.md#2020-03-02). Los prefijos deben tener entre 3 y 12 caracteres y no pueden coincidir con ningún otro prefijo de cliente, ni siquiera con prefijos en desuso. ### Prefijos de las cuentas Connect Al crear facturas con el parámetro `on_behalf_of`, Stripe utiliza la cuenta conectada como comerciante registrado. Cada comerciante registrado mantiene su propia secuencia de números de factura, lo que significa: - Cada cuenta conectada tiene su propia secuencia de numeración de facturas que comienza en `0001`. - Las facturas para el mismo cliente de diferentes cuentas conectadas (especificadas usando `on_behalf_of`) pueden tener el mismo prefijo y sufijo de número de factura. - El comerciante registrado determina qué secuencia de facturas se utiliza, no la cuenta de la plataforma. ### Establecer el número de factura inicial De forma predeterminada, la numeración de las facturas comienza en `0001`. No obstante, si quieres usar un número de inicio diferente, puedes cambiarlo. Por ejemplo, si estás migrando clientes existentes a Stripe Invoicing, quizás te convenga continuar con la numeración de tu sistema anterior. Si el usuario quedó en `123` en la última factura del sistema anterior, Stripe permite retomar la misma numeración y empezar en `124`. Si usas prefijos a nivel del cliente, establece el número de inicio en la página **Datos del cliente** en tu Dashboard o con la API. Si modelas clientes como objetos `Account` configurados por cliente, usa el parámetro [configuration.customer.billing.invoice.next_sequence](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-customer-billing-invoice-next_sequence). Si modelas clientes como objetos `Customer`, usa el parámetro [next_invoice_sequence](https://docs.stripe.com/api/customers/create.md#create_customer-next_invoice_sequence). Si usas prefijos a nivel de cuenta, establece el número de inicio en el campo **Siguiente secuencia de facturas** en la página de [configuración de facturas](https://dashboard.stripe.com/settings/billing/invoice) de tu Dashboard. El número de la siguiente factura debe ser un número mayor que cualquier otro número utilizado en facturas. El número máximo permitido para una factura es 1,000,000,000, independientemente de cómo lo hayas definido. Utiliza el valor más bajo posible para no alcanzar este límite. ## Campos de la factura Obtén más información sobre los diferentes campos de la factura, como la nota, el pie de página y los campos personalizados. Para establecer el mismo valor en estos campos para grupos de clientes, puedes usar [Plantillas de facturas](https://docs.stripe.com/invoicing/invoice-rendering-template.md). ### Nota predeterminada Se incluye una nota en las facturas en PDF, en los correos electrónicos de facturas y en la [página de facturas alojadas](https://docs.stripe.com/invoicing/hosted-invoice-page.md). Las notas suelen utilizarse como una sección de comentarios para agradecerle al cliente por su confianza o para darle más contexto a la factura (por ejemplo, una nota de parte del vendedor que habló con el cliente). Puedes definir un campo de notas predeterminado para tu cuenta en [Configuración de facturas](https://dashboard.stripe.com/settings/billing/invoice). Las nuevas facturas usarán este valor. Asimismo, puedes especificar la nota en las [Plantillas de facturas](https://docs.stripe.com/invoicing/invoice-rendering-template.md), que reemplaza la nota predeterminada en las facturas mediante una plantilla. Puedes especificar una nota diferente para una factura en particular cuando la crees o actualices en el Dashboard. También puedes especificar una nota usando la API llamando a [actualizar factura](https://docs.stripe.com/api/invoices/update.md#update_invoice-description) e incluyendo el parámetro `description`. ### Pie de página predeterminado Las facturas en PDF pueden incluir un bloque de texto opcional en el pie de página que suele utilizarse para incluir texto del contrato o exigido por la ley. Con frecuencia, se utiliza para incluir los datos de registro de la empresa exigidos por la ley, como el número de registro de Companies House del Reino Unido. Al igual que el campo de la nota, puedes establecer el valor predeterminado del pie de página en [Invoice settings](https://dashboard.stripe.com/settings/billing/invoice) o especificar los pies de página en [Plantillas de facturas](https://docs.stripe.com/invoicing/invoice-rendering-template.md). Puedes especificar un pie de página diferente para un borrador de factura en particular cuando lo creas o actualizas en el Dashboard, o con la API llamando a [actualizar factura](https://docs.stripe.com/api/invoices/update.md#update_invoice-footer). Si la factura se [finalizó](https://docs.stripe.com/invoicing/integration/workflow-transitions.md#finalized), no podrás actualizar el campo de pie de página. ### Precios de los ítems predeterminados 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. ### Campos personalizados Agrega campos personalizados para mejorar los documentos PDF de tu factura y ayudarte a cumplir con tus obligaciones de prácticas comerciales y declaraciones fiscales. Los campos personalizados te permiten especificar hasta cuatro pares clave-valor que se muestran en el encabezado de la factura. Puedes configurar hasta cuatro pares clave-valor para los campos personalizados en el [editor de facturas](https://dashboard.stripe.com/invoices/create), con la [API Invoices](https://docs.stripe.com/api/invoices/create.md#create_invoice-custom_fields) o con [plantillas de facturas](https://docs.stripe.com/invoicing/invoice-rendering-template.md). Estos son algunos usos comunes de los campos personalizados: - Números de orden de compra - Números de contratista - Cumplimiento de la normativa fiscal #### Herencia de campos personalizados Puedes configurar campos de factura personalizados en el objeto que utilizas para representar a tu cliente. Los campos personalizados que configuras a nivel del cliente se aplicarán a todas las facturas en borrador que generes para ese cliente. Tienes tiempo de modificar estos campos personalizados heredados mientras la factura esté en borrador. Si finalizas la factura, no podrás actualizar los campos personalizados. ## Identificaciones fiscales Agrega identificaciones fiscales para que aparezcan en las facturas en PDF y en los recibos por correo electrónico. Puedes definir una o más como predeterminadas para incluirlas en todas las facturas de forma automática, o seleccionar diferentes identificaciones cuando crees facturas individuales. Para gestionar las identificaciones fiscales, ve a **Configuración** > **Facturación** > [Facturas](https://dashboard.stripe.com/settings/billing/invoices/general) y desplázate hasta la sección Información fiscal de la factura. Luego de agregar una identificación fiscal, no podrás cambiar el número ni el tipo. Para actualizar una, elimínala y agrega una nueva. ## Tamaño de página en PDF Puedes establecer el tamaño de página de tu factura en PDF, incluidas las facturas finalizadas, en A4 (8,27 x 11,69 pulgadas) o carta (8,5 x 11 pulgadas). #### Dashboard Para establecer el tamaño de la página desde el Dashboard, ve al [editor de facturas](https://dashboard.stripe.com/invoices/create) y busca la sección **Opciones avanzadas**. Luego, en la subsección **Tamaño de página PDF**, selecciona **A4** o **Carta**. #### API Para establecer el tamaño de la página usando la API, puedes [crear](https://docs.stripe.com/api/invoices/create.md#create_invoice-rendering-pdf) o [actualizar](https://docs.stripe.com/api/invoices/update.md#update_invoice-rendering-pdf) una factura y establecer el parámetro `rendering["pdf"]["page_size"]` con el tamaño de página preferido. El tamaño predeterminado de página con formato PDF es A4 para los clientes con una configuración regional japonesa y tamaño carta para los clientes con otras configuraciones regionales. Puedes volver a establecer el parámetro `rendering["pdf"]["page_size"]` en `auto` para activar este comportamiento predeterminado. Este es un ejemplo de creación de una factura con A4 como tamaño de página PDF: #### Accounts v2 ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d "rendering[pdf][page_size]=a4" ``` #### Customers v1 ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ -d "rendering[pdf][page_size]=a4" ``` ## Agrupa partidas individuales Para ayudar a tus clientes a comprender mejor tus facturas (incluidos los archivos PDF, la página de facturas alojadas y los correos electrónicos de facturas), clasifica y muestra las partidas de las facturas en diferentes grupos. También puedes ocultar grupos departidas. Si algunas partidas son excesivamente detalladas, puedes configurarlo para que solo tus clientes puedan ver su subtotal a nivel de grupo. ## Condiciones de pago predeterminadas En las **Condiciones de pago predeterminadas** de la [Configuración de facturas](https://dashboard.stripe.com/settings/billing/invoice), puedes seleccionar cuándo vencerá el pago después de enviar la factura. También puedes elegir si se incluirá en la factura por correo electrónico un enlace para acceder a una página de pagos de facturas. Los clientes pueden usar este enlace para pagar, descargar y ver el estado de su factura. Finalmente, en esta sección puedes gestionar los métodos de pago aceptados. ## Idiomas preferidos de los clientes Cuando crees un cliente, usa el menú desplegable **Idioma** para definir su idioma de preferencia. (También puedes agregar o editar el idioma de preferencia en los detalles de facturación en el Dashboard o cuando crees una factura). Stripe utilizará este idioma para localizar facturas por correo electrónico y en PDF, recibos por correo electrónico y en PDF, y también las notas de crédito en PDF. Para actualizar el idioma de preferencia de un cliente con la API, establece [defaults.locales](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-defaults-locales) para los objetos `Account` configurados por el cliente o [preferred_locales](https://docs.stripe.com/api/customers/object.md#customer_object-preferred_locales) para los objetos `Customer`. Ambas propiedades son matrices y puedes agregar varias configuraciones regionales en orden de preferencia. Stripe Invoicing acepta los siguientes idiomas: - Búlgaro - Chino (Hong Kong) - Chino (simplificado) - Chino (Taiwán) - Croata - Checo - Danés - Neerlandés - Inglés (Reino Unido) - Inglés (Estados Unidos) - Estonio - Filipino - Finés - Francés (Canadá) - Francés (Francia) - Alemán - Griego - Húngaro - Indonesio - Italiano - Japonés - Coreano - Letón - Lituano - Malayo (Malasia) - Malayalam - Maltés - Noruego - Polaco - Portugués (Brasil) - Portugués (Portugal) - Rumano - Ruso - Eslovaco - Esloveno - Español (Latinoamérica) - Español (España) - Sueco - Tailandés - Turco - Vietnamita ## Direcciones de cobro y envío ### Direcciones de facturación Stripe utiliza la [identity.individual.address](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-identity-individual-address) del cliente (para los objetos `Account` configurados por el cliente) o la [dirección](https://docs.stripe.com/api/customers/object.md#customer_object-address) (para los objetos `Customer`) como complemento de facturación de la factura en PDF. Si no estableces expresamente esa dirección, Stripe mostrará su dirección de envío como complemento de facturación en PDF. También puedes agregar o editar la dirección de facturación del cliente en la página **Datos del cliente** del Dashboard. ### Direcciones de envío Para que los datos de envío aparezcan en la factura en PDF, configura la propiedad [shipping_details](https://docs.stripe.com/api/invoices/create.md#create_invoice-shipping_details). Si no estableces la propiedad `shipping_details` de la factura, Stripe muestra la dirección de envío en el PDF con la dirección de envío del objeto [Account](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-configuration-customer-shipping) o del objeto [Customer](https://docs.stripe.com/api/customers/object.md#customer_object-shipping) configurado por el cliente. ## Información de soporte público Las facturas incluyen cualquier información pública que hayas especificado en [información comercial pública](https://dashboard.stripe.com/settings/public), como tu dirección de correo electrónico de soporte o el sitio web comercial. Con esta configuración, también puedes optar por incluir un número de teléfono de soporte en los documentos orientados al cliente, como los PDF de facturas y los correos electrónicos, o de forma predeterminada en la dirección de tu empresa. ## See also - [Usar el Dashboard](https://docs.stripe.com/invoicing/dashboard.md) - [Página de facturas alojadas](https://docs.stripe.com/invoicing/hosted-invoice-page.md) - [Enviar correos electrónicos al cliente](https://docs.stripe.com/invoicing/send-email.md)