多通貨情報のポスト

支払備金または保険金支払をポストする場合は、必ず、通貨情報を指定する必要があります。ClaimCenter の単一通貨インスタンスでは、指定したすべての通貨を同じにする必要があります。多通貨が有効になっている場合は、指定する通貨は別のものにできます。

要求ペイロードに複数の通貨値が含まれている場合は、指定する通貨が関連するすべての検証条件を満たしている必要があります。例えば、支払備金を作成する場合は、クレーム通貨が支払備金通貨と一致する必要はありません。ただし、それぞれの支払備金明細項目の通貨は支払備金通貨と一致する必要があります。この種の検証条件が満たされなかった場合は、Cloud API がエラーを返します。

複数の通貨を含む支払備金のポスト

クレーム cc:202 に対する新しい支払備金の要求ペイロードの例を以下に示します。ペイロードでは明確でありませんが、cc:202 のクレーム通貨は米ドル（USD）です。

支払備金通貨はユーロ（EUR）です。
支払備金トランザクション通貨は日本円（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"
          }
        }
      ]
    }
  }
}

カスタム為替レートを含む支払備金のポスト

カスタム為替レートを指定するには、transToReservingExchangeRate オブジェクトを使用します。トランザクション通貨を支払備金通貨に換算するときに使用されるレートを、これによって指定します。このオブジェクトは 3 つのフィールドを使用します。

オプションの説明文字列値。
Boolean 市場値（このトランザクションの ExchangeRateSetPlugin で生成された市況レートと新しいカスタムレートのどちらを ClaimCenter で使用するのかを、これによって識別します。カスタム為替レートが指定された場合、市場値を False に設定します）。
10 進レート値。

支払備金通貨は米ドル（USD）です。
支払備金トランザクション通貨はカナダドル（CAD）です。
カスタム為替レートは 4.0 です（トランザクション額は 300 です。つまり、$1200 米ドル（USD）と等しい $300 カナダドル（CAD）として記録されます）。

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"
          }
        }
      ]
    }
  }
}

複数の通貨を含む保険金支払セットのポスト

クレーム cc:202 に対する新しい保険金支払セットの保険金支払セットペイロードの例を以下に示します。ペイロードでは明確でありませんが、cc:202 のクレーム通貨は米ドル（USD）です。

支払備金通貨は英国ポンド（GBP）です。
保険金支払（と関連する支払トランザクション）用の通貨はカナダドル（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"
        }
      }
    }
  }
}

カスタム為替レートを含む保険金支払セットのポスト

オプションの説明文字列値。
Boolean 市場値（このトランザクションの ExchangeRateSetPlugin で生成された市況レートと新しいカスタムレートのどちらを ClaimCenter で使用するのかを、これによって識別します。カスタム為替レートが指定された場合、市場値を False に設定します）。
10 進レート値。

支払備金通貨は英国ポンド（GBP）です。
保険金支払（と関連する支払トランザクション）用の通貨はカナダドル（CAD）です。
カスタム為替レートは 0.5 です（トランザクション額は 50 です。つまり、25 英国ポンド（GBP）と等しい $50 カナダドル（CAD）として記録されます）。

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"
        }
      }
    }
  }
}

多通貨明細項目の指定

transactionAmount を指定すると、市場またはカスタム為替レートに基づいて、reservingAmount、claimAmount、および reportingAmount の各明細項目が自動的に計算されます。この自動換算は、多通貨に関するほとんどのユースケースをカバーします。ただし、インスタンスによっては、ユーザー指定の金額フィールドによる自動計算のオーバーライドが保証されます。このインスタンスの例が、保険契約通貨での補償の免責金額の埋め合わせです。

例えば、USD を使用する保険契約に 500 USD の免責金額が含まれているとします。

500 USD の免責金額を埋め合わせるために、支払は GBP で行われます。これは、GBP の支払によって、為替レートを使用して USD に換算された GBP のトランザクション額が差し引かれることを意味します。

ただし、為替レートによっては、次のように、正確な換算が不可能な場合があります。

378.16GPV=499.96 USD、378.17 GVP = 500.01 USD。換算によって免責金額が埋め合わされないか、エクスポージャーのクローズが阻止されます。

このようなエッジケースに対処するために、transactionAmount、reservingAmount、claimAmount、および reportingAmount. を指定できます。

多通貨プロパティ金額依存条件

4 つの金額プロパティのうちの 1 つ以上を含む多通貨情報をポストする場合は、Cloud API ルールによって、すべてのプロパティがある値で初期化され、すべてのプロパティがユーザー指定の値でオーバーライドされ、同じ通貨を共有するフィールドで同じ値が使用されることが保証されます。同じ通貨の別の値を使用する多通貨フィールドは、常に、エラーをスローします。

次の点に注目します。

transactionAmount フィールドは、常に必須で、指定されなかった明細項目を自動的に計算します（これがデフォルトの動作です）。
- 支払備金通貨がトランザクション通貨と同じ場合は、reservingAmount が transactionAmount に設定されます。そうでない場合は、reservingAmount が換算後の値に設定されます。
- クレーム通貨がトランザクション通貨と同じ場合は、claimAmount が transactionAmount に設定されます。そうでない場合は、claimAmount が換算後の値に設定されます。
- レポート通貨がトランザクション通貨と同じ場合は、reportingAmount が transactionAmount に設定されます。そうでない場合は、transactionAmount が換算後の値に設定されます。
reservingAmount フィールドは、指定された場合に、トランザクション通貨と同じ通貨に設定できません。
- クレーム通貨が支払備金通貨と同じ場合は、claimAmount が reservingAmount に設定されます。
- レポート通貨が支払備金通貨と同じ場合は、reportingAmount が reservingAmount に設定されます。
claimAmount フィールドは、指定された場合に、トランザクション通貨またはクレーム通貨と同じ通貨に設定できません。
- レポート通貨がクレーム通貨と同じ場合は、reportingAmount が claimAmount に設定されます。
reportingAmount は、指定された場合に、トランザクション通貨、支払備金通貨、またはクレーム通貨と同じ通貨に設定できません。

警告: 多通貨トランザクションをパッチして、transactionAmount を指定すると、他の 3 つの金額プロパティが再計算され、transactionAmount 為替レート計算で上書きされます。これは、金額プロパティが事前に指定されていた場合も発生します。

例として、標準の多通貨計算で免責金額が埋め合わされないエッジケースを考えてみます。保険金支払セットの作成時点の為替レートでは、250.02 GBP が 499.99 USD と計算されます。つまり、このクレームのエクスポージャーはクローズできません。

注: 為替レートで免責金額を埋め合わせない値が計算されるエッジケースに遭遇した場合やクレームが transactionAmount とは異なる通貨の場合は、免責金額に対して claimAmount を指定する必要があります。

以下を検討します。

保険金支払セットの作成時点の為替レートでは、250.02 GBP が 499.99 USD と計算されます。つまり、このクレームのエクスポージャーはクローズできません。
ユーザーが claimAmount を -500.00 USD として指定し、計算された 499.99 USD の値が上書きされます。

"primaryCheckToWrite": {
    "paymentsToWrite": [
      {
      "transToReservingExchangeRate": {
      "description": "Custom exchange rate",
      "market": false,
      "rate": "1.9998"
      },
          "lineItems": [
            {
              "transactionAmount": {
              "amount": "600",
              "currency": "gbp"
              },
      "transactionAmount": {
      "amount":"-250.02",
      "currency": "gbp"
       },
      "claimAmount": {
      "amount": "-500.00"
      "currency": "USD"
      },
      "lineCategory": {
      "code": "deductible"
      }
            }
          ], 
...

多通貨明細項目のポスト

他のインスタンスで多通貨明細項目をポストする場合は、次のように、その明細項目を要求ペイロードに追加する必要があるだけです。

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"
              },
		"reservingAmount": {
		"amount":"1.01",
		"currency": "eur"
		}
            }
          ],
          "currency": {
            "code": "jpy"
          }
        }
      ]
    }
  }
}

追加の為替レートスキーマフィールド

応答ペイロードには、以下の為替レートフィールドを含めることができます。

claimToReportingExchangeRate
transToClaimExchangeRate

これらのフィールドは読み取り専用であることに注意してください。支払備金と保険支払セットをポストする場合、transToReservingExchangeRate フィールドを使用してカスタム為替レートが必ず指定されます。