勘定科目API (/accounts)
勘定科目APIを使用して、勘定科目を作成および管理し、ビジネスの財務構造を再現します。 たとえば、マーケティング、IT、セールスに独自の予算がある場合は、Coupaでそれぞれに別々の勘定科目を作成できます。
アカウントにアクセスするURLは次のとおりです。 https ://<instance>/api/accounts
詳細については、統合のベストプラクティスを参照してください。
注:
動的勘定科目は、バッキング検索値に基づいて、使用時に作成または更新されます。 検索値を管理することで、動的アカウントを管理します。 動的アカウントのAPIを使用して勘定科目を作成する必要はありません。 その場合、エラーメッセージが表示されることがあります。
アクション
勘定科目APIでは以下の操作が可能です。
| 動詞 | パス | アクション | Description |
|---|---|---|---|
| POST | /api/accounts |
作成 | 勘定科目を作成 |
| GET | /api/accounts/favorites |
favorites | お気に入り |
| GET | /api/accounts |
インデックス | 勘定科目を検索 |
| GET | /api/accounts/recent |
recent | 最近 |
| GET | /api/accounts /: id |
表示 | 勘定科目を表示 |
| PUT | /api/accounts /: id |
更新 | 勘定科目を更新 |
Elements
勘定科目APIでは、次の要素を使用できます。
| 要素 | 説明 | 必須フィールド？ | 一意？ | 許容値 | Api_Inフィールド？ | Api_Outフィールド？ | データタイプ |
|---|---|---|---|---|---|---|---|
| アカウントタイプ | account_type | yes | yes | yes | アカウントタイプ | ||
| account-type-id | 勘定科目タイプのID。 このフィールドは、アカウントの設定によっては表示されない場合があります。 | yes | yes | 整数 | |||
| アクティブ | falseの場合、勘定科目は無効となり、ユーザーは使用できません。 trueの場合、勘定科目はアクティブとなり、使用可能です。 | yes | yes | boolean | |||
| code |
すべての区分がハイフン(-)で連結されています 外部参照の一部としてハイフンを使用しないことをお勧めします。 ルックアップのコード。さもなければ、システムはそれを別のセグメントとして解釈します。 |
yes | 文字列 | ||||
| 作成日時 | CoupaがYYY-MM-DDTHH:MM:SS+HH:MMZの形式で自動的に作成します | yes | datetime | ||||
| created-by | 作成したユーザー | yes | ユーザー | ||||
| ID | Coupaの一意の識別子 | yes | 整数 | ||||
| 名前 | これは勘定科目のニックネームです。 ユーザーは、ユーザーインターフェイスを介してのみこのフィールドを表示および検索できます。 | yes | yes | 文字列 | |||
| segment-1 | 各セグメントは、勘定科目コードのセグメントを表します(例: コード: 99-9023-100132、セグメント1は99、セグメント2は9023、セグメント3は100132) | yes | yes | string(100) | |||
| segment-10 | 各セグメントは、勘定科目コードのセグメントを表します(例: コード: 99-9023-100132、セグメント1は99、セグメント2は9023、セグメント3は100132) | yes | yes | string (100) | |||
| segment-11 | 各セグメントは、勘定科目コードのセグメントを表します(例: コード: 99-9023-100132、セグメント1は99、セグメント2は9023、セグメント3は100132) | yes | yes | string(100) | |||
| segment-12 | 各セグメントは、勘定科目コードのセグメントを表します(例: コード: 99-9023-100132、セグメント1は99、セグメント2は9023、セグメント3は100132) | yes | yes | string(100) | |||
| segment-13 | 各セグメントは、勘定科目コードのセグメントを表します(例: コード: 99-9023-100132、セグメント1は99、セグメント2は9023、セグメント3は100132) | yes | yes | string (100) | |||
| segment-14 | 各セグメントは、勘定科目コードのセグメントを表します(例: コード: 99-9023-100132、セグメント1は99、セグメント2は9023、セグメント3は100132) | yes | yes | string(100) | |||
| segment-15 | 各セグメントは、勘定科目コードのセグメントを表します(例: コード: 99-9023-100132、セグメント1は99、セグメント2は9023、セグメント3は100132) | yes | yes | string(100) | |||
| segment-16 | 各セグメントは、勘定科目コードのセグメントを表します(例: コード: 99-9023-100132、セグメント1は99、セグメント2は9023、セグメント3は100132) | yes | yes | string (100) | |||
| segment-17 | 各セグメントは、勘定科目コードのセグメントを表します(例: コード: 99-9023-100132、セグメント1は99、セグメント2は9023、セグメント3は100132) | yes | yes | string(100) | |||
| segment-18 | 各セグメントは、勘定科目コードのセグメントを表します(例: コード: 99-9023-100132、セグメント1は99、セグメント2は9023、セグメント3は100132) | yes | yes | string(100) | |||
| segment-19 | 各セグメントは、勘定科目コードのセグメントを表します(例: コード: 99-9023-100132、セグメント1は99、セグメント2は9023、セグメント3は100132) | yes | yes | string(100) | |||
| segment-2 | 各セグメントは、勘定科目コードのセグメントを表します(例: コード: 99-9023-100132、セグメント1は99、セグメント2は9023、セグメント3は100132) | yes | yes | string(100) | |||
| segment-20 | 各セグメントは、勘定科目コードのセグメントを表します(例: コード: 99-9023-100132、セグメント1は99、セグメント2は9023、セグメント3は100132) | yes | yes | string (100) | |||
| segment-3 | 各セグメントは、勘定科目コードのセグメントを表します(例: コード: 99-9023-100132、セグメント1は99、セグメント2は9023、セグメント3は100132) | yes | yes | string (100) | |||
| segment-4 | 各セグメントは、勘定科目コードのセグメントを表します(例: コード: 99-9023-100132、セグメント1は99、セグメント2は9023、セグメント3は100132) | yes | yes | string(100) | |||
| segment-5 | 各セグメントは、勘定科目コードのセグメントを表します(例: コード: 99-9023-100132、セグメント1は99、セグメント2は9023、セグメント3は100132) | yes | yes | string(100) | |||
| segment-6 | 各セグメントは、勘定科目コードのセグメントを表します(例: コード: 99-9023-100132、セグメント1は99、セグメント2は9023、セグメント3は100132) | yes | yes | string (100) | |||
| segment-7 | 各セグメントは、勘定科目コードのセグメントを表します(例: コード: 99-9023-100132、セグメント1は99、セグメント2は9023、セグメント3は100132) | yes | yes | string(100) | |||
| segment-8 | 各セグメントは、勘定科目コードのセグメントを表します(例: コード: 99-9023-100132、セグメント1は99、セグメント2は9023、セグメント3は100132) | yes | yes | string(100) | |||
| segment-9 | 各セグメントは、勘定科目コードのセグメントを表します(例: コード: 99-9023-100132、セグメント1は99、セグメント2は9023、セグメント3は100132) | yes | yes | string (100) | |||
| updated-at | CoupaがYYY-MM-DDTHH:MM:SS+HH:MMZの形式で自動的に作成します | yes | datetime | ||||
| updated-by | 更新したユーザー | yes | ユーザー |
注:
- 勘定科目の大規模なデータセットを扱う場合は、常にいくつかの条件でGETを制限してください。
- 勘定科目タイプ(勘定科目表)はシステムにすでに存在している必要があります。APIを使用して勘定科目タイプを作成することはできません。
- 勘定科目タイプ(勘定科目表)はシステムにすでに存在している必要があります。APIを使用して勘定科目タイプを作成することはできません。