> ## Documentation Index
> Fetch the complete documentation index at: https://docs-platform.services-valid.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Assinatura incremental

> Assine PDFs que já chegam assinados por outras partes sem alterar o arquivo recebido e sem invalidar as assinaturas que ele traz.

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

**1. Envie os PDFs e os signatários**

Em uma única chamada ([`POST /signer/v1/incremental-signatures`](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/post-incremental-signature)) ou em etapas, começando por [`POST .../drafts`](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/post-incremental-draft).

**2. 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.

**3. 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.

**4. 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

| | Envelope comum | Assinatura incremental |
| :- | :- | :- |
| Arquivo recebido | Convertido e regravado numa versão nova | Não é alterado |
| Assinaturas que já vinham no PDF | Ficam só no original | Continuam no mesmo arquivo, válidas |
| Página de manifesto | Sim | Não |
| Conversão para PDF/A | Sim | Não. Se o documento precisa ser PDF/A, envie-o assim |
| Posicionamento da chancela | Opcional, com página de assinaturas como alternativa | Obrigatório: você marca (`OPERATOR`) ou o signatário escolhe (`SIGNER`) |
| Assinatura do portal no fim | Com o histórico desenhado no manifesto | Invisível |

## Tipos de assinatura

Os mesmos do envelope comum, informados por signatário no campo `signatureType`:

| Tipo | Como o signatário assina |
| :- | :- |
| `ICP_BRASIL` | Com o próprio certificado ICP-Brasil (em nuvem ou no computador). É o padrão quando o campo não vem. |
| `MFA_EMAIL` / `MFA_SMS` | Com código de verificação por e-mail ou SMS. Os tipos por SMS exigem `phoneNumber`. |
| `LIVENESS` | Com prova de vida. |
| `MFA_EMAIL_LIVENESS` / `MFA_SMS_LIVENESS` | Com código de verificação e prova de vida. |

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`](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/get-envelopes). Use `incremental=true` para listar só elas, ou `incremental=false` para os demais. Para acompanhar uma delas, use [`GET /signer/v1/envelopes/:uuid`](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/get-envelope-by-id) e os [webhooks](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/notificacoes-webhook.md) 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

> [card] [Criar em uma chamada](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/post-incremental-signature.md)
>
> Documentos, signatários e posições num pedido só

> [card] [Criar em etapas](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/post-incremental-draft.md)
>
> Rascunho, documentos, signatários, posicionamento e envio


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.