Números de documento nos modelos

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

{% 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.
Modelos que reúnem todos os pedidos selecionados nunca recebem numeração.

Boas-vindas

Primeiros passos

Impressão

Modelos

Editor de modelos

Designs

Envio de PDFs

Modelos de e-mail

Contas de clientes

Exportações

Faturas e numeração

Impostos e jurídico

Integrações

Cobrança e planos

Configurações

Solução de problemas

Jurídico