注文書API（/ purchase_orders）
このページは機械翻訳を使用して翻訳されています。
概要
発注書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を介して利用できる注文オブジェクトの完全なリストです。ただし、ここにリストされているすべてのオブジェクトにエンドポイントがあるわけではありません。一部のオブジェクトはオブジェクトによってのみ参照され、直接更新することはできません。
アクション
注文書APIを使用すると、次のことができます。
| 動詞 | パス | アクション | 説明 |
|---|---|---|---|
| 置く | /api/purchase_orders/:id/cancel |
キャンセル | キャンセル |
| 置く | /api/purchase_orders/:id/close |
終了 | 発注書を終了します。詳細については、発注書を閉じるを参照してください。 |
| 投稿 | /api/purchase_orders |
作成 | 外部発注書機能の一部として発注書を作成します。Coupaベースの発注書には使用しないでください。 |
| 置く | /api/purchase_orders/:id/ignore_window_and_issue |
ignore_window_and_issue | ウィンドウを無視して問題 |
| GET | /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 |
release_from_buyer_hold | バイヤーの保留中に発注書をリリースする |
| 置く | /api/purchase_orders/:id/reopen |
再開の理由を設定するのでしょうか | 仮完了の発注書を再度開きます。仮完了の詳細については、発注書の完了を参照してください。 |
| GET | /api/purchase_orders/:id |
表示 | 発注書を表示 |
| パッチ | /api/purchase_orders/:id |
更新 | 発注書を更新済み |
| 置く | /api/purchase_orders/:id |
更新 | 発注書を更新済み |
要素
| 要素 | 説明 | 必須 | 一意 | 許容値 | で | アウト | データタイプ |
|---|---|---|---|---|---|---|---|
| acknowledged-at | acknowledged-at | はい | 日時 | ||||
| 承認済みフラグ | POはサプライヤーによって承認されましたか？ | はい | はい | ブール値 | |||
| attachments | attachments | はい | はい | 添付ファイルAPI添付ファイルAPI | |||
| 変更タイプ | POの最後のタイプの変更は、POが変更リクエストによって変更されたか、修正によって変更されたかを表します。 | 変更、修正 | はい | 文字列（255） | |||
| coupa-accelerate-status | 固定割引による請求書に割引支払条件があるかどうかを示すステータス | 加速した | はい | 文字列（255） | |||
| created-at | Coupaでレコードが作成された日付。 | はい | 日時 | ||||
| created_by | インボイスを作成したユーザーのCoupa ID | はい | ユーザー | ||||
| currency | 取引の通貨 | はい | はい | 通貨通貨API（/通貨） | |||
| 現在の統合履歴レコード | 現在の統合履歴レコード | はい | インテグレーション履歴記録インテグレーション履歴記録 | ||||
| exported | トランザクションがエクスポートされたかどうかを示します | はい | ブール値 | ||||
| 非表示の価格 | サプライヤーに価格を表示しませんTureまたはFalse。 | no | no | はい | ブール値 | ||
| id | Coupaの内部ID | はい | 整数 | ||||
| internal-revision | 内部改訂番号 - 変更が内部であるか、変更によってPOがサプライヤーに再送信されるかにかかわらず、POが変更されるたびに更新します。 | はい | 整数 | ||||
| 請求書停止 | 請求書停止フラグ | はい | ブール値 | ||||
| 最終エクスポート日時 | トランザクションが最後にエクスポートされた日時の形式：YYYY-MM-DDTHH：MM：SS + HH：MMZ | はい | 日時 | ||||
| order_lines | order_lines | はい | はい | はい | 注文品目発注書API | ||
| payment-method | payment_method | はい | はい | 文字列（255） | |||
| payment-term | 支払条件 | はい | はい | 支払条件支払条件API（/ payment_terms） | |||
| pcard | pcard | はい | はい | pcard | |||
| po_number | PO番号 | はい | はい | はい | はい | 文字列（20） | |
| 価格非表示 | サプライヤーに価格を表示しませんTureまたはFalse。 | はい | ブール値 | ||||
| reason_insight_events | 変更、再開などの理由インサイトイベント | はい | Reason Insightイベント | ||||
| requester | 申請アカウントのログイン | はい | ユーザー | ||||
| requisition_headers | 請求書ヘッダー | はい | 請求書ヘッダー申請API（/ requisitions） | ||||
| ship_to_address | ship_to_address | no | no | 任意 | はい | はい | 住所アドレスAPI（/ addresses） |
| ship-to-attention | 注文が処理されるユーザー。注意に出荷します。 | no | no | 任意 | はい | はい | 文字列（255） |
| ship_to_user | ship_to_user | はい | はい | はい | ユーザー | ||
| 発送期限 | 支払条件 | はい | はい | ShippingTerm | |||
| status | 発注書のステータス | はい | 文字列（50） | ||||
| supplier | サプライヤーのCoupa内部ID番号 | はい | はい | はい | サプライヤー | ||
| SupplierSite | サプライヤーサイト | no | no | 任意 | はい | はい | サプライヤーサイトサプライヤーサイトAPI（/サプライヤーサイト） |
| 送信メール | 送信メールのカンマ区切りリスト | no | no | 任意 | はい | はい | テキスト |
| 送信方法オーバーライド | 送信方法の上書き | no | no | supplier_default、email、do_not_transmit | はい | はい | 文字列（30） |
| transmission-status | 送信ステータス | no | no | created、deferred、deferred_processing、pending_manual、pending_manual_cancel、awaiting_online_purchase、scheduled_for_email、sented_via_email、scheduled_for_cxml、scheduled_for_xml、sent_via_cxml、sent_via_xml、sent_manually、Purchased_online、transmission_failure | はい | string型 | |
| type | 注文の種類 | ExternalOrderHeader | はい | 文字列（255） | |||
| updated-at | 最終更新日 | はい | 日時 | ||||
| updated_by | インボイスを作成したユーザーのCoupa ID | はい | ユーザーユーザーAPI（/ users） | ||||
| version | POサプライヤーバージョン番号 - POが変更され、サプライヤーへの再送信がトリガーされるたびに増加します。 | はい | はい | 整数 | |||
| 分類 | 分類 | msp、サプライヤー | はい | はい | 文字列（255） | ||
| currency | 取引の通貨 | はい | |||||
メモ
- ソースフィールドの値に基づいてクエリ可能になる依存フィールドがあります。
po-method=emailたとえば、に対してクエリを実行する場合、追加のクエリ条件としてpo-emailを追加できます。はい*の付いたフィールドをご覧ください。 - 大きなデータセットとパフォーマンスの最適化のためには、常にいくつかの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を再度開く
仮完了の詳細については、発注書の完了 を参照してください。
理由インサイト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>