申請書API(/requisition)
申請書APIを使用して、申請書を作成、更新、照会します。
申請書にアクセスするためのURLは次のとおりです。 https://{your_instance_name}/api/requisitions
詳細については、「インテグレーションのベストプラクティス 」を参照してください。
申請書APIオブジェクト
これは、UIを介して利用できる経費オブジェクトの完全なリストです。ただし、ここにリストされているすべてのオブジェクトにエンドポイントがあるわけではありません。一部のオブジェクトはオブジェクトによってのみ参照され、直接更新することはできません。
wiki.tree();
アクション
申請書APIでは次のことができます。
動詞 | パス | アクション | 説明 |
---|---|---|---|
プット | /api/requisitions/:id/add_approver |
承認者を追加 | 手動で申請書の承認者を追加する |
投稿 |
|
カートに追加 | カートに追加 |
投稿 | /api/requisitions |
作成 | ドラフトステータスで申請書を作成します。その後、手動で提出する必要があります |
取得 | /api/requisitions/current_cart |
現在のカート | 現在のカートをユーザーに送信します。現在のカートがない場合は、作成して送信します |
取得 | /api/requisitions |
インデックス | 申請書を問い合わせ |
取得 | /api/requisitions/mine |
私のもの | /api/requisitions/mine |
プット | /api/requisitions/:id/remove_approval |
承認を削除 | 手入力で追加された承認者を削除 |
プット | /api/requisitions/:id/save_for_later |
後で保存 | API申請書のために後で保存 |
取得 | /api/requisitions/:id |
表示 | 申請書を表示 |
投稿 | /api/requisitions/submit_for_approval |
承認を得るために送信 | 申請書を作成し、承認/購入者アクションのために提出を試みます |
プット | /api/requisitions/:id |
更新 | 申請書を更新 |
プット | /api/requisitions/:id/update_and_submit_for_approval |
承認のためのupdate_and_submit_for_approval | 申請書を更新して、承認を得るために提出 |
要素
要素 | 説明 | 必須 | 一意 | 許容値 | で | 出力 | データタイプ |
---|---|---|---|---|---|---|---|
approvals | approvals | はい | 承認 | ||||
approver | approver | はい | ユーザー | ||||
attachments | attachments | はい | 添付ファイル | ||||
購入者メモ | 購入者からのコメントまたはメモ | はい | はい | テキスト | |||
created-at | 「YYYY-MM-DDTHH:MM:SS+HH:MMZ」の形式で、Coupaによって自動的に作成されます | はい | 日時 | ||||
作成者 | 作成したユーザー | はい | はい | はい | ユーザー | ||
currency | 通貨コード | はい | USD | ||||
現在の承認 | 現在の/保留中の承認 | はい | 承認 | ||||
department | 請求部署 | はい | はい | 部署 | |||
exported | 取引がエクスポートされたか示します | はい | ブール値 | ||||
外部po参照 | 外部発注書参照。顧客が自動生成された発注書番号を上書きする発注書番号を提供できるようにします | no | はい | 任意 | はい | 文字列(255) | |
非表示価格 | サプライヤーに価格を表示しない真または偽 | no | no | はい | 請求ヘッダー | ||
id | Coupaの一意の識別子 | はい | 整数 | ||||
justification | 請求の理由についてのコメント | はい | はい | テキスト | |||
品目数 | 申請書ヘッダー品目数 | no | no | 任意 | はい | 整数 | |
マイルストーン | マイルストーン | はい | はい | 購買・調達:マイルストーン | |||
モバイル通貨 | 使用される既定の通貨 | はい | USD | ||||
移動合計 | total | はい | decimal型 | ||||
need-by-date | アイテムの納品日 | はい | はい | 日時 | |||
pcard | Pカードの名前 | はい | はい | Pカード | |||
価格非表示 | サプライヤーに価格を表示しない。真または偽 | はい | ブール値 | ||||
受領倉庫ID | 受領倉庫ID | no | no | 任意 | はい | はい | 整数 |
繰り返し発生する規則 | 定期ルール | はい | |||||
却下理由コメント | 最終却下理由コメント | はい | 文字列 | ||||
申請書タイトル | 請求のオプションタイトル | はい | はい | 文字列(50) | |||
申請者 | 申請者 | はい | はい | ユーザー | |||
requester | 申請者 | はい | はい | ユーザー | |||
申請書の品目 | requisition_lines | はい | はい | はい | RequisitionLi | ||
発送先住所 | 住所の名前 | はい | はい | はい | 住所 | ||
ship-to-attention | 発送先住所の宛名 | はい | はい | 文字列(255) | |||
status | 取引のステータス | はい | はい | 文字列(50) | |||
送信日時 | submitted_at | はい | 日時 | ||||
タグ | はい | はい | [] | ||||
taggings | はい | はい | [] | ||||
合計 | 自国通貨での合計 | はい | decimal型 | ||||
updated-at | 「YYYY-MM-DDTHH:MM:SS+HH:MMZ」の形式で、Coupaによって自動的に作成されます | はい | 日時 | ||||
更新者 | 更新したユーザー | はい | ユーザー | ||||
ユーザーメンバー | ユーザーメンバー | はい | ユーザー | ||||
user_group_members | ユーザーグループのメンバー | はい | ユーザー |
created_by要素はAPIユーザーキーからデフォルト設定されますが、申請書APIで上書きすることもできます。 Coupaサポートに連絡して、申請書APIでAPIユーザーキーの値を上書きできるようにしてください。
- 申請書の品目では、説明(フリーフォーム)またはアイテム(カタログアイテム)を使用できます。 アイテムIDが使用される場合、そのアイテムは存在する必要があります。
は使用されず、無視されます。 - 通貨、申請者およびサプライヤーのユーザーは、ステータスが有効であるシステム内である必要があります。
- アイテム:推奨サプライヤーと価格がアイテムで利用可能な場合、単価が指定されていない限り、それが使用されます。 単価を指定すると、アイテムで利用可能な既定の価格が上書きされます。 説明とアイテムを指定することはエラーではありませんが、アイテムを使用すると、説明がアイテムの説明に設定され、説明フィールドに渡された説明は無視されます。
- デフォルト設定:XMLで特に指定されていない限り、システムはシステム内の関連するデフォルト設定を優先します。 サプライヤー記録からの支払条件や配送条件の既定値の設定など。
- 項目番号:APIは、新しい項目番号ごとに項目番号が1ずつ増加することを想定しています。 同じline-numを使用すると、同じ番号の他のすべての項目が無視されます。
- バージョン30.2.2のリリースアップデートの一環として、申請者のコンテンツグループ以外のユーザーの申請書を作成できない問題を解決しました。 これで、申請書APIはUIの機能を反映するようになりました。
「作成者」ユーザーがAPIを介して設定されている場合、そのユーザーのコンテンツグループアクセスが申請書の作成について検証されます。参照については、以下の表を参照してください。
api経由で作成された上書き許可 | 作成者はコンテンツグループを介してアクセスできます | 申請者はコンテンツグループを介してアクセスできます | API経由の作成を許可 |
---|---|---|---|
真 | はい | 該当なし | はい |
真 | いいえ | 該当なし | いいえ |
偽 | 該当なし | 該当なし | はい |
既定のサプライヤーアイテムの動作
数量ベース品目を含む申請書がAPI経由で作成されると、サプライヤー品目は以下のルールを使用して申請書の品目を既定値にします。
APIペイロード | 予想結果 |
---|---|
アイテム ID | 推奨または最低価格のサプライヤーアイテム |
アイテムID、サプライヤー | 提供されたサプライヤーIDと一致する推奨または最低価格のサプライヤーアイテム |
アイテムID、サプライヤー、ソース品番 | 提供されたサプライヤーIDとソース品番に一致する推奨または最低価格のサプライヤーアイテム |
アイテムID、サプライヤー、ソース品番、サプライヤー予備品番 | 提供されたサプライヤーID、ソース品番、サプライヤー予備品番と一致する推奨または最低価格のサプライヤーアイテム |
アイテムID、サプライヤー、契約 | 提供されたサプライヤーIDと契約IDに一致する推奨または最低価格のサプライヤーアイテム |
アイテムID、サプライヤー、契約、価格 | 提供されたサプライヤーIDと契約IDと一致する推奨または最低価格のサプライヤーアイテム(価格は一致で使用されません) |
アイテムID、サプライヤー、契約、ソース品番 | 提供されたサプライヤーID、契約ID、ソース品番と一致する推奨または最低価格のサプライヤーアイテム |
アイテムID、サプライヤー、契約、ソース品番、サプライヤー予備品番 | 提供されたサプライヤーID、契約ID、ソース品番、サプライヤー予備品番と一致する推奨または最低価格のサプライヤーアイテム |
- サプライヤーアイテムがカタログに関連付けられている場合、カタログは「承認済み」ステータスで、現在の日付がカタログの開始日内である必要があります。
- サプライヤーアイテムが契約に関連付けられている場合、契約のステータスは「公開済み」で、現在の日付がカタログの開始日内である必要があります。
このページに表示されている一部、または全ての内容は、機械翻訳によるものです。ご了承ください。