Wie man den Brazil Police Bericht (FNRH) verbindet und verwendet

Gabriela Garcia

Aktualisiert 23. Oktober 2026 09:16

Zweck	Verbinden, konfigurieren, überwachen und Fehler beheben bei der Integration des Brazil Police Report (FNRH).
Am besten geeignet für	Teams an der Rezeption und Administratoren des PMS in Unterkünften in Brasilien.
Verwenden Sie dies, wenn	Sie die Integration verbinden, verstehen möchten, wann Gastdaten synchronisiert werden, FNRH-Übermittlungen überwachen oder einen Validierungsfehler beheben müssen.
Anforderungen	FNRH API-Zugangsdaten, Mitarbeiter-CPF-Informationen und der erforderliche Marketplace-Zugang.
Erwartetes Ergebnis	Daten eingecheckter Gäste werden automatisch an FNRH gesendet, und Validierungsfehler können in Integration Sync erkannt und korrigiert werden.

Einführung

FNRH (Ficha Nacional de Registro de Hóspedes) ist die verpflichtende Gästeregistrierungsplattform der brasilianischen Regierung. Die Integration Brazil Police Report übermittelt Gästeregistrierungsdaten vom Cloudbeds PMS an FNRH, damit Unterkünfte die geltenden Meldepflichten erfüllen können.

Dieser Artikel konzentriert sich auf die technische Einrichtung und den täglichen Betrieb der Integration. Für die rechtlichen Anforderungen und einen umfassenderen Hintergrund zu FNRH siehe Brazil Police Report (FNRH) – Alles, was Sie wissen müssen.

Nutzen Sie die folgenden Abschnitte, um die erforderlichen Zugangsdaten vorzubereiten, die App zu verbinden, den Synchronisationsablauf zu verstehen und fehlgeschlagene FNRH-Übermittlungen zu beheben.

Inhaltsverzeichnis

Wer davon betroffen ist und wie
Bevor Sie beginnen
Die App verbinden
Die App-Einstellungen konfigurieren
Wie die Synchronisierung funktioniert
Erforderliche Gastinformationen für die FNRH-Synchronisierung
FNRH-Synchronisierung überwachen
FNRH-Validierungsfehler beheben
Häufig gestellte Fragen

Wer davon betroffen ist und wie

Die Integration umfasst sowohl Einrichtungsverantwortlichkeiten als auch die Eingabe von Gastdaten. Nutzen Sie die untenstehende Rollenübersicht, um sich auf die für Sie relevanten Teile des Workflows zu konzentrieren.

Rolle	Wissenswertes
Rezeption	Füllen Sie die erforderlichen FNRH-Informationen für jeden Gast aus und nutzen Sie FNRH-Validierungsfehler beheben, wenn eine Reservierung nicht erfolgreich synchronisiert wird.
PMS-Administrator	Bereiten Sie die API-Zugangsdaten und die CPFs des Personals vor, verbinden Sie die App, konfigurieren Sie die Integration und prüfen Sie bei Bedarf Synchronisierungsprobleme.

Bevor Sie beginnen

Bevor Sie die Brazil Police Report-App verbinden, bereiten Sie die von FNRH geforderten staatlichen Zugangsdaten und Mitarbeiterinformationen vor. Das rechtzeitige Erfüllen dieser Voraussetzungen verhindert, dass die Einrichtung mittendrin stoppt.

Holen Sie Ihre FNRH-API-Zugangsdaten: Rufen Sie die eindeutigen Zugangsschlüssel vom brasilianischen Regierungsportal ab.
1. Gehen Sie zum offiziellen Gov.br SSO-Portal und klicken Sie auf Entrar com gov.br.
2. Melden Sie sich mit Ihrem CPF und Passwort an, um zum FNRH-Dashboard zu gelangen.
3. Nach der Anmeldung navigieren Sie zum Modul Chave das API's im Haupt-Dashboard.
4. Finden und kopieren Sie Ihren Usuário (Benutzernamen) und Ihre Chave (Schlüssel). Beide Werte benötigen Sie, wenn Sie die App konfigurieren.
Sammeln Sie die CPFs des Personals: Erfassen Sie die CPF (Cadastro de Pessoas Físicas) aller Cloudbeds-Benutzer, die den Gast-Check-in durchführen. FNRH verlangt eine individuelle Kennung (cpf_solicitante) für jeden Datensatz, daher muss jeder Cloudbeds-Benutzer in den App-Einstellungen seinem CPF zugeordnet werden.

Unterkünfte in Organisationen: Organisationsinhaber können diese App nicht aus dem Marketplace herunterladen. Verwenden Sie einen Benutzer auf Unterkunftsebene mit Marketplace-Berechtigungen, um die App zu verbinden.

Sie haben noch kein FNRH-Konto? Wenn Ihre Unterkunft noch nicht beim Tourismusministerium registriert ist, registrieren Sie Ihre Unterkunft, bevor Sie API-Schlüssel generieren.

App verbinden

Verbinden Sie die Brazil Police Report-App aus dem Cloudbeds-Marketplace, nachdem Sie die erforderlichen FNRH-Zugangsdaten und einen Benutzer auf Unterkunftsebene mit den notwendigen Marketplace-Berechtigungen haben.

Klicken Sie im Kontomenü auf Apps & Marketplace
Suchen Sie nach Brazil, verwenden Sie dabei ein z, auch wenn Ihre PMS-Sprache auf Portugiesisch eingestellt ist, und klicken Sie bei Brazil Police Report auf Mehr erfahren.

Name der Anwendung: Im Cloudbeds-Marketplace kann die Integration als Brazil Police Report erscheinen. Dies ist der globale technische Name des Moduls und bezieht sich auf Meldungen an die digitale FNRH-Plattform des Ministeriums für Tourismus gemäß MTur-Verordnung Nr. 41/2025.

Das Suchergebnis im Marketplace zeigt die Brazil Police Report-App an, bevor Sie die Details öffnen.

Klicken Sie auf App verbinden.

Klicken Sie auf Zugriff erlauben, um die angeforderten Berechtigungen zu erteilen.

Nach der Erteilung des Zugriffs werden Sie zur Seite Verbundene Apps weitergeleitet. Klicken Sie dort auf App-Seite für Brazil Police Report.

Klicken Sie auf Einstellungen.

Konfigurieren Sie die App-Einstellungen

Verwenden Sie die Einstellungsseite für den Brazil Police Report, um die FNRH-Zugangsdaten einzugeben und Cloudbeds-Benutzer den für FNRH-Übermittlungen erforderlichen CPF-Werten zuzuordnen.

FNRH API-Zugangsdaten: Geben Sie den Benutzernamen und den API-Schlüssel ein, die Sie im FNRH-Portal erhalten haben.
Benutzerzuordnung:
- Anforderer-CPF: Geben Sie für jeden aufgeführten Cloudbeds-Benutzer den CPF ein. FNRH verlangt die individuelle Kennung der Person, die den Check-in durchführt, für jede Synchronisierung.
- Standard-CPF: Geben Sie einen Ersatz-CPF an. Dieser Wert wird verwendet, wenn ein Check-in durch eine Systemaktion oder einen Benutzer ausgelöst wird, der nicht individuell zugeordnet wurde.
Klicken Sie auf Senden, um Ihre Zugangsdaten und die Benutzerzuordnung zu speichern.

Nach dem Klicken auf Senden erscheint kein Bestätigungs-Popup. Ihre Einstellungen werden sofort gespeichert.

Die Einstellungsseite enthält die FNRH-Zugangsdaten und Benutzerzuordnungsfelder, die zur Aktivierung der Integration erforderlich sind.

Sie sind verbunden. Die Integration synchronisiert automatisch Daten für eingecheckte Gäste, sobald die erforderlichen Gastinformationen vollständig sind.

So funktioniert die Synchronisierung

Brazil Police Report sendet Gastdaten automatisch, nachdem die Integration konfiguriert wurde. Die Synchronisierung ist an Meilensteine des Gästeaufenthalts und Änderungen der Reservierung gebunden, nicht nur an die Reservierungserstellung.

Check-in: Wenn ein Gast eingecheckt wird, werden die Reservierung und alle zugehörigen Gastdaten in einer einzigen Anfrage an FNRH gesendet.
Check-out: Wenn ein Gast auscheckt, wird der FNRH-Datensatz aktualisiert, um den Aufenthalt abzuschließen.
Änderungen: Wenn Gastdetails nach dem Check-in, aber vor dem Check-out aktualisiert werden oder wenn neue Gäste einer eingecheckten Reservierung zugewiesen werden, werden die Änderungen automatisch synchronisiert.

Validierungsregel: Erforderliche Informationen müssen für jeden Gast in der Reservierung vollständig sein. Fehlt bei einem Gast eine erforderliche Information, schlägt die Synchronisierung der Reservierung fehl.

Erforderliche Gastinformationen für die FNRH-Synchronisierung

FNRH validiert erforderliche Gästeinformationen, bevor eine Reservierungssynchronisierung akzeptiert wird. Füllen Sie die erforderlichen Felder für jeden Gast aus, um Validierungsfehler auf Reservierungsebene zu vermeiden.

Gästeinformationen	Anforderung
Vollständiger Name	Für jeden Gast erforderlich.
Geburtsdatum	Für jeden Gast erforderlich. Die Integration verwendet zunächst die Daten aus dem Gäste-Registrierungsformular der Reservierung und kann auf das im Gästeprofil gespeicherte Geburtsdatum zurückgreifen.
Dokumentnummer und Dokumenttyp	Beide Werte müssen vorhanden sein, da FNRH sie gemeinsam validiert.
Nationalität	Für jeden Gast erforderlich.
Reiseregrund und Transportmittel	Erforderlich und werden über das Gäste-Registrierungsformular erfasst.

Geschlecht, ethnische Zugehörigkeit und Behinderung sind für diese Integration optional. Wenn diese Felder leer bleiben, werden sie in der FNRH-Übermittlung standardmäßig als nicht angegeben behandelt.

FNRH-Synchronisierung überwachen

Verwenden Sie die Integration Sync im Cloudbeds PMS, um zu bestätigen, ob FNRH-Übermittlungen erfolgreich abgeschlossen wurden und um Datensätze zu identifizieren, die Aufmerksamkeit erfordern.

Öffnen Sie im Kontomenü , die Utilities , und öffnen Sie dann Integration Sync.
Überprüfen Sie die Datensätze des Brazil Police Reports und deren Status:
- Abgeschlossen: Die Gästedaten wurden erfolgreich an FNRH gesendet.
- Offen mit Fehler: Die Synchronisierung wurde nicht abgeschlossen. Wählen Sie Mehr anzeigen, um die Validierungsnachricht und das betroffene Feld einzusehen.

Die Seite Integration Sync zeigt den Status und die Fehlerdetails für jede Übermittlung des Brazil Police Reports an.

FNRH-Validierungsfehler beheben

Eine fehlgeschlagene FNRH-Synchronisierung bleibt im Offen-Status, bis die erforderlichen Gastinformationen korrigiert sind. Die Fehlerdetails zeigen das Feld an, das die Synchronisierung der Reservierung verhindert hat, wie zum Beispiel ein fehlendes Geburtsdatum oder ein ungültiger Dokumentenwert.

Gehen Sie im Kontomenü zu Utilities und öffnen Sie dann Integration Sync.
Suchen Sie den fehlgeschlagenen Brasilien Polizeibericht-Datensatz und wählen Sie Mehr anzeigen, um das fehlende oder ungültige Feld zu identifizieren.

Im folgenden Beispiel zeigt der erweiterte Fehler data_nascimento an, was bedeutet, dass das Geburtsdatum des Gasts fehlt oder korrigiert werden muss.

Öffnen Sie die betroffene Reservierung und vervollständigen Sie die erforderlichen Informationen für jeden Gast. Verwenden Sie die Tabelle der erforderlichen Gastinformationen als Checkliste.
Speichern Sie die aktualisierten Gast- oder Reservierungsinformationen.
Kehren Sie zu Integration Sync zurück und bestätigen Sie, dass der Fehler nach einem erneuten Synchronisierungsversuch der Integration behoben ist.

Kein erneuter Check-in ist erforderlich. Wenn sich Reservierungsdetails nach der Korrektur der fehlenden Informationen ändern, versucht die Integration automatisch erneut zu synchronisieren. Die Unterkunft muss den Gast nicht erneut einchecken oder den Cloudbeds-Support kontaktieren, nur um einen weiteren Synchronisierungsversuch auszulösen.

Häufig gestellte Fragen

Erweitern Sie die untenstehenden Fragen für weitere Details zum Verhalten und zur Einrichtung, die für Ihre Unterkunft relevant sein können.

Wird diese Integration Reservierungen sofort nach ihrer Erstellung synchronisieren?

Nein. Der Brazil Police Report synchronisiert eine Reservierung nicht bei ihrer Erstellung. Die Synchronisierung beginnt erst beim Check-in des Gasts. Bestätigte oder ausstehende Reservierungen werden erst nach dem Check-in an FNRH gesendet.

Was passiert, wenn ein Gast keine CPF hat?

Die Vorlage Brazil Guest Information unterstützt sowohl inländische als auch internationale Gäste. Brasilianische Staatsbürger müssen eine CPF angeben, während internationale Gäste Passdaten angeben können. Stellen Sie sicher, dass die Brazil-Vorlage aktiv ist, damit die korrekten Pflichtfelder entsprechend der Nationalität des Gasts erfasst werden.

Wie behebe ich einen FNRH-Synchronisierungsfehler?

Nutzen Sie FNRH-Validierungsfehler beheben, um das fehlende Feld in der Integration Sync zu identifizieren, korrigieren Sie die betroffenen Gastinformationen und bestätigen Sie, dass der automatische Wiederholungsversuch den Fehler beseitigt.

Wie kann ich die Brazil Police Report-App trennen?

Trennen Sie Brazil Police Report genauso wie andere Marketplace-Apps. Folgen Sie Marketplace – So trennen Sie eine App vom Cloudbeds PMS. Wenn Sie die App später erneut verbinden, müssen Sie die Konfigurationsdetails für Brazil Police Report erneut eingeben.

Da Sie die Integration Brazil Police Report verbinden, überwachen und Fehler beheben können, nutzen Sie diese Ressourcen für umfassendere FNRH-Anforderungen und allgemeine Anleitungen zur Integration Sync: