• 最終編集日時: 13 May 2022

申請書API(/requisition)

申請書APIを使用して、申請書を作成、更新、照会します。

申請書にアクセスするためのURLは次のとおりです。 https://{your_instance_name}/api/requisitions

詳細については、「インテグレーションのベストプラクティス 」を参照してください。

申請書APIオブジェクト 

これは、UIを介して利用できる経費オブジェクトの完全なリストです。ただし、ここにリストされているすべてのオブジェクトにエンドポイントがあるわけではありません。一部のオブジェクトはオブジェクトによってのみ参照され、直接更新することはできません。

wiki.tree();

アクション

申請書APIでは次のことができます。

動詞 パス アクション 説明
プット /api/requisitions/:id/add_approver 承認者を追加 手動で申請書の承認者を追加する
投稿

/api/requisitions/add_to_cart

カートに追加 カートに追加
投稿 /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、ソース品番、サプライヤー予備品番と一致する推奨または最低価格のサプライヤーアイテム
メモ
  • サプライヤーアイテムがカタログに関連付けられている場合、カタログは「承認済み」ステータスで、現在の日付がカタログの開始日内である必要があります。
  • サプライヤーアイテムが契約に関連付けられている場合、契約のステータスは「公開済み」で、現在の日付がカタログの開始日内である必要があります。

このページに表示されている一部、または全ての内容は、機械翻訳によるものです。ご了承ください。

関連アイテム


Coupa Core API

CoupaのRESTful APIは、お客様のデータをCoupaプラットフォームで読み取り、編集し、統合するための堅牢なアクセスを提供します。

APIの開始

Coupa APIの使用に関する一般情報、およびCSVの使用を検討するタイミング。

OAuth 2.0およびOIDCへの移行

Coupaは従来のAPIキーを廃止し、OAuth 2.0 / OIDCの使用を必要としています。R34以降、新しいAPIキーは発行されず、R35ではAPIキーはサポートされなくなります。

リソース

参照データ、トランザクションデータ、共有リソースなど、オブジェクトのタイプ別にAPIエンドポイントを整理しました。