Identifizieren des ClaimContact

Es gibt mehrere Möglichkeiten, einem Schadenfall ClaimContact-Informationen hinzuzufügen. Sie haben folgende Möglichkeiten:

  • Einen neuen ClaimContact erstellen und dessen Rolle angeben
  • Im Policenverwaltungssystem eine Rolle für einen Kontakt angeben, der sich auf der Police befindet
  • Eine Rolle für einen ClaimContact angeben, der sich bereits im Schadenfall befindet

Jeder dieser Ansätze verwendet eine andere Eigenschaft, um den ClaimContact zu identifizieren.

Erstellen eines neuen ClaimContact und Angeben von dessen Rolle

Sie können einen neuen ClaimContact erstellen und seine Rolle in denselben Nutzdaten durch Anforderungseinschluss angeben. Wenn Sie diesen Ansatz verwenden, identifizieren Sie den ClaimContact durch refid. Weitere Informationen zu diesem Thema finden Sie unter Anforderungseinschluss.

Das folgende Beispiel sind die Nutzdaten für ein PATCH an einem bestehenden Schadenfall mit der ID cc:402. Dieses PATCH erstellt einen neuen ClaimContact und legt den Meldenden des Schadenfalls auf diesen ClaimContact fest. Beachten Sie, dass der für refid verwendete Wert „newContact“ willkürlich ist. Es kann jeder Wert verwendet werden, solange der gleiche Wert für die refid des Meldenden im data-Abschnitt und für die refid im included-Abschnitt des ClaimContact verwendet wird.

PATCH /claim/v1/claim/cc:402

{
  "data": {
    "attributes": {
      "reporter": {
        "refid": "newContact"
      }
    }
  },
  "included": {
    "ClaimContact": [
      {
        "refid": "newContact",
        "attributes": {
            "contactSubtype": "Person",
            "firstName": "Carol",
            "lastName": "Daniels"
        },
        "method": "post",
        "uri": "/claim/v1/claims/cc:402/contacts"
      }   
    ]
  }
}

Angeben einer Rolle für einen ClaimContact, der sich bereits im Schadenfall befindet

Wenn in ClaimCenter ein ClaimContact erstellt wird, wird ihm eine id zugewiesen. Dieser Wert ist die öffentliche ID des ClaimContact in ClaimCenter.

ClaimContact-Rollen können über das Feld id angegeben werden. Dies ist nützlich, wenn die aufrufende Anwendung die Nutzdaten für ein PATCH an einem vorhandenen Schadenfall erstellt, der ClaimContact für den Schadenfall bereits vorhanden ist und die aufrufende Anwendung den Wert der id des ClaimContact kennt.

Das folgende Beispiel sind die Nutzdaten für ein PATCH an einem bestehenden Schadenfall. Dieses PATCH setzt den reporter (Meldenden) des Schadenfalls auf den ClaimContact, dessen id cc:202 lautet.

{
  "data": {
    "attributes": {
      "reporter": {
        "id": "cc:202"
      }
    }
  }
}

Angeben einer Rolle für einen Kontakt, der sich im Schadenfall befindet

Wenn ein Schadenfallentwurf zunächst per POST an ClaimCenter übergeben wird, werden Informationen zur Police aus dem Policenverwaltungssystem nach ClaimCenter kopiert. Dazu gehören in der Regel die in der Police aufgeführten Kontakte.

Policensystem-IDs

Eines der Policenkontaktattribute, das in ClaimCenter kopiert wird, ist die Policensystem-ID des Kontakts. Die Policensystem-ID ist ein Wert, der einen bestimmten Objekttyp in der Police eindeutig identifiziert. Beispiel: Für eine bestimmte Police darf die Policensystem-ID jedes Kontakts nur von einem Kontakt verwendet werden.

Der Wert, der als die Policensystem-ID verwendet wird, wird durch den Integrationscode bestimmt, der die Policeninformationen nach ClaimCenter kopiert. Dieser Code wird während der Implementierung geschrieben und unterscheidet sich für jeden Versicherer und jedes Policenverwaltungssystem. Eine Policensystem-ID muss nicht im gesamten Policenverwaltungssystem eindeutig sein. Sie muss jedoch in allen Instanzen des jeweiligen Objekttyps einer bestimmten Police eindeutig sein.

Festlegen von Rollen nach Policensystem-ID

In den System-APIs lautet der Name des Policensystem-ID-Felds policySystemId. Die Angabe von Rollen über policySystemId ist unter folgenden Umständen hilfreich:

  • Die aufrufende Anwendung erstellt die Nutzdaten für den ersten POST /claims und möchte einen vorhandenen ClaimContact und seine Rolle in die Nutzdaten einbeziehen. Zu diesem Zeitpunkt wurden die Policeninformationen (einschließlich der Policenkontakte) noch nicht nach ClaimCenter kopiert. Daher hat der relevante Kontakt noch keine ClaimCenter-ID.
  • Die aufrufende Anwendung erstellt die Nutzdaten für ein PATCH an einem vorhandenen Schadenfallentwurf oder offenen Schadenfall. Die Anwendung kennt die Policensystem-ID aus einem vorherigen Aufruf des Policenverwaltungssystems und möchte kein separates GET ausführen, um die ClaimCenter-ID abzurufen. Daher identifiziert sie den ClaimContact anhand der Policensystem-ID.
Anmerkung: Bei allen Ressourcenfeldnamen wird zwischen Groß- und Kleinschreibung unterschieden. Im Gegensatz zu refid und id, bei denen das i (als Kleinbuchstabe) verwenden wird, wird bei policySystemId das I (als Großbuchstabe) verwendet.

Das folgende Beispiel sind die Nutzdaten für ein PATCH an einem bestehenden Schadenfall. Dieses PATCH setzt den reporter (Meldenden) des Schadenfalls auf den ClaimContact, dessen Policensystem-ID ab:0001-1 lautet.

{
  "data": {
    "attributes": {
      "reporter": {
        "policySystemId": "ab:0001-1"
      }
    }
  }
}