発注変更API
概要
このAPIを使用すると、承認中またはサプライヤーに送信された、すでに進行中の発注を変更できます。
注:
発注変更GET APIは、発注書の修正をエンタープライズリソース計画に取得することを目的としていません。
発注書の修正の場合は、必ずexported = falseで発注書GET APIを使用し、「version」値を使用して、発注書が新しいものか修正された発注書かを識別します。
アクション
発注変更APIでは以下の操作が可能です。
| 動詞 | パス | アクション | Description |
|---|---|---|---|
| PUT | /api/purchase_order_changes /: id/add_approver | add_approver | 発注ヘッダーの変更の承認者を手入力で追加 |
| POST | /api/purchase_order_changes | 作成 | 発注変更を作成. ドラフトまたは承認待ちのステータスの発注書のPOSTコールは送信できません。 |
| GET | /api/purchase_order_changes | インデックス | 発注変更の検索 |
| PUT | /api/purchase_order_changes /: id/remove_approval | remove_approval | 手動で追加された承認者を削除 |
| GET | /api/purchase_order_changes /: id | 表示 | 発注変更を表示 |
| PUT | /api/purchase_order_changes /: id/submit_for_approval | submit_for_approval | 発注変更を承認のために送信 |
| PUT | /api/purchase_order_changes /: id | 更新 | 発注変更を更新. Coupa Supplier Portalで作成されたレコードは更新できません。 |
Elements
| 要素 | 説明 | 必須 | 一意 | 許容値 | 入力 | 出力 | データタイプ |
|---|---|---|---|---|---|---|---|
| acknowledged-at | acknowledged_at | yes | 日付 | ||||
| 承認 | 既存のPO変更要求へのPUT/PATCHには、<approver> 属性と <login> 値を含める必要があります。 | はい* | 現在の承認者 <login> はCoupaに存在する必要があります | yes | yes | 承認 | |
| 添付ファイル | 添付ファイル | yes | 添付ファイル | ||||
| 作成日時 | CoupaがYYY-MM-DDTHH:MM:SS+HH:MMZの形式で自動的に作成します | yes | datetime | ||||
| created-by | 作成したユーザー | yes | ユーザー | ||||
| current-approval | 現在/承認待ち | yes | 承認 | ||||
| 部署 | 部署 | yes | 部署 | ||||
| easy_form_response_id | 簡易フォームの回答ID | yes | |||||
| exported | 取引がエクスポート済みかどうかを示す | yes | boolean | ||||
| hide-price | サプライヤーに対し価格を非表示にします。 (TrueまたはFalse) | なし | なし | yes | 発注ヘッダー変更 | ||
| ID | 発注変更申請のCoupaの一意の識別子。 既存の変更申請へのPUT更新に必要 | はい* | 有効な発注変更申請ID | yes | yes | 整数 | |
| 理由 | 理由 | yes | |||||
| order-header-id | 変更中の発注ID 新しいPOST変更申請に必要 | はい* | 有効な発注ヘッダーID | yes | yes | 整数 | |
| order-line-changes | 発注明細変更 | yes | yes | ||||
| payment-method | payment_method | yes | string(255) | ||||
| 支払条件 | 支払条件 | yes | yes | 支払条件 | |||
| Pカード | Pカード | yes | yes | Pカード | |||
| po-number | 発注番号 | yes | string(20) | ||||
| price-hidden | サプライヤーに対し価格を非表示にします。 (TrueまたはFalse) | yes | boolean | ||||
| reject-reason | 却下の理由 | yes | コメント | ||||
| 申請者 | アカウントのログインを申請中 | yes | ユーザー | ||||
| requisition-header-id | requisition_header_id | yes | 整数 | ||||
| ship-to-address | 発送先住所 | yes | 住所 | ||||
| ship-to-user | 発送先ユーザー | yes | yes | ユーザー | |||
| 発送条件 | 発送条件 | yes | yes | 発送条件 | |||
| ソース品番 | source_part_num | yes | yes | string(255) | |||
| ステータス | 発注書ステータス | yes | string(255) | ||||
| supplier | サプライヤー | yes | サプライヤー | ||||
| transmission-emails | 送信メールのコンマ区切りリスト | なし | なし | any | yes | yes | text |
| transmission-method-override | 送信方法の上書き | なし | なし | supplier_default, email、do_not_transmit | yes | yes | string(30) |
| updated-at | CoupaがYYY-MM-DDTHH:MM:SS+HH:MMZの形式で自動的に作成します | yes | datetime | ||||
| バージョン | 発注書サプライヤーバージョン番号 - 発注書が変更されると増加し、サプライヤーへの再送信がトリガーされます。 | yes | 整数 | ||||
| manufacturer_name | Manufacturer Name | yes | yes | string(255) | |||
| manufacturer_part_number | 製造業者の部品番号 | yes | yes | string(255) | |||
| extra_line_attribute | yes | yes | |||||
| service_type | yes | ||||||
| currency | yes | yes | |||||
| milestones | yes | yes | |||||
| recurring-rules | 繰り返しルール | yes | - | ||||
| total | 発注変更文書の総数 | yes | decimal(32,4) | ||||
| pending-cancel | 発注書がキャンセル待ちかどうか (TrueまたはFalse) | yes | boolean | ||||
| lines-count | 発注変更文書の明細数 | yes | 整数 | ||||
| lines-pending-add-count | 発注変更文書に追加待ちの明細数 | yes | 整数 | ||||
| lines-pending-delete-count | 発注変更文書から削除待ちの明細数 | yes | 整数 |
呼び出しの例
発注変更申請を作成
発注変更申請を作成:
投稿https ://{your_instance}.coupahost.com/api/purchase_order_changes
ペイロード
POSTには、元のヘッダーのIDと変更する要素を含める必要があります。 属性の変更には元の発注書と同じ形式を使用します。
<?xml version="1.0" encoding="UTF-8"?> <order-header-change> <order-header-id>1000</order-header-id> 発注書 </order-header-change> <!--への変更依頼-->201成功レスポンス
Coupaは、変更のIDと、POSTペイロードで指定した変更を含む完全なPOを含む新しい <order-header-change> を返します。
<?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> <!--変更を要求された元のPO --> </order-header-change>POの <status> は、変更が新しい承認を必要としない場合は 件の承認済み 件、変更が新しい承認を必要とする場合は 件のPENDING_APPROVAL 件になります。
発注変更申請の更新
承認待ちの発注変更申請は、次の認証されたAPIコールを送信することで変更できます。
POST 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> <!--発注書への変更依頼 --> </order-header-change>200 レスポンス
応答はPOSTと同じです。PUTペイロードで指定した変更を含め、IDと完全なPOを持つ <order-header-change> です。
<?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> <!--変更を要求された元のPO --> </order-header-change>400不適切なリクエストレスポンス
不正なリクエストを送信すると、Coupaからエラーのリストが表示されます。
<?xml version="1.0" encoding="UTF-8"?> <errors> <error> <!--エラー一覧--> </error> </errors>