Conceitos
Esta página explica as palavras que aparecem no painel, na página de assinatura e na API. Vale a pena ler antes de enviar o primeiro envelope.
Envelope#
O envelope é a unidade de trabalho do Ravisign: um documento, as pessoas que precisam assiná-lo e as regras do envio (ordem, prazo, lembretes, nível de assinatura). Cada envelope tem um código no formato 157b650a-75e0-4eaa-a32c-b92b5a432ee4, impresso no manifesto e usado no validador público.
Cada envelope criado conta no limite mensal de envelopes do plano, inclusive os que forem cancelados depois.
Documento#
O documento é o PDF que será assinado. Ele vem de uma de três fontes:
- PDF enviado por você, de até 20 MB e sem senha.
- Modelo de texto com variáveis: o texto do modelo recebe os dados do envelope (nome, CPF ou CNPJ, endereço, plano, valor, vigência) e vira PDF uma única vez, logo depois da criação.
- Modelo em PDF fixo: um PDF pronto, usado como está.
No momento em que o documento fica pronto, o Ravisign registra o hash SHA-256 do original, uma impressão digital do arquivo. Qualquer alteração, por menor que seja, muda esse valor. O original nunca é gerado de novo.
Signatário e papéis#
Signatário é cada pessoa incluída no envelope. Um envelope aceita de 1 a 50 pessoas, com ao menos uma que assine. Cada uma tem um papel:
| Papel | O que faz |
|---|---|
| Signatário | Assina como parte do documento (papel padrão) |
| Testemunha | Assina como testemunha |
| Aprovador | Assina para aprovar o documento, por exemplo um gestor da sua empresa |
| Observador | Acompanha o envelope, não assina |
De cada pessoa o Ravisign usa nome, e-mail, telefone (opcional) e CPF ou CNPJ (opcional, conferido pelos dígitos verificadores e registrado no manifesto).
Ordem de assinatura#
- Paralela (padrão): todos recebem o convite juntos e assinam em qualquer ordem.
- Sequencial: as pessoas assinam por grupos, na ordem definida. Cada grupo recebe o convite quando o anterior termina. Pessoas com o mesmo número de ordem formam um grupo e assinam juntas.
Confirmação de identidade#
No nível avançado, antes de assinar, cada signatário confirma a identidade com um código de uso único de 6 dígitos:
| Canal | Como o código chega | Validade |
|---|---|---|
| Enviado pelo Ravisign ao e-mail do signatário | 10 minutos | |
| Conversa | Entregue pelo ChatISP na conversa do WhatsApp em que o cliente está sendo atendido | 30 minutos |
Cada código aceita 5 tentativas, e um signatário pode pedir no máximo 4 códigos por hora.
Em breve código por WhatsApp pela API oficial e por SMS.
Prazo e lembretes#
- Prazo: data limite para assinar, de 1 a 365 dias. O padrão da conta é 30 dias. Vencido o prazo sem todas as assinaturas, o envelope fica expirado.
- Lembretes automáticos: a cada tantas horas (padrão 48, até 720; zero desliga), o Ravisign lembra por e-mail quem ainda não assinou e já está na vez. Você também pode lembrar manualmente pelo painel ou pela API; quem recebeu lembrete na última hora fica de fora.
Situações do envelope#
| Situação | Significado |
|---|---|
| Rascunho | Criado, ainda não enviado (ou aguardando o PDF do modelo ficar pronto) |
| Enviado | Enviado; ninguém assinou ainda |
| Em andamento | Ao menos uma assinatura registrada |
| Concluído | Todos assinaram; a via final está disponível |
| Recusado | Um signatário recusou, com motivo |
| Expirado | O prazo venceu sem todas as assinaturas |
| Cancelado | Cancelado por quem enviou, com motivo |
Concluído, recusado, expirado e cancelado são situações finais: o envelope não muda mais.
Situações do signatário#
| Situação | Significado |
|---|---|
| Pendente | Aguardando o envio do envelope ou a vez dele na ordem sequencial |
| Notificado | O convite foi entregue |
| Visualizado | Abriu o documento |
| Assinado | Assinou |
| Recusado | Recusou, com motivo |
Via final e manifesto#
Quando todos assinam, o Ravisign junta o original e o manifesto de assinaturas num PDF único, assina digitalmente esse arquivo com o certificado da plataforma e aplica o carimbo do tempo. Essa é a via final, também chamada de via assinada. Detalhes em Via final e manifesto.
Trilha de auditoria#
Cada acontecimento do envelope (criação, envio, abertura do link, código enviado e validado, assinatura, recusa, lembrete, conclusão) vira um evento numa trilha encadeada por hash: cada evento sela o anterior, e qualquer alteração quebra a sequência. Veja Trilha de auditoria.
Fale com o suporte da Ravi Systems pelo e-mail abaixo.