Templates PDF

Sumário

  1. Conceito
  2. Alterações no GED
  3. Menu de Template
  4. Criação de Templates
  5. Edição de Templates
  6. Formatação de Templates
  7. Uso da API
    7.1 Como Funciona
    7.2 Exemplo de Requisição Completa
  8. Validações

1. Conceito

A funcionalidade de Template de PDF permite a criação de documentos-modelo com campos posicionados visualmente e vinculados aos signatários, viabilizando a padronização de documentos e a automação do envio de envelopes exclusivamente por meio de API.

2. Alterações no GED

Quando um novo PDF é salvo no GED, o sistema registra automaticamente:

Essa funcionalidade é controlada por um feature toggle. Caso o recurso não esteja habilitado, o GED mantém seu comportamento original, sem armazenar as dimensões do arquivo.

As informações salvas são utilizadas nas validações de compatibilidade entre o arquivo enviado via API e o Template aplicado.

3. Menu Template

O módulo SIGN conta com um menu dedicado para o gerenciamento de Templates de PDF. Por meio dessa funcionalidade, é possível criar, editar, formatar e excluir templates de forma centralizada e padronizada.

Caminho: SIGN > Templates de PDF

4. Criação de Templates

Para criar um Template é necessário informar:

Item Descrição
Nome do Template Obrigatório.
Arquivo PDF base Obrigatório. O PDF servirá como referência para posicionamento de campos.
Ícone do Template Opcional.
Informações salvas automaticamente

Altura da primeira página

Largura da primeira página

Total de páginas

Lista de Templates

ID

Nome

Ações: Editar / Formatar / Excluir

5. Edição de Templates

Ao clicar em Editar, é exibido um painel lateral contendo:

Ações disponíveis:

6. Formatação de Templates

Nesta etapa, são definidas as regras de assinatura e o posicionamento dos campos no documento, respeitando a ordem e o vínculo com os signatários.

Campo Descrição
Assinantes Genéricos

É obrigatório haver pelo menos um assinante.

Não existe limite máximo de assinantes.

Os assinantes representam a posição/ordem em que os signatários serão enviados na API.

Campos do Template

Todo campo criado deve estar vinculado a um assinante.

Não é permitido salvar um Template com campos sem vínculo.

Regras para Remover Assinantes

Não é permitido remover um assinante vinculado a algum campo.

A remoção sempre ocorre no último assinante da lista.

7. Uso da API

Atenção

As configurações de Templates criadas por meio do Menu Templates de PDF são aplicadas exclusivamente para uso via API. As definições de Templates criadas diretamente no editor de PDF, a partir do fluxo de Gestão de Envelopes, não são suportadas nem aplicadas nas APIs.

7.1 Como funciona

Para utilizar um Template ao criar um envelope via API, informe o campo pdfTemplateId dentro de cada item de envelopeDocuments. O SIGN validará automaticamente dimensões e número de páginas e aplicará os campos configurados no Template.

7.2 Exemplo de Requisição Completa

{
				"signers": [
				{
				"name": "LUCAS DE CARVALHO",
				"email": "teste@senior.com.br",
				"phoneNumber": "(47) 99999-9999",
				"username": "admin@teste.com.br",
				"orderSign": 1,
				"signerType": "MANDATORY",
				"communicationChannel": {
				"email": true,
				"platform": false
				}
				},
				{
				"name": "LUCAS EDUARDO",
				"email": "teste1@senior.com.br",
				"phoneNumber": "(47) 99999-9999",
				"username": "admin@teste1.com.br",
				"orderSign": 1,
				"signerType": "MANDATORY",
				"communicationChannel": {
				"email": true,
				"platform": false
				}
				}
				],
				"conectors": [],
				"envelopeDocuments": [
				{
				"documentVersion": "d92098b9-592c-4525-882f-bcdfa3e54976",
				"envelopePosition": 1,
				"pdfTemplateId": "f78cd463-c5be-4fa2-b5b5-27f796d92c78"
				}
				],
				"envelopeDraftId": "",
				"name": "Teste",
				"documentsVersions": [
				"d92098b9-592c-4525-882f-bcdfa3e54976"
				],
				"askGeolocation": "DONT_ASK_LOCATION",
				"daysToNotify": 0,
				"daysToExpire": 120,
				"permissions": [],
				"notificateAuthor": false,
				"searchJobPosition": false,
				"recurrentNotificationIntervalDays": 0
				}
		

8. Validações

Validação Descrição
Existência do Template O pdfTemplateId informado deve existir no banco de dados.
Compatibilidade de Dimensões

Altura e largura da 1ª página devem ser compatíveis (tolerância de 5%).

A quantidade de páginas deve ser idêntica.

As dimensões são obtidas das informações salvas no GED.

Ausência de Informações Caso Template ou documento não possua informações de dimensões, um erro será retornado.
Validação de Signatários

A quantidade mínima de signatários deve respeitar os campos criados no Template.

Exemplos:

  • Campos vinculados ao 1 e 2 → mínimo de 2 signatários.
  • Campos vinculados ao 1 e 3 → mínimo de 3 signatários.
Mapeamento dos Signatários

Signatário 1 = 1º item do array signers.

Signatário 2 = 2º item.

Não existe relação com orderSign.

Ignorando Validações

Se pdfTemplateId não for informado, nenhuma validação será aplicada.

O documento será processado normalmente, sem vínculo com Template.

Documentos Mistos

É possível enviar documentos com e sem Template na mesma requisição.

{
								"envelopeDocuments": [
								{
								"documentVersion": "abc",
								"envelopePosition": 1,
								"pdfTemplateId": "template-123"
								},
								{
								"documentVersion": "abc",
								"envelopePosition": 2
								}
								]
								}
						

O primeiro documento passará pelas validações. O segundo será processado normalmente.

Este artigo ajudou você?