Skip to Content
PMS CoreHóspedesVerificação de Documentos

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ísTipos oferecidos (codigo gravado)
BRCPF (CPF), CNPJ (CNPJ), RG (RG), Passaporte (PASSPORT), Outro (OTHER)
USSSN (SSN), EIN (EIN), Passaporte (PASSPORT), Outro (OTHER)
ARDNI (DNI), CUIT (CUIT), Passaporte (PASSPORT), Outro (OTHER)
COCC (CC), NIT (NIF), Passaporte (PASSPORT), Outro (OTHER)
Demais paisesPassaporte (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

CampoTipoObrigatorioDescricao
documentstring (criptografado)NaoNumero completo do documento, armazenado com criptografia AES-256-GCM
documentLast6stringNaoUltimos 6 caracteres do documento em texto plano (sem pontos, tracos, barras e espacos), para exibicao mascarada
documentTypestringNaoCodigo do tipo do documento (veja a tabela acima)
documentCountrystringNaoPais emissor no formato ISO 3166-1 alpha-2 (ex: BR, US, AR, CO)
documentExpirationdateNaoData 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:

AspectoDetalhe
AlgoritmoAES-256-GCM (Galois/Counter Mode)
Gerenciamento de chavesAWS KMS (Key Management Service)
Campo criptografadodocument — armazena o blob criptografado (ate 500 caracteres)
Campo de exibicaodocumentLast6 — ultimos 6 caracteres em texto plano
Acesso a chaveApenas 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: ***567890

O 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

  1. Acesse Hospedes e localize o hospede na listagem
  2. Na coluna Documento, clique no icone de olho (Revelar documento (registrado))
  3. 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-document

A 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 registradoDescricao
userIdID do usuario que solicitou a revelacao
ipAddressEndereco IP de origem da requisicao
createdAtData e hora exata da revelacao
recordIdID do hospede cujo documento foi revelado (o nome do hospede tambem e registrado)
actionREAD, 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)

  1. Funcionario cria o hospede → verified = false
  2. 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
  3. O hospede clica no link ou digita o codigo
  4. 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)

  1. O proprio hospede preenche seus dados durante a reserva
  2. O cadastro e criado com verified = true e verifiedChannel = 'self'
  3. Nenhuma etapa adicional e necessaria — o hospede IS o titular dos dados

Canais de verificacao

CanalCodigoDescricao
E-mailemailHospede clicou no link magico enviado por e-mail
SMSsmsHospede digitou o codigo de 6 digitos recebido por SMS
Self-serviceselfHospede se cadastrou diretamente pelo motor de reservas
LegadolegacyHospede 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

AcaoAdminOperacionalFinanceiro
Cadastrar documento (Novo Hóspede)SimSimNao (botao oculto)
Visualizar mascarado (***LAST6)SimSimSim
Revelar documento completoSimSimSim
Editar documento existente (Editar)SimSimSim
Excluir documentoNao disponivelNao disponivelNao 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

  1. Sempre registre o pais emissor — o campo documentCountry e essencial para hospedes estrangeiros.
  2. Confira a validade do passaporte — passaportes vencidos podem causar problemas com autoridades. Oriente o hospede quando detectar vencimento proximo.
  3. Nao anote documentos em papel — utilize exclusivamente o sistema para registrar numeros de documento. Anotacoes em papel violam a LGPD.
  4. Monitore revelacoes — revise periodicamente o log de auditoria para identificar acessos excessivos ou injustificados a documentos completos.
  5. Treine a equipe sobre privacidade — todos os funcionarios devem entender que documentos sao dados sensiveis protegidos por lei e que o acesso e rastreado.
Last updated on