Treasury API
キャッシュフローや口座残高などの財務データを取得および更新します。
概要
Treasury REST APIはCoupa Core APIと同じ構造ですが、以下の点にご注意ください。
- JSON形式のみサポート。
- APIのフィルター機能および返却形式はサポートされません。
- offsetパラメーターを使用する際は、データの不整合を避けるためにオブジェクトIDで並び替えてください。
詳細なエンドポイントやオブジェクト構造は下記をご覧ください。
- TreasuryインスタンスでREST APIを確認するには、Treasury APIドキュメントを表示を参照してください。
- Postmanコレクションをダウンロードするには、Coupa API用のPostmanコレクションを参照してください。Treasury APIはJSONコレクションにのみ含まれます。
詳細はCoupa Core APIをご参照ください。
認証フロー
Treasury APIは、Coupa Coreインスタンス内のCoupa Core OpenID Connect (OIDC)認証を使用します。認証フローは以下のとおりです。
- Coupa CoreインスタンスでOIDCクライアントを作成し、[付与タイプ]を[クライアント証明書]に設定。アクセスするエンドポイントに応じてスコープをクライアントに付与します。Coupa Coreでクライアントを作成しトークンを取得する手順はOAuth 2.0およびOIDCを参照してください。
- Coupa Coreインスタンスを使用してアクセストークンを生成。
- 以降のTreasury APIリクエストを、生成したトークンを使用してTreasury URLに送信します。以下のベースURLセクションを参照してください。
ベースURL
Treasury REST APIは、次のようなTreasuryインスタンスURLを使用します。
https://<your-domain>.mytm5.com/v1/cash-management/account-balances