Números de documento nos modelos

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

{% 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.
Os modelos para todas as encomendas selecionadas nunca são numerados.

Boas-vindas

Primeiros passos

Impressão

Modelos

Editor de modelos

Designs

Envio de PDF

Modelos de email

Contas de cliente

Exportações

Faturas e numeração

Impostos e jurídico

Integrações

Faturação e planos

Definições

Resolução de problemas

Jurídico