Como Enviar um PDF para Assinatura Sem Criar um Modelo

A maioria das APIs de assinatura eletrónica faz com que você crie um modelo antes de poder enviar qualquer coisa para assinatura. Você carrega seu PDF, define seus campos, salva como um modelo e, em seguida, cria uma solicitação de assinatura a partir desse modelo.

Esse fluxo de trabalho faz sentido quando você está enviando o mesmo documento repetidas vezes. Contratos de trabalho, NDAs, acordos de fornecedores. Qualquer coisa que você vá usar mais do que algumas vezes merece um modelo.

Mas às vezes você só precisa enviar um documento único. Uma proposta personalizada. Um acordo legal que é diferente a cada vez. Uma aprovação interna rápida que você nunca repetirá. Criar um modelo para um documento que você só vai usar uma vez adiciona atrito e sobrecarrega seu espaço de trabalho.

Firma.dev agora suporta pedidos de assinatura únicos. Você pode carregar um PDF diretamente, definir seus destinatários e campos inline e enviá-lo para assinatura sem nunca criar um modelo. Este post explica como funciona.

Quando os Modelos Fazem Sentido (E Quando Não Fazem)

Os modelos são a escolha certa quando você está enviando a mesma estrutura de documento repetidamente. Se você tem uma carta de oferta que é enviada para cada nova contratação, ou um NDA que todo fornecedor assina, ou uma fatura mensal que sempre tem os mesmos campos nos mesmos lugares, os modelos economizam seu tempo. Você os configura uma vez e os reutiliza para sempre.

Mas os modelos se tornam um custo adicional quando o documento é único. Uma proposta personalizada com preços que mudam para cada cliente potencial. Um acordo de liquidação que é negociado e revisado antes da assinatura. Um formulário de aprovação interna que é diferente dependendo da situação.

Nesses casos, criar um modelo só para utilizá-lo uma vez é perda de tempo. Você acaba com um espaço de trabalho cheio de modelos de uso único que nunca mais tocará novamente.

O Fluxo de Trabalho de Solicitação de Assinatura Única

O fluxo de trabalho único pula completamente a etapa do modelo. Veja como ele funciona:

1. Pegue seu PDF e codifique-o em base64

2. Defina seus destinatários inline (nome, email, se são um assinante ou cópia enviada, ordem de assinatura se aplicável)

3. Defina seus campos inline (caixas de assinatura, campos de texto, datas, caixas de seleção, o que você precisar) com suas posições na página

4. Chame o endpoint de criação ou o endpoint atômico de criação e envio

5. Pronto. Nenhum modelo necessário.

A solicitação de assinatura funciona exatamente como uma baseada em modelo. Seus destinatários são notificados, eles assinam, você recebe o documento completo e o histórico de auditoria. A única diferença é que você não precisou criar um modelo primeiro.

Exemplo: Enviando uma Proposta Personalizada

Vamos dizer que você é uma empresa SaaS enviando uma proposta de preços personalizada para um cliente potencial. A proposta é um PDF de uma página com o nome da empresa deles, o preço que você negociou e uma linha de assinatura.

Veja como a chamada de API se parece usando o endpoint atômico de criação e envio:

{
  "name": "Proposal - Acme Corp",
  "document": "JVBERi0xLjQK...",
  "recipients": [
    {
      "id": "temp_signer_1",
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane@acmecorp.com",
      "designation": "Signer",
      "order": 1
    }
  ],
  "fields": [
    {
      "recipient_id": "temp_signer_1",
      "type": "signature",
      "page": 1,
      "x": 100,
      "y": 650,
      "width": 200,
      "height": 50
    },
    {
      "recipient_id": "temp_signer_1",
      "type": "date",
      "page": 1,
      "x": 320,
      "y": 650,
      "width": 100,
      "height": 30
    }
  ],
  "settings": {
    "send_signing_email": true
  }
}

{
  "name": "Proposal - Acme Corp",
  "document": "JVBERi0xLjQK...",
  "recipients": [
    {
      "id": "temp_signer_1",
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane@acmecorp.com",
      "designation": "Signer",
      "order": 1
    }
  ],
  "fields": [
    {
      "recipient_id": "temp_signer_1",
      "type": "signature",
      "page": 1,
      "x": 100,
      "y": 650,
      "width": 200,
      "height": 50
    },
    {
      "recipient_id": "temp_signer_1",
      "type": "date",
      "page": 1,
      "x": 320,
      "y": 650,
      "width": 100,
      "height": 30
    }
  ],
  "settings": {
    "send_signing_email": true
  }
}

{
  "name": "Proposal - Acme Corp",
  "document": "JVBERi0xLjQK...",
  "recipients": [
    {
      "id": "temp_signer_1",
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane@acmecorp.com",
      "designation": "Signer",
      "order": 1
    }
  ],
  "fields": [
    {
      "recipient_id": "temp_signer_1",
      "type": "signature",
      "page": 1,
      "x": 100,
      "y": 650,
      "width": 200,
      "height": 50
    },
    {
      "recipient_id": "temp_signer_1",
      "type": "date",
      "page": 1,
      "x": 320,
      "y": 650,
      "width": 100,
      "height": 30
    }
  ],
  "settings": {
    "send_signing_email": true
  }
}

O campo document contém o seu PDF codificado em base64. A matriz recipients define quem precisa assinar. A matriz fields coloca uma caixa de assinatura e um campo de data na página 1 nas coordenadas que você especificar.

Uma chamada de API, e Jane recebe um e-mail pedindo que ela assine. Nenhuma criação de modelo necessária.

Observe o padrão temp_signer_1 no ID do destinatário. Quando você está criando destinatários e campos no mesmo pedido, você usa IDs temporários para vinculá-los juntos. A API resolve isso para UUIDs reais após a criação.

Definindo Campos Sem o Editor de Modelo

Quando você usa modelos, pode colocar campos visualmente usando o editor de modelo incorporado. Com solicitações únicas, você está definindo as posições dos campos na própria chamada de API, o que significa que você precisa conhecer as coordenadas.

Cada campo precisa de:

• page – qual página do PDF (indexada a partir de 1)

• x e y – posição a partir do canto inferior esquerdo da página, em pontos

• width e height – dimensões do campo, em pontos

Se você não tem certeza de onde colocar os campos, abra seu PDF em um visualizador que mostra coordenadas (a maioria deles faz isso), ou apenas estime e ajuste. A experiência de assinatura é tolerante o suficiente para que você não precise de um posicionamento em pixel perfeito.

Tipos de campo disponíveis para solicitações únicas:

• signature – captura de assinatura

• initials – captura de iniciais

• text – entrada de texto livre

• date – seletor de data

• checkbox – caixa de seleção sim/não

Você também pode marcar campos de texto como read_only se quiser pré-preencher um valor que o assinante pode ver, mas não editar. Isso é útil para coisas como valores de contrato, números de referência, ou qualquer dado que já tenha sido acordado.

Quando Usar Modelos em Vez Disso

As solicitações únicas são ótimas para documentos ad-hoc, mas os modelos ainda são a melhor escolha quando você está enviando a mesma estrutura de documento mais de algumas vezes.

Os modelos permitem que você use o editor de modelo incorporado para colocar campos visualmente, em vez de calcular coordenadas. Eles também funcionam com o editor de solicitação de assinatura incorporado, que permite que usuários não técnicos preencham detalhes do destinatário e enviem documentos sem tocar na API.

A regra geral: se você vai enviar um documento mais de duas ou três vezes, crie um modelo. Se é algo único, pule o modelo e use uma solicitação única.

Finalizando

Solicitações de assinatura única eliminam o atrito dos documentos ad-hoc. Você não precisa criar modelos que nunca irá reutilizar, e não precisa sobrecarregar seu espaço de trabalho com estruturas de documento de uma única vez.

Os modelos ainda estão lá quando você precisar deles. Ambos os fluxos de trabalho usam os mesmos tipos de campo, as mesmas opções de destinatário e os mesmos rastreamentos e trilhas de auditoria. Você está apenas escolhendo o caminho que se adapta à situação.

Se você quiser experimentar, o endpoint de criação de solicitação de assinatura tem documentação completa sobre o fluxo de trabalho único. Ou use o endpoint atômico para criar e enviar em uma única chamada.

Comece com Firma.dev gratuitamente – não é necessário cartão de crédito.