サプライヤーアイテムAPI (/supplier_items)
サプライヤーアイテムAPIを使用すると、従業員が申請書の作成時に選択するサプライヤーが提供する商品を作成、更新、または照会できます。
サプライヤーアイテムにアクセスするためのURL:
https ://<instance>/api/supplier items詳細については、統合のベストプラクティスを参照してください。
アクション
サプライヤーアイテムAPIでは以下の操作が可能です。
| 動詞 | パス | アクション | Description |
|---|---|---|---|
| POST | /api/items/:item_id/supplier_items | 作成 | サプライヤーアイテムを作成 |
| POST | /api/supplier_items | 作成 | サプライヤーアイテムを作成 |
| GET | /api/items/:item_id/supplier_items | インデックス | サプライヤーアイテムのクエリ |
| GET | /api/supplier_items | インデックス | サプライヤーアイテムのクエリ |
| GET | /api/supplier_items/search | search | サプライヤーアイテムの高度な検索 |
| GET | /api/items/:item_id/supplier_items/:id | 表示 | サプライヤーアイテムの表示 |
| GET | /api/supplier_items/:id | 表示 | サプライヤーアイテムの表示 |
| PUT | /api/items/:item_id/supplier_items/:id | 更新 | サプライヤーアイテムの更新 |
| PUT | /api/supplier_items/:id | 更新 | サプライヤーアイテムの更新 |
| DELETE | /api/supplier_items/:id | delete | サプライヤーアイテムの削除 |
Elements
サプライヤーアイテムAPIでは次の要素を使用できます。
| 要素 | Description | 必須フィールド？ | 一意？ | 許容値 | Api_Inフィールド？ | Api_Outフィールド？ | データタイプ |
|---|---|---|---|---|---|---|---|
| availability | 提供状況 | in_stock, out_of_stock, backordered | yes | string(255) | |||
| availability-date | 利用可能日 | any | yes | datetime | |||
| catalog | catalog | yes | yes | ||||
| contract | contract | yes | yes | 契約 | |||
| contract-term | contract_term | yes | yes | ContractTerm | |||
| 作成日時 | CoupaがYYY-MM-DDTHH:MM:SS+HH:MMZの形式で自動的に作成します | yes | datetime | ||||
| created-by | 作成したユーザー | yes | ユーザー | ||||
| currency | 取引の通貨 | yes | yes | Currency | |||
| ID | Coupaの一意の識別子 | yes | 整数 | ||||
| アイテム | アイテム | yes | yes | アイテム | |||
| lead-time | lead_time | yes | yes | 整数 | |||
| manufacturer | manufacturer | yes | yes | 文字列 | |||
| minimum_order_quantity | minimum_order_quantity | なし | なし | any | yes | yes | decimal(30,6) |
| order_increment | order_increment | なし | なし | any | yes | yes | decimal(30,6) |
| preferred | このアイテムの優先サプライヤーを示します。この要素をクエリパラメータとして使用する場合は、 preferred_flag に変更します。例： /api/supplier_items? item [item_number] =<item_id>& preferred_flag = false |
true、false | yes | yes | boolean | ||
| 価格 | 価格 | yes | yes | 小数 | |||
| price-change | 価格変更 | yes | yes | float | |||
| price-tier-1 | 価格層1 | yes | yes | 小数 | |||
| price-tier-10 | 価格層10 | yes | yes | 小数 | |||
| price-tier-11 | 価格層11 | yes | yes | 小数 | |||
| price-tier-12 | 価格層12 | yes | yes | 小数 | |||
| price-tier-13 | 価格層13 | yes | yes | 小数 | |||
| price-tier-14 | 価格層14 | yes | yes | 小数 | |||
| price-tier-15 | 価格層15 | yes | yes | 小数 | |||
| price-tier-16 | 価格層16 | yes | yes | 小数 | |||
| price-tier-17 | 価格層17 | yes | yes | 小数 | |||
| price-tier-18 | 価格層18 | yes | yes | 小数 | |||
| price-tier-19 | 価格層19 | yes | yes | 小数 | |||
| price-tier-2 | 価格層2 | yes | yes | 小数 | |||
| price-tier-20 | 価格層20 | yes | yes | 小数 | |||
| price-tier-3 | 価格層3 | yes | yes | 小数 | |||
| price-tier-4 | 価格層4 | yes | yes | 小数 | |||
| price-tier-5 | 価格層5 | yes | yes | 小数 | |||
| price-tier-6 | 価格層6 | yes | yes | 小数 | |||
| price-tier-7 | 価格層7 | yes | yes | 小数 | |||
| price-tier-8 | 価格層8 | yes | yes | 小数 | |||
| price-tier-9 | 価格層9 | yes | yes | 小数 | |||
| savings-pct | 節減率 | yes | yes | 小数 | |||
| supplier | supplier | yes | yes | yes | サプライヤー | ||
| supplier-aux-part-num | サプライヤー予備品番 | yes | yes | 文字列 | |||
| supplier-part-num | サプライヤー品番 | yes | yes | yes | 文字列 | ||
| unspsc-code | UNSPSCコード | no | no | any | yes | string(255) | |
| updated-at | CoupaがYYY-MM-DDTHH:MM:SS+HH:MMZの形式で自動的に作成します | yes | datetime | ||||
| updated-by | 更新したユーザー | yes | ユーザー | ||||
注:
supplier_number、contract_name、item_name、currency_codeは、システム内にすでに存在している必要があります。