Skip to main content
POST
Assinar com submit (templates)
Fluxo otimizado para envelopes baseados em template: permite que o signatário preencha os campos dinâmicos e assine em uma única chamada. Não é válido para envelopes avulsos (sem template). Autenticação: use apenas o sessionToken na URL.

Parâmetros

string
required
Token da sessão do signatário.
string
required
UUID do arquivo a assinar.
array
required
Lista de campos dinâmicos para preencher e assinar junto.

Respostas

string
URL assinada para download do PDF final assinado e renderizado com campos. Válida por 15 minutos.
string
Timestamp de expiração da URL.

Erros

Veja Autenticação e erros.
  • 400: Campo desconhecido, valor inválido, ou envelope não baseado em template.
  • 404: Session token inválido.
  • 410: Session token expirado.
  • 409: Envelope já foi assinado, ou campo obrigatório não preenchido.

Exemplo

Fluxo de assinatura com submit

  1. Pré-visualização (opcional): use GET /v1/sign/:sessionToken/preview para ver como ficará o PDF antes de confirmar.
  2. Submit: envie todos os campos finais + assinatura numa única chamada.
  3. Congelamento: o PDF é renderizado com os campos nesta chamada (one-time freeze) — não pode ser alterado depois.
  4. Assinatura: documento é assinado com a estratégia automática (PAdES ou Eletrônica).
  5. Finalização: se último signatário, webhook FINISHED dispara.

Quando usar submit vs. sign separado?

Relacionado