Personalizar faturas

Você pode usar os editores de API, fatura e assinatura, Modelos de fatura ou as Configurações da fatura da conta para personalizar o conteúdo de uma fatura. Também é possível definir um idioma preferido do cliente e incluir dados públicos nos detalhes da conta. Como você sabe mais sobre seus clientes e sua empresa do que a Stripe, verifique se as faturas contêm todas as informações necessárias. Elas precisam ser exatas, recolher os impostos adequados e cumprir a legislação e regulamentação vigentes em sua região.

Configurações de fatura

Branding

A Stripe permite personalizar (e visualizar) recibos de e-mail, faturas hospedadas, faturas em PDF e assim por diante nas Configurações de marca.

Icons and logos must be in JPG or PNG format, less than 512kb in size, and equal to or greater than 128px by 128px.

• Icon—A square, digital-friendly icon or logo.
• Logo—A non-square logo to override some uses of the icon.
• Brand color—Used on receipts, invoices, and the customer portal.
• Accent color—Used as a background on emails and pages.

Apply brand settings

Brand settings apply to your whole account and take effect in many places.

Invoice numbering

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 e do Reino Unido 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.

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 do Dashboard ou pela API, com o parâmetro 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. A versão padrão da API da sua conta precisa ser pelo menos 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

Para contas conectadas não gerenciadas com o parâmetro on_behalf_of, a numeração sequencial de faturas por cliente e comerciante começará a partir de 0001 se o parâmetro for usado no futuro.

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. 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.

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.

Invoice fields

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.

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. 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. Todas as novas faturas usam esse valor. Você também pode especificar a observação em Modelos de fatura, 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 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 ou especificar rodapés em Modelos de fatura. É 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. Se uma fatura tiver sido finalizada, 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.

Campos personalizados

Add custom fields to enhance your invoice PDF documents and help you comply with your business practice and tax reporting obligations. Custom fields allow you to provide up to four key-value pairs ​​that display in the invoice header. You can set up to four custom field key-value pairs in the Invoice Editor, with the Invoices API, or with Invoice Templates.

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

You can set custom invoice fields on the Customer object. Any custom fields you set at the customer level apply to all of the draft invoices you generate for that customer. You can always modify these inherited custom fields while the invoice is still a draft. After the invoice finalizes, you can’t update the custom fields.

PDF page size

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

API

Para definir o tamanho da página usando o Dashboard, acesse o Editor de faturas 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.

Opções avançadas no editor de Fatura

Group line items

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 de pagamento padrão nas Configurações da fatura, selecione quando o pagamento vence após enviar a fatura. Você também pode optar por incluir um link hospedado pela Stripe para uma página de pagamento de fatura no e-mail da fatura. Os clientes podem visitar este link para pagar, baixar e ver o status da fatura. Por fim, gerencie suas formas de pagamento aceitas nesta seção.

Customer preferred languages

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.

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

Billing and shipping addresses

A Stripe usa o endereço do cliente como endereço 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. Se você não definir o campo shipping_details, a Stripe processará o endereço de entrega do campo envio do cliente no PDF.

Public support information

As faturas incluem todas as informações públicas especificadas em Dados comerciais públicos, 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.