Buchen von Mehrwährungsinformationen

Wenn Sie eine Reserve oder einen Scheck buchen, müssen Sie Währungsinformationen angeben. Für eine Einzelwährungsinstanz von ClaimCenter müssen alle angegebenen Währungen identisch sein. Wenn die Mehrwährungsfunktion aktiviert ist, können die angegebenen Währungen unterschiedlich sein.

Wenn Anforderungs-Nutzdaten mehrere Währungswerte enthalten, müssen die angegebenen Währungen alle relevanten Validierungskriterien erfüllen. Beispielsweise muss beim Erstellen einer Reserve die Währung für den Schadenfall nicht mit der Reservewährung übereinstimmen. Die Währung für jede Reserveposition muss jedoch mit der Reservewährung übereinstimmen. Wenn diese Validierungskriterien nicht erfüllt sind, gibt die Cloud-API einen Fehler zurück.

POSTen einer Reserve mit mehreren Währungen

Im Folgenden finden Sie ein Beispiel für Anforderungs-Nutzdaten für den Schadenfall cc:202. Auch wenn dies aus den Nutzdaten nicht ersichtlich ist, ist die Währung für den Schadenfall für cc:202 US-Dollar (usd).

  • Die Reservewährung ist Euro (eur).
  • Die Reservetransaktionswährung ist Japanischer Yen (jpy).
POST http://localhost:8080/cc/rest/claim/v1/claims/cc:202/reserve-sets

{
  "data": {
    "attributes": {
      "reservesToWrite": [
        {
          "reserveLine": {
            "costCategory": {
              "code": "body"
            },
            "costType": {
              "code": "claimcost"
            },
            "exposure": {
              "id": "cc:SfXS3Pey0Al29PI13KC5C"
            },
            "reservingCurrency": {
              "code": "eur"
            }
          },
          "lineItems": [
            {
              "transactionAmount": {
                "amount": "100.00",
                "currency": "jpy"
              }
            }
          ],
          "currency": {
            "code": "jpy"
          }
        }
      ]
    }
  }
}

POSTen einer Reserve mit einem benutzerdefinierten Wechselkurs

Verwenden Sie zum Angeben eines benutzerdefinierten Wechselkurses das Objekt transToReservingExchangeRate. Damit wird der Kurs angegeben, der bei der Umwandlung der Transaktionswährung in die Reservewährung verwendet wird. Das Objekt enthält drei Felder:

  • einen optionalen Beschreibungs-Zeichenfolgenwert.
  • einen booleschen Marktwert. (Damit wird angegeben, ob ClaimCenter für diese Transaktion den Marktkurs verwendet, der vom ExchangeRateSetPlugin aufgefüllt wird, oder ob ein neuer benutzerdefinierter Kurs verwendet wird. Wenn ein benutzerdefinierter Wechselkurs angegeben wird, setzen Sie „market“ auf „false“.)
  • einen Dezimalsatzwert.

Im Folgenden finden Sie ein Beispiel für Anforderungs-Nutzdaten für den Schadenfall cc:202. Auch wenn dies aus den Nutzlasten nicht ersichtlich ist, ist die Schadenfallwährung für cc:202 US-Dollar (usd).

  • Die Reservewährung ist US-Dollar (usd).
  • Die Reservetransaktionswährung ist kanadischer Dollar (cad).
  • Der benutzerdefinierte Wechselkurs ist 4,0 (Der Transaktionsbetrag ist 300). Somit wird dies als 300 CAD erfasst, was 1200 USD entspricht.)
POST http://localhost:8080/cc/rest/claim/v1/claims/cc:202/reserve-sets

{
  "data": {
    "attributes": {
      "reservesToWrite": [
        {
          "transToReservingExchangeRate": {
            "description": "Custom exchange rate",
            "market": false,
            "rate": "4.0"
          },
          "reserveLine": {
            "costCategory": {
              "code": "body"
            },
            "costType": {
              "code": "claimcost"
            },
            "exposure": {
              "id": "cc:SfXS3Pey0Al29PI13KC5C"
            },
            "reservingCurrency": {
              "code": "usd"
            }
          },
          "lineItems": [
            {
              "transactionAmount": {
                "amount": "300.00",
                "currency": "cad"
              }
            }
          ],
          "currency": {
            "code": "cad"
          }
        }
      ]
    }
  }
}

POSTen eines Schecksatzes mit mehreren Währungen

Im Folgenden finden Sie ein Beispiel für die Schecksatz-Nutzdaten für einen neuen Schecksatz für den Schadenfall cc:202. Auch wenn dies aus den Nutzdaten nicht ersichtlich ist, ist die Schadenfallwährung für cc:202 US-Dollar (usd).

  • Die Reservewährung ist Britische Pfund (gbp).
  • Die Währung für den Scheck (und alle zugehörigen Zahlungstransaktionen) ist kanadischer Dollar (cad).
POST http://localhost:8080/cc/rest/claim/v1/claims/cc:202/check-sets

{
  "data": {
    "attributes": {
      "primaryCheckToWrite": {
        "paymentsToWrite": [
          {
            "lineItems": [
              {
                "transactionAmount": {
                  "amount": "75.00",
                  "currency": "cad"
                }
              }
            ],
            "paymentType": {
              "code": "final"
            },
            "reserveLine": {
              "costCategory": {
                "code": "body"
              },
              "costType": {
                "code": "claimcost"
              },
              "exposure": {
                  "id": "cc:SfXS3Pey0Al29PI13KC5C"
              },
              "reservingCurrency": {
                "code": "gbp"
              }
            },
            "currency": {
              "code": "cad"
            }
          }
        ],
        "payees": [
          {
            "contact": {
              "id": "cc:Sr-RcOtnyAd2_TsoU4Szy"
            },
            "payeeType": {
              "code": "insured"
            }
          }
        ],
        "paymentMethod": {
          "code": "eft"
        }
      }
    }
  }
}

POSTen eines Schecksatzes mit einem benutzerdefinierten Wechselkurs

Verwenden Sie zum Angeben eines benutzerdefinierten Wechselkurses das Objekt transToReservingExchangeRate. Damit wird der Kurs angegeben, der bei der Umwandlung der Transaktionswährung in die Reservewährung verwendet wird. Das Objekt enthält drei Felder:

  • einen optionalen Beschreibungs-Zeichenfolgenwert.
  • einen booleschen Marktwert. (Damit wird angegeben, ob ClaimCenter für diese Transaktion den Marktkurs verwendet, der vom ExchangeRateSetPlugin aufgefüllt wird, oder ob ein neuer benutzerdefinierter Kurs verwendet wird. Wenn ein benutzerdefinierter Wechselkurs angegeben wird, setzen Sie „market“ auf „false“.)
  • einen Dezimalsatzwert.

Im Folgenden finden Sie ein Beispiel für Anforderungs-Nutzdaten für den Schadenfall cc:202. Auch wenn dies aus den Nutzdaten nicht ersichtlich ist, ist die Währung für den Schadenfall für cc:202 US-Dollar (usd).

  • Die Reservewährung ist Britische Pfund (gbp).
  • Die Währung für den Scheck (und alle zugehörigen Zahlungstransaktionen) ist kanadischer Dollar (cad).
  • Der benutzerdefinierte Wechselkurs ist 0,5 (Der Transaktionsbetrag ist 50). Somit wird dies als 50 CAD erfasst, was 25 GPB entspricht.)
POST http://localhost:8080/cc/rest/claim/v1/claims/cc:202/reserve-sets

{
  "data": {
    "attributes": {
      "primaryCheckToWrite": {
        "paymentsToWrite": [
          {
            "lineItems": [
              {
                "transactionAmount": {
                  "amount": "50.00",
                  "currency": "cad"
                }
              }
            ],
            "paymentType": {
              "code": "partial"
            },
            "reserveLine": {
              "costCategory": {
                "code": "body"
              },
              "costType": {
                "code": "claimcost"
              },
              "exposure": {
                  "id": "cc:SfXS3Pey0Al29PI13KC5C"
              },
              "reservingCurrency": {
                "code": "gbp"
              }             
            },
            "currency": {
              "code": "cad"
            },
            "transToReservingExchangeRate": {
              "description": "Custom exchange rate",
              "market": false,
              "rate": "0.5"
            }             
          }
        ],
        "payees": [
          {
            "contact": {
              "id": "cc:Sr-RcOtnyAd2_TsoU4Szy"
            },
            "payeeType": {
              "code": "insured"
            }
          }
        ],
        "paymentMethod": {
          "code": "eft"
        }
      }
    }
  }
}

Zusätzliche Felder für Wechselkursschemata

Antwort-Nutzdaten können auch die folgenden Wechselkursfelder enthalten:

  • claimToReportingExchangeRate
  • transToClaimExchangeRate

Beachten Sie, dass diese Felder schreibgeschützt sind. Beim POSTen von Reserven und Schecksätzen werden benutzerdefinierte Wechselkurse immer über das Feld transToReservingExchangeRate angegeben.