発注書API(/purchase_orders)
発注書APIを使用して、発注書を作成、更新、または照会します。
概要
発注書APIを使用する場合、次のリソースエンドポイントから作業できます。
| リソース | パス | 説明 |
|---|---|---|
| POヘッダー | /api/purchase_orders |
PO品目、支払条件、住所などを含む完全な発注書。詳細につい ては、 「アクション 」と「要素 」を参照してください |
| PO品目 | /api/purchase_order_lines |
アイテム情報や会計の詳細など、PO品目に関する詳細情報。詳細につ いては、「発注書項目API 」および「 注文品目割当API 」を参照してください。 |
| PO変更 | /api/purchase_order_changes |
承認を促進するかどうかにかかわらず、PO変更申請を作成および管理します。 |
| Reason Insights | /api/reason_insights/ |
注文を再開する際に理由を入力します。 |
発注書APIオブジェクト
これは、UIで利用可能な注文オブジェクトの完全なリストです。ただし、ここにリストされているすべてのオブジェクトにエンドポイントがあるわけではありません。一部のオブジェクトはオブジェクトによってのみ参照され、直接更新することはできません。
wiki.tree()
アクション
発注書APIでは次のことができます。
| 動詞 | パス | アクション | 説明 |
|---|---|---|---|
| プット | /api/purchase_orders/:id/cancel |
キャンセル | キャンセル |
| プット | /api/purchase_orders/:id/close |
終了 | 発注書を完了します。 詳細については、「発注書を完了する」を参照してください。 |
| 投稿 | /api/purchase_orders |
作成 | 外部発注書機能の一部として発注書を作成します 。CoupaベースのPOには使用しないでください。 |
| プット | /api/purchase_orders/:id/ignore_window_and_issue |
ウィンドウと問題を無視 | ウィンドウと問題を無視 |
| 取得 | /api/purchase_orders |
インデックス | 発注書を問い合わせ |
| プット | /api/purchase_orders/:id/issue |
問題 | POを発行してサプライヤーに送信します。 |
| プット | /api/purchase_orders/:id/issue_without_send |
送信なしの問題 | POをサプライヤーに送信せずに発行します。 |
| プット | /api/purchase_orders/:id/release_from_buyer_hold |
リリースfrom_buyer_hold | 購入者が保留中の発注書をリリース |
| プット | /api/purchase_orders/:id/reopen |
再開の理由を設定するのでしょうか | 仮完了済み発注書を再度開きます。 仮完了の詳細については、「発注書を完了する」を参照してください。 |
| 取得 | /api/purchase_orders/:id |
表示 | 発注書を表示 |
| パッチ | /api/purchase_orders/:id |
更新 | 発注書を更新 |
| プット | /api/purchase_orders/:id |
更新 | 発注書を更新 |
要素
| 要素 | 説明 | 必須 | 一意 | 許容値 | で | 出力 | データタイプ |
|---|---|---|---|---|---|---|---|
| acknowledged-at | 受領確認 | はい | 日時 | ||||
| 受信確認フラグ | POはサプライヤーによって承認されましたか？ | はい | はい | ブール値 | |||
| attachments | attachments | はい | はい | 添付書類 | |||
| 変更タイプ | 発注書の最新の変更タイプです。発注書の変更が申請によるものか、修正によるものかを示します。 | 変更、修正、確認 | はい | 文字列（255） | |||
| coupa-accelerate-status | インボイスの固定割引による割引支払条件の有無を示すステータス | 高速化 | はい | 文字列（255） | |||
| created-at | Coupaでレコードが作成された日付。 | はい | 日時 | ||||
| 作成者 | インボイスを作成したユーザーのCoupa ID | はい | ユーザー | ||||
| currency | 取引の通貨 | はい | はい | 通貨 | |||
| current-integration-history-records | 統合履歴の記録をスキップ | はい | インテグレーション履歴記録 | ||||
| exported | 取引がエクスポートされたか示します | はい | ブール値 | ||||
| 非表示価格 | サプライヤーに価格を表示しない真または偽 | no | no | はい | ブール値 | ||
| id | Coupaの内部ID | はい | 整数 | ||||
| internal-revision | 内部改訂番号 - 変更が内部であるか、変更によってPOがサプライヤーに再送信されるかにかかわらず、POが変更されるたびに更新します。 | はい | 整数 | ||||
| 請求書停止 | インボイス停止フラグ | はい | ブール値 | ||||
| last-exported-at | 取引が最後にエクスポートされた日時はYYYY-MM-DDTHH:MM:SS+HH:MMZの形式になります | はい | 日時 | ||||
| マイルストーン | マイルストーン | はい | はい | 購買・調達：マイルストーン | |||
| 注文品目 | order_lines | はい | はい | はい | 注文品目 | ||
| payment-method | payment_method | はい | はい | 文字列（255） | |||
| payment-term | 支払条件 | はい | はい | 支払条件 | |||
| pcard | pcard | はい | はい | Pカード | |||
| 発注書番号 | PO番号 | はい | はい | はい | はい | 文字列（20） | |
| 価格非表示 | サプライヤーに価格を表示しない真または偽 | はい | ブール値 | ||||
| reason-insight-events | 変更、再開などの理由インサイトイベント | はい | Reason Insightイベント | ||||
| requester | アカウントのログインを申請中 | はい | ユーザー | ||||
| 申請書ヘッダー | 請求書ヘッダー | はい | 申請書ヘッダー | ||||
| 発送先住所 | ship_to_address | no | no | 任意 | はい | はい | 住所 |
| ship-to-attention | 注文の宛先となるユーザー。発送先は宛名です。 | no | no | 任意 | はい | はい | 文字列（255） |
| 発送先ユーザー | ship_to_user | はい | はい | はい | ユーザー | ||
| 配送条件 | 支払条件 | はい | はい | 配送条件 | |||
| status | 発注書のステータス | はい | 文字列（50） | ||||
| supplier | サプライヤーのCoupa内部ID番号 | はい | はい | はい | サプライヤー | ||
| サプライヤーサイト | サプライヤーサイト | no | no | 任意 | はい | はい | サプライヤーサイト |
| 送信メール | 送信メールのコンマ区切りリスト | no | no | 任意 | はい | はい | テキスト |
| 送信方法の上書き | 送信方法の上書き | no | no | supplier_default、email、do_not_transmit | はい | はい | 文字列（30） |
| transmission-status | 送信ステータス | no | no | created、deferred_processing、pending_manual、pending_manual_cancel、waiting_online_purchase、scheduled_for_email、sent_via_email、scheduled_for_cxml、scheduled_for_xml、sent_via_cxml、sent_via_xml、sent_manually、purched_online、transmission_failure | はい | string型 | |
| type | 注文のタイプ | 外部注文ヘッダー | はい | 文字列（255） | |||
| updated-at | 最終更新日 | はい | 日時 | ||||
| 更新者 | インボイスを作成したユーザーのCoupa ID | はい | ユーザー | ||||
| version | POサプライヤーバージョン番号 - POが変更され、サプライヤーへの再送信がトリガーされるたびに増加します。 | はい | はい | 整数 | |||
| 分類 | 分類 | msp、サプライヤー、vm | はい | はい | 文字列（255） | ||
| 通貨 | 取引の通貨 | はい | |||||
| 確認時間 | 確認者 | はい | 整数 | ||||
| 注文確認レベル | 確認レベル | はい | 整数（11） | ||||
| ユーザーメンバー | ユーザーメンバー | はい | ユーザー | ||||
| ユーザーグループメンバー | ユーザーグループのメンバー | はい | ユーザー | ||||
メモ
- ソースフィールドからの値に基づいてクエリ可能になる依存フィールドがあります。 たとえば、に対してクエリを実行
po-method=emailする場合、追加のクエリ基準としてPOメールを追加できます。 [はい]*のあるフィールドを参照してください。 - 大規模なデータセットやパフォーマンスの最適化のために、いくつかのGET基準で結果を常に制限する必要があります。
- PO変更によってバージョン番号が増加するとは限りません。詳細については、「発注書の修正の原因となるフィールド」を参照してください。 このフ
updated-atィールドは、変更が加えられたかどうかを常に確認するために使用できます。
コード例
PUTを使用して注文品目を削除する
<?xml version="1.0" encoding="UTF-8"?>
<order-header>
<order-lines>
<order-line>
<id>coupa_line_id</id>
<_delete>true</_delete>
</order-line>
</order-lines>
</order-header> 仮完了済みPOを再度開く
仮完了の詳細については、 「発注書を完了する」を参照してください。
Reason Insight IDを使用する
<?xml version="1.0" encoding="UTF-8"?>
<order-header>
<reason-insight-id>1</reason-insight-id>
<reason-insight-event-comment>comment body</reason-insight-event-comment>
</order-header>理由インサイトコードを使用する
<?xml version="1.0" encoding="UTF-8"?>
<order-header>
<reason-insight-code>code</reason-insight-code>
<reason-insight-event-comment>comment body</reason-insight-event-comment>
</order-header>このページに表示されている一部、または全ての内容は、機械翻訳によるものです。ご了承ください。