Definir ordem de assinaturas
Quando estiver criando o envelope, ao definir os destinatários, você pode definir uma ordem da qual deseja que cada um realize suas ações.
Sem ordem
Como padrão, qualquer destinatário pode assinar em qualquer momento. Assim que o envelope é enviado, todos os destinatários recebem o email com o pedido de assinatura. Exemplo:
{
"type": "signer",
"routing_order": null,
"signature_type": "simple",
"addressees": [
{
"via": "email",
"value": "joao.pedro@example.com",
"name": "João Pedro"
}
]
}
Para ver todas as opções do endpoint de adição de destinatário, clique aqui.
Com ordem
Agora, para definirmos uma ordem de assinatura, podemos enumerar a ordem usando a propriedade de routing_order conforme exemplo:
{
"type": "signer",
"routing_order": 1,
"signature_type": "simple",
"addressees": [
{
"via": "email",
"value": "joao.pedro@example.com",
"name": "João Pedro"
}
]
}
Agora para adicionar o próximo assinante:
{
"type": "signer",
"routing_order": 2,
"signature_type": "simple",
"addressees": [
{
"via": "email",
"value": "maria.neves@example.com",
"name": "Maria Neves"
}
]
}
Caso coloque mais de um destinatário na mesma ordem, ambos irão receber o pedido de forma simultânea. Isso significa que, caso tenha adicionado 3 destinatários, sendo o primeiro na ordem 1 e o segundo e terceiro na ordem 2, assim que o primeiro assinar, ambos segundo e terceiro destinatário receberão a notificação de assinatura.
Indepente se está em sequência numérica ou se pular números, exemplo pular de ordem 1 para ordem 3, não mudará a ordem de envios. A ordem de envios é sempre do menor para o maior mesmo que algum número seja pulado, podendo até mesmo começar por números negativos ou zero.
Caso misture ordens nulas com ordens numéricas, todos que estiverem com ordem nula seguirão a regra sem ordem, ou seja, assim que o envelope for enviado, todos os nulos receberão o pedido de assinatura. Já em relação aos ordernados numericamente, estes continuarão respeitando a ordem, sendo que o com a menor ordem receberá também a notificação de assinatura junto aos que estão com ordem nula.