為替レートAPI (/exchange_rates)
予算明細APIを使用して、会社が商品の支払に使用する通貨の為替レートを管理します。
為替レートAPIは、一方向の為替レートの作成のみをサポートしています。 たとえば、EUR > USDのコールを行うと、Coupaインスタンスにそのレートが設定されますが、逆レート( USD > EUR )は作成されません。 USD > EURの場合は、別途電話をかける必要があります。
https ://<instance>/api/exchangeangerates詳細については、統合のベストプラクティスを参照してください。
アクション
為替レートAPIでは以下の操作が可能です。
| 動詞 | パス | アクション | Description |
|---|---|---|---|
| POST | /api/exchange_rates | 作成 | 為替レートを作成 |
| GET | /api/exchange_rates | インデックス | 為替レートを検索 |
| GET | /api/exchange_rates /: id | 表示 | 為替レートを表示 |
| PUT | /api/exchange_rates /: id | 更新 | 為替レートを更新 |
Elements
為替レートAPIでは、次の要素を使用できます。
| 要素 | 説明 | 必須フィールド? | 一意? | 許容値 | Api_Inフィールド? | Api_Outフィールド? | データタイプ |
|---|---|---|---|---|---|---|---|
| 作成日時 | CoupaがYYY-MM-DDTHH:MM:SS+HH:MMZの形式で自動的に作成します | yes | datetime | ||||
| created-by | 作成したユーザー | yes | ユーザー | ||||
| from-currency | 換算元通貨コード | yes | yes | yes | Currency | ||
| ID | Coupaの一意の識別子 | yes | 整数 | ||||
| rate | 為替レート | yes | yes | 小数 | |||
| rate-date | 有効日 | yes | yes | yes | datetime | ||
| to-currency | 換算先通貨コード | yes | yes | yes | Currency | ||
| updated-at | CoupaがYYY-MM-DDTHH:MM:SS+HH:MMZの形式で自動的に作成します | yes | datetime | ||||
| updated-by | 更新したユーザー | yes | ユーザー | ||||
- 大規模なデータセットの場合、パフォーマンスの最適化のために、常にいくつかのGET条件で結果を制限してください。
- 参照オブジェクトの通貨とそれぞれの通貨コードまたはIDが、システムにすでに存在している必要があります。