> ## Documentation Index
> Fetch the complete documentation index at: https://foliant-help.iforiti.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurar a numeração de documentos

> Dê às faturas, notas de crédito e orçamentos números sequenciais próprios, com prefixo, sufixo, dígitos e reinício anual ou mensal.

O Foliant pode dar números sequenciais às faturas, notas de crédito e orçamentos, como `INV-2026-0042`. Cada tipo de documento tem sua própria série, então faturas, notas de crédito e orçamentos são contados separadamente. Você define o formato do número em **Configurações › Documentos e impressão**, na seção **Numeração de documentos**. A numeração de documentos está disponível em todos os planos.

![Numeração de documentos nas configurações de Documentos e impressão](https://mintcdn.com/foliant-dev/AoWxppgqeHqT1nDZ/invoices-and-numbering/images/document-numbering.png?fit=max\&auto=format\&n=AoWxppgqeHqT1nDZ\&q=85\&s=3c03cf7defc767306c2467bd787f248e)

## Antes de começar

Só os modelos com um tipo de documento são numerados. Nas configurações de cada modelo, defina **Tipo de documento** como **Fatura**, **Nota de crédito** ou **Orçamento**. Os modelos definidos como **Outro (sem numeração)**, como guias de remessa e formulários de devolução, nunca recebem número.

Se você ativar a numeração de um tipo e nenhum modelo tiver esse tipo de documento ainda, o Foliant mostra um aviso, por exemplo: "Nenhum modelo é uma fatura ainda, então nada será numerado."

## Ativar a numeração

1. No Foliant, acesse **Configurações › Documentos e impressão**.
2. Em **Numeração de documentos**, ative **Numerar faturas**, **Numerar notas de crédito** ou **Numerar orçamentos**.
3. Defina o formato (veja a tabela abaixo). Abaixo dos campos, **Próximos números** mostra os três próximos números como eles vão aparecer.
4. Clique em **Salvar**.
5. O Foliant pede que você confirme: **Salvar a numeração?** lista os próximos números de cada tipo que você alterou. Clique em **Salvar numeração**.

## Formato do número

| Campo | O que faz |
| - | - |
| **Prefixo** | Texto antes do número, como `INV-`. Até 30 caracteres. |
| **Sufixo** | Texto depois do número. Até 30 caracteres. |
| **Dígitos** | Quantos dígitos o número tem. Números mais curtos são completados com zeros à esquerda: com 4 dígitos, 42 aparece como `0042`. De 1 a 12. |
| **Próximo número** | O número que o próximo documento recebe. Ele só pode avançar. |
| **Recomeçar em 1** | **Nunca**, **Todo ano** ou **Todo mês**. |

### Usar a data no prefixo ou no sufixo

Você pode adicionar `{year}` e `{month}` ao prefixo ou ao sufixo. O Foliant os substitui pelo ano (`2026`) e pelo mês (`05`) do dia em que o número é emitido, no fuso horário da sua loja.

Por exemplo, o prefixo `INV-{year}-` com 4 dígitos gera `INV-2026-0001`, `INV-2026-0002` e assim por diante.

### Recomeçar todo ano ou todo mês

Se os números recomeçarem em 1, eles se repetiriam, a menos que a data faça parte do número. Por isso:

* **Todo ano** exige `{year}` no prefixo ou no sufixo.
* **Todo mês** exige `{year}` e `{month}`.

Se eles estiverem faltando, o Foliant mostra "Números que recomeçam precisam de `{year}` no prefixo ou no sufixo, senão vão se repetir." e você só consegue salvar depois de adicioná-los.

Quando você muda a frequência de reinício, a contagem continua a partir do número atual no período atual. Os números só voltam para 1 quando começar o próximo ano ou mês.

## O próximo número só avança

Depois que um documento recebe um número, ele o mantém, e o Foliant nunca dá esse número a outro documento. Você pode aumentar o **Próximo número**, por exemplo para continuar a partir dos números que você usava em outro app. Você não pode diminuí-lo abaixo do número que o próximo documento receberia.

Abaixo de cada tipo, o Foliant mostra o último número emitido e a data dele, por exemplo "Último emitido: INV-2026-0041 em 3 de maio de 2026".

## Mostrar o número nos seus documentos

Os modelos mostram o número com a variável Liquid `{{ document_number }}`. Os modelos prontos de fatura, nota de crédito e orçamento já o mostram, com a data de emissão como "Data da fatura" ("Data da nota de crédito", "Data do orçamento"). No editor visual, o bloco **Número do documento** mostra o número e essa data nos documentos numerados. Nos seus próprios modelos, imprima a data com `{{ document_date }}`: veja [A data da fatura](https://foliant-help.iforiti.com/pt-BR/template-editor/liquid-document-numbers.md#the-invoice-date).

Se um modelo numerado ainda não usa `{{ document_number }}`, o Foliant adiciona uma linha pequena no final do documento, como "Número da fatura: INV-2026-0042 · 3 de maio de 2026", para que o número e a data nunca fiquem faltando.

## Desativar a numeração

Desative a chave de um tipo e salve. Os novos documentos desse tipo não são numerados. Os números já emitidos são mantidos: esses documentos continuam com o número quando você os baixa ou imprime de novo.

## Bom saber

* As prévias dos modelos no editor mostram o próximo número como exemplo. Elas não consomem um número.
* Se algumas alterações de numeração não puderem ser salvas, o Foliant mostra "Algumas alterações de numeração não foram salvas" e indica o campo a corrigir. Suas outras configurações na página continuam salvas.
* O aumento do próximo número fica registrado em **Configurações › Registro de atividades**.

## Artigos relacionados

* [Quando um documento recebe seu número](https://foliant-help.iforiti.com/pt-BR/invoices-and-numbering/when-documents-get-numbers.md)
* [Ver os números dos documentos em um pedido](https://foliant-help.iforiti.com/pt-BR/invoices-and-numbering/document-numbers-on-orders.md)
* [Bloquear faturas emitidas](https://foliant-help.iforiti.com/pt-BR/invoices-and-numbering/locked-invoices.md)
* [Configurações do modelo](https://foliant-help.iforiti.com/pt-BR/templates/template-settings.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.