> ## 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 fatura, nota de crédito e orçamento com {{ document_number }}, a data da fatura com {{ document_date }} e um aviso de anulação.

Com a numeração de documentos ativada, o Foliant dá às faturas, notas de crédito e orçamentos números sequenciais próprios, 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 **Configurações › Documentos e impressão › Numeração de documentos**. Veja [Configurar a numeração de documentos](https://foliant-help.iforiti.com/pt-BR/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 configurações dele. Modelos do tipo **Outro (sem numeração)** não recebem números.

## No editor visual

Adicione o bloco **Número do documento** (em **Conformidade**). Ele imprime o número e a data do documento com os rótulos, como "Número da fatura" e "Data da fatura" ("Data da nota de crédito" em uma nota de crédito, "Data do orçamento" em um orçamento), no idioma do documento. Ele só aparece em documentos numerados.

Você também pode adicionar **Número do documento** e **Data do documento** aos **Detalhes abaixo do 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 com `date`. |
| `{{ document_date }}` | A data do documento, sempre preenchida: quando o número foi emitido ou, se não houver número, a data do pedido (a data do reembolso, em uma nota de crédito). Use como data da fatura. Formate com `date`. |
| `{{ document_voided }}` | Verdadeiro quando o documento foi cancelado. O número continua usado e nunca é dado de novo. |
| `{{ document_kind }}` | `invoice`, `credit_note` ou `quote`; vazio quando o modelo não é numerado. |

Imprima o número só quando ele 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 ela foi emitida: o dia em que recebeu o número. Não é a data do pedido, nem a data de hoje, que muda cada vez que você imprime de novo. `{{ document_date }}` dá essa data:

* Em um documento numerado, é o dia em que o número foi emitido, no fuso horário da sua loja. Imprimir o documento de novo no mês seguinte não a altera.
* Em um documento sem número, é a data do pedido. Para pedidos importados de outro lugar, é a data em que o pedido foi processado. Uma nota de crédito usa a data do reembolso.

Assim, um único modelo funciona com a numeração ativada ou desativada. Os modelos padrão de fatura, nota de crédito e orçamento já imprimem essa data, com o rótulo "Data da fatura", "Data da nota de crédito" ou "Data do orçamento". Se o seu modelo imprime `'now' | date` como data, substitua por `{{ document_date | date: '%d %B %Y' }}`.

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

Quando o modelo de um documento numerado não usa `document_number` em nenhum lugar, o Foliant adiciona uma linha pequena no final 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 quiser, e a linha extra desaparece. Se o seu modelo já imprime `document_date` ou `document_issued_at`, a linha mostra só o número.

## Bom saber

* Um documento recebe o número na primeira vez que é baixado, impresso ou exportado, e fica com ele.
* A prévia do editor mostra o número que o seu próximo documento receberia, sem consumi-lo.
* Um código de barras do número: `{{ document_number | barcode }}`. Veja [Códigos de barras e QR codes](https://foliant-help.iforiti.com/pt-BR/template-editor/liquid-barcodes-and-qr-codes.md).
* Modelos que reúnem todos os pedidos selecionados nunca recebem numeração.

## Artigos relacionados

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


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