Buchen von Schecks

Scheckerstellung in ClaimCenter

Schecks und Validierungsstufen

Sowohl Schadenfälle als auch Teilschäden haben Validierungsstufen. Eine Validierungsstufe ist eine Bezeichnung für die Reife des Schadenfalls oder Teilschadens. Mit jeder Validierungsstufe kann ein Satz von Validierungskriterien verknüpft sein. Ein Schadenfall oder Teilschaden kann erst dann eine bestimmte Validierungsstufe erreichen, wenn alle zugehörigen Validierungskriterien erfüllt sind.

In den meisten Instanzen von ClaimCenter ist die höchste Validierungsstufe „Zahlungsfähigkeit“. Das bedeutet, dass der Schadenfall oder Teilschaden an dem Punkt ist, an dem Schecks ausgestellt werden können.

Um einen Schecksatz zu erstellen, muss Folgendes zutreffen:

Die Validierung des Schadenfalls muss „Zahlungsfähigkeit“ ergeben.
Jeder Teilschaden, der eine Reserveposition besitzt, aus der Zahlungstransaktionen stammen, muss ebenfalls den Status „Zahlungsfähigkeit“ aufweisen.

Weitere Informationen zur Validierung von Schadensfällen finden Sie unter Validieren von Schadensfällen. Weitere Informationen zur Validierung von Teilschäden finden Sie unter Prüfen von Teilschäden.

Schecks und Zahlungsarten

Wenn ein Scheck erstellt wird, kann jede zugrunde liegende Zahlung einer von drei Arten entsprechen:

Endgültig: Dies gilt für offene Schadenfälle und Teilschäden. Dies bedeutet, dass keine zusätzlichen Zahlungen aus der entsprechenden Reserveposition erwartet werden.
Teilweise: Dies gilt für offene Schadenfälle und Teilschäden. Dies bedeutet, dass zusätzliche Zahlungen aus der entsprechenden Reserveposition erfolgen können.
Ergänzung: Wird verwendet, um Zahlungen für geschlossene Schadenfälle und Teilschäden durchzuführen.

Erstellen von Schecks über die Cloud-API

Beim Erstellen von Schecks über die Cloud-API gibt es keinen POST-Endpunkt, dessen Stammressource ein Scheck oder Zahlungstransaktion ist. Schecks und Zahlungstransaktionen werden im Kontext eines Schecksatzes erstellt. Beachten Sie, dass Schecksätze nur für Schadenfälle erstellt werden können, die mindestens den Status „Zahlungsfähigkeit“ haben, und nur Teilschäden verwenden, die mindestens den Status „Zahlungsfähigkeit“ haben.

Verwenden Sie zum Erstellen eines Schecksatzes den folgenden Endpunkt:

POST /claims/{claimId}/check-sets

Vor dem Erstellen des Schecksatzes benötigen Sie Folgendes:

Für jede Reserveposition, aus der die Schecks stammen:
- Die ID des übergeordneten Teilschadens. (Wenn sich die Reserveposition auf Schadenfallebene befindet, geben Sie „null“ für die Teilschaden-ID an.)
- Die Kostenart, Kostenkategorie und Währung der Reserveposition.
Für jeden Zahlungsempfänger, der bereits im Schadenfall enthalten ist:
- Die ID des entsprechenden Kontakts.

Das `primaryCheckToWrite`-Objekt

Wenn Sie einen Reservesatz erstellen, müssen Sie das primaryCheckToWrite-Objekt angeben. Das Objekt muss mindestens aus den folgenden drei Elementen bestehen:

Sie müssen ein Array von paymentsToWrite angeben. Für jedes Mitglied des Arrays müssen Sie Folgendes angeben:

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)
Ein paymentType (ein Wert aus der PaymentType-Typenliste, z. B. partial oder final)
Die reserveLine, woher das Geld kommt. 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
- Die reservingCurrency
Die Zahlungstransaktionswährung

Sie müssen auch ein Array von Zahlungsempfängern angeben. Für jeden Zahlungsempfänger müssen Sie die folgenden Informationen angeben:

Eine ID für den Zahlungsempfänger
- Wenn der Kontakt für den Schadenfall bereits vorhanden ist, können Sie ihn über seine id referenzieren.
- Wenn der Kontakt für den Schadenfall nicht vorhanden ist, können Sie ihn im gleichen Aufruf mit der Anforderungseinschließung erstellen und ihn mit einer refid referenzieren.
Der payeeType (ein Wert aus der ContactRole-Typenliste, gefiltert nach payee, z. B. insured, claimant, vendor oder other)

Sie müssen auch die paymentMethod angeben. Dies ist ein Wert aus der Typenliste PaymentMethod, z. B. check oder eft.

Währungen in den POST-Schecksatz-Nutzdaten

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

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

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

Es gibt ein drittes Feld, das auf einen Währungswert gesetzt ist, reservingCurrency. Dies muss immer angegeben werden. 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.

Schecks und Composite-Anforderungen

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

Beispiel für die Erstellung eines minimalen Schecksatzes

Die folgenden Nutzdaten sind ein Beispiel für das Erstellen eines Schecksatzes.

Die ID des Schadenfalls lautet cc:55. Der Schaden hat den Status „Zahlungsfähigkeit“.
Das Geld stammt aus einem einzelnen Teilschaden, der ebenfalls den Status „Zahlungsfähigkeit“ hat.
- Die ID des Teilschadens lautet cc:58.
- Die Kostenart ist claimcost.
- Die Kostenkategorie ist Kfz-Karosserie (body).
Es gibt nur eine Zahlungstransaktion.
- Die Währung und Reservewährung ist USD.
- Der Betrag ist 75,50 $.
- Diese Zahlung ist endgültig.
Es gibt nur einen Zahlungsempfänger.
- Die Kontakt-ID des Zahlungsempfängers lautet cc:613.
- Der Typ des Zahlungsempfängers ist insured.
Die Zahlungsmethode ist Elektronische Geldmittelübertragung (eft).

POST /claims/cc:55/check-sets

{
  "data": {
    "attributes": {
      "primaryCheckToWrite": {
        "paymentsToWrite": [
          {
            "lineItems": [
              {
                "transactionAmount": {
                  "amount": "75.50",
                  "currency": "usd"
                }
              }
            ],
            "paymentType": {
              "code": "final"
            },
            "reserveLine": {
              "costCategory": {
                "code": "body"
              },
              "costType": {
                "code": "claimcost"
              },
              "exposure": {
                  "id": "cc:58"
              },
              "reservingCurrency": {
                "code": "usd"
              }
            },
            "currency": {
              "code": "usd"
            }
          }
        ],
        "payees": [
          {
            "contact": {
              "id": "cc:613"
            },
            "payeeType": {
              "code": "insured"
            }
          }
        ],
        "paymentMethod": {
          "code": "eft"
        }
      }
    }
  }
}