メインコンテンツまでスキップ

 

 

Coupa Japanese

発注書変更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>
  • この記事は役に立ちましたか?