# Personalizar faturas Saiba como personalizar o conteúdo e a marca das suas faturas. Se sua integração usar [customer-configured Accounts](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-customer), substitua `Customer` e as referências a eventos nos exemplos de código pelas referências equivalentes da API Accounts v2. Para mais informações, consulte [Representar clientes com objetos Account](https://docs.stripe.com/connect/use-accounts-as-customers.md). 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. ## 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. É possível substituir os prefixos para facilitar o acompanhamento de faturas junto aos clientes. Defina prefixos na página [Clientes](https://dashboard.stripe.com/customers) do Dashboard ou pela API, com o parâmetro [invoice_prefix](https://docs.stripe.com/api/customers/create.md#create_customer-invoice_prefix). Os prefixos têm de 3 a 12 caracteres e não podem ser repetidos, inclusive no caso de prefixos que não estão mais em uso. ### 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. > Não é possível usar um prefixo de cliente como prefixo da conta, mesmo que esse prefixo de cliente não esteja 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. ### Configurar o número da próxima fatura 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. Defina o número na página **Detalhes do cliente** ou com a API utilizando o parâmetro [next_invoice_sequence](https://docs.stripe.com/api/customers/create.md#create_customer-next_invoice_sequence). Se estiver usando prefixos em nível de conta, defina o número da próxima fatura no campo **Próxima sequência de faturas** em [Configurações da fatura](https://dashboard.stripe.com/settings/billing/invoice). 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 de fatura personalizados no objeto [Customer](https://docs.stripe.com/api/customers/object.md#customer_object-invoice_settings-custom_fields). Qualquer campo personalizado definido para um cliente vale para todas as faturas provisórias geradas para esse cliente. Esses campos personalizados herdados podem ser alterados enquanto a fatura estiver em rascunho. Após a finalização da fatura, não é possível atualizar 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: ```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 **Idioma** para adicionar seu idioma preferencial (também é possível adicionar ou editar o idioma preferencial de um cliente na página **Detalhes do cliente** ou ao criar uma fatura). A Stripe usa o idioma escolhido 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 usando a API, use o campo [preferred_locales](https://docs.stripe.com/api/customers/object.md#customer_object-preferred_locales). 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 A Stripe usa o endereço do cliente como [endereço](https://docs.stripe.com/api/customers/object.md#customer_object-address) de cobrança no PDF da fatura. Você pode adicionar ou editar o endereço de um cliente na página **Detalhes do cliente**. Se você não definir o campo `address`, a Stripe processará o endereço de entrega como endereço de cobrança no PDF. Para processar detalhes de envio no PDF da fatura, defina o campo [shipping_details](https://docs.stripe.com/api/invoices/create.md#create_invoice-shipping_details). Se você não definir o campo `shipping_details`, a Stripe processará o endereço de entrega do campo [envio](https://docs.stripe.com/api/customers/object.md#customer_object-shipping) do cliente no PDF. ## 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)