Arbeiten mit Annahmeproblemen

Problemwerttypen

In PolicyCenter ist ein Annahmeproblem häufig mit einem Problemwerttyp und einem zulässigen Bereich verknüpft, wie von der sichernden UWIssue-Entität definiert. Ein Annahmeproblem kann beispielsweise in einer Sparte für Privatfahrzeuge ausgelöst werden, wenn eine Deckung für einen Fahrer im Alter unter 25 Jahren angefordert wird. In diesem Fall ist der Werttyp des Annahmeproblems ein Alter (ein ganzzahliger Wert) und der Auslösebereich ein Wert unter 25.

Eine Annahmeproblemressource unterstützt Eigenschaften, die mit Problemwerttypen verknüpft sind. Die für eine bestimmte Ressource verwendete Werttypeigenschaft wird durch den erforderlichen Werttyp der zugehörigen UWIssue-Entität bestimmt.

Mögliche Problemwerttypen sind Ganzzahlen, Dezimalzahlen, Geldbeträge oder festgelegte Bundesländer/Kantone, die mithilfe der folgenden Ressourceneigenschaften deklariert werden können:

• integerValue: Ein ganzzahliger Wert, der als Zeichenfolge übergeben wird
• decimalValue: Ein Dezimalwert, der als Zeichenfolge übergeben wird
• moneyValue: Eine MonetaryAmount-Ressource, die currency- und amount-Eigenschafte enthält, welche die entsprechende Währung und den entsprechenden Betrag angeben
• setStateValue: Eine ExclusiveStateSet-Ressource, welche die Eigenschaften includeType und states enthält

Wenn die zugrunde liegende UWIssue-Entität keinen Problemwerttyp erfordert, hat die Ressource auch keinen. In solchen Fällen wird der Problemwerttyp als unformatiert oder leer betrachtet.

Annahmeproblemressourcen können auch die folgenden Eigenschaften enthalten:

• valueType: Eine schreibgeschützte Eigenschaft, die den Problemwerttyp angibt
• comparator: Eine schreibgeschützte Eigenschaft, die ggf. den Vergleichsoperator-Typ angibt, der einem ValueComparator-Typencode entspricht. Diese Eigenschaft ist bei Problemen vorhanden, bei denen ein Wert innerhalb eines bestimmten Bereichs liegen muss.

Blockierungspunkte

Ein Annahmeproblem kann Blockierungspunkte haben, d. h., der zugehörige Job kann erst über den angegebenen Blockierungspunkt hinaus fortgesetzt werden, nachdem das Annahmeproblem genehmigt wurde.

Blockierungspunkte werden durch UWIssueBlockingPoint-Typencode-Werte festgelegt und auf die folgenden Ressourceneigenschaften für Annahmeprobleme angewendet:

• blockingPoint: Der für das Annahmeproblem festgelegte Standardblockierungspunkt
• approvalBlockingPoint: Beim Genehmigen eines Problems kann der Blockierungspunkt zurückgesetzt werden, z. B. wenn zusätzliche Genehmigungen erforderlich sind. Wenn keine Genehmigungen mehr erforderlich sind, wird dieser Wert auf NonBlocking gesetzt.
• currentBlockingPoint: Der aktuelle Blockierungspunkt für das Problem

Auflösungseigenschaften

Annahmeprobleme können entweder durch Genehmigung oder Ablehnung aufgelöst werden. Bei aufgelösten Annahmeproblemressourcen werden die für die Art der Lösung geeigneten Eigenschaften angezeigt.

Für alle aufgelösten Probleme wird die Eigenschaft hasApprovalOrRejection auf true gesetzt.

Genehmigte Probleme haben folgende Eigenschaften:

• approvalDurationType: Ein UWApprovalDurationType-Typencode-Wert, der die Genehmigungsdauer angibt
• approvingUser: Eine SimpleReference für den Benutzer, der das Problem genehmigt hat
• autoApprovable: Kann das Problem automatisch genehmigt werden? (Boolescher Wert)
• canEditApprovalBeforeBind: Kann die Genehmigung vor der Verbindlichmachung bearbeitet werden? (Boolescher Wert)
• currentBlockingPoint: Bei Genehmigung wird der aktuelle Blockierungspunkt auf NonBlocking gesetzt

Wenn eine Genehmigung mit einem entsprechenden Problemwerttyp übermittelt wird, kann dieser Wert über eine der folgenden Eigenschaften zur Ressource hinzugefügt werden:

• integerApprovalValue: Der genehmigte ganzzahlige Wert
• decimalApprovalValue: Der genehmigte Dezimalwert
• moneyApprovalValue: Der genehmigte Geldbetrag
• stateSetApprovalValue: Die festgelegten Bundesländer/Kantone

In solchen Fällen enthält die Ressource anschließend eine displayApprovalValue-Eigenschaft, die den genehmigten Wert im Zeichenfolgenformat anzeigt.

Abgelehnte Probleme haben folgende Eigenschaften:

• rejected: Boolescher Wert, der auf true gesetzt ist
• rejectingUser: Eine SimpleReference für den Benutzer, der das Problem abgelehnt hat
• currentBlockingPoint: Bei Ablehnung wird der aktuelle Blockierungspunkt auf Rejected gesetzt

Genehmigungstypen

Eine Genehmigung kann in die folgenden vier Typen unterteilt werden:

• Vollständige Genehmigung: Das Annahmeproblem wurde überprüft und genehmigt und enthält bei Bedarf einen Wert, der innerhalb des erwarteten Wertebereichs liegt.
• Teilgenehmigung: Das Annahmeproblem wurde geprüft und genehmigt, sein Wert liegt jedoch außerhalb des erwarteten Wertebereichs. In der Regel wird ein teilweise genehmigtes Problem zur endgültigen Genehmigung an eine höhere Stelle weitergeleitet.
• Automatische Genehmigung: Das Annahmeproblem ist so konfiguriert, dass es die automatische Genehmigung unterstützt, wenn bestimmte Kriterien erfüllt sind. Bei einem solchen Problem ist die Ressourceneigenschaft autoApprovable auf true gesetzt.
• Spezielle Genehmigung: Zur Genehmigung eines Problems wird unabhängig vom Wert die Berechtigung als Genehmigungsüberschreibung bereitgestellt. Guidewire empfiehlt, dass Sie diese Berechtigung nur dann verwenden, wenn eine zeitkritische Police durch keinen Underwriter weitergeführt werden kann.

Übermitteln von Genehmigungsanforderungen

Beim Aufrufen von Genehmigungsendpunkten muss der Anforderungstext mindestens folgenden Inhalt enthalten:

{
  "data": {
    "attributes": {
    }
  }
}

Wenn das Annahmeproblem einen formatierten Wert erwartet, kann die Anforderung einen Problemwerttyp mit einer Ganzzahl, einer Dezimalzahl, einem Geldbetrag oder Bundesländern/Kantonen enthalten, die über eine der folgenden Eigenschaften festgelegt werden:

• integerApprovalValue: Ein ganzzahliger Wert, der als Zeichenfolge übergeben wird
• decimalApprovalValue: Ein Dezimalwert, der als Zeichenfolge übergeben wird
• moneyApprovalValue: Eine MonetaryAmount-Ressource, die currency- und amount-Eigenschafte enthält, welche die entsprechende Währung und den entsprechenden Betrag angeben
• stateSetApprovalValue: Eine ExclusiveStateSet-Ressource, welche die Eigenschaften includeType und states enthält

Optional kann der Aufrufer auch Werte für die folgenden Eigenschaften festlegen:

• approvalBlockingPoint: Ein UWIssueBlockingPoint-Typencode-Wert. Dieser kann angewendet werden, um einen nachfolgenden Blockierungspunkt festzulegen
• approvalDurationType: Ein UWApprovalDurationType-Typencode-Wert. Dieser kann angewendet werden, wenn der Aufrufer den Standardlaufzeittyp ändern möchte.
• canEditApprovalBeforebind: Kann die Genehmigung vor der Verbindlichmachung bearbeitet werden? (Boolescher Wert)

Nach einem erfolgreichen Aufruf eines Genehmigungsendpunkts wird die Eigenschaft hasApprovalOrRejection der Ressource auf true gesetzt.

Der folgende Codeblock zeigt eine Anforderung für ein PAHighValueAuto-Annahmeproblem, das einen Geldbetrag von 8,50 USD genehmigt, den nächsten Blockierungspunkt bei der Ausstellung festlegt, die Genehmigungsdauer aufhebt und die Bearbeitung des Annahmeproblems vor der Verbindlichmachung ermöglicht:

{
  "data": {
    "attributes": {
      "approvalBlockingPoint": {
        "code": "BlocksIssuance"
      },
      "approvalDurationType": {
        "code": "Rescinded"
      },
      "canEditApprovalBeforeBind": true,
      "moneyApprovalValue": {
        "amount": "8.5",
        "currency": "usd"
      }
    }
  }
}

Der genehmigte Geldbetrag (8,50 USD) ist jedoch geringer als der Standardschwellenwert für diesen Problemtyp (10,00 USD). Daher wird das Problem teilweise genehmigt.

Der Antworttext sieht folgendermaßen aus:

{
  "data": {
    "attributes": {
      "active": true,
      "approvalBlockingPoint": {
        "code": "BlocksIssuance",
        "name": "Blocks Issuance"
      },
      "approvalDurationType": {
        "code": "Rescinded",
        "name": "Rescinded"
      },
      "approvingUser": {
        "displayName": "Super User",
        "id": "default_data:1",
        "type": "User",
        "uri": "/admin/v1/users/default_data:1"
      },
      "autoApprovable": true,
      "blockingPoint": {
        "code": "BlocksQuote",
        "name": "Blocks Quote"
      },
      "canEditApprovalBeforeBind": true,
      "comparator": {
        "code": "Monetary_LE",
        "name": "At most (monetary)"
      },
      "currentBlockingPoint": {
        "code": "BlocksQuote",
        "name": "Blocks Quote"
      },
      "displayApprovalValue": "$8.50",
      "displayValue": "$10.00",
      "hasApprovalOrRejection": true,
      "id": "407",
      "issueKey": "407",
      "issueType": {
        "code": "PAHighValueAuto",
        "displayName": "PA: High value vehicle"
      },
      "longDescription": "Test long description",
      "moneyApprovalValue": {
        "amount": "8.50",
        "currency": "usd"
      },
      "moneyValue": {
        "amount": "10.00",
        "currency": "usd"
      },
      "shortDescription": "Test short description",
      "valueType": "money",
      "valueVariesAcrossSlices": false
    },
    . . .
  }
}

Ein nachfolgender Genehmigungsantrag ist erforderlich, um dieses Problem vollständig zu genehmigen. Ein Aufrufer mit ausreichend hoher Berechtigung kann dieses Problem mit dem aktuellen Wert genehmigen, indem er einen Aufruf mit dem oben beschriebenen Mindestanforderungstext einreicht. Alternativ kann ein Aufrufer eine Genehmigungsanforderung einreichen, die einen Wert innerhalb des erwarteten Bereichs enthält. In beiden Fällen gibt das vollständig genehmigte Problem einen Antworttext zurück, aus dem hervorgeht, dass der Blockierungspunkt entfernt wurde.