Este guia aborda a configuração técnica da integração. Para uma visão geral dos requisitos legais e dos campos obrigatórios para hóspedes, consulte nosso guia complementar: FNRH Digital (Brazil Police Report) - Tudo o que você precisa saber.
- A FNRH Digital (Ficha Nacional de Registro de Hóspedes Digital) é a plataforma obrigatória de registro de hóspedes do governo brasileiro.
- A integração com FNRH Digital (Brazil Police Report) sincroniza automaticamente os dados de registro de hóspedes do sistema da Cloudbeds com o portal da FNRH Digital, garantindo conformidade para estabelecimentos de hotelaria no Brasil.
- A Cloudbeds oferece esta integração para auxiliar as propriedades a manterem a conformidade com as exigências de relatórios obrigatórios.
Ainda não tem uma conta na FNRH Digital? Se seu estabelecimento ainda não está registrado no Ministério do Turismo, você deve primeiro registrar sua propriedade aqui antes de gerar as Chaves de API.
Antes de começar
-
Obtenha suas Credenciais de API da FNRH Digital: Antes de configurar o sistema da Cloudbeds, você deve obter suas chaves de acesso únicas no portal do governo brasileiro.
- Acesse o portal Gov.br SSO oficial e clique em Entrar com gov.br;
- Faça o logon usando seu CPF e senha para acessar o Painel de Controle da FNRH Digital;
- Após o logon, navegue até o módulo Chave das APIs no Painel de Controle principal;
- Encontre e copie seu Usuário (Username) e sua Chave (Key). Você precisará dessas informações para a configuração do aplicativo.
- Acesse o portal Gov.br SSO oficial e clique em Entrar com gov.br;
- Reúna os CPFs da Equipe: Colete o CPF (Cadastro de Pessoas Físicas) de todos os usuários do PMS da Cloudbeds que realizam check-in de hóspedes. Como a plataforma da FNRH Digital exige um identificador individual (cpf_solicitante) para cada registro, cada usuário do sistema da Cloudbeds deve ser mapeado ao seu CPF específico nas configurações do aplicativo.
Propriedades em Organizações: Os proprietários da Organização não podem baixar este aplicativo do Marketplace. Use um usuário no nível da propriedade, com permissões do Marketplace, para conectar o aplicativo.
Conectando o aplicativo
- No seu menu Conta
, clique em Aplicativos eMarketplace
;
- Procure por “Brazil” (usando “z”, mesmo que o idioma do seu PMS esteja configurado para Português (Brasil)) e clique em Saiba mais para FNRH Digital (Brazil Police Report);
Observação sobre o nome do aplicativo: No Marketplace da Cloudbeds, a integração pode aparecer com o nome “Brazil Police Report”. Note que este é o nome técnico global do módulo, mas ele se refere especificamente ao envio da FNRH (Ficha Nacional de Registro de Hóspedes) para a nova plataforma FNRH Digital do Ministério do Turismo, conforme exigido pela Portaria MTur nº 41/2025.
- Clique em Conectar Aplicativo;
- Clique em Permitir Acesso para conceder as permissões solicitadas;
- Após permitir o acesso, você será redirecionado para Aplicativos Conectados. Clique em Página do Aplicativo;
- Clique em Configurações.
Definindo as configurações do aplicativo
- Credenciais de API da FNRH Digital: Insira o Nome do usuário e a Chave de API que você obteve no portal da FNRH Digital;
-
Mapeamento de Usuário:
- CPF do Solicitante: Insira o CPF de cada usuário do sistema da Cloudbeds listado. A plataforma da FNRH Digital exige o identificador individual da pessoa que realiza o check-in para cada sincronização.
- CPF Padrão: Forneça um CPF padrão para uso como alternativa. Ele será usado caso o check-in seja acionado por uma ação do sistema ou por um usuário que não tenha sido mapeado individualmente.
-
Clique em Enviar para salvar suas credenciais e o mapeamento de usuários.
Não há uma mensagem de "sucesso" após clicar em Enviar; suas configurações são salvas imediatamente ao clicar no botão.
Você se conectou! A integração agora sincronizará automaticamente os dados dos hóspedes com check-in feito.
Como funciona a sincronização
A integração sincroniza os dados automaticamente com base em marcos específicos dos hóspedes:
- Check-in: Quando um hóspede faz o check-in, a reserva e todos os dados associados ao hóspede são enviados para a FNRH Digital em uma única solicitação.
- Check-out: Quando um hóspede faz o check-out, o registro é atualizado no portal da FNRH Digital para concluir a estadia.
- Alteraçõ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: Para que a sincronização seja bem-sucedida, os dados obrigatórios de todos os hóspedes na reserva devem estar preenchidos. Se algum hóspede estiver com informações ausentes, a sincronização de toda a reserva falhará.
Monitoramento e Solução de Problemas
Você pode monitorar o status da sua sincronização na seção Serviços do PMS da Cloudbeds:
- Acesse o Menu da Conta
→ Serviços
→ Sincronização da Integração;
- Visualize o status de cada relatório:
- Completo: Os dados do hóspede foram enviados com sucesso para a FNRH Digital.
- Erro: A sincronização falhou. Passe o mouse sobre Mostrar mais para ver o erro específico de validação (p.ex., CPF ausente, data inválida ou credencial incorreta).
Perguntas Frequentes
Esta integração sincroniza as reservas assim que são criadas?
Não. A integração não sincroniza as reservas no momento da criação. A integração FNRH Digital (Brazil Police Report) só começa a monitorar e sincronizar os dados quando ocorre o gatilho de check-in. Reservas com status "Confirmada" ou "Pendente" não são enviadas ao portal do governo até que os hóspedes realmente cheguem e façam o check-in no PMS.
O que acontece se um hóspede não tiver CPF?
O modelo de Informações do Hóspede para o Brasil inclui lógica para hóspedes nacionais e internacionais. Enquanto cidadãos brasileiros devem fornecer o CPF, hóspedes internacionais podem fornecer os dados do passaporte. Certifique-se de que o modelo "Brasil" esteja ativo para coletar os campos obrigatórios corretos com base na nacionalidade do hóspede.
Como corrigir um erro de sincronização?
Se uma sincronização falhar, acesse o registro (log) de Sincronização da Integração em Serviços. Clique em "Mostrar mais" no erro para ver qual campo está ausente ou incorreto. Depois de atualizar as informações do hóspede no perfil dele, a integração tentará sincronizar os dados automaticamente novamente.
Como desconectar o aplicativo FNRH Digital (Brazil Police Report)?
Você pode desconectar o aplicativo FNRH Digital (Brazil Police Report) da mesma forma que qualquer outro aplicativo do Marketplace no PMS da Cloudbeds. Siga este guia: Como desconectar um aplicativo do PMS da Cloudbeds.
Depois que o aplicativo for desconectado, ele não aparecerá mais em Aplicativos Conectados, e os campos de configuração do FNRH Digital (Brazil Police Report) não estarão mais disponíveis nas Configurações.
Se você reconectar o aplicativo depois, será necessário inserir novamente os detalhes da configuração do FNRH Digital (Brazil Police Report).
Comentários
Por favor, entre para comentar.