Erstellen einer Rückerstattung

Beim Erstellen von Rückerstattungen über die Cloud-API gibt es keinen POST-Endpunkt, dessen Stammressource eine Rückerstattung ist. Rückerstattungen werden im Kontext eines Rückerstattungssatzes erstellt.

Wenn Sie einen Rückerstattungssatz erstellen, müssen Sie recoveriesToWrite angeben. Das Objekt muss mindestens aus folgenden Elementen bestehen:

  • Die reserveLine, die angibt, 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 Rückerstattungskategorie (ein Wert aus der Typenliste RecoveryCategory)
    • Die ID des übergeordneten Teilschadens
    • Die reservingCurrency
  • Ein Array aus einer oder mehreren lineItems der Transaktion. Für jede Position müssen Sie jeweils Folgendes angeben:
    • transactionAmount, einschließlich Betrag und Währung
    • Währung (ein Wert aus der Typenliste currency)

Wenn Sie möchten, dass Ihre Rückerstattung auf eine Rückerstattungsreserve verweist und ihr Transaktionsbetrag auf die Summe der erwarteten Rückerstattungsreserve angerechnet wird, müssen Sie die folgenden Informationen aus der Rückerstattungsreserve duplizieren:

  • costCategory (ein Wert aus der Typenliste CostCategory)
  • costType (ein Wert aus der Typenliste CostType)
  • Die Rückerstattungskategorie (ein Wert aus der Typenliste RecoveryCategory)
  • Die ID des übergeordneten Teilschadens
  • Die reservingCurrency

Die Währung im lineItem-Objekt muss ebenfalls identisch sein.

Note: Wenn Sie eine Rückerstattung mit einem Transaktionsbetrag erstellen, der die referenzierte Rückerstattungsreserve übersteigt, erstellt ClaimCenter eine zusätzliche Rückerstattungsreserve, um die Differenz auszugleichen.

Beispiel für das Erstellen einer Rückerstattung

Die folgenden Nutzdaten sind ein Beispiel für das Erstellen einer Rückerstattung, die auf die Rückerstattungsreserve im vorherigen Beispiel verweist:

  • Die reserveLine gleicht Beträge aus einem einzelnen Teilschaden aus:
    • Die ID des Teilschadens lautet cc:SB1
  • Die Kostenart ist claimcost.
  • Die Kostenkategorie ist Kfz-Karosserie (body).
  • Die Rückerstattungskategorie ist Restwert.
  • Die Reservewährung ist USD.
    • Der transactionAmount ist auf 3000,00 festgelegt.
Note: Die Transaktion macht 3000 Dollar (USD) der erwarteten 5000 Dollar (USD) in der Rückerstattungsreserve aus. Der ursprüngliche Gesamtbetrag der Rückerstattungsreserve wird auf die Differenz von 2000 Dollar reduziert.

POST /claim/v1/claims/

{
  "data": {
    "attributes": {
      "recoveriesToWrite": [
        {
          "reserveLine": {
            "costCategory": {
              "code": "body"
            },
            "costType": {
              "code": "claimCost"
            },
            "exposure": {
                    "id": " cc:SB1"
            },
            "recoveryCategory": {
              "code": "salvage"
            },
            "reservingCurrency": {
              "code": "usd"
            }
          },
          "lineItems": [
            {
              "transactionAmount": {
                "amount": "3000.00",
                "currency": "usd"
              }
            }
          ],
          "currency": {
            "code": "usd"
          }
        }
      ]
    }
  }
}