Autentica — onboarding, coleta e assinatura de documentos via API
Crie fluxos personalizados de onboarding, coleta de informações e assinatura de contratos. Centralize solicitações, valide identidade por biometria facial e gere evidências da operação em uma única plataforma.
Todas as requisições usam a URL base
https://api.assertivasolucoes.com.br e exigem um token OAuth2 no
cabeçalho Authorization: Bearer.
Fluxos personalizados
A solução permite montar fluxos para diferentes necessidades:
Coleta e onboarding
Coleta de dados cadastrais, envio e leitura de documentos, captura de selfie e anexação de arquivos.
Validação de identidade
Validação por biometria facial para confirmar quem está do outro lado.
Assinatura
Assinatura de propostas e contratos, com geração de evidências e carimbo do tempo.
Acompanhamento
Acompanhamento de pedidos e notificação de eventos por webhook, evitando consultas repetitivas.
Como o produto é organizado
| Conceito | Descrição |
|---|---|
| Pedido | A solicitação de coleta ou assinatura. Reúne partes, anexos globais, fluxos, dados cadastrais e documentos. |
| Parte | A pessoa ou empresa envolvida no pedido (CPF/CNPJ, nome, celular, e-mail, perfil, fluxo, anexos e campos cadastrais). Um pedido pode ter uma ou mais partes. |
| Perfil de assinatura | Define os campos e informações necessárias para a parte participar do fluxo, conforme o papel que ela desempenha. |
| Fluxo de coleta | Define as etapas que a parte executará (documentos pessoais, validação de identidade, assinatura, selfie, etc.). |
| Artefato | Uma etapa ou módulo dentro de um fluxo (captura de selfie, leitura de PDF, anexação, preenchimento de campos, assinatura, validação de identidade). |
| Carimbo do tempo | Evidência da finalização: quem realizou a ação, data/hora, local, IP e hash do documento ou da operação. |
Controllers
A API é organizada em controllers, cada um responsável por uma área:
| Controller | Responsabilidade |
|---|---|
| Fluxos | Consulta fluxos publicados e liberados para uso, e seus anexos padrão. |
| Arquivos | Gerencia uploads e downloads de arquivos das solicitações. |
| Partes | Gerencia envolvidos, status, links e resultados das partes. |
| Gera e disponibiliza o PDF com os dados de uma parte finalizada. | |
| Pedidos | Cria, consulta, filtra e gerencia pedidos de coleta ou assinatura. |
| Perfis | Consulta os perfis disponíveis e seus campos cadastrais. |
| Webhooks | Configura notificações sobre a finalização dos pedidos. |
Como uma operação acontece
Escolha o fluxo
Consulte os fluxos publicados e liberados e selecione o adequado para a operação.
Crie o pedido
Monte o pedido com o fluxo, as partes, os perfis, os dados cadastrais e os documentos, obtendo links de upload quando necessário.
Envie e acompanhe
Envie o link de acesso a cada parte, acompanhe o andamento por consulta ou webhook e trate pendências (reenviar, aprovar, reprovar, cancelar).
Obtenha o resultado
Após a finalização, baixe os documentos, gere o PDF da parte e armazene as evidências.
Cuidados com dados sensíveis
Secret, o token ou os
links de acesso; use HTTPS e não registre documentos ou tokens completos em
logs.
- Utilize somente a finalidade necessária para o processo (LGPD).
- Restrinja o acesso aos dados por perfil e controle o prazo de retenção.
- Valide a origem dos webhooks e evite processar eventos duplicados.
- Separe documentos de teste e de produção.