Verificacao de Documentos
O Opero armazena e gerencia documentos de identificacao dos hospedes com criptografia em repouso, apoiando a conformidade com LGPD e GDPR. Este guia cobre os tipos de documentos aceitos, o fluxo de verificacao, as medidas de seguranca e o acesso controlado aos dados.
Tipos de Documentos Aceitos
No painel, os tipos oferecidos no campo Tipo de Doc. dependem do País selecionado:
| País | Tipos oferecidos (codigo gravado) |
|---|---|
| BR | CPF (CPF), CNPJ (CNPJ), RG (RG), Passaporte (PASSPORT), Outro (OTHER) |
| US | SSN (SSN), EIN (EIN), Passaporte (PASSPORT), Outro (OTHER) |
| AR | DNI (DNI), CUIT (CUIT), Passaporte (PASSPORT), Outro (OTHER) |
| CO | CC (CC), NIT (NIF), Passaporte (PASSPORT), Outro (OTHER) |
| Demais paises | Passaporte (PASSPORT), Tax ID / NIF (NIF), Outro (OTHER) |
A API grava documentType como texto livre (ate 20 caracteres), sem validar essa lista.
Campos do documento no cadastro
| Campo | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
document | string (criptografado) | Nao | Numero completo do documento, armazenado com criptografia AES-256-GCM |
documentLast6 | string | Nao | Ultimos 6 caracteres do documento em texto plano (sem pontos, tracos, barras e espacos), para exibicao mascarada |
documentType | string | Nao | Codigo do tipo do documento (veja a tabela acima) |
documentCountry | string | Nao | Pais emissor no formato ISO 3166-1 alpha-2 (ex: BR, US, AR, CO) |
documentExpiration | date | Nao | Data de validade. Nao ha campo para ela no painel |
Criptografia e Armazenamento
Como funciona
Todos os numeros de documento sao criptografados antes de serem armazenados no banco de dados:
| Aspecto | Detalhe |
|---|---|
| Algoritmo | AES-256-GCM (Galois/Counter Mode) |
| Gerenciamento de chaves | AWS KMS (Key Management Service) |
| Campo criptografado | document — armazena o blob criptografado (ate 500 caracteres) |
| Campo de exibicao | documentLast6 — ultimos 6 caracteres em texto plano |
| Acesso a chave | Apenas o servico de backend via IAM role. Nenhum usuario humano tem acesso direto |
Exibicao mascarada
Na interface do Opero, documentos sao sempre exibidos no formato mascarado:
CPF: ***456789
Passaporte: ***ABC123
RG: ***567890O padrao e *** seguido dos ultimos 6 caracteres (documentLast6). Isso permite identificacao rapida sem expor o documento completo.
Revelacao do Documento Completo
Em situacoes que exigem o numero completo (verificacao presencial, exigencia legal), o operador pode solicitar a revelacao:
Via Interface
- Acesse Hospedes e localize o hospede na listagem
- Na coluna Documento, clique no icone de olho (Revelar documento (registrado))
- O numero completo e exibido por 30 segundos e entao ocultado novamente (ou antes, ao clicar em Ocultar documento)
Via API
POST /api/tenants/:tenantId/guests/:guestId/reveal-documentA resposta retorna o documento descriptografado e o tipo (document, documentType), ou 404 se o hospede nao tiver documento. O endpoint registra automaticamente no log de auditoria:
| Dado registrado | Descricao |
|---|---|
| userId | ID do usuario que solicitou a revelacao |
| ipAddress | Endereco IP de origem da requisicao |
| createdAt | Data e hora exata da revelacao |
| recordId | ID do hospede cujo documento foi revelado (o nome do hospede tambem e registrado) |
| action | READ, com REVEAL_DOCUMENT nos dados do registro |
Importante: Hoje a revelacao nao e restrita por papel: qualquer usuario autenticado da conta com acesso a listagem de hospedes pode revelar documentos. O numero revelado nao e gravado no log.
Fluxo de Verificacao do Hospede
O badge de verificacao indica que o hospede confirmou que e o titular dos dados pessoais. O fluxo difere conforme a origem do cadastro:
Hospede criado pela equipe (via dashboard ou API)
- Funcionario cria o hospede →
verified = false - O sistema envia um link magico por e-mail e um codigo de 6 digitos por SMS (para os contatos cadastrados), ambos validos por 15 minutos
- O hospede clica no link ou digita o codigo
- O sistema atualiza:
verified = true,verifiedAt = timestamp,verifiedChannel = 'email'ou'sms'
Confirmar uma reserva pelo link enviado por e-mail tambem marca o hospede como verificado (verifiedChannel = 'email').
Hospede via self-service (motor de reservas /book)
- O proprio hospede preenche seus dados durante a reserva
- O cadastro e criado com
verified = trueeverifiedChannel = 'self' - Nenhuma etapa adicional e necessaria — o hospede IS o titular dos dados
Canais de verificacao
| Canal | Codigo | Descricao |
|---|---|---|
email | Hospede clicou no link magico enviado por e-mail | |
| SMS | sms | Hospede digitou o codigo de 6 digitos recebido por SMS |
| Self-service | self | Hospede se cadastrou diretamente pelo motor de reservas |
| Legado | legacy | Hospede que ja existia quando a verificacao foi introduzida, marcado como verificado automaticamente |
Validacao de Passaportes
O Opero nao faz validacao especifica de passaportes: a validade (documentExpiration) nao e obrigatoria, nao ha campo para ela no painel e nao ha alertas de vencimento. O campo documentCountry indica o pais emissor (ex: US para Estados Unidos, FR para Franca).
Permissoes
| Acao | Admin | Operacional | Financeiro |
|---|---|---|---|
| Cadastrar documento (Novo Hóspede) | Sim | Sim | Nao (botao oculto) |
Visualizar mascarado (***LAST6) | Sim | Sim | Sim |
| Revelar documento completo | Sim | Sim | Sim |
| Editar documento existente (Editar) | Sim | Sim | Sim |
| Excluir documento | Nao disponivel | Nao disponivel | Nao disponivel |
Nota: Na edicao, deixar o documento em branco mantem o valor atual — nao ha opcao para apagar apenas o documento. A API de hospedes exige a permissao de hospede do papel: os papeis financeiros so leem; editar e excluir ficam com administradores e operacao.
Boas Praticas
- Sempre registre o pais emissor — o campo
documentCountrye essencial para hospedes estrangeiros. - Confira a validade do passaporte — passaportes vencidos podem causar problemas com autoridades. Oriente o hospede quando detectar vencimento proximo.
- Nao anote documentos em papel — utilize exclusivamente o sistema para registrar numeros de documento. Anotacoes em papel violam a LGPD.
- Monitore revelacoes — revise periodicamente o log de auditoria para identificar acessos excessivos ou injustificados a documentos completos.
- Treine a equipe sobre privacidade — todos os funcionarios devem entender que documentos sao dados sensiveis protegidos por lei e que o acesso e rastreado.