API de Assinatura para RH: Admissão e Onboarding Digital

A admissão de um colaborador envolve uma pilha de documentos — contrato de trabalho, termo de confidencialidade, ASO, opção de vale-transporte e políticas internas — que tradicionalmente circulam em papel, exigem reconhecimento de firma e travam o primeiro dia de quem chega. Uma API de assinatura para RH elimina esse atrito: você dispara todos os documentos de admissão programaticamente, define quem assina e em que ordem, confirma a identidade do colaborador e recebe atualizações automáticas no seu sistema de RH conforme cada assinatura é concluída.

Neste guia, mostramos como times de People Ops e fornecedores de software de RH usam a API SignDocs Brasil para digitalizar o onboarding de ponta a ponta — incluindo admissões coletivas em escala (uma transação por colaborador), signatários sequenciais (empresa antes ou depois do colaborador), conformidade com a CLT e a MP 2.200-2/2001, e integração via webhooks com ERPs e plataformas de gestão de pessoas.

Se você ainda está avaliando o terreno, vale começar pela visão geral da nossa API de assinatura digital; aqui o foco é o caso de uso específico de RH e admissão.

O gargalo do onboarding em papel

Quem trabalha com Departamento Pessoal conhece a rotina: o candidato é aprovado, e então começa a corrida contra o relógio para coletar assinaturas em uma pilha de documentos antes da data de início. Quando esse processo é manual ou baseado em PDFs enviados por e-mail, surgem problemas previsíveis:

• Documentos incompletos: o colaborador assina o contrato mas esquece o termo de confidencialidade ou a opção de vale-transporte, e o DP só descobre dias depois.
• Falta de prova de autoria: um PDF assinado e devolvido por e-mail não carrega trilha de auditoria, IP, carimbo de hora do servidor ou método de identificação — frágil em caso de disputa trabalhista.
• Retrabalho em admissões coletivas: contratar 30 pessoas para uma nova loja ou turno significa montar e enviar 30 vezes o mesmo conjunto de documentos, manualmente.
• Dados presos em PDFs: nada é gravado automaticamente no sistema de RH; alguém precisa transcrever status e datas.

A solução não é apenas "assinar digitalmente". É orquestrar o fluxo de admissão por meio de uma API, de modo que a criação dos documentos, a coleta das assinaturas na ordem correta e a atualização do sistema de RH aconteçam como um único processo automatizado.

Os documentos de uma admissão digital

Um onboarding típico no Brasil reúne documentos de naturezas diferentes, cada um com requisitos próprios de assinatura. A tabela abaixo mapeia os principais e o nível de identificação recomendado para cada um.

A API SignDocs permite combinar esses métodos por documento. Você não precisa aplicar o mesmo rigor a uma ciência de política interna e a um contrato de trabalho — o nível de autenticação é configurável por etapa.

Identidade e conformidade com a CLT

A grande preocupação jurídica em documentos trabalhistas assinados eletronicamente é a prova de autoria e integridade. A validade da assinatura eletrônica no Brasil está ancorada na MP 2.200-2/2001, que instituiu a ICP-Brasil, e a Justiça do Trabalho tem aceitado contratos eletrônicos quando há evidência robusta de que aquela pessoa, e não outra, assinou.

É exatamente por isso que a etapa de identificação importa. A API SignDocs registra, para cada assinatura, uma trilha de auditoria com método de autenticação, IP, geolocalização, carimbo de hora do servidor, o hash SHA-256 do documento e o aceite explícito do signatário. Todo esse conjunto é consolidado em um pacote de evidências no formato .p7m, descrito em detalhe no nosso guia sobre o evidence pack e a prova jurídica.

Vale lembrar: o SignDocs é LGPD-first. Os dados pessoais coletados na admissão (CPF, e-mail, biometria) são tratados conforme a Lei Geral de Proteção de Dados, com base legal e ciclo de retenção definidos. Para times que precisam atender solicitações de titulares sobre esses dados, a API expõe endpoints específicos.

Um fluxo de admissão via API, passo a passo

Vamos modelar uma admissão real: o representante legal da empresa assina o contrato primeiro, o gestor de RH valida em seguida, e por último o novo colaborador assina o pacote completo. Isso exige signatários sequenciais — cada parte só é convidada quando a anterior conclui.

Passo 1 — Autenticar e criar a transação de admissão

A API usa autenticação OAuth2 client-credentials. Sua plataforma de RH troca o client_id e client_secret por um bearer token e, com ele, cria o envelope de admissão contendo todos os documentos e a ordem de assinatura:

O pacote de admissão é consolidado em um único PDF (contrato, NDA, ASO, políticas) — para arquivos separados, crie um envelope por documento. Note o campo metadata.hr_employee_id: ele vincula o envelope ao registro do colaborador no seu sistema de RH e voltará em todos os webhooks, permitindo que você atualize o cadastro certo sem buscas adicionais.

Passo 2 — A ordem de assinatura entra em ação

Como signingMode é SEQUENTIAL, o diretor recebe o convite primeiro. Só após ele assinar com certificado ICP-Brasil é que a gestora de RH é notificada; e só depois dela é que Maria, a nova colaboradora, recebe o link para assinar com OTP e biometria facial. Esse encadeamento garante que o contrato chegue ao colaborador já validado internamente.

Passo 3 — Receber os webhooks e atualizar o RH

Conforme cada signatário assina, a SignDocs envia um POST HTTPS assinado com HMAC-SHA256 ao seu endpoint. Seu receptor atualiza o status da admissão e, no evento final, libera os acessos do novo colaborador:

A implementação segura desse receptor — verificação HMAC, idempotência e estratégia de retry — está documentada no nosso guia profundo sobre webhooks e eventos da API de assinatura. É leitura obrigatória antes de colocar o fluxo em produção.

Admissões coletivas em escala

O fluxo acima é perfeito para uma admissão individual. Mas e quando a empresa abre uma nova unidade e precisa admitir 50 pessoas na mesma semana? Reenviar manualmente o mesmo pacote 50 vezes seria o gargalo de volta. É aí que entra a orquestração via API.

Com a API, você define o conjunto-modelo de documentos de admissão uma vez e dispara para uma lista de colaboradores a partir de uma única rotina: um laço no seu sistema cria uma transação por pessoa, reutilizando os mesmos documentos-modelo. Cada colaborador recebe sua própria sessão de assinatura, com seus próprios dados e sua própria trilha de auditoria, mas você orquestra tudo de um só ponto:

Cada colaborador da lista vira uma transação independente que emite os mesmos eventos de webhook, então sua lógica de atualização do RH funciona igual ao caso individual — só que multiplicada.

Integração com sistemas de RH e ERPs

O valor de uma API de assinatura para RH aparece quando ela conversa com o resto da sua pilha — seja um sistema de folha (TOTVS, Senior, Sólides), um ERP corporativo (SAP) ou uma plataforma própria de gestão de pessoas. A integração acontece em duas direções:

Direção 1: do RH para a SignDocs (envio)

Sua plataforma de RH chama a API para criar a transação de admissão. A SignDocs oferece SDKs oficiais para TypeScript/Node, Python, Go, Java, PHP e C#/.NET, então provavelmente já existe um SDK na linguagem do seu backend. Se você usa Ruby ou outra stack, a API REST é agnóstica de linguagem e funciona via cURL/HTTP puro.

Direção 2: da SignDocs para o RH (webhooks)

Os webhooks fecham o ciclo. Em vez de o DP ficar verificando manualmente quem já assinou, cada evento atualiza o sistema automaticamente:

Esse desenho elimina a transcrição manual e mantém o cadastro do colaborador sempre fiel ao estado real das assinaturas. Combinado com lembretes automáticos de assinatura (disparados pela própria SignDocs aos signatários que ainda não concluíram), o tempo entre "candidato aprovado" e "colaborador ativo no sistema" cai de dias para horas.

Lembretes automáticos e trilha de auditoria

Lembretes que reduzem o abandono

Um dos motivos clássicos de atraso na admissão é o colaborador que recebe o link e esquece de assinar. A API SignDocs envia lembretes automáticos por e-mail (e, dependendo do canal configurado, outros meios) aos signatários pendentes, em intervalos que você define. Você também pode disparar um lembrete sob demanda via API quando o gestor solicitar, sem precisar recriar a transação.

Trilha de auditoria pronta para auditoria trabalhista

Cada documento de admissão assinado carrega uma trilha de auditoria completa: data e hora com carimbo de hora do servidor, IP, geolocalização, o hash SHA-256 do documento, método de autenticação e o conteúdo exato aceito por cada parte. Esse dossiê é exportável e verificável publicamente — qualquer pessoa pode conferir a autenticidade do documento no verificador da SignDocs sem precisar de conta. Em uma eventual reclamação trabalhista, essa prova de autoria e integridade é o que sustenta a validade do contrato eletrônico.

RH não é o único caso de uso de API de assinatura

O padrão que descrevemos aqui — disparar documentos por API, orquestrar signatários e reagir a webhooks — se repete em praticamente todo setor que move documentos. Se a sua empresa também atua em outras frentes, vale conhecer como o mesmo motor de assinatura se aplica a verticais vizinhas:

• API de assinatura para fintechs — contratos de crédito, cédulas, termos de adesão com identidade reforçada.

Todos esses casos partem da mesma API de assinatura digital da SignDocs — o que muda é a configuração de métodos de autenticação, ordem de assinatura e integrações, exatamente como ilustramos para o onboarding de RH.