API
Assinar com submit (templates)
Preenche campos finais e assina em uma única chamada (fluxo específico para templates).
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
- Pré-visualização (opcional): use
GET /v1/sign/:sessionToken/previewpara ver como ficará o PDF antes de confirmar. - Submit: envie todos os campos finais + assinatura numa única chamada.
- Congelamento: o PDF é renderizado com os campos nesta chamada (one-time freeze) — não pode ser alterado depois.
- Assinatura: documento é assinado com a estratégia automática (PAdES ou Eletrônica).
- Finalização: se último signatário, webhook
FINISHEDdispara.
Quando usar submit vs. sign separado?
Relacionado
POST /v1/sign/:sessionToken/sign— assinar sem preencher campos (fluxo alternativo)PATCH /v1/sign/:sessionToken/fields— preencher campos antes de assinar separadamenteGET /v1/sign/:sessionToken/preview— pré-visualizar PDF com campos preenchidos
Assinar com submit (templates)