Erstellen von Teilschäden

Damit ein Teilschaden zuweisbar ist, muss er mindestens Folgendes aufweisen:

• eine Deckung und einen Deckungsuntertyp
• einen Anspruchsteller
• einen Vorfall

Die exposure-Ressource verfügt auch über ein coverage-Attribut, welches das coverage-Objekt in der Police identifiziert. Dies ist kein erforderliches Attribut. Es gibt jedoch Funktionen in ClaimCenter, für die dieses Attribut festgelegt werden muss, damit sie ordnungsgemäß funktionieren. Beispielsweise funktioniert die Abwicklung von Selbstbehalten nur, wenn der Teilschaden mit dem entsprechenden coverage-Objekt verknüpft ist, sodass ClaimCenter ermitteln kann, ob und in welcher Höhe die Deckung einen Selbstbehalt hat. Daher empfiehlt Guidewire, immer das coverage-Attribut des Teilschadens festzulegen.

Das folgende JSON-Gerüst fasst diese Komponenten so zusammen, wie sie in Anforderungs-Nutzdaten für ein POST /exposures angezeigt werden.

{
    "data": {
        "attributes": {
            "primaryCoverage": {
                "code": "..."
            },
            "coverageSubtype": {
                "code": "..."
            },
            "claimant": {
                "id" / "refid" / "policySystemId": "..."
            },
            "...Incident": {
                "id" / "refid": "..."
            },
            "coverage": {
                "id": "..."
            }
        }
    },
    "included": {
        "...Incident": ...
        "ClaimContact": ...
    }
}

Beachten Sie die folgenden Punkte:

• Die Deckung und der Deckungsuntertyp werden durch Typencodes aus den Typenlisten CoverageType und CoverageSubtype identifiziert.
• Auf den Anspruchsteller kann durch Folgendes verwiesen werden:
  • id, wenn der Anspruchsteller bereits für den Schadenfall existiert
  • refid, wenn der Anspruchsteller in denselben Nutzdaten wie der Teilschaden erstellt wird
  • policySystemId, wenn der Anspruchsteller in der Police aufgeführt ist
• Der Teilschaden muss auf einen Vorfall verweisen. Der Vorfalltyp variiert je nach Deckung.
• Auf den Vorfall kann durch Folgendes verwiesen werden:
  • id, wenn der Vorfall für den Schadenfall bereits vorhanden ist
  • refid, wenn der Vorfall in denselben Nutzdaten wie der Teilschaden erstellt wird
• Die Deckung ist optional. Guidewire empfiehlt jedoch, sie immer einzubeziehen, da einige ClaimCenter-Funktionen sie erfordern, damit sie erwartungsgemäß funktionieren.

Um Teilschaden-Nutzdaten zu erstellen, müssen Sie folgende Schritte durchführen:

1. Identifizieren des Deckungstyps
2. Identifizieren des Deckungsuntertyps
3. Anspruchsteller erstellen oder identifizieren
4. Vorfall erstellen oder identifizieren
5. Identifizieren der Deckung

Beachten Sie, dass jedes Element in der vorherigen Liste nicht notwendigerweise einem einzelnen Codeblock zugeordnet ist. Wenn es an der Zeit ist, den Teilschaden zu erstellen, verfügt die aufrufende Anwendung möglicherweise bereits über die erforderlichen Informationen. Darüber hinaus kann die aufrufende Anwendung ClaimCenter in einem einzigen Aufruf nach mehreren Informationen abfragen.

Wenn die aufrufende Anwendung den Deckungstyp nicht kennt, kann sie mithilfe des GET /claims/{claimId}/policy-Endpunkts die mit dem Honda Civic verknüpften Deckungen ermitteln.

GET  http://localhost:8080/cc/rest/claim/v1/claims/demo_sample:8037/policy/vehicle-risk-units?fields=*all

"RUNumber": 1,
  "coverages": [
    {
      ...
      "coverageType": {
        "code": "PACollisionCov",
        "name": "Collision"
        }
       ...
    }
  ],
  "id": "cc:9",
  "vehicle": {
    ...
    "id": "demo_sample:4",
    "make": "Honda",
    "model": "Civic"
    ...

{
    "data": {
        "attributes": {
            "primaryCoverage": {
                "code": "PACollisionCov"
            },
            ...

Der Satz der ClaimCenter-Deckungstypen und -Deckungsuntertypen ändert sich selten. Um die Anzahl der Aufrufe zu reduzieren, können Sie die möglichen Deckungstypen und Deckungsuntertypen lokal in der aufrufenden Anwendung speichern.

Die aufrufende Anwendung kann entweder während der Entwicklung oder zum Zeitpunkt der Erstellung des Teilschadens die Deckungsuntertypen für eine bestimmte Deckung bestimmen, indem sie den GET /typelists-Endpunkt der Common API ausführt. Um die Antwort auf nur die Deckungsuntertypen für einen bestimmten Deckungstyp zu beschränken, kann der Aufruf die Typenliste CoverageSubtype mithilfe des CoverageType des Teilschadens (z. B. PACollisionCov) filtern.

Weitere Informationen zum GET //typelists-Endpunkt der Common API finden Sie unter Die /typelists-Endpunkte.

GET  http://localhost:8080/cc/rest/common/v1/typelists/CoverageSubtype
         ?typekeyFilter=category:cn:CoverageType.PACollisionCov    

"description": "Subtype of coverage, filtered by CoverageType",
"name": "CoverageSubtype",
"typeKeys": [
  {
    "code": "PACollisionCov",
    "description": "Collision",
    "name": "Collision",
    "priority": -1
  }
]

{
    "data": {
        "attributes": {
            "primaryCoverage": {
                "code": "PACollisionCov"
            },
            "coverageSubtype": {
                "code": "PACollisionCov"
            },
            ...

Wenn der Anspruchsteller in der Police vorhanden ist, können die Nutzdaten den Anspruchsteller anhand seiner policySystemId identifizieren. Gegebenenfalls kann die aufrufende Anwendung das Policenverwaltungssystem die policySystemId abfragen.

Wenn der Anspruchsteller nicht bereits vorhanden ist, kann die aufrufende Anwendung einen neuen ClaimContact in den POST /exposures-Anforderungs-Nutzdaten erstellen und dann mithilfe einer refid auf diesen ClaimContact verweisen. Diese Vorgehensweise wird als Anforderungseinschluss bezeichnet. Weitere Informationen finden Sie unter Anforderungseinschluss.

Wenn der Anspruchsteller in ClaimCenter vorhanden ist, können die Nutzdaten den Anspruchsteller anhand seiner id identifizieren. Bei Bedarf kann die aufrufende Anwendung ClaimCenter nach der id abfragen.

In diesem Beispiel wurde der Anspruchsteller bereits in ClaimCenter kopiert. Daher identifizieren die Nutzdaten den Anspruchsteller anhand der ClaimCenter-id.

GET  http://localhost:8080/cc/rest/claim/v1/claims/demo_sample:8037/contacts

{
  "attributes": {
    ...
    "displayName": "Allen Robertson",
    "id": "cc:32",
    ...
    },

{
    "data": {
        "attributes": {
            "primaryCoverage": {
                "code": "PACollisionCov"
            },
            "coverageSubtype": {
                "code": "PACollisionCov"
            },
            "claimant": {
                "id": "cc:32"
            },
            ...

Ein Vorfall ist eine Sammlung von Informationen, in der Regel über ein verloren gegangenes oder beschädigtes Objekt. Vorfälle können auf Objekte in einer Police verweisen. (Ein Kfz-Vorfall kann beispielsweise auf ein Fahrzeug in der Police verweisen.) Vorfälle werden jedoch nie in Policen angezeigt. Vorfälle gibt es nur in ClaimCenter.

Wenn der Vorfall nicht bereits vorhanden ist, kann die aufrufende Anwendung einen neuen Vorfall in den POST /exposures-Anforderungs-Nutzdaten erstellen und dann mit einer refid auf diesen Vorfall verweisen. Diese Vorgehensweise wird als Anforderungseinschluss bezeichnet. Weitere Informationen finden Sie unter Anforderungseinschluss. Je nach Vorfalltyp kann der neue Vorfall auf ein untergeordnetes Objekt (einen Ort, eine verletzte Person oder ein Fahrzeug) verweisen. Dieses untergeordnete Objekt kann sich in der Police, in ClaimCenter oder auch in den POST /exposures-Anforderungs-Nutzdaten befinden.

Wenn der Vorfall bereits in ClaimCenter vorhanden ist, kann die aufrufende Anwendung durch ihre id darauf verweisen.

In diesem Beispiel ist der Vorfall nicht vorhanden und muss erstellt werden. Er verweist jedoch auf ein Fahrzeug, das bereits in der Police enthalten ist. Die ID für dieses Fahrzeug wurde bereits im ersten Schritt abgerufen, als der Deckungstyp identifiziert wurde. Die ID lautet demo_sample:4. Es ist keine zusätzliche Anforderung zum Abrufen zusätzlicher Fahrzeuginformationen erforderlich.

{
    "data": {
        "attributes": {
            "primaryCoverage": {
                "code": "PACollisionCov"
            },
            "coverageSubtype": {
                "code": "PACollisionCov"
            },
            "claimant": {
                "id": "cc:32"
            },
            "vehicleIncident": {
                "refid": "newVehicleIncident"
            },
            ...
        }
    },
    "included": {
        "VehicleIncident": [
            {
              "attributes": {
                "vehicle": {
                  "id": "demo_sample:4"
                }
              },
            "refid": "newVehicleIncident",
            "method": "post",
            "uri": "/claim/v1/claims/demo_sample:8037/vehicle-incidents"
            }
        ]
    }
}

Die coverage ist ein Objekt in der Police, das Informationen über die Deckung bereitstellt, einschließlich Deckungsbedingungen wie Selbstbehalte oder Limits. Beim Erstellen eines Teilschadens müssen Sie die Deckung nicht angeben. Guidewire empfiehlt jedoch, dies immer zu tun. Das liegt daran, dass es in ClaimCenter Funktionen wie die Abwicklung von Selbstbehalten gibt, die das Festlegen dieses Attributs erfordern, damit sie ordnungsgemäß funktionieren.

Auf die Deckung muss über ihre id verwiesen werden. Der Endpunkt, der zum Abrufen einer Deckung verwendet wird, hängt davon ab, mit welcher Deckung sie verknüpft ist. Zum Beispiel:

• Verwenden Sie für Deckungen, die mit der Police selbst verbunden sind (in der Regel Haftpflichtdeckungen): GET /claims/{claimId}/policy/coverages/{coverageId}.
• Verwenden Sie für Deckungen, die mit einem ortsgebundenen Wagnis verknüpft sind: GET /claims/{claimId}/policy/location-based-risk-units/{locationBasedRiskUnitId}
• Verwenden Sie für Deckungen, die mit einem Kfz-Wagnis verknüpft sind: GET /claims/{claimId}/policy/vehicle-risk-units/{vehicleRiskUnitId}

GET  http://localhost:8080/cc/rest/claim/v1/claims/demo_sample:8037/
     policy/vehicle-risk-units/cc:121

{
    "attributes": {
      "coverages": [
        {
          "coverageType": {
            "code": "PACollisionCov"
          },
          "id": "cc:7007",
...

{
    "data": {
        "attributes": {
            "primaryCoverage": {
                "code": "PACollisionCov"
            },
            "coverageSubtype": {
                "code": "PACollisionCov"
            },
            "claimant": {
                "id": "cc:32"
            },
            "vehicleIncident": {
                "refid": "newVehicleIncident"
            },
            "coverage": {
                "id": "cc:7007"
            }
        }
    },
    "included": {
        "VehicleIncident": [
            {
              "attributes": {
                "vehicle": {
                  "id": "demo_sample:4"
                }
              },
            "refid": "newVehicleIncident",
            "method": "post",
            "uri": "/claim/v1/claims/demo_sample:8037/vehicle-incidents"
            }
        ]
    }
}