発注書変更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>