• 最終編集日時: 13 May 2022

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

関連アイテム


ソーシングAPI (/ quote_requests)

03 September 2021

Coupa Sourcing APIを使用して、新しいRFxイベントを作成し、サプライヤーの回答を確認し、ラインレベルでサプライヤーを授与します。

プロジェクトAPI (/ projects)

22 December 2021

プロジェクトAPIを使用して、Coupa内のプロジェクトを作成または更新します。

タスクAPI (/ tasks)

22 December 2021

ユーザーAPIを使用すると、ユーザーを作成、更新、またはクエリできます。

トランザクションAPIの受信(/ receiving_transactions)

05 April 2022

在庫トランザクションAPIは、在庫領収書の詳細の作成、更新、クエリに役立ちます。