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

# Números de documento nos modelos

> Imprima números de faturas, notas de crédito e orçamentos com {{ document_number }}, a data da fatura com {{ document_date }} e um aviso de anulação.

Quando a numeração de documentos está ativa, o Foliant atribui às faturas, notas de crédito e orçamentos uma numeração sequencial própria, como `INV-0042`. Um modelo imprime o número com `{{ document_number }}` ou, no editor visual, com o bloco **Número do documento**.

## Antes de começar

* Ative a numeração em **Definições › Documentos e impressão › Numeração de documentos**. Consulte [Configurar a numeração de documentos](https://foliant-help.iforiti.com/pt-PT/invoices-and-numbering/document-numbering.md).
* Defina o **Tipo de documento** do modelo como **Fatura**, **Nota de crédito** ou **Orçamento** na página de definições do modelo. Os modelos do tipo **Outro (sem numeração)** não recebem números.

## No editor visual

Adicione o bloco **Número do documento** (em **Conformidade**). Imprime o número e a data do documento com as respetivas etiquetas, como "Número da fatura" e "Data da fatura" ("Data da nota de crédito" numa nota de crédito, "Data do orçamento" num orçamento), no idioma do documento. Só aparece em documentos numerados.

Também pode adicionar **Número do documento** e **Data do documento** aos **Detalhes sob o título** de um bloco **Cabeçalho**, ou usar **Número do documento** como o conteúdo codificado por um bloco **Código de barras / QR**.

## No código

| Variável | O que é |
| - | - |
| `{{ document_number }}` | O número do documento. Vazio quando o documento não tem número. |
| `{{ document_issued_at }}` | Quando o número foi emitido. Vazio quando o documento não tem número. Formate-o com `date`. |
| `{{ document_date }}` | A data do documento, sempre definida: quando o número foi emitido ou, caso contrário, a data da encomenda (a data do reembolso, numa nota de crédito). Use-a como data da fatura. Formate-a com `date`. |
| `{{ document_voided }}` | Verdadeiro quando o documento foi anulado. O número continua utilizado e nunca é atribuído novamente. |
| `{{ document_kind }}` | `invoice`, `credit_note` ou `quote`; vazio quando o modelo não é numerado. |

Imprima o número apenas quando existir:

```liquid theme={null}
{% if document_number %}
  <p>{{ 'document_number.invoice' | t }}: {{ document_number }}</p>
  <p>{{ 'document_date.invoice' | t }}: {{ document_date | date: '%d %B %Y' }}</p>
  {% if document_voided %}<p>{{ 'document_number.void' | t }}</p>{% endif %}
{% endif %}
```

`'document_date.invoice' | t` imprime "Data da fatura" no idioma do documento; use `document_date.credit_note` ou `document_date.quote` para os outros tipos.

## A data da fatura

A data de uma fatura é o dia em que foi emitida: o dia em que o número foi atribuído. Não é a data da encomenda, nem a data de hoje, que muda sempre que volta a imprimi-la. `{{ document_date }}` dá-lhe essa data:

* Num documento numerado, é o dia em que o número foi emitido, no fuso horário da sua loja. Voltar a imprimir o documento no mês seguinte não a altera.
* Num documento sem número, é a data da encomenda. Para encomendas importadas de outro sítio, é a data em que a encomenda foi processada. Uma nota de crédito usa a data do respetivo reembolso.

Assim, o mesmo modelo funciona com a numeração ativa ou desativada. Os modelos predefinidos de fatura, nota de crédito e orçamento já a imprimem, com a etiqueta "Data da fatura", "Data da nota de crédito" ou "Data do orçamento". Se o seu próprio modelo imprimir `'now' | date` como data, substitua-o por `{{ document_date | date: '%d %B %Y' }}`.

## Se o seu modelo não imprimir o número

Quando o modelo de um documento numerado não usa `document_number` em lado nenhum, o Foliant acrescenta no fim uma pequena linha com o número e a data de emissão, como "Número da fatura: INV-0042 · 4 de outubro de 2026", para que o número nunca falte. Adicione `{{ document_number }}` onde o pretender e a linha extra desaparece. Se o seu modelo já imprimir `document_date` ou `document_issued_at`, a linha mostra apenas o número.

## Bom saber

* Um documento recebe o número na primeira vez que é transferido, impresso ou exportado, e mantém-no.
* A pré-visualização do editor mostra o número que o seu próximo documento receberia, sem o gastar.
* Um código de barras do número: `{{ document_number | barcode }}`. Consulte [Códigos de barras e códigos QR](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-barcodes-and-qr-codes.md).
* Os modelos para todas as encomendas selecionadas nunca são numerados.

## Artigos relacionados

* [Configurar a numeração de documentos](https://foliant-help.iforiti.com/pt-PT/invoices-and-numbering/document-numbering.md)
* [Referência de blocos](https://foliant-help.iforiti.com/pt-PT/template-editor/block-catalogue.md)
* [Códigos de barras e códigos QR](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-barcodes-and-qr-codes.md)
* [Datas, idiomas e traduções](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-dates-and-languages.md)


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