"Manda pra Ana e pro Bruno": ordem de assinatura em linguagem natural
"Manda esse contrato pra Ana e pro Bruno assinarem." A frase é clara para uma pessoa e ambígua para um sistema, porque ela não diz o que acontece depois: os dois recebem ao mesmo tempo, ou o Bruno só é chamado quando a Ana terminar? Quem responde a essa pergunta, quando ninguém a fez, é a ordem em que os nomes apareceram. E há um caso em que a resposta é imposta independentemente do que foi pedido: se qualquer um dos signatários assina com certificado digital, o envelope inteiro vira sequencial. Este guia explica as duas regras e o que um agente deveria confirmar antes de enviar.
As duas regras: a ordem dos nomes na lista é a ordem de assinatura — não existe campo separado. E qualquer signatário com certificado digital força o envelope inteiro a sequencial, independentemente do que foi pedido.
A ambiguidade que só aparece depois
"Manda esse contrato pra Ana e pro Bruno assinarem."
Para uma pessoa, a frase é completa. Para um sistema, falta a informação que decide a experiência das duas próximas horas: os dois recebem o convite agora, ou o Bruno só é chamado quando a Ana concluir?
Quem responde, quando ninguém perguntou, é a ordem em que os nomes foram citados. E é aí que mora o desconforto: citar pessoas numa frase não é escolher uma sequência, mas o sistema não tem como distinguir uma enumeração casual de uma ordem deliberada.
Paralelo e sequencial
| Paralelo | Sequencial | |
|---|---|---|
| Convites | Todos ao mesmo tempo | Um de cada vez |
| Ordem de assinatura | Qualquer uma | A da lista |
| Quando usar | Partes independentes | Quando alguém precisa ver o que o anterior fez, ou hierarquia importa |
| Prazo total | O do mais lento | A soma de todos |
A última linha é a que costuma surpreender quem pediu sem pensar no modo: um envelope sequencial com três pessoas que demoram um dia cada leva três dias, não um. Se ninguém precisa ver a assinatura do outro, paralelo entrega o mesmo resultado em um terço do tempo.
O modo vale para o envelope inteiro. Não existe arranjo híbrido em que dois assinam juntos e o terceiro depois.
A regra que ignora o que foi pedido
Há um caso em que a escolha não é sua: se qualquer signatário do envelope usa o perfil de certificado digital, o envelope inteiro vira sequencial — mesmo que o pedido tenha sido explicitamente por paralelo.
O motivo é técnico e não tem contorno: cada assinatura com certificado é aplicada sobre o PDF já assinado pelo anterior. Duas pessoas assinando ao mesmo tempo produziriam dois documentos divergentes, cada um ignorando a assinatura do outro. A sequência não é uma política de produto; é o que o encadeamento criptográfico exige.
Basta um. A regra não exige que todos usem certificado — um único signatário com esse perfil, entre dez que assinam por clique, arrasta o envelope inteiro para sequencial. É a parte que mais pega gente desprevenida, porque o pedido pode ter sido "todos em paralelo, só o diretor com certificado".
Quando isso acontece, a resposta da criação sinaliza que a modalidade foi alterada. Esse sinal existe para ser repassado a quem enviou, e não apenas registrado em log.
Por que o aviso importa para quem enviou
Alguém que pediu "manda pros três" e não foi avisado espera que os três recebam agora. O que acontece é que um recebe. Os outros dois não receberam nada, e do ponto de vista de quem enviou isso parece falha de entrega — o que gera a sequência previsível: reenviar, cancelar, abrir chamado, ou pior, criar um segundo envelope achando que o primeiro não funcionou.
O custo é concreto: enviar consome um documento do plano, e o consumo não é devolvido no cancelamento. Um envelope criado por engano é uma perda real, não apenas um transtorno.
Por isso a conduta correta de um agente, ao receber a resposta com a indicação de modo forçado, é dizer em texto claro: a ordem foi tornada sequencial porque um dos signatários assina com certificado; Ana recebe agora, e Bruno só depois que ela concluir.
O que um agente deveria confirmar antes de enviar
Três perguntas, e só a primeira é sempre necessária:
- Quem assina, e com qual perfil de verificação. Isso determina se a segunda pergunta importa.
- Se a ordem for enforçada, ler a sequência de volta. "Ana primeiro, depois Bruno — confirma?" É uma frase, e evita um envelope perdido.
- Se o modo foi forçado, avisar antes que a pessoa perceba sozinha.
A segunda pergunta não precisa ser feita quando o modo é paralelo — aí a ordem da lista não tem efeito visível, e perguntar seria fricção sem ganho. Um agente que confirma tudo, sempre, treina o usuário a aprovar sem ler, o que anula o propósito da confirmação.
O que não dá para desfazer
- A ordem é definida na criação. Envelopes não são reordenáveis; corrigir significa cancelar e recriar.
- O documento consumido não volta. O cancelamento encerra o envelope, não devolve a cota.
- Um convite entregue já foi visto. Cancelar depois não desfaz o e-mail que chegou.
Nada disso é grave isoladamente. Somado, é o argumento para a confirmação valer a pergunta: o erro custa mais do que o atrito de confirmar.
Limites que valem conhecer antes de montar o pedido
- Até 100 signatários por envelope.
- Um documento por envelope. Um conjunto que precisa ser assinado junto se resolve encadeando envelopes pelo evento de conclusão.
- Signatário repetido é recusado no mesmo envelope.
- CPF ou CNPJ é obrigatório para cada signatário, em qualquer perfil — inclusive assinatura por clique.
O último item é o que mais interrompe um fluxo conversacional: o pedido chega com nome e e-mail, e falta o documento de identificação. Vale o agente perguntar antes de tentar, em vez de descobrir na recusa.
Para quem integra pela API direta
As mesmas duas regras valem: a posição na lista define a ordem, e o perfil de certificado força o modo. A diferença é que na API você declara explicitamente o modo desejado — e continua precisando tratar o caso em que ele foi alterado, porque a decisão do servidor prevalece sobre o pedido.
O modelo de envelope e suas alternativas estão em transação, sessão ou envelope, e o comportamento de ordem na API em ordem sequencial vs paralela. Para o documento final com o comprovante de cada signatário, carimbo combinado. E a visão geral da API de assinatura eletrônica descreve os perfis citados aqui.
Perguntas Frequentes
Como a ordem de assinatura é definida?
Pela ordem do array de signatários no envelope: a posição 1 assina primeiro. Não há um campo separado de sequência — a lista é a sequência. Isso significa que, num pedido em linguagem natural, a ordem em que os nomes foram citados vira a ordem de assinatura, mesmo que quem falou não estivesse escolhendo nada.
Qual a diferença entre paralelo e sequencial?
Em paralelo, todos são convidados ao mesmo tempo e assinam em qualquer ordem. Em sequencial, o convite vai para um de cada vez, e cada pessoa só é chamada quando a anterior conclui. O modo é do envelope inteiro; não existe modo híbrido por grupos.
Quando o modo é forçado?
Quando qualquer signatário do envelope usa o perfil de certificado digital. Nesse caso o envelope vira sequencial independentemente do que foi pedido, e a resposta indica isso. O motivo é técnico: cada assinatura com certificado é aplicada sobre o PDF já assinado pelo anterior, então elas não podem acontecer em paralelo.
Como sei que o modo foi forçado?
A resposta da criação traz uma indicação explícita de que a modalidade foi alterada. É o sinal de que a sua integração — ou o seu agente — precisa avisar a pessoa: quem envia deve saber que os convites vão sair um de cada vez, e não todos juntos, porque isso muda a expectativa de prazo.
O que um agente deveria fazer antes de enviar?
Ler a ordem de volta e obter concordância, quando a ordem for enforçada. Citar pessoas numa frase não é escolher uma sequência, e confirmar custa uma pergunta; corrigir custa cancelar um envelope, perder o documento consumido do plano e refazer.
Dá para mudar a ordem depois de criar?
Não. A ordem é definida na criação e o envelope não é reordenável. Corrigir significa cancelar e recriar — e o documento consumido do plano não é devolvido no cancelamento, então o erro tem custo.
Quantos signatários cabem?
Até 100 por envelope, e um envelope carrega um único documento. Para conjuntos de documentos que devem ser assinados juntos, o caminho é encadear envelopes pelo evento de conclusão.
Confirme a ordem antes de criar o vínculo
Enviar consome um documento do plano e não é devolvido no cancelamento. Um envelope em homologação custa nada e mostra exatamente o comportamento.
Criar credenciais de homologação Fale com o time comercial