発注書変更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>
このページに表示されている一部、または全ての内容は、機械翻訳によるものです。ご了承ください。