Como conectar e usar a Ficha de Registro de Hóspedes do Brasil (FNRH)

Objetivo Conectar, configurar, monitorar e solucionar problemas da integração com a Ficha Nacional de Registro de Hóspedes (FNRH) do Brasil.
Ideal para Equipes da Recepção e Administradores de PMS em estabelecimentos no Brasil.
Use este recurso quando Você precisar conectar a integração, entender quando os dados dos hóspedes são sincronizados, monitorar as submissões à FNRH ou resolver um erro de validação.
Requisitos Credenciais da API da FNRH, informações do CPF da equipe e o acesso necessário ao Marketplace.
Resultado esperado Os dados dos hóspedes com check-in feito são enviados automaticamente para a FNRH, e erros de validação podem ser identificados e corrigidos a partir da Sincronização da Integração.

Introdução

FNRH (Ficha Nacional de Registro de Hóspedes) é a plataforma obrigatória de registro de hóspedes para o governo brasileiro. A integração Brazil Police Report envia os dados de registro dos hóspedes do PMS da Cloudbeds para a FNRH, permitindo que os estabelecimentos cumpram os requisitos legais aplicáveis.

Este artigo foca na configuração técnica e na operação diária da integração. Para os requisitos legais e informações gerais sobre a FNRH, consulte Brazil Police Report (FNRH) - Tudo que você precisa saber.

Use as seções abaixo para preparar as credenciais necessárias, conectar o aplicativo, entender o fluxo de sincronização e resolver submissões à FNRH que falharam.

Neste artigo

Quem isso afeta e como

A integração envolve tanto responsabilidades de configuração quanto o preenchimento de dados no nível do hóspede. Use as orientações por papel abaixo para focar nas partes do fluxo de trabalho que se aplicam a você.

Papel O que você precisa saber
Recepção Preencha as informações obrigatórias do FNRH para cada hóspede e use Resolver erros de validação do FNRH quando uma reserva não sincronizar com sucesso.
Administrador do PMS Prepare as credenciais de API e os CPFs da equipe, conecte o aplicativo, configure a integração e revise problemas de sincronização quando necessário.

Antes de começar

Antes de conectar o aplicativo Ficha de Registro de Hóspedes do Brasil, prepare as credenciais governamentais e as informações da equipe exigidas pelo FNRH. Completar esses pré-requisitos primeiro evita que a configuração pare no meio do caminho.

  • Obtenha suas credenciais de API do FNRH: Recupere as chaves de acesso únicas no portal do governo brasileiro.
    1. Acesse o portal Gov.br SSO oficial e clique em Entrar com gov.br.

      Página inicial do Gov.br mostrando o botão Entrar com gov.br usado para acessar o portal FNRH

    2. Faça logon usando seu CPF e senha para acessar o painel do FNRH.

      Página de login do Gov.br mostrando o campo CPF usado para acessar o painel do FNRH

    3. Após o logon, navegue até o módulo Chave das API's no painel principal.

      Painel do FNRH mostrando o módulo Chave das API's usado para recuperar as credenciais de integração

    4. Localize e copie seu Usuário (Username) e Chave (Key). Você precisará desses dois valores ao configurar o aplicativo.

      Página de acesso à API do FNRH mostrando os campos Username e Key necessários para o aplicativo Boletim de Ocorrência do Brasil

  • Reúna os CPFs da equipe: Colete o CPF (Cadastro de Pessoas Físicas) de todos os usuários do Cloudbeds que realizam check-in de hóspedes. O FNRH exige um identificador individual (cpf_solicitante) para cada registro, portanto, cada usuário do Cloudbeds deve ser mapeado para seu CPF nas configurações do aplicativo.

 Estabelecimentos em Organizações: Proprietários da organização não podem baixar este aplicativo pelo Marketplace. Use um usuário a nível da propriedade com permissões do Marketplace para conectar o aplicativo.

 Ainda não tem uma conta no FNRH? Se seu estabelecimento ainda não está registrado no Ministério do Turismo, registre seu estabelecimento antes de gerar as chaves de API.

Conecte o aplicativo

Conecte o aplicativo Ficha de Registro de Hóspedes do Brasil no Marketplace da Cloudbeds após obter as credenciais FNRH necessárias e um usuário a nível da propriedade com as permissões necessárias do Marketplace.

  1. No Menu da Conta Menu da Conta.jpg, clique em Apps e Marketplace Ícone Apps e Marketplace
  2. Pesquise por Brazil, usando z mesmo que o idioma do seu PMS esteja configurado para português, e clique em Saiba mais para Ficha de Registro de Hóspedes do Brasil.

 Nome do aplicativo: No Marketplace da Cloudbeds, a integração pode aparecer como Ficha de Registro de Hóspedes do Brasil. Este é o nome técnico global do módulo e refere-se às submissões à plataforma digital FNRH do Ministério do Turismo conforme a Portaria MTur nº 41/2025.

O resultado da busca no Marketplace mostra o aplicativo Ficha de Registro de Hóspedes do Brasil antes de abrir seus detalhes.

Resultados da busca no Marketplace da Cloudbeds mostrando o aplicativo Ficha de Registro de Hóspedes do Brasil e a ação Saiba mais

  1. Clique em Conectar aplicativo.

Página do Marketplace da Ficha de Registro de Hóspedes do Brasil mostrando o botão Conectar aplicativo

  1. Clique em Permitir acesso para conceder as permissões solicitadas.

Janela de autorização da Cloudbeds para a Ficha de Registro de Hóspedes do Brasil mostrando as permissões solicitadas e o botão Permitir acesso

  1. Após permitir o acesso, você será redirecionado para Apps conectados. Clique em Página do aplicativo para a Ficha de Registro de Hóspedes do Brasil.

Página de Apps conectados da Cloudbeds mostrando o cartão da Ficha de Registro de Hóspedes do Brasil e a ação Página do aplicativo

  1. Clique em Configurações.

Página do aplicativo Ficha de Registro de Hóspedes do Brasil mostrando a ação Configurações usada para configurar a integração

Configure as configurações do aplicativo

Use a página de configurações do Relatório Policial do Brasil para inserir as credenciais do FNRH e mapear os usuários do Cloudbeds aos valores de CPF necessários para as submissões ao FNRH.

  1. Credenciais da API do FNRH: Insira o Nome do usuário e a Chave de API que você obteve no portal do FNRH.
  2. Mapeamento de usuários:
    • CPF do solicitante: Insira o CPF para cada usuário do Cloudbeds listado. O FNRH exige o identificador individual da pessoa que realiza o check-in para cada sincronização.
    • CPF padrão: Forneça um CPF de reserva. Esse valor é usado se um check-in for acionado por uma ação do sistema ou por um usuário que não foi mapeado individualmente.
  3. Clique em Enviar para salvar suas credenciais e o mapeamento de usuários.

 Não há uma janela de confirmação após clicar em Enviar. Suas configurações são salvas automaticamente.

A página de configurações contém as credenciais do FNRH e os campos de mapeamento de usuários necessários para ativar a integração.

Página de configurações do Relatório Policial do Brasil mostrando os campos Nome do usuário, Chave, CPF padrão e CPF individual do solicitante

 Você está conectado. A integração sincronizará automaticamente os dados dos hóspedes com check-in feito quando as informações necessárias estiverem completas.

Como a sincronização funciona

O Relatório Policial do Brasil envia os dados dos hóspedes automaticamente após a configuração da integração. A sincronização está vinculada aos marcos da estadia do hóspede e às alterações na reserva, e não apenas à criação da reserva.

  • Check-in: Quando um hóspede faz o check-in, a reserva e todos os dados associados ao hóspede são enviados ao FNRH em uma única solicitação.
  • Check-out: Quando um hóspede faz o check-out, o registro no FNRH é atualizado para finalizar a estadia.
  • Modificações: Se os detalhes do hóspede forem atualizados após o check-in, mas antes do check-out, ou se novos hóspedes forem designados a uma reserva com check-in feito, as alterações são sincronizadas automaticamente.

 Regra de validação: As informações obrigatórias devem estar completas para cada hóspede na reserva. Se um hóspede estiver com informações obrigatórias faltando, a sincronização da reserva falha.

Informações obrigatórias do hóspede para sincronização com o FNRH

O FNRH valida as informações obrigatórias do hóspede antes de aceitar a sincronização de uma reserva. Complete os campos obrigatórios para cada hóspede para evitar falhas na validação da reserva.

Informações do hóspede Requisito
Nome completo Obrigatório para cada hóspede.
Data de nascimento Obrigatório para cada hóspede. A integração utiliza primeiro os dados do formulário de registro do hóspede na reserva e pode recorrer à data de nascimento armazenada no perfil do hóspede.
Número e tipo de documento Ambos os valores devem estar presentes, pois o FNRH os valida em conjunto.
Nacionalidade Obrigatório para cada hóspede.
Motivo da viagem e meio de transporte Obrigatórios e coletados por meio do formulário de registro do hóspede.

Gênero, raça e deficiência são opcionais para esta integração. Se esses campos forem deixados em branco, eles terão o valor padrão não informado na submissão ao FNRH.

Monitorar a sincronização com o FNRH

Use a Sincronização de Integração no PMS da Cloudbeds para confirmar se as submissões ao FNRH foram concluídas com sucesso e para identificar registros que precisam de atenção.

  1. No Menu da Conta Menu da Conta.jpg, acesse Utilitários Ícone de Utilitários, e então abra a Sincronização de Integração.
  2. Revise os registros da Ficha de Registro de Hóspedes do Brasil e seus status:
    • Completo: Os dados do hóspede foram enviados com sucesso ao FNRH.
    • Aberto com erro: A sincronização não foi concluída. Selecione Mostrar mais para ver a mensagem de validação e o campo que precisa de atenção.

A página de Sincronização de Integração mostra o status e os detalhes dos erros para cada submissão da Ficha de Registro de Hóspedes do Brasil.

Página de Sincronização da Integração de Utilitários filtrada para Ficha de Registro de Hóspedes do Brasil mostrando registros concluídos e abertos com detalhes de erro

Resolva erros de validação do FNRH

Uma sincronização do FNRH que falhou permanece com status Aberto até que as informações obrigatórias do hóspede sejam corrigidas. Os detalhes do erro identificam o campo que impediu a sincronização da reserva, como a falta da data de nascimento ou valor do documento.

  1. No Menu da Conta Menu da Conta.jpg, acesse Utilitários Ícone de Utilitários, e então abra Sincronização de Integração.
  2. Encontre o registro da Ficha de Registro de Hóspedes do Brasil que falhou e selecione Mostrar mais para identificar o campo ausente ou inválido.

No exemplo abaixo, o erro expandido identifica data_nascimento, que significa que a data de nascimento do hóspede está ausente ou precisa ser corrigida.

Sincronização de Integração mostrando um registro Aberto da Ficha de Registro de Hóspedes do Brasil com erro de validação do FNRH identificando data_nascimento como o campo que precisa de correção

  1. Abra a reserva afetada e preencha as informações obrigatórias para todos os hóspedes. Use a tabela de informações obrigatórias do hóspede como uma lista de verificação.
  2. Salve as informações atualizadas do hóspede ou da reserva.
  3. Retorne à Sincronização de Integração e confirme que o erro foi resolvido após a integração tentar enviar novamente.

 Não é necessário novo check-in. Quando os detalhes da reserva mudam após a correção das informações ausentes, a integração tenta novamente automaticamente. O estabelecimento não precisa fazer o check-in do hóspede novamente nem contatar o Suporte da Cloudbeds apenas para disparar outra tentativa de sincronização.

Perguntas frequentes

Expanda as perguntas abaixo para obter detalhes adicionais sobre o comportamento e a configuração que podem se aplicar ao seu estabelecimento.

Esta integração sincroniza as reservas assim que são criadas?

Não. O Brazil Police Report não sincroniza uma reserva quando ela é criada. A sincronização começa quando o hóspede faz o check-in. Reservas Confirmadas ou Pendentes não são enviadas ao FNRH até que o check-in ocorra.

O que acontece se um hóspede não tiver CPF?

O modelo de Informações do Hóspede do Brazil suporta hóspedes nacionais e internacionais. Cidadãos brasileiros devem fornecer o CPF, enquanto hóspedes internacionais podem fornecer os dados do passaporte. Certifique-se de que o modelo Brazil está ativo para que os campos obrigatórios corretos sejam coletados conforme a nacionalidade do hóspede.

Como corrigir um erro de sincronização do FNRH?

Use Resolver erros de validação do FNRH para identificar o campo faltante na Sincronização de Integração, corrigir as informações do hóspede afetado e confirmar que a nova tentativa automática elimina o erro.

Como desconectar o aplicativo Brazil Police Report?

Desconecte o Brazil Police Report da mesma forma que outros aplicativos do Marketplace. Siga as instruções em Marketplace - Como desconectar um aplicativo do PMS da Cloudbeds. Se você reconectar o aplicativo depois, será necessário inserir novamente os detalhes da configuração do Brazil Police Report.


Agora que você pode conectar, monitorar e solucionar problemas da integração Brazil Police Report, use estes recursos para requisitos mais amplos do FNRH e orientações gerais sobre Sincronização de Integração:

Esse artigo foi útil?
Usuários que acharam isso útil: 0 de 0

Comentários

4 comentários
  • Boa noite! Ja fiz a sincronização. Qual será o proximo passo?

    O hospede irá fazer a reserva e terão campos obrigatorios de preenchimento?

    Como será o procedimento de acompanhantes?

    Obrigado.

    Kennedy

    0
  • Olá, Kennedy Campos

    Para garantir que você receba a ajuda que merece, estamos escalando o seu caso diretamente para a nossa equipe de Suporte dedicada, que irá analisar a situação específica do seu sistema e entrar em contato com você em breve.

    Agradecemos pela sua paciência e estamos comprometidos em resolver isso para você.

    0
  • Boa noite, a integração foi feita corretamente, porém todas reservas apresentam um erro de document.id ausente, mesmo a informação constando no cadastro, como resolver?

    0
  • Olá Alexandre Teixeira,

    Muito obrigado pelo seu contacto e por nos sinalizar esta situação. Vamos encaminhar o seu caso para a nossa equipa de Suporte, que irá analisar o erro e ajudá-lo a encontrar uma solução o mais brevemente possível.

    Agradecemos muito a sua paciência e compreensão!

    0

Por favor, entre para comentar.