Suchen nach aktiven und archivierten Schadenfällen

Eine aufrufende Anwendung kann nach einem oder mehreren Schadenfällen suchen, die nicht mit dem Aufrufer verknüpft sind, die archiviert sind oder die anderweitig nicht in den Ergebnissen von GET /claims angezeigt werden. Verwenden Sie den Endpunkt POST /claim/v1/search/claims-v2, um eine Zusammenfassung der Schadenfalleigenschaften zurückzugeben.

Die Namenskonvention des Endpunkts POST /claim/v1/search/claims-v2 unterscheidet ihn vom ursprünglichen Suchendpunkt POST /claim/v1/search/claims. Der ursprüngliche Suchendpunkt ist noch funktionsfähig, aber /claim/v1/search/claims-v2 bietet zusätzliche Anforderungsparameter und detailliertere Antwort-Nutzdaten, die archivierte Fälle enthalten können.

Archivierte Schadenfälle oder Schadenfälle, die aus dem Archiv abgerufen werden, werden niemals in den Ergebnissen von GET /claims angezeigt. Um nach archivierten Schadenfällen zu suchen, müssen Sie /claims/search-v2 verwenden und die entsprechenden Felder für die Suche nach archivierten Schadenfällen festlegen.

Weitere Informationen zur Datenarchivierung finden Sie im Guidewire Data Archiving.

Beachten Sie, dass ein Aufrufer mit /search/claims-v2 nach einem Schadenfall suchen kann, jedoch möglicherweise keinen Zugriff auf den Schadenfall selbst hat. Wenn der Aufrufer nicht über die Berechtigung zum Anzeigen des Schadenfalls verfügt, kann er die Zusammenfassung des Schadenfalls über POST /search/claims-v2 anzeigen, den Schadenfall jedoch nicht über GET /claims/{claimId} anzeigen.

Anfordern von Nutzdaten für eine Schadenfallsuche

Das Anforderungsobjekt für einen POST /claim-/v1-/search/claims-v2-Aufruf muss einen Text enthalten. Der Text muss Suchparameter mit der folgenden Syntax angeben:

{
  "data": {
    "attributes": {
      "archivedSearch": booleanValue,
      "claimNumber": "stringValue",
      "companyName": "stringValue",
      "firstName": "stringValue",
      "lastName": "stringValue",
      "nameSearchType": {
        "code": " ClaimSearchNameSearchTypeCode ",
      },
      "policyNumber": "stringValue",
      "taxId": "stringValue"
    }
  }
}

Sie müssen eines der folgenden Felder für ein Minimum an Anforderungs-Nutzdaten angeben:

Anmerkung:

Das Feld companyName und das Feld firstName/lastName können nicht in denselben Anforderungs-Nutzdaten enthalten sein.

  • claimNumber
  • companyName
    • nameSearchType (optional)
  • firstName
  • lastName
    • nameSearchType (optional)
  • policyNumber
  • taxID
    • nameSearchType (optional)

Die folgenden Nutzdaten suchen beispielsweise nach allen Schadenfällen, die mit der Policennummer 54-123456 verknüpft sind:

POST /claim/v1/search/claims-v2 
{
  "data": {
    "attributes": {
      "policyNumber": "54-123456"
    }
  }
}

Die folgenden Nutzdaten suchen nach allen Schadenfällen, bei denen ein Anspruchsteller mit dem Vornamen „Ray“ und dem Nachnamen „Newton“ vorliegt:

{
  "data": {
    "attributes": {
      "firstName": "Ray",
      "lastName": "Newton"
    }
  }
}

Suchen nach archivierten Schadenfällen

Um nach archivierten Schadenfällen zu suchen, fügen Sie das Feld archivedSearch hinzu und setzen das Feld auf „true“. Anforderungs-Nutzdaten, die nicht das Feld archivedSearch enthalten (oder bei denen archivedSearch auf „false“ gesetzt ist), suchen automatisch nur nach aktiven Schadenfällen.

Anmerkung:
Wenn die Archivierung für Ihre Instanz von ClaimCenter nicht aktiviert ist, geben die Antwort-Nutzdaten einen 400-Fehler zurück. Beachten Sie, dass die Archivierung in der Fehlermeldung nicht explizit erwähnt wird:
{
    "status": 400,
    "errorCode": "com.guidewire.pl.modules.rest.framework.v1.exceptions.OperationNotCurrentlyAllowedException",
    "userMessage": "The operation is not currently allowed for this resource"
}

Suchen nach Name und Steuernummer

Wenn die Nutzdaten entweder firstName, lastName, companyName oder taxID enthalten, besteht das Standardverhalten darin, nach Schadenfällen zu suchen, bei denen ein Anspruchsteller mit diesem Vornamen, Nachnamen, Unternehmensnamen oder dieser Steuernummer vorliegt.

Sie können auch den Parameter nameSearchType verwenden, um Suchen auszuführen, bei denen die benannte Person entweder der Versicherte oder ein Mitversicherter ist oder eine Rolle für den Schadenfall hat. Geben Sie dazu einen der folgenden Codes für den Code ClaimSearchNameSearchType ein:

  • addinsured (Mitversicherter)
  • any (alle Rollen des Schadenfalls, einschließlich der Rollen, die über den Mitversicherten, Anspruchsteller und Versicherten hinausgehen)
  • claimant (dies ist das Standardverhalten)
  • insured

Beispiel: Die folgenden Nutzdaten suchen nach allen Schadenfällen, bei denen ein Anspruchsteller mit dem Vornamen „Ray“ und dem Nachnamen „Newton“ vorliegt: Der nameSearchType verwendet ein Feld aus dem Code ClaimSearchNameSearchType:

POST /claim/v1/search/claims-v2 

{
  "data": {
    "attributes": {
      "firstName": "Ray",
      "lastName": "Newton",
      "nameSearchType": {
        "code": "insured"
      }
    }
  }
}

Die folgenden Nutzdaten suchen nach allen archivierten Schadenfällen, bei denen der Versicherte den Unternehmensnamen „Wright Construction“ hat:

{
  "data": {
    "attributes": {
      "archivedSearch": true,
      "companyName": "Wright Construction",
    }
  }
}

Antwort-Nutzdaten für eine leere Schadenfallsuche

Für die System-APIs müssen Sie keine Suchparameter angeben, aber ClaimCenter führt keine Schadenfallsuche ohne Suchparameter aus. Wenn Sie versuchen, eine Schadenfallsuche ohne Suchparameter über die Benutzeroberfläche oder über eine System-API auszuführen, gibt ClaimCenter die folgende Fehlermeldung zurück:

Please specify Claim #, Policy #, any Contact field, Assigned To Group, Assigned To User, Created By, Cat #, VIN or License Plate

Beachten Sie, dass diese Nachricht in erster Linie für die Suche nach Schadenfällen in der Benutzeroberfläche vorgesehen ist. Daher verweist sie auf Felder, die für den Endpunkt /claim/v1/search/claims-v2 nicht verfügbar sind, z. B. Zugewiesen an Gruppe, Zugewiesen an Benutzer und Erstellt von.

Antwort-Nutzdaten für eine Schadenfallsuche

Die Endpunkte /claim/v1/claims und /claim/v1/claims/{claimId} geben einen Schadenfall oder eine Sammlung von Schadenfällen zurück. Der Endpunkt claim/v1/search/claims-v2 gibt eine Auflistung im ClaimSearchResultWrapper zurück. Folglich gibt der Endpunkt die Nutzdaten mit einer etwas anderen Struktur zurück.

Die folgende Tabelle zeigt die wichtigsten Unterschiede.

Informationen Beispiel für Schadenfall-Nutzdaten Beispiel für ClaimSearchResultWrapper-Nutzdaten
Eigentümer des Schadenfalls
"assignedUser": {
  "displayName": "Andy Applegate",
  "id": "demo_sample:1"
}
"adjusterName": "Andy Applegate"
Schadenfall-ID
"id": "cc:33",
"claimId": "cc:33"
Versicherter
"insured": {
    "displayName": "Bill Kinman ",
    "id": "cc:33",
    "uri": "/claim/v1/claims/cc:33/
            contacts/cc:101"
}
"insuredName": "Bill Kinman"
Anspruchsteller
"included": {
  "ClaimContact": [
    {
      "attributes": {
   	  ...
        "id": "cc:101",
        "roles": [
        {
          "relatedTo": {
            "id": "cc:47",
            "type": "Exposure"
          },
          "role": {
            "code": "claimant"
          }
        },
       ...
"claimants": [
  "Bill Kinman"
  ],
Anmerkung:

Mithilfe von Abfrageparametern können Sie die Antwort-Nutzdaten verfeinern, um Standardfelder auszuschließen und Nicht-Standardfelder einzuschließen. Weitere Informationen finden Sie unter Verfeinern von Antwort-Nutzdaten.

Je nachdem, ob die Suche nach archivierten oder aktiven Schadenfällen durchgeführt wurde, variieren die Antwort-Nutzdaten.

In den folgenden Abschnitten werden die Unterschiede zwischen den Suchergebnissen für archivierte und aktive Schadenfälle beschrieben.

Suchergebnisse für aktive Schadenfälle

Im folgenden Beispiel suchte ein Versicherungsnehmer nach allen Schadenfällen, die mit Bill Kinman verknüpft sind:

  • adjusterName gibt den Namen Benutzers an, der dem Schadenfall zugewiesen ist
  • assignedGroup stellt die dem Schadenfall zugewiesene Gruppe bereit
  • claimID
  • claimNumber
  • Eine Liste der claimants
  • Das flagged Feld, das angibt, ob der Schadenregulierer eine eindeutige Markierungsanweisung für den Schadenfall bereitgestellt hat
  • futurePayments sind die für das Senden geplanten Zahlungen
  • insuredName
  • lossDate des Schadenfalls
  • Der paid Gesamtbetrag
  • policyNumber des Schadenfalls
  • remainingReserves, die für den Schadenfall verbleiben
  • status des Schadenfalls: ob er offen oder geschlossen ist
{
    "count": 1,
    "data": [
        {
            "attributes": {
                "adjusterName": "Andy Applegate",
                "assignedGroup": "Auto1 - TeamA",
                "claimId": "cc:SO",
                "claimNumber": "235-53-425891",
                "claimants": [
                    "Bill Kinman"
                ],
                "flagged": true,
                "futurePayments": {
                    "amount": "0.00",
                    "currency": "usd"
                },
                "insuredName": "Bill Kinman",
                "lossDate": "2021-02-28T00:00:00.000Z",
                "paid": {
                    "amount": "0.00",
                    "currency": "usd"
                },
                "policyNumber": "4775949863-02",
                "remainingReserves": {
                    "amount": "0.00",
                    "currency": "usd"
                },
                "status": {
                    "code": "open",
                    "name": "Open"
                }
            }
        },

Suchergebnisse für archivierte Schadenfälle

Suchergebnisse für archivierte Schadenfälle liefern ähnliche Ergebnisse wie die Suche nach aktiven Schadenfällen, beinhalten aber auch auf die Archivierung bezogene Felder. Zu diesen auf die Archivierung bezogenen Feldern gehören:

  • Der archiveState des Schadenfalls, der angibt, ob der Schadenfall archiviert ist oder in einen aktiven Schadenfallstatus zurückkehrt
  • Ob der Schadenfall archived wurde oder nicht (immer „true“)
  • Der archivedAdjuster, der den Schadenregulierer angibt, der die Archivierung durchgeführt hat
  • Die claimInfoID, welche die Identifikationsnummer des claimInfo-Objekts angibt, welches das Abrufen des archivierten Schadenfalls ermöglicht

Unterschiede zwischen Suchversionen

In der folgenden Tabelle werden die Unterschiede in den Suchfunktionen zwischen dem Endpunkt claim/v1/search/claims-v2 und dem Endpunkt claim/v1/search/claims beschrieben.

Suchfunktion claim/v1/search/claims-v2

claim/v1/search/claims

Suchen nach archivierten Schadenfällen
Suchen nach Steuernummer
Suchen nach Geschäftsname
Suchen nach Schadenfällen unabhängig von der Zuordnung zum Benutzer