PDF4me Modelo do Word
O que este guia abrange
Este guia orienta você na geração de uma única fatura. PDF em n8n usando o pacote modelo.docx e data.json pacote de amostra. O modelo do Word usa PDF4me <<[nomeDoCampo]>> Mesclar tags (sintaxe do mecanismo de relatórios LINQ). Você carrega o .docx como dados binários, colar ou carregar correspondência JSON/XML/CSVe receba um finalizado PDF por execução.
Antes de começar
modelo.docx É um layout de fatura. Valores dinâmicos usam <<[Nº do Inv]>>, <<[nomeDaEmpresa1]>>, <<[nome do produto]>>e tags semelhantes. Os nomes dos campos diferenciam maiúsculas de minúsculas e devem corresponder exatamente às suas chaves de dados.data.json (recomendado), test.xml, ou test.csvTodos os três têm os mesmos valores de fatura. Escolha o Tipo de dados do documento no nó para corresponder ao formato de arquivo fornecido.Pacote de Arquivos de Amostra
Faça o download dos quatro arquivos abaixo. Eles foram projetados para funcionar em conjunto: um modelo e três formatos de dados equivalentes.
<<[campo]>> tagsO que há dentro dos arquivos de amostra?
Layout do modelo (template.docx)
O modelo de exemplo é uma página única. fatura Com rótulos fixos e campos de mesclagem dinâmicos:
| Seção de documentos | Rótulo estático (fixo no modelo) | Etiqueta de mesclagem (preenchida a partir de dados) |
|---|---|---|
| Cabeçalho | FATURA | (estático) |
| Metadados da fatura | Fatura # | <<[InvNr]>> |
| Metadados da fatura | Valor da fatura | <<[invAmt]>> |
| Metadados da fatura | Data da fatura | <<[invDate]>> |
| Metadados da fatura | DEPOIS # | <<[invPO]>> |
| Metadados da fatura | Período de faturamento | <<[from]>> para <<[to]>> |
| Faturado para | COBRADO A | <<[companyName1]>>, <<[companyName2]>>, <<[addressline1]>>, <<[addressline2]>>, <<[country]>> |
| Linha do item | Descrição / Preço / IVA % / VALOR (USD) | <<[productName]>>, <<[price]>>, <<[vat]>>, <<[amount]>> |
:::dica Sintaxe de mesclagem de tags
Uso de modelos do PDF4me Word <<[fieldName]>> (colchetes angulares duplos com colchetes retos). Isso é diferente de HTML sintaxe de bigode ({{fieldName}}). Veja o Guia de sintaxe de modelos do Word laços de repetição, condições e strings de formatação.
:::
Mapeamento de campos em todos os arquivos de dados
Cada valor dinâmico no modelo corresponde a uma chave em data.json, um XML elemento em test.xmlou um CSV coluna em test.csv:
| Template tag | JSON key (data.json) | XML element (test.xml) | Sample value |
|---|---|---|---|
<<[companyName1]>> | companyName1 | CompanyName1 | Muster AG |
<<[companyName2]>> | companyName2 | CompanyName2 | Hans Muster |
<<[addressline1]>> | addressline1 | AddressLine1 | example street |
<<[addressline2]>> | addressline2 | AddressLine2 | 8000 Zürich |
<<[country]>> | country | Country | Switzerland |
<<[productName]>> | productName | ProductName | PDF4me |
<<[price]>> | price | Price | 1000 |
<<[vat]>> | vat | VAT | 8.00 |
<<[amount]>> | amount | Amount | 1000 |
<<[InvNr]>> | InvNr | InvoiceNumber | 202311InV |
<<[invAmt]>> | invAmt | InvoiceAmount | 1000 |
<<[invDate]>> | invDate | InvoiceDate | 2023-11-24 |
<<[invPO]>> | invPO | PurchaseOrder | 1234567 |
<<[from]>> | from | FromDate | 2023-10-24 |
<<[to]>> | to | ToDate | 2023-10-24 |
Visão geral do fluxo de trabalho
A maneira mais rápida de testar o pacote de amostras em n8n:
Manual Trigger → Read Binary File (template.docx) → PDF4me Generate Document (Single) → (optional) Write Binary File
| Etapa | n8n nó | Propósito |
|---|---|---|
| 1 | Gatilho manual | Inicie o fluxo de trabalho sob demanda |
| 2 | Ler arquivo binário | Cargas template.docx em propriedade binária data |
| 3 | PDF4me → Gerar documento (único) | Combina modelo + dados, gerando um único resultado. PDF |
| 4 | Escrever arquivo binário (opcional) | Salva generated_document_output.pdf para disco |
/generate-document-single-full-word.png "Clique para ampliar")
Configuração de destino: Modelo do Word a partir de binário + JSON colado em Texto dos dados do documento + PDF saída
Passo 1: Baixe e coloque os arquivos de exemplo.
- Download
template.docxedata.jsondo Pacote de Arquivos de Amostra acima. - Salve os dois arquivos em algum lugar. n8n pode lê-los, por exemplo
C:\pdf4me-samples\em uma instância auto-hospedada ou faça o upload para o Google Drive/Dropbox se preferir gatilhos na nuvem posteriormente. - Opcionalmente, faça o download.
test.xmloutest.csvSe você quiser testar XML ou CSV tipos de dados em vez de JSON.
Passo 2: Crie o n8n Fluxo de trabalho
- Em n8nCrie um novo fluxo de trabalho.
- Adicionar um Gatilho manual nó (ou qualquer gatilho que você preferir para produção).
- Adicionar um Ler arquivo binário nó após o gatilho.
- Adicionar PDF4me → Gerar documento (único) após ler o arquivo binário.
- Conecte os nós em sequência.
Passo 3: Carregar o modelo do Word (Read Binary File)
Configure o Ler arquivo binário nó:
| Campo | Valor |
|---|---|
| Caminho do arquivo | Caminho completo para o arquivo baixado. template.docx |
| Nome da propriedade | data (padrão; isso se torna a propriedade binária do PDF4me leituras do nó) |
Execute este nó uma vez e confirme se o item de saída exibe um campo binário chamado data com nome de arquivo template.docx.
Etapa 4: Configurar PDF4me Gerar documento (único)
Abra o PDF4me No nó, defina esses campos. Os valores abaixo correspondem exatamente ao pacote de amostra.
Configurações principais
| Campo | Valor | Notas |
|---|---|---|
| Credencial para se conectar com | Seu PDF4me credencial | Pegar API chave |
| Recurso | Generate | |
| Gerar operações | Gerar documento (único) | |
| Tipo de arquivo de modelo | Modelo PDF4me Word | Partidas .docx com <<[field]>> tags |
| Tipo de saída | Usar Word Se você precisar de uma mesclagem editável .docx em vez de |
Entrada de modelo (de Ler arquivo binário)
| Campo | Valor |
|---|---|
| Tipo de entrada de arquivo de modelo | Dados binários |
| Propriedade binária do modelo | data |
| Nome do arquivo de modelo | template.docx |
Dados do documento (cole o JSON de data.json)
| Campo | Valor |
|---|---|
| Tipo de entrada de dados do documento | Texto |
| Tipo de dados do documento | JSON |
| Texto dos dados do documento | Cole o conteúdo completo de data.json (ver bloco abaixo) |
{
"companyName1": "Muster AG",
"companyName2": "Hans Muster",
"addressline1": "example street",
"addressline2": "8000 Zürich",
"country": "Switzerland",
"productName": "PDF4me",
"price": 1000,
"vat": 8.0,
"amount": 1000,
"InvNr": "202311InV",
"invAmt": 1000,
"invDate": "2023-11-24",
"invPO": "1234567",
"from": "2023-10-24",
"to": "2023-10-24"
}
Opções de saída
| Campo | Valor |
|---|---|
| Manter PDF Editável | Off (default) |
| Nome da saída de dados binários | data (padrão) |
Etapa 5: Execute e verifique o PDF
- Clique Executar fluxo de trabalho (ou fugir do PDF4me nó).
- Abra o PDF4me Saída do nó. Em Binário, abra o arquivo em propriedades
data(nome do arquivo)generated_document_output.pdf). - Confirme se a fatura emitida mostra:
- Fatura # →
202311InV - Faturado para → Muster AG / Hans Muster / example street / 8000 Zurique / Suíça
- Item de linha → PDF4me, preço 1000, IVA 8,00, quantidade 1000
- Período de faturamento →
2023-10-24para2023-10-24
- Fatura # →
Se um campo ficar em branco, compare o nome da tag em template.docx com o JSON chave. Devem corresponder exatamente (incluindo maiúsculas e minúsculas: InvNr não invNr).
Passo 6: Salvar o resultado (Opcional)
Adicionar um Escrever arquivo binário nó após PDF4me:
| Campo | Valor |
|---|---|
| Nome do arquivo | invoice-output.pdf (ou use uma expressão) |
| Nome da propriedade de dados | data |
| Caminho de saída | Pasta onde n8n deve escrever o arquivo |
Formatos de dados alternativos
O mesmo template.docx Funciona com todos os três arquivos de dados no pacote de amostras. Apenas o Tipo de dados do documento e alteração da carga útil.
Opção A: JSON arquivo como binário (data.json)
- Adicione um segundo Ler arquivo binário nó para
data.json. - Use um Fusão Node para combinar o binário do modelo e o binário dos dados em um único item (ou executar o carregamento de dados em um ramo separado).
- Em PDF4me: Tipo de entrada de dados do documento = Dados binários, Tipo de dados do documento = JSON, Propriedade binária do documento =
data, Nome do arquivo de dados do documento =data.json.
:::cuidado Conflito de nomes de propriedades binárias
Quando o modelo e os dados usam a propriedade data No mesmo item, eles se sobrescrevem. Use nomes de propriedade separados (por exemplo, template e dataFile) ou mesclar itens de dois nós de Leitura de Arquivo Binário.
:::
Opção B: XML (test.xml)
Definir Tipo de dados do documento para XML e cole o conteúdo de test.xml:
<?xml version="1.0" encoding="UTF-8"?>
<Invoice>
<CompanyName1>Muster AG</CompanyName1>
<CompanyName2>Hans Muster</CompanyName2>
<AddressLine1>example street</AddressLine1>
<AddressLine2>8000 Zürich</AddressLine2>
<Country>Switzerland</Country>
<ProductName>PDF4me</ProductName>
<Price>1000</Price>
<VAT>8.00</VAT>
<Amount>1000</Amount>
<InvoiceNumber>202311InV</InvoiceNumber>
<InvoiceAmount>1000</InvoiceAmount>
<InvoiceDate>2023-11-24</InvoiceDate>
<PurchaseOrder>1234567</PurchaseOrder>
<FromDate>2023-10-24</FromDate>
<ToDate>2023-10-24</ToDate>
</Invoice>
Opção C: CSV (test.csv)
Definir Tipo de dados do documento para CSV e cole o CSV corpo (linha de cabeçalho + uma linha de dados):
companyName1,companyName2,addressline1,addressline2,country,productName,price,vat,amount,InvNr,invAmt,invDate,invPO,from,to
"Muster AG","Hans Muster","example street","8000 Zürich","Switzerland","PDF4me",1000,8.00,1000,"202311InV",1000,"2023-11-24","1234567","2023-10-24","2023-10-24"
CSV Os cabeçalhos das colunas correspondem ao JSON chaves diretamente, que mapeiam para o <<[fieldName]>> tags no modelo.
Padrões de fluxo de trabalho de produção
Formas comuns de fornecer modelos e dados em produção.Once the sample test works, replace the Manual Trigger and Read Binary File nodes with these patterns.
- O Google Drive / Dropbox / OneDrive dispara um gatilho ao criar um novo arquivo.
- Baixar nós busca
modelo.docx(ou use um caminho de modelo fixo). - Construir JSON em um Código ou Definir nó de CRM/Campos da planilha.
- PDF4me mesclagens e saídas PDF para e-mail ou armazenamento.
- O webhook recebe os dados do pedido/fatura.
- Modelo carregado uma vez de URL ou armazenamento binário.
- Corpo do webhook mapeado para Texto dos dados do documento com uma expressão.
- As chaves ainda devem corresponder.
<<[nomeDoCampo]>>tags no modelo.
- Hospedar
modelo.docxedata.jsonem público HTTPS URLs. - Definir Tipo de entrada de arquivo de modelo = URL, URL do arquivo de modelo = link do modelo.
- Definir Tipo de entrada de dados do documento = URL, URL do arquivo de dados do documento = link de dados.
- Não são necessários nós de download prévios.
Perguntas frequentes
Guias relacionados
- Visão geral da geração de documento (único): todos os parâmetros, campos de saída e tipos de modelo
- Sintaxe do modelo do Word:
<<[field]>>tags, loops, condições, formatação - Gerar PDF do modelo do Word em Make: mesmo padrão de amostra em Make