Solavel Documentos
Português

Editor de PDF — referência de campos e variáveis

Última atualização

Esta página lista todos os campos (variáveis) que você pode inserir em um modelo de PDF no editor de PDF: como se chamam na lista de campos, o que imprimem, um exemplo e quando ficam vazios. Para saber como usar o próprio editor, veja Editor de PDF e Modelos de PDF.

#Como os campos funcionam

  • Um modelo é um layout de página. Cada elemento de texto, tabela ou imagem está vinculado a um campo. Quando um documento é impresso, baixado ou enviado por e-mail, o SolaCount preenche cada elemento vinculado com o valor desse documento.
  • No editor, a tela mostra valores de exemplo (os dados da sua própria empresa mais um documento de exemplo) para que você avalie o layout. O exemplo nunca é salvo no modelo: só o vínculo é salvo. Um documento sem valor para um campo o imprime vazio.
  • Cada campo tem um nome de exibição (o que você vê na lista de campos, no idioma do editor) e um nome interno como doc_number. Você pode pesquisar a lista pelo nome em inglês ou em árabe ou pelo nome interno. O nome interno também é o que você digita em textos estáticos entre chaves, por exemplo {doc_number}.
  • Os campos oferecidos dependem do tipo de documento. Um comprovante de lançamento contábil não tem cliente; um recibo de pagamento não tem data de vencimento.
  • O mesmo campo pode ser inserido mais de uma vez. No editor, os campos são agrupados como Documento, Projeto, Pagamento, Organização, Cliente / fornecedor, Tabelas, Totais, Campos personalizados, Rótulos, Imagens e QR.
  • A página Variáveis do editor mostra cada campo com sua origem (perfil da empresa, cadastro do cliente ou do fornecedor, o documento, o projeto vinculado, idioma do documento, campo personalizado), seu valor atual e seu status.
  • Tudo é impresso no idioma do documento definido em Configurações → Modelos de PDF (veja Modelos de PDF), seja qual for o idioma de quem imprime.

#Quantidade de campos por tipo de documento

Tipo de documento Campos do catálogo Tabelas
Fatura 80 items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice
Cotação 76 items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice
Pedido de venda 79 items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice
Recibo de venda 78 items, items_simple, tax_summary, items_detailed, items_tax_invoice
Nota de Crédito 75 items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice
Recibo de reembolso 59 allocations
Conta de fornecedor 81 items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice
Pedido de compra 75 items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice
Nota de Débito 75 items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice
Recibo de pagamento 62 allocations
Pagamento a fornecedor 62 allocations
Comprovante de despesa 79 items, items_simple, tax_summary, items_detailed, items_tax_invoice
Comprovante de lançamento contábil 41 journal
Extrato do Cliente 56 statement
Extrato do fornecedor 56 statement

Estes são os campos do catálogo. Todo tipo também oferece seus campos do sistema e campos personalizados (veja abaixo). O grupo Imagens e QR está sempre disponível para inserir um logotipo ou sua própria imagem.

#Grupo Documento

Nome de exibição Nome interno O que é impresso Exemplo Notas
Título do documento doc_title O nome do tipo de documento no idioma do documento Invoice / فاتورة Tipos: Fatura, Cotação, Pedido de venda, Recibo de venda, Nota de crédito, Recibo de reembolso, Conta de fornecedor, Pedido de compra, Nota de débito, Recibo de pagamento, Pagamento a fornecedor, Comprovante de despesa, Comprovante de lançamento contábil, Extrato do cliente, Extrato do fornecedor
Número doc_number O número do documento INV-00042 O texto da esquerda para a direita é mantido em ordem dentro de documentos em árabe
Data doc_date Data de emissão (nos pagamentos, a data do pagamento) 2026-11-20 Segue o formato de data do modelo (veja Datas)
Data de vencimento doc_due_date Data de vencimento; em uma cotação, a data de validade; em um pedido de venda, a data prevista 2026-12-20 Somente em fatura, cotação, pedido de venda, conta e pedido de compra. Vazio quando não há
Referência doc_reference A referência guardada no documento PO-7781 Não existe em comprovantes de lançamento contábil. Vazio quando não há
Estado doc_status Status no idioma do documento Paga, Rascunho, Anulada
Moeda doc_currency Código da moeda AED
Modo de preço doc_tax_mode "Preços com imposto" ou "Preços sem imposto" Os preços não incluem imposto Somente em tipos com linhas de itens; vazio quando o documento não tem modo de imposto
Notas doc_notes Texto das observações Obrigado pela preferência Várias linhas
Termos e condições doc_terms Texto dos termos Pagamento em até 30 dias Somente em tipos com linhas de itens. Várias linhas
Valor por extenso doc_amount_words O total geral escrito por extenso UAE Dirhams One Thousand Two Hundred Fifty and 50/100 Only Escrito em inglês ou árabe; os outros idiomas de documento imprimem o texto em inglês. Vazio quando o documento não tem moeda ou total
Marca-d'água de status doc_watermark O texto da marca-d'água de status que o documento teria DRAFT Vazio quando o documento não tem nenhuma
Gerado doc_generated_at Data e hora em que o PDF foi produzido 2026-11-20 14:05 Sempre Y-m-d H:i, sem ser afetado pelo formato de data do modelo
Nota de origem importada doc_source_note Nota sobre o sistema original de onde veio uma fatura importada — Somente faturas. Se um modelo a omitir, a nota é adicionada em uma última página própria
Nº da fatura original / Nº da conta original / Nº da nota de crédito / Nº da cotação de origem doc_original_number O número do documento original vinculado INV-00042 Nota de crédito (fatura), nota de débito (conta), recibo de reembolso (nota de crédito), pedido de venda (cotação). Vazio quando não há vínculo
Nº do nosso pedido de compra (ao fornecedor) doc_po_number O pedido de compra que esta organização emitiu ao fornecedor PO-00017 Somente contas de fornecedor. O número do pedido de compra do próprio cliente não é armazenado, então esse campo não existe
Taxa de câmbio doc_exchange_rate Taxa em relação à moeda base 3.6725 Tipos com linhas e pagamentos. Vazio quando a taxa é 1. Até 6 casas decimais, com os zeros finais removidos
Data de envio doc_shipment_date Data de envio 2026-12-01 Somente pedidos de venda
Nº da revisão doc_revision Número da revisão da cotação 2 Somente cotações; vazio na revisão 1
Beneficiário doc_payee_name O beneficiário Gulf Utilities Somente comprovantes de despesa
Motivo do reembolso doc_refund_reason O motivo informado no reembolso Mercadorias devolvidas Somente recibos de reembolso
Preparado por · Nome approval_prepared_by O nome de quem criou o documento Sara Haddad Vazio quando desconhecido

#Grupo de projeto

Disponíveis em fatura, cotação, pedido de venda, nota de crédito, conta de fornecedor, pedido de compra, nota de débito e comprovante de despesa. Eles leem o vínculo real do documento com o projeto (não um campo de texto livre). Vários projetos em um mesmo comprovante de despesa são unidos por vírgulas. Um projeto excluído continua sendo impresso. No exemplo ficam vazios e a tela mostra "Nenhum projeto selecionado".

Nome de exibição Nome interno O que é impresso Exemplo
Nome do projeto (vinculado) doc_project_name Nome do projeto Villa Fit-out
Código do projeto (vinculado) doc_project_code Código do projeto PRJ-014
Projeto (código — nome) (vinculado) doc_project Código e nome PRJ-014 — Villa Fit-out

#Grupo Pagamento

Disponível em recibo de pagamento, pagamento a fornecedor, comprovante de despesa, recibo de venda e recibo de reembolso.

Nome de exibição Nome interno O que é impresso Exemplo Notas
Forma de pagamento doc_payment_method A forma Transferência bancária Os nomes das formas estão no idioma do documento
Número do cheque / Referência da transação doc_payment_reference Número do cheque e referência da transação, unidos por " · " CHQ-5521 · TRX-908 As partes vazias são descartadas
Data do pagamento doc_payment_date A data do documento 2026-11-20

#Grupo Organização (empresa)

Disponível em todos os tipos de documento. Veja "Variáveis da empresa" abaixo para saber quais delas um modelo pode substituir.

Nome de exibição Nome interno O que é impresso Exemplo Notas
Logotipo org_logo A imagem do logotipo da empresa (imagem) Vazio (nada é impresso) quando não há logotipo. Convertida em PNG/JPEG e limitada a 1600 px no lado maior
Nome da empresa org_name O nome fantasia Palm Grove Furnishings
Razão social org_legal_name A razão social registrada Palm Grove Furnishings LLC Vazio quando é igual ao nome da empresa
Endereço da empresa org_address Endereço registrado em uma linha Street 4, Dubai, United Arab Emirates Elemento de várias linhas
Telefone da empresa org_phone Telefone +971 4 000 0000
E-mail da empresa org_email E-mail accounts@example.com
Site org_website Site www.example.com
Nº fiscal org_tax_number Somente o número de registro fiscal (sem legenda) 100123456700003 Adicione sua própria legenda ou use o rótulo Nº fiscal
Nº de registro org_registration Somente o número de registro comercial 1234567
Linha de contato (telefone · e-mail · site) org_contact_line Os três unidos por " · " +971 4 000 0000 · accounts@example.com · www.example.com As partes vazias são descartadas
Dados da empresa (endereço, telefone, e-mail, nº fiscal) org_details Um bloco com um valor por linha; a linha fiscal aparece como "Nº fiscal: …" (4 linhas) Várias linhas
Linha de rodapé (nome • e-mail • telefone • site) footer_line Nome, e-mail, telefone e site unidos por " • "

#Grupo Cliente / fornecedor

Disponível em todos os tipos, exceto comprovantes de lançamento contábil. Nos tipos de compra (conta de fornecedor, pedido de compra, nota de débito, pagamento a fornecedor, comprovante de despesa, extrato do fornecedor), os valores vêm do fornecedor; em todos os outros, do cliente.

Nome de exibição Nome interno O que é impresso Exemplo Notas
Título da parte party_label A legenda do bloco Faturar para / Fornecedor "Cliente" ou "Fornecedor" nos extratos
Cliente / Fornecedor party_name Nome jurídico ou de exibição atual Harbor Grill Restaurants Sempre o nome atual do cliente, não uma cópia armazenada
Código do cliente / Código do fornecedor party_code O código da parte CUS-0012
Cliente · Endereço party_address Partes do endereço de cobrança unidas por vírgulas Office 12, Dubai, UAE Elemento de várias linhas
Cliente · Telefone party_phone Telefone (ou celular) +971 50 000 0000
Cliente · E-mail party_email E-mail buyer@example.com
Cliente · Nº fiscal party_tax_number Somente o número fiscal / de IVA 100987654300003 Veja o exemplo de TRN do cliente
Nome da matriz party_parent_name Nome do escritório central quando o cliente ou fornecedor é uma filial Head Office Co. Vazio quando não é uma filial
Filial de label_parent A legenda "Filial de" no idioma do documento Filial de Impressa somente quando há matriz; em branco nos demais casos
Código da matriz party_parent_code Código do escritório central HQ-001 Vazio quando não é uma filial
Cliente · Detalhes (endereço, telefone, e-mail, nº fiscal) party_details Um bloco, um valor por linha; a linha fiscal aparece como "Nº fiscal: …" (4 linhas) Várias linhas

O cliente de exemplo do editor é uma filial da "Head Office Co." (HQ-001), então os campos da matriz mostram valores reais na tela.

Os campos personalizados chamados custom_deliver_to_name e custom_deliver_to_address imprimem o nome e o endereço do cliente quando ficam vazios no documento.

#Grupo Tabelas

As tabelas repetem suas linhas entre as páginas e podem repetir o cabeçalho. Nas células das tabelas, os valores ficam sem sufixo de moeda (a moeda é impressa uma vez nos totais); uma linha em outra moeda mantém o próprio código. As células são números com separadores de milhar, por exemplo 1,250.00. O painel Colunas no editor permite mostrar, ocultar e reordenar colunas; os títulos estão no idioma do documento.

Tabela Nome interno Tipos Colunas (chave interna = título)
Linhas de itens items Tipos com linhas de itens no = #, description, qty = Qtd., unit, unit_price, discount, tax, amount
Linhas de itens (simples) items_simple Tipos com linhas de itens no, description, qty, unit_price, amount
Resumo de Impostos tax_summary Tipos com linhas de itens tax ("Imposto 5%"), taxable, amount
Linhas de itens com projeto items_project Fatura, cotação, pedido de venda, nota de crédito, conta de fornecedor, pedido de compra, nota de débito no, description, project, qty, unit_price, amount
Linhas de itens (detalhado) items_detailed Tipos com linhas de itens no, code, description, project, division, dimensions, qty, unit, unit_price, discount_percent (Desc. %), discount, tax_rate (Imposto %), tax, amount. Começa mostrando 9 colunas; as demais ficam em Colunas ocultas
Linhas de itens (fatura fiscal) items_tax_invoice Tipos com linhas de itens no, code (nº do item), barcode (Código de barras / GTIN), description, unit, qty, unit_price, discount, after_discount, tax_rate, tax, amount
Documentos aplicados allocations Recibo de reembolso, recibo de pagamento, pagamento a fornecedor no, document, date, document_total (Total original), amount (Este pagamento / Aplicado), remaining
Linhas de lançamento contábil journal Comprovante de lançamento contábil no, account, description, debit, credit (o lado vazio imprime "—")
Movimentação do extrato statement Extrato do cliente e do fornecedor data, documento, descrição, débito, crédito, saldo

Tipos "com linhas de itens": fatura, cotação, pedido de venda, recibo de venda, nota de crédito, conta de fornecedor, pedido de compra, nota de débito, comprovante de despesa.

Como as colunas de linha são impressas:

Coluna O que é impresso
no Número da linha
code Código do item / SKU (também acrescentado sob a descrição nas tabelas padrão)
barcode O código de barras da linha, ou o código de barras / GTIN do item
description Descrição da linha (uma linha histórica sem estoque acrescenta uma segunda linha com o nome armazenado)
qty Quantidade, de 0 a 3 casas decimais, só as necessárias
unit Nome da unidade
unit_price Preço unitário na precisão de exibição, com os zeros finais reduzidos até a precisão de lançamento
discount Valor do desconto
discount_percent Desconto como porcentagem da linha
after_discount Valor da linha antes do imposto
tax_rate Taxa como 5%; vazio quando é 0
tax Valor do imposto
project, division O projeto da linha (ou o projeto do documento quando a linha não tem) e sua divisão no idioma do documento
dimensions Valores de dimensão salvos, "Dimensão: Valor; Dimensão: Valor"
amount Total de linhas

A legenda Resumo de impostos fica em branco quando o documento não tem linhas de imposto, e um elemento de resumo de impostos sem linhas é removido da página impressa.

#Grupo Totais

Os totais são impressos com o código da moeda do documento, por exemplo 1,250.00 AED. Um total que não se aplica imprime "—". Cada total tem uma legenda correspondente no grupo Rótulos (label_*) cuja redação segue o tipo.

Nome de exibição Nome interno Legenda (label_*) Tipos
Subtotal totals_subtotal Subtotal Tipos com linhas de itens
Desconto totals_discount Desconto Tipos com linhas de itens
Imposto totals_tax Imposto Tipos com linhas de itens
Frete totals_shipping Frete Tipos com linhas de itens
Total geral totals_total Total geral (label_total) Tipos com linhas de itens e recibo de reembolso
Pago totals_paid Pago Fatura, conta de fornecedor, recibo de venda
Valor devido totals_balance Valor devido (label_balance_due) Fatura, conta de fornecedor, recibo de venda
Total recebido totals_total Total recebido Recibo de pagamento, pagamento a fornecedor
Total aplicado totals_paid Total aplicado Recibo de pagamento, pagamento a fornecedor
Valor não aplicado totals_balance Valor não aplicado Recibo de pagamento, pagamento a fornecedor
Total de débitos / Total de créditos / Diferença totals_debit, totals_credit, totals_difference Total de débitos, Total de créditos, Diferença Comprovante de lançamento contábil
Saldo inicial / Total de débitos / Total de créditos / Saldo final totals_opening, totals_debit, totals_credit, totals_closing mesmos nomes Extrato do cliente e do fornecedor

A fatura ou conta de exemplo do editor mostra o saldo totalmente em aberto (igual ao total).

#Grupo Rótulos

Os rótulos são legendas no idioma do documento (em inglês "Due Date", em árabe "تاريخ الاستحقاق"…). Use-os para que o mesmo layout funcione em todos os idiomas. Uma legenda que depende de um valor fica em branco quando esse valor está vazio, de modo que nenhuma legenda solta seja impressa: Observações, Termos, Valor por extenso, Referência, Data de vencimento, Resumo de impostos, as legendas de pagamento, Moeda, Filial de, Projeto, Documento original, Pedido de compra, Taxa de câmbio, Data de envio.

Nome interno Impressão (inglês) Notas
label_number Não.
label_date Data de emissão
label_due_date Data de vencimento Tipos com data de vencimento
label_reference Referência Não existe em comprovantes de lançamento contábil
label_status Estado
label_currency Moeda
label_from De Legenda do bloco da empresa
label_subtotal, label_discount, label_tax, label_shipping, label_total, label_paid, label_balance_due Subtotal, Desconto, Imposto, Frete, Total geral (Total recebido em pagamentos), Pago (Total aplicado), Valor devido (Valor não aplicado) Presente quando o total correspondente existe
label_opening, label_debit, label_credit, label_closing, label_difference Saldo inicial, Total de débitos, Total de créditos, Saldo final, Diferença Extratos e comprovante de lançamento contábil
label_notes, label_terms, label_amount_words, label_tax_summary Observações, Termos e condições, Valor por extenso, Resumo de impostos Termos e Resumo de impostos somente em tipos com linhas de itens
label_page Página Usado pelos números de página
label_prepared_by Preparado por
label_received_by Recebido por nos tipos de venda; Assinatura do fornecedor nos tipos de compra; Conferido por em um comprovante de lançamento contábil Legenda da segunda assinatura
label_approved_by Aprovado por
label_signature Assinatura
label_project Projeto Tipos com projeto
label_original_number Documento original Nota de crédito, nota de débito, recibo de reembolso, pedido de venda
label_po_number Pedido de compra Conta de fornecedor
label_exchange_rate Taxa de câmbio Tipos com linhas e pagamentos
label_shipment_date Data de envio Pedido de venda
label_payment_method, label_payment_reference, label_payment_date Forma de pagamento, Número do cheque ou Referência da transação, Data do pagamento Tipos de pagamento
label_parent Filial de No grupo Cliente / fornecedor

#Grupo Imagens e QR, assinatura e carimbo

  • Logotipo (org_logo) é a única imagem vinculada. Você também pode inserir sua própria imagem (por exemplo, um carimbo, uma imagem de assinatura ou um selo de certificação) com Inserir → Imagem; é uma imagem fixa impressa em todos os documentos.
  • Inserir → Mais adiciona formas fixas (retângulo, linha, elipse) e códigos fixos (código QR, Code 128, EAN-13) cujo conteúdo você digita.
  • Não há campo de assinatura nem de carimbo. Para um bloco de assinatura, coloque os campos de legenda label_prepared_by, label_received_by, label_approved_by ou label_signature com uma forma de linha acima ou abaixo de cada um, e approval_prepared_by para o nome de quem criou o documento. Um carimbo é uma imagem fixa.
  • Um campo de código QR para fatura eletrônica não está disponível: a chave doc_qr existe, mas sempre é impressa vazia e não é oferecida na lista de campos.

#Números de página

Os números de página são elementos de texto que usam os marcadores {currentPage}, {totalPages} e {label_page}. Escolha o formato na configuração de números de página do editor; ela reescreve todos os elementos de número de página de uma vez.

Formato English Árabe
Página x de y Página 1 de 2 الصفحة 1 من 2
x de y 1 de 2 1 من 2
Página x / y Página 1 / 2 الصفحة 1 / 2
x / y 1 / 2 1 / 2
x/y 1/2 1/2
Página x Página 1 الصفحة 1
x 1 1
- x - - 1 - - 1 -

A palavra entre os números segue o idioma do documento: of, من, sur, von, de, di, de, из, از (turco e chinês usam "/"). Qualquer outro texto que você digitar é mantido como "Texto personalizado".

#Campos personalizados

  • Os campos personalizados que você define para um tipo de documento aparecem no grupo Campos personalizados com o rótulo e imprimem o valor informado em cada documento.
  • O nome interno é custom_ mais o nome do campo, com todo caractere que não seja letra, dígito ou sublinhado substituído por _, por exemplo custom_delivery_terms.
  • Na tela, o exemplo mostra o rótulo do campo. Um campo com vários valores os imprime separados por vírgulas.
  • Um campo personalizado cujo rótulo coincide com o de um campo integrado (por exemplo, um "Projeto" de texto livre) recebe "(campo personalizado)" no nome da lista para que você os distinga.
  • Compatível com: fatura, cotação, pedido de venda, recibo de venda, nota de crédito, recibo de reembolso, conta de fornecedor, pedido de compra, nota de débito, recibo de pagamento, pagamento a fornecedor, comprovante de despesa, comprovante de lançamento contábil. Os extratos não têm campos personalizados.

#Campos do sistema (todas as colunas armazenadas)

Para cada tipo de documento, o editor também oferece como campos inseríveis as colunas armazenadas do documento, do cliente ou fornecedor e da organização. Isso dá acesso a dados que não têm um campo dedicado.

Prefixo Fonte Exemplo de nome interno
doc_f_ A tabela do próprio documento doc_f_exchange_rate, doc_f_payment_terms
party_f_ O cadastro do cliente ou fornecedor party_f_credit_limit
org_f_ O cadastro da organização org_f_default_document_language
  • O nome de exibição é o nome da coluna com sublinhados como espaços e a primeira letra maiúscula (somente em inglês); eles aparecem nos grupos Documento, Cliente / fornecedor e Organização.
  • Os valores são somente leitura: vêm sempre do cadastro e não podem ser substituídos em um modelo. São impressos exatamente como armazenados. As datas são impressas como Y-m-d (com a hora H:i somente quando há uma hora armazenada), os decimais são reduzidos à precisão de lançamento, os valores sim/não imprimem Yes / No, e um nome armazenado em vários idiomas é impresso no idioma do documento.
  • Ficam vazios no exemplo da tela e vazios quando o cadastro não tem valor.
  • Nunca são oferecidos: identificadores de registro e qualquer coluna terminada em _id, _ids, _token, _secret, _hash, _key, _json, _snapshot, _payload, _meta; senhas e tokens; colunas de auditoria (criado, atualizado, excluído por); configurações, metadados, opções e outros dados estruturados. Os dados de campos personalizados são oferecidos por meio dos campos personalizados.
  • Um campo do sistema nunca substitui um campo dedicado de mesmo nome: só são adicionadas as colunas que não têm um.

A lista exata depende das colunas das tabelas da sua organização, por isso não é reproduzida aqui; pesquise o nome da coluna na lista de campos.

#Variáveis da empresa

Os valores da empresa vêm do perfil da sua organização. Um modelo pode ter o seu próprio valor para alguns deles (por exemplo, o endereço de uma filial em um único modelo) na página Variáveis do editor.

Variável Nome interno Substituível por modelo
Logotipo org_logo Sim. Envie PNG ou JPEG; deixe em branco para não imprimir logotipo
Nome da empresa org_name Sim
Razão social org_legal_name Sim
Endereço da empresa org_address Sim
Telefone da empresa org_phone Sim
E-mail da empresa org_email Sim
Site org_website Sim
Nº fiscal org_tax_number Sim
Nº de registro org_registration Sim
Linha de contato, Dados da empresa, Linha de rodapé org_contact_line, org_details, footer_line Não (linhas combinadas), mas acompanham as substituições dos valores que combinam

Regras:

  • Sem substituição = o modelo segue o perfil da empresa; as alterações posteriores no perfil passam a valer automaticamente.
  • Substituição vazia = um branco proposital: o valor não imprime nada, mesmo que o perfil tenha um.
  • Uma substituição é limitada a 1000 caracteres; a substituição de logotipo deve ser uma imagem PNG ou JPEG.
  • Status na página Variáveis: Substituição do modelo, Deixado em branco, Padrão da empresa, Ausente, Linha combinada, Do documento, Vazio no exemplo, Idioma do documento. Use Restaurar para remover uma substituição.
  • Não substituíveis: todos os campos de documento, pagamento, projeto, cliente / fornecedor, total, rótulo, tabela, personalizados e do sistema. Os valores das transações sempre vêm do documento.

#Formatação

Valores e casas decimais

  • O dinheiro é impresso com separadores de milhar e ponto decimal: 1,250.00. Os totais acrescentam o código da moeda (1,250.00 AED); as células de tabela não.
  • As casas decimais seguem a precisão de lançamento da organização, mas as casas decimais não utilizadas não são impressas: um documento em uma moeda de 2 casas imprime 190,000.00 mesmo que a contabilidade lance com 3 casas, e só passa a 3 quando um valor desse documento realmente precisa da terceira. Uma única precisão vale para o documento inteiro, para que as colunas fiquem alinhadas.
  • As quantidades imprimem de 0 a 3 casas decimais, conforme necessário. Os preços unitários podem mostrar mais casas decimais (a precisão de exibição), reduzidas até a precisão de lançamento.
  • Os dígitos são ocidentais (0–9) em todos os idiomas de documento, inclusive o árabe.

Datas

  • O formato de data do modelo vale para as datas de emissão, vencimento, validade, previsão e envio: Y-m-d (2026-11-20, o padrão), d/m/Y, m/d/Y ou F j, Y (novembro 20, 2026). A hora de geração é sempre Y-m-d H:i. Os campos do sistema imprimem as datas como armazenadas (Y-m-d).

Moeda

  • O código da moeda (AED, SAR, JOD, USD…) é impresso após cada total. Uma linha em outra moeda mantém o código nas células da tabela. O valor por extenso usa o nome da moeda (em inglês ou árabe).

Idioma e escrita da direita para a esquerda

  • Legendas, status, nomes de tipos, formas de pagamento e palavras de data seguem o idioma do documento. Nomes, endereços, observações e outros textos digitados por você ou por seus clientes são impressos como armazenados; não são traduzidos.
  • Os documentos em árabe são organizados da direita para a esquerda. Números, códigos, e-mails, telefones, números fiscais e URLs são envolvidos de modo a manter a ordem da esquerda para a direita dentro do texto da direita para a esquerda. Um valor escrito em alfabeto árabe segue a direção normal do texto.
  • Em um modelo em árabe, o editor espelha as colunas das tabelas e alinha à direita o texto novo.

Valores vazios

  • Um campo vazio não imprime nada. As legendas condicionais ficam em branco por conta própria (veja Rótulos). Em um elemento de texto, você pode definir um texto alternativo que é impresso quando o campo está vazio, por exemplo "Sem projeto".

#Exemplos práticos

Cabeçalho bilíngue (inglês e árabe)

  1. Coloque doc_title e defina o idioma do documento como árabe para obter o título em árabe, ou use o texto estático "FATURA FISCAL | فاتورة ضريبية" para um título bilíngue fixo.
  2. Coloque label_number e doc_number lado a lado, depois label_date e doc_date. As legendas seguem o idioma do documento, então um único modelo serve para ambos.
  3. Coloque org_name e, abaixo dele, org_legal_name. Se o nome da empresa em árabe não estiver no seu perfil, defina-o como substituição do modelo para org_name na página Variáveis.

Bloco de dados bancários

Não há campo de conta bancária. Adicione um elemento de texto estático, por exemplo:

Bank: Example Bank — IBAN: AE00 0000 0000 0000 0000 000
Payment reference: {doc_number}

O texto estático pode conter nomes de campos entre chaves; aqui {doc_number} imprime o número da fatura. Nos documentos de pagamento, doc_payment_method e doc_payment_reference imprimem a forma de pagamento e a referência do cheque ou da transação do documento.

Linha de TRN do cliente

Coloque o texto estático Customer TRN: {party_tax_number} ou use dois elementos: uma legenda estática e o campo party_tax_number. Para imprimir a mesma linha da empresa, use Tax No.: {org_tax_number}. Se o cliente não tiver número fiscal, defina um texto alternativo, como "—", no elemento, ou use party_details, que imprime "Nº fiscal: …" somente quando há um número.

Faturas de filiais

Os modelos integrados já imprimem esta linha como a última linha do painel da parte. Em uma cópia salva e editada, coloque label_parent e party_parent_name sob party_name. Para um cliente matriz, ambos ficam vazios e a legenda desaparece; para uma filial, imprime "Filial de Head Office Co.".

Linha de projeto

Coloque label_project e doc_project. Defina o texto alternativo de doc_project como "Geral" para que os documentos sem projeto imprimam "Geral" (a legenda então acompanha o valor vazio e fica em branco).

#O que não está disponível

  • Um campo de conta bancária / IBAN, um campo de código QR de fatura eletrônica (doc_qr é sempre vazio), um campo de assinatura ou carimbo, o número do pedido de compra do próprio cliente nas faturas (somente as contas de fornecedor têm o pedido de compra emitido ao fornecedor) e lógica condicional ou cálculos em nível de página (os modelos usam apenas os valores listados aqui; sem expressões).
  • Os valores não são recalculados no PDF: valores, impostos, saldos e extenso imprimem exatamente o que o documento contém.
  • Nenhum dado de outros documentos, exceto o original vinculado (nota de crédito, nota de débito, reembolso, pedido de venda), o projeto e suas divisões e o pedido de compra da conta.
  • As variáveis da empresa podem ser substituídas por modelo; todo o resto é fixo na sua origem.

#Lista completa de campos por tipo de documento

As tabelas abaixo listam os campos do catálogo de cada tipo de documento pelo nome interno. Procure cada nome nas seções acima.

#Fatura

80 campos do catálogo (mais campos do sistema e campos personalizados, veja abaixo).

Grupo Campos Quantidade
Documento doc_title, doc_number, doc_date, doc_due_date, doc_reference, doc_status, doc_currency, doc_tax_mode, doc_notes, doc_terms, doc_amount_words, doc_watermark, doc_generated_at, doc_source_note, doc_exchange_rate, approval_prepared_by 16
Projeto doc_project_name, doc_project_code, doc_project 3
Organização org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / fornecedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tabelas items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice 6
Totais totals_subtotal, totals_discount, totals_tax, totals_shipping, totals_total, totals_paid, totals_balance 7
Rótulos label_subtotal, label_discount, label_tax, label_shipping, label_total, label_paid, label_balance_due, label_number, label_date, label_due_date, label_reference, label_project, label_exchange_rate, label_status, label_currency, label_from, label_notes, label_terms, label_amount_words, label_tax_summary, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature 25

#Cotação

76 campos do catálogo (mais campos do sistema e campos personalizados, veja abaixo).

Grupo Campos Quantidade
Documento doc_title, doc_number, doc_date, doc_due_date, doc_reference, doc_status, doc_currency, doc_tax_mode, doc_notes, doc_terms, doc_amount_words, doc_watermark, doc_generated_at, doc_exchange_rate, doc_revision, approval_prepared_by 16
Projeto doc_project_name, doc_project_code, doc_project 3
Organização org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / fornecedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tabelas items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice 6
Totais totals_subtotal, totals_discount, totals_tax, totals_shipping, totals_total 5
Rótulos label_subtotal, label_discount, label_tax, label_shipping, label_total, label_number, label_date, label_due_date, label_reference, label_project, label_exchange_rate, label_status, label_currency, label_from, label_notes, label_terms, label_amount_words, label_tax_summary, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature 23

#Pedido de venda

79 campos do catálogo (mais campos do sistema e campos personalizados, veja abaixo).

Grupo Campos Quantidade
Documento doc_title, doc_number, doc_date, doc_due_date, doc_reference, doc_status, doc_currency, doc_tax_mode, doc_notes, doc_terms, doc_amount_words, doc_watermark, doc_generated_at, doc_original_number, doc_exchange_rate, doc_shipment_date, approval_prepared_by 17
Projeto doc_project_name, doc_project_code, doc_project 3
Organização org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / fornecedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tabelas items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice 6
Totais totals_subtotal, totals_discount, totals_tax, totals_shipping, totals_total 5
Rótulos label_subtotal, label_discount, label_tax, label_shipping, label_total, label_number, label_date, label_due_date, label_reference, label_project, label_original_number, label_exchange_rate, label_shipment_date, label_status, label_currency, label_from, label_notes, label_terms, label_amount_words, label_tax_summary, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature 25

#Recibo de venda

78 campos do catálogo (mais campos do sistema e campos personalizados, veja abaixo).

Grupo Campos Quantidade
Documento doc_title, doc_number, doc_date, doc_reference, doc_status, doc_currency, doc_tax_mode, doc_notes, doc_terms, doc_amount_words, doc_watermark, doc_generated_at, doc_exchange_rate, approval_prepared_by 14
Pagamento doc_payment_method, doc_payment_reference, doc_payment_date 3
Organização org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / fornecedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tabelas items, items_simple, tax_summary, items_detailed, items_tax_invoice 5
Totais totals_subtotal, totals_discount, totals_tax, totals_shipping, totals_total, totals_paid, totals_balance 7
Rótulos label_subtotal, label_discount, label_tax, label_shipping, label_total, label_paid, label_balance_due, label_number, label_date, label_reference, label_exchange_rate, label_status, label_currency, label_from, label_notes, label_terms, label_amount_words, label_tax_summary, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature, label_payment_method, label_payment_reference, label_payment_date 26

#Nota de Crédito

75 campos do catálogo (mais campos do sistema e campos personalizados, veja abaixo).

Grupo Campos Quantidade
Documento doc_title, doc_number, doc_date, doc_reference, doc_status, doc_currency, doc_tax_mode, doc_notes, doc_terms, doc_amount_words, doc_watermark, doc_generated_at, doc_original_number, doc_exchange_rate, approval_prepared_by 15
Projeto doc_project_name, doc_project_code, doc_project 3
Organização org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / fornecedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tabelas items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice 6
Totais totals_subtotal, totals_discount, totals_tax, totals_shipping, totals_total 5
Rótulos label_subtotal, label_discount, label_tax, label_shipping, label_total, label_number, label_date, label_reference, label_project, label_original_number, label_exchange_rate, label_status, label_currency, label_from, label_notes, label_terms, label_amount_words, label_tax_summary, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature 23

#Recibo de reembolso

59 campos do catálogo (mais campos do sistema e campos personalizados, veja abaixo).

Grupo Campos Quantidade
Documento doc_title, doc_number, doc_date, doc_reference, doc_status, doc_currency, doc_notes, doc_amount_words, doc_watermark, doc_generated_at, doc_original_number, doc_refund_reason, approval_prepared_by 13
Pagamento doc_payment_method, doc_payment_reference, doc_payment_date 3
Organização org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / fornecedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tabelas allocations 1
Totais totals_total 1
Rótulos label_total, label_number, label_date, label_reference, label_original_number, label_status, label_currency, label_from, label_notes, label_amount_words, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature, label_payment_method, label_payment_reference, label_payment_date 18

#Conta de fornecedor

81 campos do catálogo (mais campos do sistema e campos personalizados, veja abaixo).

Grupo Campos Quantidade
Documento doc_title, doc_number, doc_date, doc_due_date, doc_reference, doc_status, doc_currency, doc_tax_mode, doc_notes, doc_terms, doc_amount_words, doc_watermark, doc_generated_at, doc_po_number, doc_exchange_rate, approval_prepared_by 16
Projeto doc_project_name, doc_project_code, doc_project 3
Organização org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / fornecedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tabelas items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice 6
Totais totals_subtotal, totals_discount, totals_tax, totals_shipping, totals_total, totals_paid, totals_balance 7
Rótulos label_subtotal, label_discount, label_tax, label_shipping, label_total, label_paid, label_balance_due, label_number, label_date, label_due_date, label_reference, label_project, label_po_number, label_exchange_rate, label_status, label_currency, label_from, label_notes, label_terms, label_amount_words, label_tax_summary, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature 26

#Pedido de compra

75 campos do catálogo (mais campos do sistema e campos personalizados, veja abaixo).

Grupo Campos Quantidade
Documento doc_title, doc_number, doc_date, doc_due_date, doc_reference, doc_status, doc_currency, doc_tax_mode, doc_notes, doc_terms, doc_amount_words, doc_watermark, doc_generated_at, doc_exchange_rate, approval_prepared_by 15
Projeto doc_project_name, doc_project_code, doc_project 3
Organização org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / fornecedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tabelas items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice 6
Totais totals_subtotal, totals_discount, totals_tax, totals_shipping, totals_total 5
Rótulos label_subtotal, label_discount, label_tax, label_shipping, label_total, label_number, label_date, label_due_date, label_reference, label_project, label_exchange_rate, label_status, label_currency, label_from, label_notes, label_terms, label_amount_words, label_tax_summary, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature 23

#Nota de Débito

75 campos do catálogo (mais campos do sistema e campos personalizados, veja abaixo).

Grupo Campos Quantidade
Documento doc_title, doc_number, doc_date, doc_reference, doc_status, doc_currency, doc_tax_mode, doc_notes, doc_terms, doc_amount_words, doc_watermark, doc_generated_at, doc_original_number, doc_exchange_rate, approval_prepared_by 15
Projeto doc_project_name, doc_project_code, doc_project 3
Organização org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / fornecedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tabelas items, items_simple, tax_summary, items_project, items_detailed, items_tax_invoice 6
Totais totals_subtotal, totals_discount, totals_tax, totals_shipping, totals_total 5
Rótulos label_subtotal, label_discount, label_tax, label_shipping, label_total, label_number, label_date, label_reference, label_project, label_original_number, label_exchange_rate, label_status, label_currency, label_from, label_notes, label_terms, label_amount_words, label_tax_summary, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature 23

#Recibo de pagamento

62 campos do catálogo (mais campos do sistema e campos personalizados, veja abaixo).

Grupo Campos Quantidade
Documento doc_title, doc_number, doc_date, doc_reference, doc_status, doc_currency, doc_notes, doc_amount_words, doc_watermark, doc_generated_at, doc_exchange_rate, approval_prepared_by 12
Pagamento doc_payment_method, doc_payment_reference, doc_payment_date 3
Organização org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / fornecedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tabelas allocations 1
Totais totals_total, totals_paid, totals_balance 3
Rótulos label_total, label_paid, label_balance_due, label_number, label_date, label_reference, label_exchange_rate, label_status, label_currency, label_from, label_notes, label_amount_words, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature, label_payment_method, label_payment_reference, label_payment_date 20

#Pagamento a fornecedor

62 campos do catálogo (mais campos do sistema e campos personalizados, veja abaixo).

Grupo Campos Quantidade
Documento doc_title, doc_number, doc_date, doc_reference, doc_status, doc_currency, doc_notes, doc_amount_words, doc_watermark, doc_generated_at, doc_exchange_rate, approval_prepared_by 12
Pagamento doc_payment_method, doc_payment_reference, doc_payment_date 3
Organização org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / fornecedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tabelas allocations 1
Totais totals_total, totals_paid, totals_balance 3
Rótulos label_total, label_paid, label_balance_due, label_number, label_date, label_reference, label_exchange_rate, label_status, label_currency, label_from, label_notes, label_amount_words, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature, label_payment_method, label_payment_reference, label_payment_date 20

#Comprovante de despesa

79 campos do catálogo (mais campos do sistema e campos personalizados, veja abaixo).

Grupo Campos Quantidade
Documento doc_title, doc_number, doc_date, doc_reference, doc_status, doc_currency, doc_tax_mode, doc_notes, doc_terms, doc_amount_words, doc_watermark, doc_generated_at, doc_exchange_rate, doc_payee_name, approval_prepared_by 15
Projeto doc_project_name, doc_project_code, doc_project 3
Pagamento doc_payment_method, doc_payment_reference, doc_payment_date 3
Organização org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / fornecedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tabelas items, items_simple, tax_summary, items_detailed, items_tax_invoice 5
Totais totals_subtotal, totals_discount, totals_tax, totals_shipping, totals_total 5
Rótulos label_subtotal, label_discount, label_tax, label_shipping, label_total, label_number, label_date, label_reference, label_project, label_exchange_rate, label_status, label_currency, label_from, label_notes, label_terms, label_amount_words, label_tax_summary, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature, label_payment_method, label_payment_reference, label_payment_date 25

#Comprovante de lançamento contábil

41 campos do catálogo (mais campos do sistema e campos personalizados, veja abaixo).

Grupo Campos Quantidade
Documento doc_title, doc_number, doc_date, doc_status, doc_currency, doc_notes, doc_amount_words, doc_watermark, doc_generated_at, approval_prepared_by 10
Organização org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Tabelas journal 1
Totais totals_debit, totals_credit, totals_difference 3
Rótulos label_debit, label_credit, label_difference, label_number, label_date, label_status, label_currency, label_from, label_notes, label_amount_words, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature 15

#Extrato do Cliente

56 campos do catálogo (mais campos do sistema e campos personalizados, veja abaixo).

Grupo Campos Quantidade
Documento doc_title, doc_number, doc_date, doc_reference, doc_status, doc_currency, doc_notes, doc_amount_words, doc_watermark, doc_generated_at, approval_prepared_by 11
Organização org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / fornecedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tabelas statement 1
Totais totals_opening, totals_debit, totals_credit, totals_closing 4
Rótulos label_opening, label_debit, label_credit, label_closing, label_number, label_date, label_reference, label_status, label_currency, label_from, label_notes, label_amount_words, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature 17

#Extrato do fornecedor

56 campos do catálogo (mais campos do sistema e campos personalizados, veja abaixo).

Grupo Campos Quantidade
Documento doc_title, doc_number, doc_date, doc_reference, doc_status, doc_currency, doc_notes, doc_amount_words, doc_watermark, doc_generated_at, approval_prepared_by 11
Organização org_logo, org_name, org_legal_name, org_address, org_phone, org_email, org_website, org_tax_number, org_registration, org_contact_line, org_details, footer_line 12
Cliente / fornecedor party_label, party_name, party_code, party_address, party_phone, party_email, party_tax_number, party_parent_name, label_parent, party_parent_code, party_details 11
Tabelas statement 1
Totais totals_opening, totals_debit, totals_credit, totals_closing 4
Rótulos label_opening, label_debit, label_credit, label_closing, label_number, label_date, label_reference, label_status, label_currency, label_from, label_notes, label_amount_words, label_page, label_prepared_by, label_received_by, label_approved_by, label_signature 17