Signatários¶
Cada signatário representa uma pessoa que precisa assinar o documento.
Campos¶
{
"name": "Maria Silva",
"email": "maria@cliente.com",
"phone": "+55 11 98765-4321",
"documentNumber": "111.222.333-44",
"verificationMethod": "email_token",
"signingOrder": 1,
"locale": "pt-BR"
}
| Campo | Obrigatório | Comentário |
|---|---|---|
name |
sim | Aparece nos emails e no PDF assinado |
email |
sim | Pra onde vai o convite + link |
phone |
só se verificationMethod envolve SMS |
Formato E.164 (+5511...) |
documentNumber |
não | CPF/CNPJ — gravado no audit trail e PDF assinado |
verificationMethod |
sim | Ver tabela abaixo |
signingOrder |
sim | Define paralelismo/sequência (ver abaixo) |
locale |
não (default pt-BR) |
Idioma do email + portal de assinatura |
Métodos de verificação¶
| Método | Como funciona | Quando usar |
|---|---|---|
simple |
Signatário clica no link e assina. Sem OTP. | Documentos baixa criticidade (NDA interno, formulário) |
email_token |
OTP de 6 dígitos enviado por email no momento da assinatura | Padrão recomendado — equilíbrio entre fricção e segurança |
sms_token |
OTP por SMS | Quando o email é menos confiável (signatário externo, fora do corporativo) |
email_and_sms |
OTP em ambos — precisa digitar os dois | Documentos de alta criticidade (contratos grandes, instrumentos legais) |
Ordem de assinatura (signingOrder)¶
O signingOrder controla paralelismo vs sequência:
- Mesmo número → assinam em paralelo (todos recebem convite no
send) - Números diferentes → assinam em sequência (o de ordem maior só recebe convite depois que todos com ordem menor assinaram)
Exemplos¶
Todos em paralelo (3 sócios assinam ao mesmo tempo):
Fluxo de aprovação sequencial (gerente assina primeiro, depois diretor):
Híbrido (2 sócios em paralelo, depois testemunha):
Quando o signatário não assina sozinho¶
A Aceitou manda lembretes automáticos a cada reminderIntervalDays (configurado no documento, default 3 dias) até o documento Expired.
Você também pode disparar manualmente:
curl -X POST https://api.aceitou.com.br/api/v1/documents/123/signers/456/resend \
-H "X-Api-Key: $KEY"
Ou obter o link e enviar pelo seu próprio canal (WhatsApp, in-app, etc):