Modelos de Solução — Fluxos de Assinatura Eletrônica por Cenário de Negócio

Os modelos de solução são guias ponta a ponta que mostram como resolver um fluxo de negócio real com a API da SignDocs Brasil — do problema (contrato parado, consentimento sem registro, aprovação por e-mail sem prova) até o resultado auditável: documento assinado com validade fundada na MP 2.200-2/2001 e pacote de evidências assinado com certificado ICP-Brasil. Cada guia cobre o fluxo completo: autenticação OAuth2, criação da sessão ou envelope, entrega do link ao signatário, acompanhamento por webhooks e download da evidência.

Como usar: escolha o cenário mais próximo do seu processo nas tabelas abaixo, siga o passo a passo em HML (https://api-hml.signdocs.com.br — credenciais de homologação não consomem cota e os dados expiram em 7 dias) e depois adapte os campos de metadata, o perfil de política e a entrega do link à sua realidade. Mesmo que o seu caso não esteja listado, os blocos de construção são sempre os mesmos.

🟠 HML vs Produção — desenvolva sempre em HML (api-hml.signdocs.com.br). Credenciais em https://app.signdocs.com.br/admin/api-clients ou via contato@signdocs.com.br.

Como escolher a primitiva

Toda solução combina uma ou mais das três primitivas da API. A escolha depende de quantas pessoas assinam e se existe um documento envolvido:

Primitiva	Quando usar	Endpoint	Guia
Sessão de Assinatura	1 signatário, 1 documento, 1 chamada de API — o caso mais comum	`POST /v1/signing-sessions`	Assinatura expressa
Envelope	2 ou mais signatários no mesmo documento, em ordem (`SEQUENTIAL`) ou simultâneos (`PARALLEL`)	`POST /v1/envelopes`	Envelopes
Sessão de Confiança	Autenticar uma ação sem documento: aprovação interna, consentimento LGPD, verificação de identidade (KYC)	`POST /v1/trust-sessions`	Sessão de confiança

Em todos os casos, o resultado inclui trilha de auditoria, hash SHA-256 e pacote de evidências verificável — a diferença está no formato do fluxo, não na força da prova.

RH e Departamento Pessoal

Admissões e contratos de trabalho normalmente exigem mais de um signatário (colaborador + representante da empresa), por isso os dois cenários usam envelope sequencial:

Cenário	Primitiva	Perfil recomendado	Guia
Onboarding de Colaboradores	Envelope `SEQUENTIAL`	`CLICK_PLUS_OTP`	Ver guia
Contrato de Trabalho CLT	Envelope `SEQUENTIAL`	`CLICK_PLUS_OTP`	Ver guia

Imobiliário

Locação e compra e venda envolvem tipicamente três partes — locador/vendedor, locatário/comprador e imobiliária ou fiador — assinando em ordem definida:

Cenário	Primitiva	Perfil recomendado	Guia
Locação e Compra e Venda	Envelope `SEQUENTIAL` (3 signatários)	`CLICK_PLUS_OTP` ou `BIOMETRIC`	Ver guia

Financeiro e Compliance

Nem tudo é assinatura de documento: verificar a identidade de um cliente ou aprovar um cadastro são ações autenticadas por sessão de confiança, que pode ser combinada com um envelope quando há contrato ao final:

Cenário	Primitiva	Perfil recomendado	Guia
KYC de Clientes	Sessão de confiança	`BIOMETRIC`	Ver guia
Onboarding de Fornecedores	Sessão de confiança + envelope	`CLICK_PLUS_OTP`	Ver guia

Vendas

Proposta comercial assinada pelo cliente, com aprovação interna do desconto registrada como evidência antes do envio:

Cenário	Primitiva	Perfil recomendado	Guia
Proposta Comercial	Sessão de assinatura + sessão de confiança (aprovação)	`CLICK_ONLY`	Ver guia

Jurídico

Procurações pedem vínculo forte entre signatário e identidade — biometria facial mais código OTP:

Cenário	Primitiva	Perfil recomendado	Guia
Procuração Particular	Sessão de assinatura	`BIOMETRIC_PLUS_OTP`	Ver guia

Saúde

O consentimento livre e esclarecido (TCLE) pode ser registrado como sessão de confiança de consentimento — sem PDF — ou como assinatura simples do termo:

Cenário	Primitiva	Perfil recomendado	Guia
TCLE / Telemedicina	Sessão de confiança (consentimento) ou sessão de assinatura	`CLICK_ONLY`	Ver guia

Seguros

Proposta assinada pelo segurado e emissão da apólice condicionada à aprovação da subscrição:

Cenário	Primitiva	Perfil recomendado	Guia
Proposta e Apólice	Sessão de assinatura + sessão de confiança (aprovação)	`CLICK_PLUS_OTP`	Ver guia

✅ Dica — em dúvida sobre o perfil de política, comece com CLICK_PLUS_OTP e consulte Perfis de assinatura e níveis legais antes de subir ou descer o nível de autenticação.

Sem código

Vários desses fluxos podem ser montados sem escrever uma linha de código:

n8n — nó oficial da SignDocs para automações self-hosted ou cloud: guia de integração. Templates prontos para importar: contrato a partir do Google Docs, link de assinatura via WhatsApp/Telegram e pipeline imobiliário.
Make — cenários visuais com os módulos SignDocs: guia de integração.
Zapier — conecte a SignDocs a milhares de apps: guia de integração.
Agentes de IA via MCP — o servidor @signdocs-brasil/mcp-server expõe a API como ferramentas MCP, permitindo que assistentes como o Claude criem sessões, acompanhem envelopes e baixem evidências em linguagem natural.

WhatsApp e Telegram atuam como canais de entrega do link de assinatura (via n8n, Make ou a API do WhatsApp Business do próprio cliente) — a sessão é sempre criada pela API da SignDocs.

Não achou seu cenário?

Os blocos de construção são os mesmos em qualquer fluxo: sessões de assinatura, envelopes, sessões de confiança, webhooks e pacote de evidências. Combine-os para o seu caso:

Receitas de assinatura expressa — payloads prontos de sessões e envelopes para dezenas de variações.
Receitas de sessão de confiança — aprovações, consentimentos e verificações de identidade.
Webhooks — reaja à conclusão de qualquer fluxo em tempo real.

Se o seu processo não se encaixa em nenhum modelo, escreva para contato@signdocs.com.br descrevendo o fluxo — ajudamos a desenhar a solução e, se fizer sentido, ela vira o próximo guia desta seção.