発注書変更API
発注書変更APIを使用して、承認中またはサプライヤーに送信されたいずれかで、すでに進行中の注文を変更します。
概要
このAPIを使用して、承認中またはサプライヤーに送信されたいずれかで、すでに進行中の注文を変更します。
発注書の変更GET APIは、発注書のリビジョンをERPに取得することを目的としていません。
POリビジョンの場合は、必ずexported = falseでPO GET APIを使用し、「バージョン」値を使用して、POが新しいPOであるか、改訂されたPOであるかを識別します。
アクション
発注書変更APIを使用すると、次のことができます。
| 動詞 | パス | アクション | 説明 | ||
|---|---|---|---|---|---|
| プット | /api/purchase_order_changes /: id/add_approver |
add_approver | 注文ヘッダーの変更の承認者を手入力で追加 | ||
| 投稿 | /api/purchase_order_changes |
作成 | 発注書の変更を作成します。ドラフトまたは保留中の承認ステータスの発注書のポストコールを送信することはできません。 | ||
| 取得 | /api/purchase_order_changes |
index | 発注書の変更をクエリ | ||
| プット | /api/purchase_order_changes /: id/remove_approval |
remove_approval | 手入力で追加された承認者を削除 | ||
| 取得 | /api/purchase_order_changes /: id |
表示 | 発注書の変更を表示 | ||
| プット | /api/purchase_order_changes /: id/submit_for_approval |
submit_for_approval | 発注書の変更を承認のために送信 | ||
| プット | /api/purchase_order_changes /: id |
更新 | 発注書の変更を更新します。Coupaサプライヤーポータルで作成されたレコードを更新できません。 | ||
要素
| 要素 | 説明 | 申請済み | 一意 | 許容値 | In | アウト | データタイプ |
|---|---|---|---|---|---|---|---|
| acknowledged - at | acknowledged_at | はい | date | ||||
| 承認 | <login> 値を持つ <approver> 属性は、既存のPO変更要求へのPUT/PATCHに含まれている必要があります。 |
＊ | Coupaには現在の承認者が存在する <login> 必要があります |
はい | はい | 承認 | |
| 添付ファイル | 添付ファイル | はい | 添付 | ||||
| created - at | CoupaがYYY - MM - DDTHH: MM: SS + HH: MMZの形式で自動的に作成しました | はい | 日時 | ||||
| created - by | 作成したユーザー | はい | ユーザー | ||||
| current - approval | 現在の/保留中の承認 | はい | 承認 | ||||
| 部署 | 部署 | はい | 部署 | ||||
| 簡単なフォームの回答ID | 簡単なフォームの回答ID | はい | |||||
| exported | 取引がエクスポートされたか示します | はい | boolean | ||||
| hide - price | サプライヤーに価格を表示しない。「はい」または「はい」 | いいえ | いいえ | はい | 注文ヘッダー変更 | ||
| iD | PO変更リクエストのCoupaの一意の識別子。既存の変更リクエストへのPUT更新が必要です | はい* | 有効なPO変更要求ID | はい | はい | 整数 | |
| 理由 | 理由 | はい | |||||
| order - header - id | 変更中の注文ID。新しい投稿の変更リクエストのリクエスト | はい* | 有効なPOヘッダーID | はい | はい | 整数 | |
| order - line - changes | 注文品目変更 | はい | はい | ||||
| payment - method | 支払方法 | はい | string (255) | ||||
| payment - term | 支払条件 | はい | はい | 支払条件 | |||
| pカード | pカード | はい | はい | Pcard | |||
| po - number | 発注番号 | はい | string (20) | ||||
| price - hidden | サプライヤーに価格を表示しない。「はい」または「はい」 | はい | boolean | ||||
| reject - reason | 却下の理由 | はい | コメント | ||||
| 申請者 | アカウントのログインを申請中 | はい | ユーザー | ||||
| requisition - header - id | 申請書ヘッダーID | はい | 整数 | ||||
| ship - to - address | 発送先住所 | はい | 住所 | ||||
| ship - to - user | 発送先ユーザー | はい | はい | ユーザー | |||
| shipping - term | 配送条件 | はい | はい | 発送条件 | |||
| source - part - num | source_part_num | はい | はい | string (255) | |||
| ステータス | 発注ステータス | はい | string (255) | ||||
| サプライヤー | サプライヤー | はい | サプライヤー | ||||
| transmission - emails | コンマ区切りの送信メールリスト | いいえ | いいえ | 任意の | はい | はい | テキスト |
| transmission - method - override | 送信方法の上書き | いいえ | いいえ | サプライヤー_デフォルト、メール、送信しない | はい | はい | string (30) |
| updated - at | CoupaがYYY - MM - DDTHH: MM: SS + HH: MMZの形式で自動的に作成しました | はい | 日時 | ||||
| バージョン | 発注書サプライヤーバージョン番号-発注書が変更されると増加し、サプライヤーへの再送信がトリガーされます。 | はい | 整数 | ||||
| manufacturer_name | 製造業者名 | はい | はい | string (255) | |||
| 製造元部品番号 | 製造業者品番 | はい | はい | string (255) | |||
| extra_line_attribute | はい | はい | |||||
| service_type | はい | ||||||
| 通貨 | はい | はい | |||||
| マイルストーン | はい | はい | |||||
| recurring - rules | 繰り返し発生するルール | はい | - | ||||
| 合計 | 発注変更文書の総数 | はい | 小数（ 32,4 ） | ||||
| pending - cancel | 発注はキャンセル待ちですか？「はい」または「はい」 | はい | boolean | ||||
| lines - count | 発注変更文書の明細数 | はい | 整数 | ||||
| lines - pending - add - count | 発注変更文書に追加待ちの明細数 | はい | 整数 | ||||
| lines - pending - delete - count | 発注変更文書から削除待ちの明細数 | はい | 整数 |
例の通話
発注書変更リクエストを作成する
認証されたAPI呼び出しを送信して、APIを使用してPO変更申請を作成します。Https :// {your_instance }.coupahost.com/api/purchase_order_changesを投稿
ペイロード
投稿するには、元のヘッダーのIDと変更する要素を含める必要があります。属性の変更には、最初の発注書と同じ形式を使用する。
<?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 -06 T 23:14:50 + 05:30</created-at>
<updated-at type="dateTime">2018 -04 -06 T 23:14:51 + 05:30</updated-at>
<order-header-id type="integer">123750</order-header-id>
<!-- Original PO with requested changes -->
</order-header-change>変更に新しい承認が必要ない場合、PO <status> のは承認されます。変更に新しい承認が必要な場合、PENDING_APPROVALは承認されます。
発注書の変更申請を更新する
認証されたAPIコールを送信することで、承認待ちの発注書変更申請を変更できます。 投稿https ://{ your_instance }.coupahost.com/api/purchase_order_changes/{ id}ここで、{id}は201応答の <id type="integer"> 属性です。すでに承認されている発注書変更申請は変更できません。
ペイロード
ペイロード形式は、発注変更の現在の承認者を含める必要があることを除いて、基本的にPOSTと同じです。
<?xml version="1.0" encoding="UTF-8"?>
<order-header-change>
<approver>
<login>承認者氏名</login>
</approver>
<!-- Requested changes to the PO -->
</order-header-change>200応答
応答はPOSTと同じです。PUTペイ <order-header-change> ロードで指定した変更を含め、IDと完全なPOを含む。
<?xml version="1.0" encoding="UTF-8"?>
<order-header-change>
<id type="integer">501</id>
<created-at type="dateTime">2018 -04 -06 T 23:14:50 + 05:30</created-at>
<updated-at type="dateTime">2018 -04 -06 T 23: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>