• 最終編集日時: 03 September 2021

ソーシングAPI(/quote_requests)

CoupaソーシングAPIを使用して、新しいRFxイベントを作成し、サプライヤーの返答を確認し、品目レベルでサプライヤーに発注します。

概要

ソーシングAPIを使用して次を実行します。

  1. RFP、RFI、またはRFQタイプのイベントを作成します。
  2. イベントに対するサプライヤーの返答を抽出します。
  3. 品目レベルでサプライヤーにイベントを発注します。

Coupaのバックエンドでは、ソーシングイベントは見積申請と呼ばれます。

エンドポイント

次のエンドポイントがソーシングAPIで使用できます。

リソース パス 説明
ソーシングイベント

/api/quote_requests

新しいソーシングイベントの作成と既存イベントの管理のためのエンドポイント
サプライヤーの回答

/api/quote_responses

サプライヤーの回答を取り扱うためのエンドポイント
ソーシングサプライヤー

/api/quote_suppliers

ソーシングイベントでサプライヤーに関する情報を取得するためのエンドポイント

ソーシングAPIオブジェクト

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

wiki.tree() 

コールの例

新規ソーシングイベントを作成

POST /api/quote_requests/

新しいイベントを作成するには、基本的なPOSTを送信します。以下を含む <event-type> それ以外の場合、Coupaは既定でRFIを使用します。

ペイロード

<?xml version="1.0" encoding="UTF-8" ?>
<quote-request>
	<event-type type="symbol">RFQ</event-type>
</quote-request>

201年成功対応

Coupaは、新しく作成されたソーシングイベントを一意の値で返します <id>

<?xml version="1.0" encoding="UTF-8"?>
<quote-request>
	<id type="integer">1434</id>
	<created-at type="dateTime">2018-04-11T10:37:25-07:00</created-at>
	<updated-at type="dateTime">2018-04-11T10:46:58-07:00</updated-at>
	<description nil="true" />
	<start-time type="dateTime">2018-04-11T17:00:00-07:00</start-time>
	<start-on-submit type="boolean">true</start-on-submit>
	<event-type type="symbol">rfi</event-type>
	<end-time type="dateTime">2018-04-25T17:00:00-07:00</end-time>
	<state>draft</state>
	<comments nil="true" />
	<allow-multiple-response type="boolean">true</allow-multiple-response>
	<sealed-bids type="boolean">true</sealed-bids>
	<allow-award-individual-line-items type="boolean">false</allow-award-individual-line-items>
	<automatic-bid-unsealing type="boolean">true</automatic-bid-unsealing>
	<timezone>US/Pacific</timezone>
	<currency>...</currency>
	<lots type="array" />
	<lines type="array" />
	<quote-suppliers type="array" />
	<attachments type="array" />
	<forms type="array" />
	<quote-request-attachments type="array" />
	<tags type="array" />
	<business-partners type="array" />
	</business-partners>
	<created-by>...</created-by>
	<updated-by>...</updated-by>
	<custom-fields />
</quote-request>

特定のイベントに対するすべてのサプライヤーの回答を表示

GET /api/quote_requests/{event_id}/quote_responses

200 OK応答

<?xml version="1.0" encoding="UTF-8"?>
<quote-responses type="array">
	<quote-response>
		<id type="integer">1080</id>
		<created-at type="dateTime">2018-04-10T05:51:28-07:00</created-at>
		<updated-at type="dateTime">2018-04-10T05:51:34-07:00</updated-at>
		<quote-request-id type="integer">1429</quote-request-id>
		<submitted-at type="dateTime">2018-04-10T05:51:34-07:00</submitted-at>
		<state>submitted</state>
		<position type="integer">2</position>
		<comments nil="true" />
		<lines type="array">
			<line>
				<id type="integer">7447</id>
				<created-at type="dateTime">2018-04-10T05:51:28-07:00</created-at>
				<updated-at type="dateTime">2018-04-10T05:51:33-07:00</updated-at>
				<price-amount type="decimal">200.0</price-amount>
				<quantity type="decimal">1.0</quantity>
				<reporting-price-amount type="decimal">200.0</reporting-price-amount>
				<price-currency>...</price-currency>
				<quote-request-line-id type="integer">5834</quote-request-line-id>
				<lot-id type="integer">0</lot-id>
			</line>
		</lines>
		<quote-supplier>
			<id type="integer">1714</id>
			<created-at type="dateTime">2018-04-10T05:50:21-07:00</created-at>
			<updated-at type="dateTime">2018-04-10T05:51:34-07:00</updated-at>
			<name>bnew</name>
			<display-name>bnew</display-name>
			<email>irairaira666555@gmail.com</email>
			<contact-name />
			<supplier nil="true" />
			<created-by>...</created-by>
			<updated-by>...</updated-by>
		</quote-supplier>
	</quote-response>
</quote-responses>

サプライヤーにイベントを受注する

POST /api/quote_responses/{response_id}/award

返答が届いたら <id> を使用して返答を落札できます。

受注するペイロード

<?xml version="1.0" encoding="UTF-8"?>
<root>
	<quote_response_line_ids>7447</quote_response_line_ids>
</root>
メモ

見積返答品目ID(上記の例では7447)を指定しない場合は、すべての品目を一度に落札できます。

200 OK応答

Coupaは本文なしの200 OKを返します。

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

関連アイテム


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エンドポイントを整理しました。