Sie befinden sich hier:
APIs für die Verwaltung von Versicherungsgruppenleistungen
Erweitern Sie die Verwaltung Ihrer Versicherungsgruppenleistungen mit APIs.
- Insurance Bulk Census Management (POST)
- Versicherungsgruppen-Zählungsmitglieder (POST, PATCH, DELETE)
- Versicherungsgruppen-Zählungsmitglieder löschen (POST)
- Versicherungspersonenaccounts und -benutzer (POST)
- Versicherungskontakte und -benutzer
- Bewertung von Versicherungsmitgliedern (POST)
- Versicherungsmitgliedspläne (POST)
- Versicherungsmitgliedspläne (PATCH)
- Versicherungsmitgliedspläne löschen (POST)
- Synchronisierung der Versicherungszensuszusammenfassung (POST)
- Berechtigte Pläne für Versicherungsmitglieder (GET)
- Versicherungsvertrag aus Angebot (POST)
- Bewertung der Versicherungsgruppe (POST)
- Individuelle Registrierung (POST)
Insurance Bulk Census Management (POST)
Verwenden Sie die POST-API (Assurance Bulk Census Management), um Gruppenzählungsdaten per Massenvorgang für eine bestimmte Gruppenzählungs-ID zu verarbeiten. Mit dieser API können Versicherer große Mengen an Mitgliedsdaten, einschließlich primärer Mitglieder und Angehöriger, während der Einarbeitung, Verlängerung oder offenen Registrierung effizient verwalten.
Diese API liest Mitgliedsdaten aus der CSV-Datei, die an den Gruppenzählungsdatensatz angehängt ist, validiert den Inhalt und erstellt oder aktualisiert Mitglieder- und abhängige Datensätze. Sie wendet die Duplikatserkennung an, überprüft die primären und abhängigen Beziehungen und führt den Standard-Flow aus, um Gruppenklassenzuweisungen und die Plankonfiguration anzuwenden. Verwenden Sie diese API, wenn Sie große Zähldateien verarbeiten müssen, statt Mitglieder einzeln hinzuzufügen.
Im Hintergrund ruft die API den Flow "Census Member Data" (Daten der Zählungsmitglieder verarbeiten) auf, der Datensätze von Zählungsmitgliedern validiert, umwandelt und speichert. Sie können diesen Flow entsprechend Ihren Geschäftsanforderungen erweitern und anpassen.
Sie können diese API als Teil automatisierter Registrierungs-Workflows verwenden, bei denen Zähldaten von HR-Systemen oder Drittanbieteradministratoren erfasst werden. Nach der Verarbeitung sind die daraus resultierende Gruppenzählung und die zugehörigen Datensätze für nachgelagerte Vorgänge wie Plankonfiguration, Gruppenbewertung, Angebotserstellung und Richtlinienerstellung verfügbar.
Funktionsweise
- Ruft Zensus-Metadaten und die angehängte CSV-Datei ab.
- Validiert Mitgliedszeilen für erforderliche Daten und übergeordnete und untergeordnete Zuordnungen.
- Aktualisiert vorhandene Mitglieder und erstellt neue Mitglieder.
- Erfasst Fehler und gibt sie in der API-Antwort zurück oder speichert sie zur Überprüfung.
- Aktualisiert bei Registrierungszählungstypen auch Plandetails anhand von Geschäftsregeln.
Wann es verwendet werden soll
- Hochladen einer neuen Zähldatei für eine Gruppenrichtlinie.
- Wiederverarbeiten einer korrigierten CSV-Datei nach der Behebung von Validierungsfehlern.
- Automatisieren von Workflows für die Einarbeitung, bei denen Zensusdaten aus externen HR- oder Gehaltsabrechnungssystemen stammen.
Versicherungsgruppen-Zählungsmitglieder (POST, PATCH, DELETE)
Verwenden Sie die API für Mitglieder der Zählung von Versicherungsgruppen (POST, PATCH, DELETE), um Mitgliedsdatensätze innerhalb einer bestimmten Gruppenzählung hinzuzufügen, zu aktualisieren oder zu löschen.
- Verwenden Sie POST, um einer Gruppenzählung ein oder mehrere Mitglieder und ihre Angehörigen hinzuzufügen.
- Aktualisieren Sie vorhandene Mitgliedsdetails mithilfe von PATCH.
- Verwenden Sie DELETE, um alle Mitglieder aus einer angegebenen Gruppenzählung zu entfernen.
Die API verarbeitet sowohl primäre Mitglieder als auch abhängige Mitglieder und wendet die erforderlichen Validierungsregeln an, um die Zählung genau, konsistent, bewertet oder in Anführungszeichen gesetzt zu halten. Er wertet Beziehungen zwischen primären und abhängigen Mitgliedern aus, führt die Duplikatserkennung aus und wendet Gruppenklassen- und Registrierungslogik über den Flow "Daten der Zählung von Mitgliedern verarbeiten" an, sofern Sie keinen anderen Flow angeben.
Die API verwendet die groupCensusId im Pfad und verarbeitet nur die in der Anforderung angegebenen Mitgliedsdatensätze. Sie verwenden diese API in der Regel bei der Einarbeitung neuer Mitgliedsdaten, der Korrektur demografischer Felder wie Name, Geburtsdatum oder Gruppenklasse oder der Vorbereitung der Zählung für nachgelagerte Schritte wie die Planauswahl.
Die DELETE-Methode entfernt alle Mitglieder, die mit der angegebenen groupCensusId verknüpft sind. Dies unterscheidet sich von der POST-API (Census Members Delete für Versicherungsgruppenmitglieder), die nur die einzelnen Mitglieder löscht, deren IDs Sie in der Anforderung angeben. Verwenden Sie DELETE, wenn Sie die vollständige Zählung vor der erneuten Verarbeitung löschen und zurücksetzen müssen, und verwenden Sie die API zum gezielten Löschen, wenn Sie nur bestimmte Mitglieder entfernen möchten.
Löschen von Mitgliedern der Zählung von Versicherungsgruppen (POST)
Verwenden Sie die POST-API (Census Members Delete) für Versicherungsgruppen, um ein oder mehrere Zählungsmitglieder zu entfernen, die einer bestimmten Gruppen-Zensus-ID zugeordnet sind. Diese API hilft Versicherern, die Zähldaten sauber und genau zu halten, indem sie Mitglieder entfernen, die für Registrierungs-, Bewertungs- oder Angebotsprozesse nicht mehr geeignet, aktiv oder relevant sind.
Wenn ein Mitglied gelöscht wird, werden auch alle zugehörigen abhängigen Datensätze entfernt. Gelöschte Datensätze können nicht wiederhergestellt werden. Verwenden Sie daher diese API, wenn ein Mitglied vollständig aus zählungsbasierten Prozessen wie Plankonfiguration, Gruppenbewertung oder Vertragserstellung ausgeschlossen werden muss. In der Anforderung geben Sie die IDs der Gruppenzensusmitglieder für die Mitgliedsdatensätze an, die Sie löschen möchten.
Accounts und Benutzer von Versicherungspersonen (POST)
Verwenden Sie die POST-API (Versicherungspersonenaccounts und -benutzer), um Personenaccounts und Portalbenutzer für Gruppenzählungsmitglieder zu erstellen. Der Personenaccount wird verwendet, um das Mitglied mit der entsprechenden Richtlinie zu verknüpfen, und der Portalbenutzer ermöglicht es dem Mitglied, sich beim Kunden-Community-Portal anzumelden.
Nachdem Datensätze erstellt und die erforderlichen Berechtigungssätze zugewiesen wurden, können Mitglieder auf das Community-Portal zugreifen, um Informationen über sich selbst, abhängige Personen und vorhandene Richtlinien basierend auf dem vom Systemadministrator konfigurierten Workflow anzuzeigen. Sie können die Portalerfahrung auch verwenden, um Pläne zu konfigurieren und ihre Registrierung anhand der Konfiguration des digitalen Workflows des Anbieters abzuschließen.
Diese API kann Personenaccounts für alle Mitglieder in einer Gruppenzählung oder für eine bestimmte Liste von Volkszählungsmitgliedern erstellen. Sie unterstützt die Duplikatserkennung, um zu vermeiden, dass mehrere Accounts für dieselbe Person erstellt werden, und verwendet Feldzuordnungen, um die Daten von Zählungsmitgliedern mit Accountfeldern abzugleichen.
Versicherungskontakte und -benutzer
Verwenden Sie die POST-API (Versicherungskontakte und -benutzer), um Kontaktdatensätze und optionale Portalbenutzer für Gruppenzählungsmitglieder zu erstellen. Mit dieser API können Daten von Zensusmitgliedern in Salesforce-Standardkontaktdatensätze konvertiert werden, die an Registrierungs-, Kommunikations- und Richtlinienprozessen teilnehmen können. Wenn Portalbenutzer erstellt werden, können Mitglieder auf die Kunden-Community zugreifen, um Pläne zu überprüfen oder Self-Service-Registrierungsschritte abzuschließen.
Diese API unterstützt die Verarbeitung aller Mitglieder einer Gruppenzählung oder bestimmter in der Anforderung identifizierter Mitglieder. Sie verhindert die doppelte Kontakterstellung, indem sie übereinstimmende Felder verwendet, und wendet Feldzuordnungen an, um die Daten der Zählungsmitglieder mit den Kontaktfeldern abzugleichen. Nachdem die Kontakt- und Portalbenutzerdatensätze erstellt und die erforderlichen Berechtigungssätze zugewiesen wurden, können Mitglieder auf das Community-Portal zugreifen, um Pläne zu überprüfen und ihre Registrierung abzuschließen.
Sie können diese API auch in den Gruppenregistrierungs-Flow integrieren, um die Erstellung von Portalbenutzern während des Registrierungsprozesses zu automatisieren. Durch Anpassen der aufrufbaren Aktion "Kontakte erstellen" und "Benutzer aus Gruppenzählung" oder "Mitglieder" im Registrierungs-Flow können Sie "Portalbenutzer erstellen" auf true festlegen und eine gültige Profil-ID angeben. Dadurch wird die automatische Erstellung von Portalbenutzern für jedes Mitglied ermöglicht, wenn Registrierungsdaten verarbeitet werden.
Konfigurieren Sie für die Batchverarbeitung einen Batchauftrag, der auf den benutzerdefinierten Registrierungs-Flow verweist. Der Batchauftrag erstellt Portalbenutzer für primäre Mitglieder per Massenvorgang basierend auf ihren Gruppenzählungsdatensätzen.
Bewertung von Versicherungsmitgliedern (POST)
Verwenden Sie die API für die Bewertung von Versicherungsmitgliedern, um Prämien und Beitragsbeträge für einzelne Mitglieder in einer Gruppenzählung zu berechnen. Diese API wertet die ausgewählten Pläne und Abdeckungen jedes Mitglieds aus, bestimmt die Preise auf Abdeckungsebene und führt diese Beträge auf Plan- und Mitgliedsebene zu.
Die API unterstützt die Berechnung von Mitarbeiter- und Arbeitgeberbeiträgen und ist somit ein wichtiger Schritt vor der Registrierung oder Gruppenbewertung.
Die API verwendet die Plan- und Abdeckungsdaten des Mitglieds als Eingabe und gibt die berechneten Prämien und Beiträge zurück. Jede Antwort enthält detaillierte Preisergebnisse, Beitragsbeträge und Fehlermeldungen, die während der Bewertung auftreten.
Verwenden Sie diese API in folgenden Fällen:
- Berechnen Sie Prämien und Beiträge auf Mitgliederebene vor der Registrierung.
- Validieren Sie die Preise oder zeigen Sie eine Vorschau der Preise für ausgewählte Pläne und Abdeckungen an.
Versicherungsmitgliedspläne (POST)
Verwenden Sie POST, um neue Pläne für ein Gruppenzählungsmitglied hinzuzufügen. Die Anforderung enthält die Mitglieds-ID und eine Liste der hinzuzufügenden Pläne. Die API fügt alle angegebenen Pläne in einem einzigen Vorgang hinzu und gibt die aktualisierte Planliste des Mitglieds sowie Fehler zurück, die während der Verarbeitung aufgetreten sind.
Versicherungsmitgliedspläne (PATCH)
Verwenden Sie PATCH, um vorhandene Planauswahlen für ein Mitglied zu aktualisieren, indem Sie neue Pläne hinzufügen oder vorhandene löschen.
Die API verarbeitet alle Änderungen als einzelne Transaktion, sodass entweder alle Aktualisierungen erfolgreich sind oder keine angewendet werden. Die Antwort listet auf, welche Pläne aktualisiert oder entfernt wurden, und enthält Validierungsfehler.
Wenn sich ein primäres Mitglied für einen Plan anmeldet, erhalten abhängige Mitglieder nicht automatisch dieselbe Planauswahl. Abhängigkeiten können denselben Plan mit unterschiedlichen Abdeckungsoptionen auswählen oder sich von der Plankategorie abmelden.
Wenn das primäre Mitglied seine Planauswahl ändert, werden alle abhängigen Planauswahlen für diesen Plan entfernt und müssen neu konfiguriert werden. Wenn sich ein primäres Mitglied von einer Plankategorie abmeldet, können sich Angehörige nicht für diese Kategorie registrieren.
Löschen von Versicherungsmitgliedsplänen (POST)
Verwenden Sie die POST-API (Insurance Member Plans Delete), um einen oder mehrere Pläne für ein Gruppenzählungsmitglied zu löschen. Diese API entfernt die angegebenen Mitgliedsplan-Datensätze und ihre zugehörigen Details aus der Gruppenzählung.
Wenn Sie eine Stammplan-ID als Eingabe angeben, entfernt die API den Plan und alle zugehörigen Abdeckungen für das Mitglied und gibt das Ergebnis der Löschanforderung zurück.
Verwenden Sie diese API, um Pläne zu entfernen, die ein Mitglied nicht mehr möchte, oder um falsche Planauswahlen zu korrigieren. Wenn Sie einen Plan löschen, werden alle zugehörigen Plandatensätze aus der Konfiguration des Mitglieds entfernt.
Synchronisierung der Zusammenfassung der Versicherungszählung (POST)
Verwenden Sie die POST-API (Assurance Census Summary Sync), um Zusammenfassungsdaten für eine Gruppenzählung neu zu berechnen und zu aktualisieren. Diese API aktualisiert die Datensätze "Gruppenzensuszusammenfassung" und "Gruppenzensusgruppen-Klassenzusammenfassung", sodass sie die neuesten Mitglieder- und abhängigen Informationen nach Hinzufügen, Aktualisieren oder Löschen von Vorgängen widerspiegeln.
Die API verwendet die Gruppenzählungs-ID zum Ausführen der Synchronisierung und erfordert keine Anforderungsnutzlast. Sie gibt aktualisierte Zusammenfassungsanzahlen zurück, beispielsweise die Gesamtanzahl der Mitglieder, abhängigen Personen und Abmeldungen, zusammen mit Aufschlüsselungen auf Gruppenklassenebene.
Sie können diese API nach dem Hinzufügen, Aktualisieren oder Löschen von Mitgliedern oder Angehörigen in einer Gruppenzählung verwenden, um sicherzustellen, dass die Zusammenfassungsdaten die neuesten Mitgliederinformationen widerspiegeln.
Anspruchsberechtigte Pläne für Versicherungsmitglieder (GET)
Verwenden Sie die API für berechtigte Versicherungsmitgliederpläne, um die Vertragsgruppenpläne abzurufen, für die ein Gruppenzählungsmitglied und seine Angehörigen berechtigt sind. Die Berechtigung wird durch Konfiguration, beispielsweise Gruppenklassenzuweisungen, und Vertragseinrichtung bestimmt.
Die API verwendet die ID des Gruppenzählungsmitglieds als Eingabe und gibt Plan- und Abdeckungsdetails zurück, die jedem Mitglied auf der Grundlage der für die Gruppenzählung definierten Anspruchsregeln zur Verfügung stehen. Mithilfe des Anforderungsparameters können Sie die abhängige Berechtigung einschließen oder ausschließen. In der Antwort werden die berechtigten Pläne und Abdeckungen jedes Mitglieds nach Produktkategorie sowie Informationen wie Plannamen und Abonnementstatus aufgeführt.
Sie können diese API als Teil des Gruppenregistrierungsprozesses verwenden, um verfügbare Pläne anzuzeigen, bevor Mitglieder ihre Planvoreinstellungen auswählen oder aktualisieren. Dadurch wird sichergestellt, dass jedes Mitglied und jeder abhängige Benutzer nur die Pläne sieht, für die er basierend auf der Gruppenklasse und der Vertragskonfiguration berechtigt ist.
Versicherungsvertrag aus Angebot (POST)
Verwenden Sie die API "Versicherungsvertrag aus Angebot", um einen Gruppenleistungsvertrag aus einem genehmigten Angebot zu erstellen. Diese API konvertiert ein Angebot in einen Vertragsdatensatz mit definierten Laufzeiten, Datumswerten und optionalen zusätzlichen Feldern.
Die API verwendet die Angebots-ID und die Vertragsdetails als Eingabe und gibt eine Antwort zurück, die angibt, ob die Vertragserstellung erfolgreich gestartet wurde, sowie eine Verfolgungs-ID für den asynchronen Auftrag. Im Rahmen des asynchronen Auftrags erstellt die API Vertragsgruppenpläne für jedes der im Angebot konfigurierten Stammprodukte und -abdeckungen sowie Attribute. Gegebenenfalls werden auch Datensätze erstellt, die zur Identifizierung der Gruppenplanberechtigung für Mitglieder anhand ihrer Gruppenklasse verwendet werden.
Die API validiert das Angebot, erstellt den Vertrag und wendet Vertragsdetails wie Start- und Enddatum, Registrierungszeiträume und Laufzeit an. Sie können auch zusätzliche Felder einfügen, um während der Vertragserstellung Werte für Einheiten wie "Vertrag", "Versicherungsvertrag" und "Vertragsgruppenplan" festzulegen.
Sie können diese API nach der Angebotsgenehmigung verwenden, sobald der Kunde der Kaufabdeckung zustimmt. Wenn Sie diese API über einen Flow aufrufen, sollten Sie beim Zuordnen von Ausgaben die Option Variablen manuell zuweisen (erweitert) aktivieren. Das Ausgabefeld asyncBulkRequestId wird bei der automatischen Variablenzuordnung nicht unterstützt.
Versicherungsgruppenbewertung (POST)
Verwenden Sie die API für die Bewertung von Versicherungsgruppen, um Prämien für alle Angebotsbelegposten in einem Gruppenleistungsangebot zu berechnen. Sie können das gesamte Angebot oder bestimmte Stammpläne bewerten, um Prämien für die zugehörigen Angebotsbelegposten zu berechnen.
Die API verwendet die quoteId im Pfad und verwendet Ihre Anforderungseingaben, um den Bewertungsprozess zu starten. Sie können eine Liste mit Angebotsbelegposten-IDs bereitstellen, um bestimmte Produkte zu bewerten, oder die Liste auslassen, um das vollständige Angebot zu bewerten. Sie können auch ein ratingDate senden, um das Preisdatum zu steuern, das für die Berechnung gilt. Die API löst einen asynchronen Bewertungsprozess aus, sodass Sie sofort eine Antwort erhalten, während die Berechnung im Hintergrund fortgesetzt wird.
Die API validiert das Eingabeangebot und verarbeitet die Bewertung mithilfe des Gruppenbewertungsmoduls. Sie berechnet Prämien anhand des Bewertungsdatums und der Konfigurationsregeln, die für die Produkte im Angebot definiert sind.
Verwenden Sie diese API, wenn Sie die Planauswahl abschließen und genaue Prämien für Angebote benötigen oder wenn Sie Mitglieder- oder Abdeckungsdaten aktualisieren und die Preise für einen oder mehrere Pläne aktualisieren möchten.
Einzelpersonenregistrierung (POST)
Verwenden Sie die POST-API (Individual Enrollment), um ein Gruppenzählungsmitglied in einem Gruppenleistungsversicherungsplan zu registrieren und die entsprechenden Policendatensätze zu erstellen. Die API verarbeitet die Registrierung für ein primäres Mitglied und dessen Angehörige unter dem angegebenen Stammvertragsgruppen-Plan.
Die API verwendet die memberId im Pfad und die Plan-ID, die Sie in der Anforderung angeben. Sie können auch einen flowName angeben, um eine benutzerdefinierte Registrierungslogik auszuführen, oder sich auf den standardmäßigen Flow "Census Member Data" (Daten des Mitglieds der Prozessgruppe) verlassen. Die API validiert die Mitglieds- und Plandetails, überprüft die Berechtigung, wendet Registrierungsregeln an und generiert einen oder mehrere Policendatensätze für die Familie.
Sie können diese API als Teil des individuellen Registrierungs-Workflows verwenden, bei dem Mitglieder berechtigte Pläne überprüfen, Prämien und Beiträge anzeigen und ihre Registrierung abschließen. Die API automatisiert die Richtlinienerstellung für ausgewählte Pläne, sobald die Validierung der Berechtigungen und Bewertungen abgeschlossen ist.
