# Personalizar faturas Saiba como personalizar o conteúdo e a marca das suas faturas. Você pode personalizar o conteúdo de uma fatura das seguintes formas: - Via API - Via editor das faturas - Via editor de assinatura - Via [modelos da fatura](https://docs.stripe.com/fatura/fatura-rendering-modelo.md) - Pelas [Configurações de Fatura](https://dashboard.stripe.com/settings/billing/invoice) da conta Você também pode definir um idioma preferencial do cliente e incluir informações públicas em seus [dados da conta](https://dashboard.stripe.com/settings/account/?support_details=true). Como você sabe mais sobre seus clientes e sua empresa do que a Stripe, certifique-se de que suas faturas incluam todas as informações necessárias. Suas faturas devem ser precisas, cobrar o imposto apropriado e cumprir todas as leis e regulamentos pertinentes em sua região. > #### Use a API Accounts v2 para representar clientes > > A API Accounts v2 está geralmente disponível para usuários do Connect e em prévia pública para outros usuários da Stripe. Se faz parte da prévia de Accounts v2, é necessário [especificar uma versão de prévia](https://docs.stripe.com/api-v2-overview.md#sdk-and-api-versioning) no seu código. > > Para solicitar acesso à prévia de Accounts v2, > > Para a maioria dos casos de uso, recomendamos [modelar seus clientes como objetos Accounts configuradas pelo cliente](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md), em vez de usar objetos [Customer](https://docs.stripe.com/api/customers.md). ## Marca A Stripe permite personalizar (e visualizar) recibos de e-mail, faturas hospedadas, faturas em PDF e assim por diante nas [Configurações de marca](https://dashboard.stripe.com/account/branding). Ícones e logotipos precisam estar em formato JPG ou PNG, ter menos de 512 kb e no mínimo 128 px por 128 px. - **Ícone**: um ícone ou logotipo quadrado para uso digital. - **Logotipo**: um logotipo não quadrado para substituir o ícone em algumas utilizações. - **Cor da marca**: usada em recibos, faturas e no portal de clientes. - **Cor de destaque**: usada como fundo em e-mails e páginas. ### Aplicar configurações da marca As configurações de marca se aplicam a toda a sua conta e são executadas em vários locais. | Configuração | E-mails | Checkout e Payment Links | Portal de clientes | Página da fatura hospedada | PDFs de faturas | | ------------------- | ------------------ | ------------------------ | ------------------ | -------------------------- | --------------- | | **Ícone** | Sim | Sim | Sim | Sim | Sim | | **Logotipo** | Não | Sim | Não | Não | Sim | | **Cor da marca** | Sim | Não | Sim | Sim | Sim | | **Cor de destaque** | Sim (cor de fundo) | Sim | Sim | Sim | Não | ## Numeração de faturas A Stripe gera números de fatura automaticamente para ajudar a monitorar e reconciliar faturas. Os números de fatura têm um prefixo e um sufixo, como `586A2E-0139` ou `MYSHOP-1203`. (O número completo da fatura é sempre único na sua conta e em ambos os esquemas). A Stripe aceita dois esquemas de numeração de faturas: - **Sequencial por cliente (nível do cliente)**: usa um prefixo único para cada cliente e atribui números de fatura sequencialmente para um determinado cliente. - **Sequencial por conta (nível da conta)**: usa o mesmo prefixo para cada cliente e atribui números de fatura sequencialmente em toda a conta. A Stripe escolhe um comportamento padrão conforme o país de sua conta Stripe. Países-membros da [União Europeia](https://ec.europa.eu/taxation_customs/business/vat/eu-vat-rules-topic/vat-invoicing-rules_en) e do [Reino Unido](https://www.gov.uk/invoicing-and-taking-payment-from-customers/invoices-what-they-must-include) normalmente exigem uma sequência por conta. Os demais países usam sequência por cliente, porque ele não expõe o número total de faturas. A alternância entre esquemas ou a atualização de prefixos não afetam as faturas existentes. As novas configurações são usadas apenas nas próximas faturas. > Os itens obrigatórios em faturas dependem de sua jurisdição. Consulte um profissional para receber orientações sobre seu uso específico. Você é responsável por garantir que suas faturas cumpram os requisitos fiscais. ### Prefixos por cliente Quando você configura uma fatura para usar numeração por cliente, cada número de fatura começa com o prefixo único da fatura do cliente. Por exemplo, se um dos seus clientes for uma empresa chamada Typographic, é possível definir o prefixo `TYPGRA`. O número da primeira fatura para a Typographic seria `TYPGRA-0001`, o segundo seria `TYPGRA-0002` e assim por diante. Os prefixos devem ter entre 3 e 12 caracteres e não podem corresponder a nenhum outro prefixo de cliente, inclusive prefixos que não estão mais em uso. Você pode definir prefixos na [página Clientes](https://dashboard.stripe.com/customers) no Dashboard ou usando a API. Se você modela clientes como objetos de `Account` configurados pelo cliente, use o parâmetro [configuration.customer.billing.invoice.prefix](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-customer-billing-invoice-prefix). Se você modela clientes como objetos `Customer`, use o parâmetro [invoice_prefix](https://docs.stripe.com/api/customers/create.md#create_customer-invoice_prefix). ### Prefixos por conta Quando você configura uma fatura para usar numeração por conta, cada fatura usa um prefixo comum e um número sequencial. Por exemplo, se a sua empresa se chamar Rocket Rides, você pode definir o prefixo como `RKTRIDE`. Sua primeira fatura seria `RKTRIDE-0001`, uma segunda fatura para outro cliente seria `RKTRIDE-0002`, outra fatura para o primeiro cliente seria `RKTRIDE-0003`, e assim por diante. A Stripe atribui automaticamente o prefixo para toda a conta, mas é possível sobrepô-lo para deixar mais claro que as faturas são da sua empresa. Para modificar o prefixo da sua conta, use as [configurações de fatura](https://dashboard.stripe.com/settings/billing/invoice). A versão padrão da API da sua conta precisa ser pelo menos [2020-03-02](https://docs.stripe.com/upgrades.md#2020-03-02). Os prefixos devem ter de 3 a 12 caracteres e não podem ser iguais a nenhum prefixo de cliente, inclusive prefixos que não estiverem mais em uso. ### Prefixos de contas Connect Ao criar faturas com o parâmetro `on_behalf_of`, a Stripe usa a conta conectada como o comerciante de registro. Cada comerciante de registro mantém sua própria sequência de números de fatura separada, o que significa que: - Cada conta conectada tem sua própria sequência de numeração de fatura, que começa em `0001`. - Faturas para o mesmo cliente de diferentes contas conectadas (especificadas usando `on_behalf_of`) podem ter o mesmo prefixo e sufixo no número da fatura. - O comerciante de registro determina qual sequência de fatura é usada, não a conta da plataforma. ### Defina o número da fatura inicial Por padrão, os números das faturas começam em `0001`, mas esse número inicial pode ser alterado. Por exemplo, alguns usuários, quando migram clientes existentes para o Stripe Invoicing, querem manter a numeração de faturas usada no sistema anterior. Se a última fatura do sistema anterior for `123`, a Stripe permite que o cliente especifique `124` como a primeira fatura a ser emitida na Stripe. Se você usa prefixos de cliente, defina o número inicial na página **Detalhes do cliente** no Dashboard ou usando a API. Se você modelar clientes como objetos de `Account` configurados pelo cliente, use o 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). Se você modela clientes como objetos `Customer`, use o parâmetro [next_invoice_sequence](https://docs.stripe.com/api/customers/create.md#create_customer-next_invoice_sequence). Se você usa prefixos por conta, defina o número inicial no campo **Próxima sequência de faturas** na página [Configurações da fatura](https://dashboard.stripe.com/settings/billing/invoice) no Dashboard. O número definido para a próxima fatura precisa ser superior a qualquer número já usado em uma fatura. O número máximo permitido é 1.000.000.000, em qualquer caso. Use o menor valor possível, para não atingir esse limite. ## Campos da fatura Saiba mais sobre os diferentes campos da fatura, incluindo observação, rodapé e campos personalizados. Para definir o mesmo valor nesses campos para grupos de clientes, você pode usar [Modelos de fatura](https://docs.stripe.com/invoicing/invoice-rendering-template.md). ### Observação padrão As observações são incluídas nos PDFs e e-mails de faturas e na [página de faturas hospedadas](https://docs.stripe.com/invoicing/hosted-invoice-page.md). Normalmente, as observações são usadas como uma seção para anotações, agradecer o cliente pela preferência e dar mais informações sobre a fatura (por exemplo, uma mensagem do vendedor que atendeu o cliente). Você pode definir um campo de observação padrão para sua conta em [Configurações da fatura](https://dashboard.stripe.com/settings/billing/invoice). Todas as novas faturas usam esse valor. Você também pode especificar a observação em [Modelos de fatura](https://docs.stripe.com/invoicing/invoice-rendering-template.md), que substitui a observação padrão nas faturas que usam um modelo. Você pode especificar uma observação diferente para uma fatura específica quando criá-la ou atualizá-la no Dashboard. Você também pode especificar uma observação usando a API chamando [atualizar fatura](https://docs.stripe.com/api/invoices/update.md#update_invoice-description) e incluindo o parâmetro `description`. ### Rodapé padrão Os PDFs de faturas podem incluir um bloco de texto opcional de rodapé. Um uso comum é a apresentação de dados da empresa obrigatórios por lei, como um número de registro na Junta Comercial do Reino Unido. Assim como no campo de observações, você pode definir o valor padrão do rodapé nas [Configurações de fatura](https://dashboard.stripe.com/settings/billing/invoice) ou especificar rodapés em [Modelos de fatura](https://docs.stripe.com/invoicing/invoice-rendering-template.md). É possível especificar um rodapé diferente para uma fatura provisória específica quando criá-la ou atualizá-la no Dashboard, ou usar a API para chamar [update Invoice](https://docs.stripe.com/api/invoices/update.md#update_invoice-footer). Se uma fatura tiver sido [finalizada](https://docs.stripe.com/invoicing/integration/workflow-transitions.md#finalized), não aserá possível atualizar o campo de rodapé. ### Preços padrão de item Você pode emitir faturas com preços de itens de linha sem impostos. Os preços sem impostos são mostrados apenas na fatura em PDF. Isso significa que, quando você usa preços com impostos, a página de fatura hospedada e os e-mails de faturas mostram preços com impostos. As configurações dos preços líquidos podem ser definidas no Dashboard ou na API. - **Com impostos**: a fatura em PDF exibe preços de itens de linha com impostos (configuração padrão). - **Sem impostos**: a fatura em PDF exibe preços de itens de linha sem impostos. > #### Precedência de pedidos > > Os preços de itens de linha que você define para o cliente têm precedência sobre as configurações da conta. ### Campos personalizados Adicione campos personalizados para aprimorar os documentos PDF da fatura e ajudar você a cumprir suas obrigações de práticas comerciais e declarações fiscais. Os campos personalizados permitem fornecer até quatro pares de valor de chave que são exibidos no cabeçalho da fatura. É possível configurar até quatro pares de valor de chave no [Editor de faturas](https://dashboard.stripe.com/invoices/create), com a [API Invoices](https://docs.stripe.com/api/invoices/create.md#create_invoice-custom_fields) ou com os [modelos de fatura](https://docs.stripe.com/invoicing/invoice-rendering-template.md). Veja a seguir alguns usos comuns dos campos personalizados: - Números de ordem de compra (OC) - Números do prestador de serviços - Conformidade fiscal #### Herança de campos personalizados Você pode definir campos personalizados de fatura no objeto que representa seu cliente. Quaisquer campos personalizados definidos no nível do cliente são aplicados a todas as faturas em rascunho geradas para esse cliente. Você sempre pode modificar esses campos personalizados herdados enquanto a fatura ainda estiver em rascunho. Após a finalização da fatura, não é possível atualizar os campos personalizados. ## IDs fiscais Adicione IDs fiscais para exibir faturas em PDFs e recibos por e-mail. Você pode definir um ou mais como padrão para incluí-los automaticamente em todas as faturas ou selecionar IDs diferentes ao criar faturas individuais. Para gerenciar IDs fiscais, acesse **Configurações** > **Faturamento** > [Faturas](https://dashboard.stripe.com/settings/billing/invoices/general) e role até a seção Informações fiscais da fatura. Depois de adicionar um ID fiscal, não é possível alterar o ID ou o tipo. Para atualizar um ID fiscal, exclua-o e adicione um novo. ## Tamanho da página do PDF Você pode definir o tamanho de página do PDF da fatura, incluindo as faturas finalizadas, como A4 (210 x 297 mm) ou Carta (279,4 x 215,9 mm). #### Dashboard Para definir o tamanho da página usando o Dashboard, acesse o [Editor de faturas](https://dashboard.stripe.com/invoices/create) e localize a seção **Opções avançadas**. Em seguida, na subseção de **Tamanho da página do PDF**, selecione **A4** ou **Carta**. #### API Para definir o tamanho da página usando a API, você pode [criar](https://docs.stripe.com/api/invoices/create.md#create_invoice-rendering-pdf) ou [atualizar](https://docs.stripe.com/api/invoices/update.md#update_invoice-rendering-pdf) uma fatura e definir o parâmetro `rendering["pdf"]["page_size"]` com o tamanho de página preferencial. O tamanho de página do PDF padrão é A4 para clientes com um local em japonês e Carta para clientes com outros locais. Você pode definir o parâmetro `rendering["pdf"]["page_size"]` de volta para `auto` para ativar esse comportamento padrão. Este é um exemplo de criação de uma fatura com a página do PDF em A4. #### 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" ``` ## Itens de linha do grupo Para ajudar seus clientes a entenderem melhor as faturas (incluindo PDFs, página de fatura hospedada e e-mails de fatura), categorize e exiba itens de linha da fatura em diferentes grupos. Você também pode ocultar grupos de itens de linha. Se alguns itens de linha forem excessivamente detalhados, é possível configurá-los de forma que somente o subtotal em nível de grupo fique visível para os clientes. ## Termos de pagamento padrão Em **Termos padrão de pagamento** nas [configurações de fatura](https://dashboard.stripe.com/settings/billing/invoice), você pode selecionar quando o pagamento vence depois de enviar a fatura. Você também pode escolher se quer incluir um link para uma página de pagamento no e-mail da fatura. Os clientes podem acessar esse link para pagar, baixar e ver o status da fatura. Por fim, você pode gerenciar suas formas de pagamento aceitas nesta seção. ## Idiomas preferenciais do cliente Ao criar um cliente, use o menu suspenso **Language** (Idioma) para adicionar o idioma de preferência dele. (Você também pode adicionar ou editar o idioma de preferência de um cliente editando os detalhes de faturamento no Dashboard ou ao criar uma fatura.) A Stripe usa o idioma de preferência para localizar e-mails e PDFs de faturas, e-mails e PDFs de recibos e PDFs de notas de crédito. Para atualizar o idioma de preferência de um cliente por meio da API, defina [defaults.locales](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-defaults-locales) para objetos `Account` configurados pelo cliente ou [preferred_locales](https://docs.stripe.com/api/customers/object.md#customer_object-preferred_locales) para objetos `Customer`. Ambas as propriedades são matrizes, e você pode adicionar vários locais em um pedido preferencial. O Stripe Invoicing aceita os seguintes idiomas: - Búlgaro - Chinês (Hong Kong) - Chinês (Simplificado) - Chinês (Taiwan) - Croata - Tcheco - Dinamarquês - Neerlandês - Inglês (Reino Unido) - Inglês (Estados Unidos) - Estoniano - Filipino - Finlandês - Francês (Canadá) - Francês (França) - Alemão - Grego - Húngaro - Indonésio - Italiano - Japonês - Coreano - Letão - Lituano - Malaio (Malásia) - Malaiala - Maltês - Norueguês - Polonês - Português (Brasil) - Português (Portugal) - Romeno - Russo - Eslovaco - Esloveno - Espanhol (América Latina) - Espanhol (Espanha) - Sueco - Tailandês - Turco - Vietnamita ## Endereços de cobrança e envio ### Endereços de faturamento A Stripe usa [identity.individual.address](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-identity-individual-address) do cliente (para objetos `Account` configurados pelo cliente) ou [endereço](https://docs.stripe.com/api/customers/object.md#customer_object-address) (para objetos `Customer`) como complemento de faturamento da fatura em PDF. Se você não definir explicitamente esse endereço, a Stripe renderizará o endereço de entrega como complemento de faturamento no PDF. Você também pode adicionar ou editar o endereço de faturamento de um cliente na página **Detalhes do cliente** no Dashboard. ### Endereços de entrega Para renderizar os dados de entrega na fatura em PDF, defina a propriedade [shipping_details](https://docs.stripe.com/api/invoices/create.md#create_invoice-shipping_details). Se você não definir a propriedade `shipping_details` da fatura, a Stripe renderizará o endereço de entrega no PDF usando o endereço de entrega do objeto [Account](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-configuration-customer-shipping) configurado pelo cliente ou do objeto [Customer](https://docs.stripe.com/api/customers/object.md#customer_object-shipping). ## Informações públicas de suporte As faturas incluem todas as informações públicas especificadas em [Dados comerciais públicos](https://dashboard.stripe.com/settings/public), como seu endereço de e-mail de suporte ou site da empresa. Usando essas configurações, você também pode optar por incluir um número de telefone de suporte em documentos voltados para o cliente, como faturas em PDF e e-mails, ou usar o endereço comercial padrão. ## See also - [Usar o Dashboard](https://docs.stripe.com/invoicing/dashboard.md) - [Página de fatura hospedada](https://docs.stripe.com/invoicing/hosted-invoice-page.md) - [Enviar e-mails aos clientes](https://docs.stripe.com/invoicing/send-email.md)