Skip to main content
Use a assinatura incremental quando o documento já chega assinado, por exemplo uma CCB assinada pela credora em outra plataforma, e você precisa que as assinaturas novas fiquem no mesmo arquivo, junto das que já estavam lá. No envelope comum, o documento que chega assinado é assinado numa versão nova, com página de manifesto, e as assinaturas recebidas ficam só no arquivo original. Na assinatura incremental o arquivo recebido não é regravado: cada assinatura nova entra como uma revisão no fim do PDF, e as assinaturas anteriores continuam válidas.

Como funciona

Envie os PDFs e os signatários

Em uma única chamada (POST /signer/v1/incremental-signatures) ou em etapas, começando por POST .../drafts.

O documento é conferido

Documento certificado como “nenhuma alteração permitida” (DocMDP /P 1), protegido por senha ou com estrutura que impede a revisão incremental é recusado com 422, antes de qualquer signatário receber o link.

Os signatários assinam

Cada signatário assina pelo link recebido. A chancela é desenhada na própria revisão da assinatura, no lugar marcado por você ou escolhido pelo signatário.

O portal assina no fim

Quando o último signatário assina, o portal assina cada documento com o certificado do assinador, também como revisão no fim do PDF. Essa assinatura é invisível e registra no próprio arquivo que o documento passou pela plataforma.

O que muda em relação ao envelope comum

Tipos de assinatura

Os mesmos do envelope comum, informados por signatário no campo signatureType: Os tipos sem certificado do signatário assinam com o certificado do portal, também por revisão no fim do PDF. A assinatura do portal na finalização é o que amarra essas assinaturas às evidências que a plataforma guarda (código, prova de vida e histórico). Como não há página de manifesto, essas evidências ficam no portal, e não impressas no documento.

Onde a chancela fica

Sem página de manifesto não há página de assinaturas, então cada signatário precisa de um lugar para a chancela em cada documento:
  • SIGNER: o próprio signatário posiciona a chancela na tela, antes de assinar.
  • OPERATOR: você informa a posição em cada documento.
Abaixo da chancela entra a faixa “Assinado no Portal V/CC da Valid”.

Listar as assinaturas incrementais

As assinaturas incrementais são envelopes e aparecem em GET /signer/v1/envelopes. Use incremental=true para listar só elas, ou incremental=false para os demais. Para acompanhar uma delas, use GET /signer/v1/envelopes/:uuid e os webhooks de sempre.

Limitações

  • As assinaturas recebidas não são validadas nem estendidas pela plataforma. Elas continuam intactas porque o arquivo não é tocado, mas não entram no relatório da plataforma. Um validador externo (ITI, Adobe) mostra todas.
  • Documento que não chega em PDF/A não vira PDF/A. Se quem recebe o documento exige o formato, resolva na origem.
  • Documento certificado como “nenhuma alteração permitida” não aceita assinatura nova. A restrição é do próprio documento.

Próximos passos

Criar em uma chamada

Documentos, signatários e posições num pedido só

Criar em etapas

Rascunho, documentos, signatários, posicionamento e envio