• 最終編集日時: 13 May 2022

発注書変更API

発注書変更APIを使用して、すでに処理中の注文を承認中またはサプライヤーに送信して変更します。

概要

このAPIを使用して、承認中またはサプライヤーに送信された、すでに処理中の注文を変更します。

メモ

発注書変更GET APIは、ERPに送信するPO修正を取得することを目的としていません。

PO修正の場合は、常にexported = falseのPO GET APIを使用し、「バージョン」の値を使用してPOが新規のものか修正されたPOかを識別します。

アクション

発注書変更APIでは次のことができます。

動詞 パス アクション 説明
プット /api/purchase_order_changes/:id/add_approver 承認者を追加 注文ヘッダーの変更の承認者を手入力で追加
投稿 /api/purchase_order_changes 作成 発注書の変更を作成
取得 /api/purchase_order_changes インデックス 発注書の変更をクエリ
プット /api/purchase_order_changes/:id/remove_approval 承認を削除 手入力で追加された承認者を削除
取得 /api/purchase_order_changes/:id 表示 発注書の変更を表示
プット /api/purchase_order_changes/:id/submit_for_approval 承認を得るために送信 発注書の変更を承認のために送信
プット /api/purchase_order_changes/:id 更新 発注書の変更を更新

要素

要素 説明 必須 一意 許容値 出力 データタイプ
acknowledged-at 受領確認 はい date
approvals <approver> 属性 <login> 既存のPO変更リクエストへのPUT/PATCHに値を含める必要があります。 はい* 現在の承認者 <login> Coupaに存在する必要があります はい はい 承認
添付ファイル 添付ファイル はい 添付書類
created-at 「YYYY-MM-DDTHH:MM:SS+HH:MMZ」の形式で、Coupaによって自動的に作成されます はい 日時
作成者 作成したユーザー はい ユーザー
現在の承認 現在の/保留中の承認 はい 承認
部署 department はい 部署
easy_form_response_id 簡単なフォームの回答ID はい
exported 取引がエクスポートされたか示します はい ブール値
非表示価格 サプライヤーに価格を表示しない真または偽 いいえ いいえ はい 注文ヘッダー変更
id PO変更リクエストに対するCoupaの一意の識別子。既存の変更リクエストへのPUT更新の申請 はい* 有効なPO変更申請ID はい はい 整数
justification justification はい
注文ヘッダーID 変更中の注文のID。新しいPOST変更リクエストの申請 はい* 有効なPOヘッダーID はい はい 整数
注文品目変更 注文品目変更 はい はい
payment-method payment_method はい 文字列(255)
payment-term 支払条件 はい はい 支払条件
Pカード pcard はい はい Pカード
発注書番号 PO番号 はい 文字列(20)
価格非表示 サプライヤーに価格を表示しない真または偽 はい ブール値
却下理由 却下理由 はい コメント
請求者 アカウントのログインを申請中 はい ユーザー
申請書ヘッダーID 申請書ヘッダーID はい 整数
発送先住所 発送先住所 はい 住所
発送先ユーザー 発送先ユーザー はい はい ユーザー
配送条件 配送条件 はい はい 配送条件
ソース品番 ソース品番 はい はい 文字列(255)
status 発注書のステータス はい 文字列(255)
supplier サプライヤー はい サプライヤー
送信メール 送信メールのコンマ区切りリスト いいえ いいえ 任意 はい はい テキスト
送信方法の上書き 送信方法の上書き いいえ いいえ supplier_default、email、do_not_transmit はい はい 文字列(30)
updated-at 「YYYY-MM-DDTHH:MM:SS+HH:MMZ」の形式で、Coupaによって自動的に作成されます はい 日時
version POサプライヤーバージョン番号 - POが変更され、サプライヤーへの再送信がトリガーされるたびに増加します。 はい 整数
製造業者名 製造業者名 はい はい 文字列(255)
製造業者品番 製造業者品番 はい はい 文字列(255)
extra_line_attribute はい はい
サービスタイプ はい
通貨 はい はい
マイルストーン はい はい
繰り返し発生する規則 定期ルール はい -
合計 PO変更文書の総数 はい 小数(32,4)
保留中 – キャンセル POはキャンセル待ちですか?真または偽 はい ブール値
品目数 PO変更文書の項目数 はい 整数
追加保留中の項目の数 PO変更文書に追加待ちの項目数 はい 整数
項目 – 保留中 – 削除カウント PO変更文書から削除待ちの項目数 はい 整数

コールの例

PO変更リクエストを作成

APIを使用してPO変更リクエストを作成するには、 認証済み APIコール:
POST https://{your_instance}.coupahost.com/api/purchase_order_changes

ペイロード

POSTを実行するには、元のヘッダーのIDと変更する要素を含める必要があります。属性変更には元のPOと同じ形式を使用します。

<?xml version="1.0" encoding="UTF-8"?>
<order-header-change>
	<order-header-id>1000</order-header-id>
	<!-- Requested changes to the PO -->
</order-header-change>

201年成功対応

Coupaは新しい <order-header-change> 変更のIDと、POSTペイロードで指定した変更を含む完全なPOが表示されます。

<?xml version="1.0" encoding="UTF-8"?>
<order-header-change>
	<id type="integer">501</id>
	<created-at type="dateTime">2018-04-06T23:14:50+05:30</created-at>
	<updated-at type="dateTime">2018-04-06T23:14:51+05:30</updated-at>
	<order-header-id type="integer">123750</order-header-id>
	<!-- Original PO with requested changes -->
</order-header-change>

<status> のPOは approved 変更に新しい承認が不要な場合、または pending_approval 変更に新しい承認が必要な場合。

PO変更リクエストを更新

承認待ちのPO変更リクエストは、 認証済み APIコール:
POST https://{your_instance}.coupahost.com/api/purchase_order_changes/{id} 場所 {id} <id type="integer"> 2010応答の属性。承認済みのPO変更リクエストは変更できません。

ペイロード

ペイロードの形式は、PO変更の現在の承認者を含める必要があることを除き、基本的にPOSTと同じです。

<?xml version="1.0" encoding="UTF-8"?>
<order-header-change>
	<approver>
		<login>Approver Name</login>
	</approver>
	<!-- Requested changes to the PO -->
</order-header-change>

200件の回答

回答はPOSTと同じです: <order-header-change> PUTペイロードで指定した変更を含む、IDと完全なPOを使用します。

<?xml version="1.0" encoding="UTF-8"?>
<order-header-change>
	<id type="integer">501</id>
	<created-at type="dateTime">2018-04-06T23:14:50+05:30</created-at>
	<updated-at type="dateTime">2018-04-06T23:14:51+05:30</updated-at>
	<order-header-id type="integer">123750</order-header-id>
	<!-- Original PO with requested changes -->
</order-header-change>

400無効なリクエストの応答

誤ったリクエストを送信すると、Coupaはエラーのリストを提供します。

<?xml version="1.0" encoding="UTF-8"?>
<errors>
	<error>
		<!-- List of errors -->
	</error>
</errors>

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

関連アイテム


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