発注書変更API
このページは機械翻訳を使用して翻訳されています。
概要
このAPIを使用して、承認中またはサプライヤーに送信済みのすでに進行中の注文を変更します。
注文書の変更GET APIは、発注書の改訂を取り出してERPに送信することを目的としていません。
発注書改訂の場合は、常にエクスポート済み= falseの発注書GET APIを使用し、「バージョン」値を使用して、発注書が新規発注書か改訂発注書かを識別します。
アクション
発注書変更APIを使用すると、次のことができます。
| 動詞 | パス | アクション | 説明 | ||
|---|---|---|---|---|---|
| 置く | /api/purchase_order_changes/:id/add_approver |
add_approver | 注文ヘッダー変更の承認者を手動で追加 | ||
| 投稿 | /api/purchase_order_changes |
作成 | 発注書変更を作成 | ||
| GET | /api/purchase_order_changes |
インデックス | 発注書変更のクエリ | ||
| 置く | /api/purchase_order_changes/:id/remove_approval |
remove_approval | 手動で追加された承認者を削除する | ||
| GET | /api/purchase_order_changes/:id |
表示 | 発注書の変更を表示 | ||
| 置く | /api/purchase_order_changes/:id |
更新 | 発注書の変更を更新 | ||
要素
| 要素 | 説明 | 必須 | 一意 | 許容値 | で | アウト | データタイプ |
|---|---|---|---|---|---|---|---|
| acknowledged-at | acknowledged-at | はい | date | ||||
| approvals | 既存のPO変更リクエストへのPUT / PATCHには、 <login><approval>値を持つ 属性を含める必要があります。 |
はい* | 現在の承認者 <login> はCoupaに存在する必要があります |
はい | はい | 承認Approvals API（/approvals） | |
| attachments | 添付ファイル | はい | > 添付ファイル | ||||
| created-at | 「YYYY-MM-DDTHH:MM:SS+HH:MMZ」の形式で、Coupaによって自動的に作成されます | はい | 日時 | ||||
| created_by | 作成したユーザー | はい | ユーザーユーザーAPI（/ users） | ||||
| 現在の承認 | 現在/保留中の承認 | はい | 承認Approvals API（/approvals） | ||||
| department | department | はい | 部署部署API（/ departments） | ||||
| easy_form_response_id | 簡易フォーム回答ID | はい | |||||
| exported | トランザクションがエクスポートされたかどうかを示します | はい | ブール値 | ||||
| 非表示の価格 | サプライヤーに価格を表示しませんTureまたはFalse。 | いいえ | いいえ | はい | 注文ヘッダー変更 | ||
| id | PO変更リクエストのためのCoupaの一意の識別子。既存の変更リクエストのPUT更新が必要です | はい* | 有効なPO変更リクエストID | はい | はい | 整数 | |
| justification | justification | はい | |||||
| order-header-id | 変更中の注文のID。新しいPOST変更リクエストが必要です | はい* | 有効なPOヘッダーID | はい | はい | 整数 | |
| order_line_changes | 注文品目変更 | はい | はい | 注文品目変更 | |||
| payment-method | payment_method | はい | 文字列（255） | ||||
| payment-term | 支払条件 | はい | はい | 支払条件支払条件API（/ payment_terms） | |||
| pcard | pcard | はい | はい | pcard | |||
| po_number | PO番号 | はい | 文字列（20） | ||||
| 価格非表示 | サプライヤーに価格を表示しませんTureまたはFalse。 | はい | ブール値 | ||||
| 却下理由 | 却下の理由 | はい | Comment | ||||
| requester | 申請アカウントのログイン | はい | ユーザーユーザーAPI（/ users） | ||||
| 請求#%{requisition_header_id} | 請求#%{requisition_header_id} | はい | 整数 | ||||
| ship_to_address | 発送先住所 | はい | 住所アドレスAPI（/ addresses） | ||||
| ship_to_user | 発送先ユーザー | はい | はい | ユーザーユーザーAPI（/ users） | |||
| 発送期限 | 配送条件 | はい | はい | 配送条件 | |||
| status | 発注書のステータス | はい | 文字列（255） | ||||
| supplier | サプライヤー | はい | サプライヤー | ||||
| 送信メール | 送信メールのカンマ区切りリスト | いいえ | いいえ | 任意 | はい | はい | テキスト |
| 送信方法オーバーライド | 送信方法の上書き | いいえ | いいえ | supplier_default、email、do_not_transmit | はい | はい | 文字列（30） |
| updated-at | 「YYYY-MM-DDTHH:MM:SS+HH:MMZ」の形式で、Coupaによって自動的に作成されます | はい | 日時 | ||||
| version | POサプライヤーバージョン番号 - POが変更され、サプライヤーへの再送信がトリガーされるたびに増加します。 | はい | 整数 | ||||
| Manufacturer_name | 製造業者名 | はい | はい | 文字列（255） | |||
| Manufacturer_part_number | 製造業者品番 | はい | はい | 文字列（255） | |||
| extra_line_attribute | はい | はい | |||||
| service_type | はい | ||||||
| currency | はい | はい |
呼び出し例
PO変更リクエストを作成
認証済みAPI呼び出しを送信して、APIを使用してPO変更リクエストを作成します。
POST 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> <!-- Requested changes to the PO --> </order-header-change>
201成功応答
Coupaは、変更のIDとPOSTペイロードで指定した変更を含む完全なPOを含む<b id="i43"><a id="x21" xid="i222.1.1">新しい[]を返します。</a></b><order-header-change>
<?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変更リクエストを更新
認証済みAPI呼び出しを送信して、承認待ちのPO変更リクエストを変更できます。POST https://{your_instance}.coupahost.com/api/purchase_order_changes/{id}ここで、 {id} は201応答の <id type="integer">属性です。すでに承認されている発注書変更リクエストは変更できません。
ペイロード
ペイロード形式は、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> とID、およびPUTペイロードで指定したすべての変更を含む完全な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>