Erstellen von Reserven

Beim Erstellen von Reserven über die Cloud-API gibt es keinen POST-Endpunkt, dessen Stammressource eine Reserveposition oder eine Reservetransaktion ist. Reservepositionen und Reservetransaktionen werden im Kontext eines Reservesatzes erstellt.

Verwenden Sie zum Erstellen eines Reservesatzes den folgenden Endpunkt:

  • POST /claims/{claimId}/reserve-sets

Wenn Sie einen Reservesatz erstellen, müssen Sie reservesToWrite angeben. Dies ist ein Reservesatz, der aus einem Array von Reservetransaktionen besteht. Für jedes Mitglied des Arrays müssen Sie Folgendes angeben:

  • Die reserveLine für die Reserve. Um diese zu ermitteln, müssen Sie Folgendes angeben:
    • costCategory (ein Wert aus der Typenliste CostCategory)
    • costType (ein Wert aus der Typenliste CostType)
    • Die id des übergeordneten Teilschadens (Diese kann auch explizit auf null gesetzt werden. In diesem Fall wird die Reserveposition auf Schadenfallebene erstellt.)
    • reservingCurrency
  • Ein Array aus einer oder mehreren lineItems der Transaktion. Für jede Position müssen Sie jeweils Folgendes angeben:
    • Ein transactionAmount (angegeben als Betrag und Währung)
  • Die Reservetransaktionswährung

Währungen in den POST reserve-sets-Nutzdaten

Jede Reservetransaktion besteht aus einer oder mehreren Einzelpositionen. Reservetransaktionen und Einzelpositionen werden in verschiedenen Datenbanktabellen gespeichert. Für eine bestimmte Reservetransaktion muss jedoch die Währung jeder Einzelposition in der Reservetransaktion mit der Währung der Reservetransaktion übereinstimmen.

Diese Unterscheidung ist bei der Verwendung der Benutzeroberfläche möglicherweise nicht ersichtlich. Der Benutzer wählt eine Währung für die Transaktion aus, und alle Einzelpositionen werden automatisch auf diese Transaktion gesetzt. Dies verschleiert die Tatsache, dass es sich um technisch unterschiedliche Werte handelt.

Diese Unterscheidung muss jedoch beim Schreiben von Reservesatz-Nutzdaten berücksichtigt werden. Es gibt keinen Mechanismus, bei dem die Einzelpositionen die Währung der Reservetransaktion erben. Daher müssen die Währung der Reservetransaktion und jeder Einzelposition explizit angegeben werden und identisch sein.

Es gibt ein drittes Feld, das auf einen Währungswert gesetzt ist, reservingCurrency. In einer Instanz von ClaimCenter, die eine Mehrwährungsfunktion verwendet, kann diese auf eine andere Währung als die Währung der Reservetransaktion gesetzt werden. Weitere Informationen finden Sie unter Arbeiten mit der Mehrwährungsfunktion.

Genehmigungsstatus

Wenn ein Reservesatz übermittelt wird, prüft ClaimCenter die Vollmachtsrahmen des entsprechenden Benutzers.

  • Wenn der Betrag dem Vollmachtsrahmen des Benutzers entspricht oder darunter liegt, wird der Schadenreservesatz genehmigt. Der entsprechende Betrag wird der Reserveposition hinzugefügt, und das Feld approvalStatus des Antwortobjekts wird auf „Genehmigt“ gesetzt.
  • Wenn der Betrag über dem Vollmachtsrahmen des Benutzers liegt, muss der Schadenreservesatz genehmigt werden. Eine Genehmigungsaktivität wird erstellt und an einen Benutzer mit ausreichender Genehmigungsberechtigung gesendet. Der Reserveposition wird kein Betrag hinzugefügt, und das Feld approvalStatus des Antwortobjekts wird auf „Nicht genehmigt“ gesetzt.

Ein bestimmter Benutzer kann einen Vollmachtsrahmen für „Gesamte Schadenreserven für den Schadenfall“, „Gesamte Schadenreserven für den Teilschaden“ oder beides haben. Weitere Informationen zu Vollmachtsrahmen finden Sie unter Anwendungshandbuch.

Wenn der Reservesatz über die Cloud-API übermittelt wird, ist der Sitzungsbenutzer der Benutzer, dessen Vollmachtsrahmen geprüft werden. Weitere Informationen zur Bestimmung des Sitzungsbenutzers finden Sie im Cloud-API-Authentifizierungshandbuch.

Reserven und Composite-Anforderungen

In einer Composite-Anforderung können Sie keine Finanzobjekte erstellen oder ändern. Dazu gehören Reservesätze und Reservetransaktionen. In einer Composite-Anforderung können Sie jedoch Informationen zu Finanzobjekten abrufen.

Beispiel für das Erstellung von Reservepositionen

Die folgenden Nutzdaten sind ein Beispiel für das Erstellen einer Reserveposition.

  • Die ID des Schadenfalls lautet cc:61.
  • Die ID des Teilschadens lautet cc:79.
  • Es gibt nur eine Reservetransaktion.
    • Die Transaktion gilt für eine Reserveposition, deren Kostenart und Kostenkategorie „Schadenfallkosten/Kfz-Karosserie“ (claimcost und body) ist.
    • Die Transaktionswährung ist USD.
    • Die Transaktion hat eine Einzelposition von 1000 $.
POST /claims/cc:61/reserve-sets

{
  "data": {
    "attributes": {
      "reservesToWrite": [
        {
          "reserveLine": {
            "costCategory": {
              "code": "body"
            },
            "costType": {
              "code": "claimcost"
            },
            "exposure": {
              "id": "cc:79"
            },
            "reservingCurrency": {
              "code": "usd"
            }
          },
          "lineItems": [
            {
              "transactionAmount": {
                "amount": "1000.00",
                "currency": "usd"
              }
            }
          ],
          "currency": {
            "code": "usd"
          }
        }
      ]
    }
  }
}

Beispiel für das Hinzufügen zu Reservepositionen

Die folgenden Nutzdaten sind ein Beispiel für das Hinzufügen zu einer vorhandenen Reserveposition. Dieser Aufruf wird nach dem vorherigen Beispiel ausgeführt.

  • Die ID des Schadenfalls lautet cc:61.
  • Die ID des Teilschadens lautet cc:79.
  • Es gibt nur eine Reservetransaktion.
    • Die Transaktion gilt für eine Reserveposition, deren Kostenart und Kostenkategorie „Schadenfallkosten/Kfz-Karosserie“ (claimcost und body) ist.
    • Die Transaktionswährung ist USD.
    • Die Transaktion hat eine Einzelposition über 250 $.

Beachten Sie, dass sich diese Nutzdaten nicht wesentlich von den vorherigen Nutzdaten unterscheiden. Wenn Sie eine Reservetransaktion erstellen, müssen Sie nur die Kostenart, die Kostenkategorie und die Währung (und den Betrag) angeben. ClaimCenter ermittelt, ob es sich um eine neue Reserveposition oder um einen Teil einer vorhandenen Reserveposition handelt.

POST /claims/cc:61/reserve-sets

{
  "data": {
    "attributes": {
      "reservesToWrite": [
        {
          "reserveLine": {
            "costCategory": {
              "code": "body"
            },
            "costType": {
              "code": "claimcost"
            },
            "exposure": {
              "id": "cc:79"
            },
            "reservingCurrency": {
              "code": "usd"
            }
          },
          "lineItems": [
            {
              "transactionAmount": {
                "amount": "250.00",
                "currency": "usd"
              }
            }
          ],
          "currency": {
            "code": "usd"
          }
        }
      ]
    }
  }
}