Pular para o conteúdo principal

Gerar documento único em Zapier

Gerar documento único é um Zapier ação por PDF4me que mescla uma Palavra, HTMLMala direta ou modelo do Google Docs com JSON ou XML dados para produzir um documento completo. Use-o para transformar CRM Transforme registros em contratos, dados de pedidos em faturas ou envios de formulários em certificados, tudo dentro de um Zap.

Artigos relacionados no blogue
Ainda não há nenhuma publicação no blogue sobre esta funcionalidade — em breve.
Entretanto, explore o blogue da PDF4me para encontrar tutoriais e fluxos de trabalho para todas as plataformas.
Visite o blogue

O que esta ação faz

PDF4me Gerar documento único A função `map` recebe um arquivo de modelo e um conjunto de dados e retorna um documento mesclado, dentro de um Zap. Palavra, HTML, PDFMala direta ou Google Docs modelo, fornecer dados como texto em linha ou um arquivo de dadose escolha o formato de saída. Ideal para geração de contratos, criação de faturas, emissão de certificados, cartas de oferta e qualquer fluxo de trabalho que transforme um registro em um documento sem escrever código de mesclagem.

Autenticando seu API Solicitar

Para acessar o PDF4me Web APICada solicitação deve incluir credenciais de autenticação adequadas. Conecte seu PDF4me conta uma vez em Zapier e cada etapa "Gerar Documento Único" em seus Zaps a reutiliza.

Fatos importantes que você não deve perder

O tipo de formato de dados de entrada define qual campo de dados é obrigatório.
Defina-o para Texto e Texto de dados torna-se o campo obrigatório para inline JSON/XMLDefina-o para Arquivo e Arquivo de dados Em vez disso, torna-se obrigatório para um arquivo de dados mapeado de uma etapa anterior. O outro campo permanece oculto até que você alterne a opção.
O tipo de arquivo de modelo não se limita ao Word/HTML/PDF
O menu suspenso também inclui Mala direta (um modelo do Word criado para campos de mala direta) e GoogleDocs (Uma exportação do Google Docs usada como modelo de mesclagem), confirmada em configurações Zap em tempo real. Compare esse valor com a forma como o arquivo de modelo foi realmente criado.
Execute o programa duas vezes para obter dois formatos de saída.
Um modelo pode alimentar duas etapas de geração de documento único com diferentes configurações. Tipo de documento de saída valores (por exemplo PDF então Docx) para produzir uma cópia bloqueada e uma cópia editável a partir de um único gatilho.
O painel de ação "Gerar Documento" do PDF4me no Zapier exibe os campos Arquivo de Modelo, Nome do Arquivo de Modelo, Tipo de Arquivo de Modelo definido como PDF, Tipo de Formato de Dados de Entrada definido como Texto, Texto dos Dados, Tipo de Dados de Entrada definido como JSON e Metadados.

Configure o painel de ações com o Tipo de Formato de Dados de Entrada definido como Texto, exibindo o campo Texto dos Dados.

Parâmetros

Obrigatório no Zapier Interface do usuário: Arquivo de modelo, Tipo de arquivo de modelo, Tipo de formato de dados de entrada, Tipo de dados de entrada e (dependendo do Tipo de formato de dados de entrada) Texto de dados ou Arquivo de dados. Nome do arquivo de modelo, Tipo de documento de saída, Manter PDF editável e Metadados são opcionais.

ParâmetroObrigatórioO que fazExemplo
Template FileRequiredTemplate file to populate. Map it from a previous step (Dropbox, Google Drive, Upload File).template.docx
Template File NameOptionalName for the output file. If left blank, the name is picked from Template File's own filename.contract_template
Template File TypeRequiredFormat of the template: Word, HTML, PDF, Mail Merge (Word built for mail-merge fields), or GoogleDocs (Google Docs export).Mail Merge
Input Data Format TypeRequiredWhether data is supplied as inline text or a file. Text reveals Data Text. File reveals Data File.Text
Data TextConditionalInline JSON or XML string to merge into the template. Required when Input Data Format Type is Text.[{"firstname":"John","lastname":"Adams"}]
Data FileConditionalData file (JSON or XML) mapped from a previous step. Required when Input Data Format Type is File.data.json
Input Data TypeRequiredStructure of the supplied data, must match Data Text or Data File exactly.Json
Output Document TypeOptionalFormat of the generated document: Pdf, Docx, and other supported formats.Pdf
Keep Pdf EditableOptionalWhen the output is a PDF from a fillable template, keeps its form fields interactive instead of flattening them.false
Meta DataOptionalMetadata to attach to template fields during generation.-

Saída

CampoTipoO que contém
File NameStringFile name of the generated document, without extension.
File ExtensionStringExtension of the output document, matching Output Document Type.
Full File NameStringComplete filename including extension.
File URLStringDirect URL to the generated document, map this into an Upload File, email, or storage step.
File SizeNumberSize of the generated document in bytes.

Como faço para configurar a geração de documento único em Zapier?

  1. Adicionar PDF4me como o aplicativo de ação no seu Zap e escolha Gerar documento.
  2. Conecte seu PDF4me Crie uma conta ou selecione uma conexão existente.
  3. Mapa Arquivo de modelo da etapa anterior e definir Tipo de arquivo de modelo para combinar com ele (Palavra, HTML, PDF, Mala Direta ou Google Docs).
  4. Definir Tipo de formato de dados de entrada para Texto e preencha Texto de dados com em linha JSON/XMLou defina-o como Arquivo e mapa Arquivo de dados da etapa anterior.
  5. Definir Tipo de dados de entrada para JSON ou XML para corresponder ao formato real dos seus dados.
  6. Opcionalmente configurado Tipo de documento de saída e Manter PDF editávelEm seguida, teste a etapa.
  7. Mapeie o resultado retornado URL do arquivo Em uma ação de Upload de Arquivo, Gmail ou armazenamento para entregar o documento gerado.

Configurações típicas

Exemplos de fluxo de trabalhoCommon Zapier patterns using Generate Document Single.
Modelo de mala direta com um JSON arquivo de dados
  1. Um novo arquivo é adicionado a uma pasta do Dropbox que está sendo monitorada (o modelo do Word).
  2. A etapa "Localizar um arquivo" encontra o arquivo correspondente. JSON Arquivo de dados na mesma pasta.
  3. Gerar documento único com o tipo de arquivo de modelo Mala direta, tipo de formato de dados de entrada Arquivo, arquivo de dados da etapa de pesquisa, tipo de dados de entrada JSON.
  4. A etapa "Carregar arquivo" salva o documento gerado de volta no Dropbox.
Modelo do Google Docs, embutido JSON, saída dupla
  1. A etapa "Localizar um arquivo" localiza um modelo do Google Docs exportado como .docx.
  2. Gerar documento único com modelo do tipo Google Docs, formato de dados de entrada: texto, texto inserido. JSON matriz, Tipo de documento de saída: PDF.
  3. Uma segunda etapa de Geração de Documento Único reutiliza o mesmo modelo com o Tipo de Formato de Dados de Entrada "Arquivo" e o Tipo de Documento de Saída "Docx", produzindo uma cópia editável ao lado do original. PDF.
CRM registro para contrato, acionado por um webhook
  1. Webhooks por Zapier O gatilho recebe uma carga útil de novo acordo de um CRM.
  2. Uma etapa de formatação transforma a carga útil em... JSON estrutura que o modelo de contrato espera.
  3. Gerar documento único com tipo de arquivo de modelo Word, tipo de formato de dados de entrada Texto, texto de dados da etapa Formatador, tipo de dados de entrada JSON e tipo de documento de saída PDF.
  4. Uma etapa do Gmail envia o contrato gerado por e-mail ao cliente.
HTML Modelo para um certificado simplificado
  1. Um gatilho de conclusão de curso é acionado por um webhook de gerenciamento de aprendizagem.
  2. Gerar documento único com tipo de arquivo de modelo HTML, Tipo de formato de dados de entrada: Texto; Dados: Texto contendo o nome do aluno, curso e data; Tipo de documento de saída: PDF.
  3. A etapa "Carregar Arquivo" salva o certificado em uma pasta compartilhada do Google Drive para o aluno.

Dicas práticas

Match Template File Type to how the template was built
Word for a plain merge-field .docx, Mail Merge for a template designed around the mail-merge field pattern, GoogleDocs for a Google Docs export. Picking the wrong type can leave placeholders unfilled.
Toggle Input Data Format Type before filling in data
Data Text and Data File are mutually exclusive: only the field matching your Input Data Format Type selection is required. The other stays out of the way.
Input Data Type must match your data exactly
Json for JSON data, Xml for XML data. A mismatch causes template fields to bind incorrectly or come back empty.
Run twice for two formats from one template
Set Output Document Type to Pdf in one step and Docx in a second step using the same template and data to get both a locked and an editable copy.
Use Keep Pdf Editable only for fillable-PDF templates
This toggle only matters when the template is itself a fillable PDF and the output is Pdf. It has no effect on Word, HTML, or Mail Merge templates.
Batch runs need Generate Documents Multiple, not this action
This action produces one document per run. To generate many personalized documents from one template and a list of records in a single step, use Generate Documents Multiple instead.

Folha de dicas

CampoValor
ActionGenerate Document
Template FileFrom a previous step
Template File TypeWord / HTML / PDF / Mail Merge / GoogleDocs
Input Data Format TypeText or File
Data TextRequired when Input Data Format Type is Text
Data FileRequired when Input Data Format Type is File
Input Data TypeJson or Xml
Output Document TypePdf, Docx, and other supported formats
Keep Pdf Editablefalse (default behavior in documented workflows)

O que devo usar em vez de "Gerar documento único"?

Se o seu fluxo de trabalho exigir muitos documentos personalizados a partir de um modelo e uma lista de registros em uma única execução, em vez de um documento por execução do Zap, use Gerar vários documentosSe o seu modelo for preenchível PDF Em vez de um modelo de campo mesclado/bigode, use um formulário. Preencha um PDF Forma para preencher diretamente os campos do AcroForm em vez de executá-lo por meio do mecanismo de modelos.

Perguntas frequentes

What is the difference between Data Text and Data File?+
Input Data Format Type controls which field is required. Text reveals Data Text for inline JSON or XML, useful when a prior step already exposes the data as text such as a webhook body or a Formatter step output. File reveals Data File for a data file mapped from a previous step, such as a downloaded JSON file. Only the field matching your selection is required at a time. See <a href="https://zapier.com/blog/create-documents-from-templates/" target="_blank" rel="noopener noreferrer">Zapier's own guide on building documents from templates</a> for background on template-merge workflows.
What template types does Generate Document Single support?+
Template File Type accepts Word (.docx with mustache or merge-field placeholders), HTML (.html with template placeholders), PDF (a PDF layout template), Mail Merge (a Word template built around the mail-merge field pattern), and GoogleDocs (a Google Docs export used as a merge template). Match this value to how the template file was actually authored.
What does Keep Pdf Editable do?+
Keep Pdf Editable applies only when the output is a PDF generated from a fillable-PDF template. Left off, the generated PDF is a static, completed document. Turned on, it preserves interactive form fields in the output so a recipient can still edit values after the document is generated.
What output formats can Generate Document Single produce?+
Output Document Type sets the generated file's format independently of the template format, options include Pdf and Docx among other supported formats. Running the same template through the action twice with different Output Document Type values produces both a PDF and a Word copy from one source, a pattern documented in PDF4me's own Zapier trigger workflows.
Do I need to specify Input Data Type as Json or Xml?+
Yes. Input Data Type is required and must match the actual structure of the data supplied in Data Text or Data File. A mismatch, such as selecting Json for XML-formatted data, causes the template engine to fail to bind fields and the generated document returns with placeholders unfilled. For background on JSON structure basics, see <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON" target="_blank" rel="noopener noreferrer">MDN's JSON reference</a>.

Ações relacionadas

Mesma tarefa em outras plataformas

Casos de uso e aplicações industriais

  • Geração de ContratosCrie contratos personalizados a partir de modelos com dados do cliente.
  • Criação de Documentos LegaisGere documentos jurídicos com informações específicas do caso.
  • Processamento de ContratosAutomatize a criação de contratos com integração dinâmica de dados.
  • Automação de DocumentosSimplifique os fluxos de trabalho de documentos jurídicos com o processamento de modelos.

Obtenha ajuda