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

> Atribua números sequenciais próprios a faturas, notas de crédito e orçamentos, com prefixo, sufixo, dígitos e recomeço anual ou mensal.

O Foliant pode atribuir números sequenciais a faturas, notas de crédito e orçamentos, como `INV-2026-0042`. Cada tipo de documento tem a sua própria série, por isso as faturas, as notas de crédito e os orçamentos são contados em separado. Defina o formato do número em **Definições › Documentos e impressão**, na secção **Numeração de documentos**. A numeração de documentos está disponível em todos os planos.

![Numeração de documentos nas definiçõ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 definiçõ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 um número.

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

## Ativar a numeração

1. No Foliant, aceda a **Definiçõ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 (consulte a tabela abaixo). Por baixo dos campos, **Próximos números** mostra os três números seguintes tal como vão aparecer.
4. Clique em **Guardar**.
5. O Foliant pede-lhe que confirme: **Guardar a numeração?** lista os próximos números de cada tipo que alterou. Clique em **Guardar numeração**.

## Formato do número

| Campo | O que faz |
| - | - |
| **Prefixo** | Texto antes do número, como `INV-`. Até 30 carateres. |
| **Sufixo** | Texto depois do número. Até 30 carateres. |
| **Dígitos** | Quantos dígitos tem o número. Os números mais curtos são completados com zeros à esquerda: com 4 dígitos, 42 é impresso como `0042`. De 1 a 12. |
| **Próximo número** | O número que o próximo documento recebe. Só pode avançar. |
| **Recomeçar em 1** | **Nunca**, **Todos os anos** ou **Todos os meses**. |

### Usar a data no prefixo ou no sufixo

Pode adicionar `{year}` e `{month}` ao prefixo ou ao sufixo. O Foliant substitui-os 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 dá `INV-2026-0001`, `INV-2026-0002`, e assim sucessivamente.

### Recomeçar todos os anos ou todos os meses

Se os números recomeçarem em 1, repetir-se-iam, a não ser que a data faça parte do número. Por isso:

* **Todos os anos** exige `{year}` no prefixo ou no sufixo.
* **Todos os meses** exige `{year}` e `{month}`.

Se faltarem, o Foliant mostra "Os números que recomeçam precisam de `{year}` no prefixo ou no sufixo, caso contrário repetir-se-iam." e não pode guardar até os adicionar.

Quando altera a frequência com que os números recomeçam, a contagem continua a partir do número atual no período atual. Os números só voltam a 1 quando começar o ano ou o mês seguinte.

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

Depois de um documento ter um número, mantém-no, e o Foliant nunca atribui esse número a outro documento. Pode aumentar o **Próximo número**, por exemplo para continuar a partir dos números que usava noutra app. Não o pode baixar para um valor inferior ao número que o próximo documento receberia.

Por baixo de cada tipo, o Foliant mostra o último número emitido e a respetiva data, por exemplo "Último emitido: INV-2026-0041 a 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 de fatura, nota de crédito e orçamento incluídos 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 }}`: consulte [A data da fatura](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-document-numbers.md#the-invoice-date).

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

## Desativar a numeração

Desative o interruptor de um tipo e guarde. Os novos documentos desse tipo deixam de ser numerados. Os números já emitidos mantêm-se: esses documentos conservam o seu número quando os voltar a transferir ou imprimir.

## Bom saber

* As pré-visualizações de modelos no editor mostram o próximo número como exemplo. Não gastam um número.
* Se não for possível guardar algumas alterações à numeração, o Foliant mostra "Algumas alterações à numeração não foram guardadas" e indica o campo a corrigir. As suas outras definições na página continuam a ser guardadas.
* O aumento do próximo número fica registado em **Definições › Registo de atividade**.

## Artigos relacionados

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


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