概念: 調達から支払までのインテグレーション
このトピックでは、調達から支払までの REST API の概要と使用ガイダンスについて説明します。
概要
調達から支払までのインテグレーションにより、 Workday VNDLY と同居している外部の調達システムに対する会社の外部ワークフォースの支出を公開先、レポートを作成することができます。予算、 SOW 、ワーク オーダーのデータの交換は、VNDLY と調達システムの間でデータと情報を交換する調達システムに依存しない API を介して行われます。これらの API は、システム間での直接的なAPIコネクションではなく、データ共有を目的として設計されています。
システムに依存しない API は、シンプルなミドルウェア プロセスに依存します。これにより、VNDLY と調達システムの間で交換されるデータが正確にフォーマットされ、互換性が確保されます。このミドルウェアは、一貫性のあるインテグレーションを提供し、調達業務を円滑化し、調達システム全体でデータを管理できるようにします。
調達から支払までのコンポーネント | インテグレーション機能 |
|---|---|
購買依頼 (PR) リクエスト | サプライヤーが内定を受諾するとすぐに、調達システムで購買依頼 (PR)調達依頼を送信できます。 |
発注書ルックアップ | 調達システムでPR のステータスを確認し、PR が承認されたら発注書 (発注書) 番号を返すことができます。 従業員が VNDLY でオンボーディングされると、発注書は調達システムから取得されます。 VNDLY は、PR が承認され発注書が発行されるまでオンボーディングを完了していません。 |
発注変更 | 請求レートや割当日の変更によって、予算割当済の発注発注書金額が変更された場合に、発注書リクエストを送信できます。 予算額を変更するワーク オーダーの変更により、調達システムで発注書変更が開始。 発注書変更が調達システムで承認されるまで、VNDLY でこの変更が有効になることはありません。 |
商品受領書 (GR) | 時間と経費の取引を、照合のために調達システムに送信できます。 請求が VNDLY で処理されると、タイムシートと経費は商品受領書として調達システムに送信されます。 |
コスト オブジェクト | 正確なコスト オブジェクト (請求コード) を VNDLY にインポートして、時間と経費を正しいアカウントに割り当てることができます。 |
API を使用するには、まず会社を設定する必要があります。次を参照してください。ステップ: 調達から支払までのインテグレーションの会社設定の設定 -
用途
プロセスの各ステップの詳細については、以下のセクションを参照してください。
コスト オブジェクトのインポートまたは既存のコスト オブジェクトの使用
インテグレーションプロセスを効率化するために、既存のインポートされたコスト オブジェクトを使用したり、請求コード テーブルをインポートしたりすることができます。既存のインポートされたオブジェクトまたはテーブルを使用すると、請求コードのフィールドと設定を VNDLY にインポートし、調達システムの設定に直接マッピングできます。アップロードが完了すると、ジョブおよびワーク オーダー フォームで請求コード フィールドが使用可能になります。
"請求コード定義" のインポートにアクセスするには、
"その他" > "会社の設定" > "時間管理と請求" > "請求コード" に
アクセスします。このステップではAPIコールは必要ありません。請求コード定義ファイルのアップロードは、 JSONファイル形式である必要があります。
求人または作業明細書の作成 (SOW)
ジョブまたはSOWを作成する際、リソース マネージャは VNDLY の
求人フォーム "
請求コード コスト割当"
でインポートされた請求コードから選択できます。これにより、従業員のオンボーディング時に、関連付けられたすべてのワーク オーダーが対応する請求コードを使用できるようになります。リソースマネージャはVNDLY でジョブまたはSOWを作成する際に、ジョブまたはSOWに複数の請求コードを追加できます。複数の請求コードが単一のジョブまたはSOWに割り当てられている場合、マネージャは各請求コードについて、
職務フォーム
の配分パーセントまたはSOWの通貨額を設定できます。マネージャはポジションの数とジョブの期間 () を入力できます。また、予算を修正することができます (有効になっている場合)。ジョブがアクティブな場合、ベンダーは候補者に応募を取り、応募者を面接することができます。この時点で、 SOWまたはワーク オーダーは承認または却下されるまで、今後の編集がロックされます。ジョブ候補者のページおよび VNDLY のワーク オーダー ページの
"リビジョン ステータス
"通知に、承認待ちの "購買リクエスト済"
が表示されます。API を使用した、従業員のオンボーディングと購買依頼のリクエスト
ジョブがパブリッシュされ、従業員が承認し、内定が提示されると、ワーク オーダーのステータスが
"オンボーディング可能"
に設定されます。このステージ ()には、イベント/変更フィードバックAPIでAPIイベントが使用可能です。これらのイベントを使用して、購買調達依頼を作成できるようになったことを調達システムに示すことができます。調達システムからの調達調達依頼のステータスは "アクティビティ" ログで確認できます。調達調達依頼がリクエストされたことを示すため、調達プロセス全体でステータスを追跡できます。
Get a List of Purchase Requisition Requests
トリガ イベント/シナリオ | の API名 | API |
|---|---|---|
従業員が承認され、内定が受諾された。 ステータスが "" のワーク オーダーのリストを返します。 purchase_order.requested 承認待ち | イベント/フィードバックの変更 | GET ~/services/program/events/v2/change_feed/ カテゴリ: purchase_order.requested |
イベントAPI は次のものを返します。
id
購買調達依頼リクエストに関連付けられたワーク オーダーの。使用可能id
ワーク オーダー詳細APIをクエリーし、ワーク オーダーに関連付けられた予算と請求コードの詳細を返します。ワーク オーダー詳細の取得
トリガ イベント/シナリオ | の API名 | API |
|---|---|---|
ワーク オーダーを使用 id "イベント/変更フィードバックAPI"から を取得して、ワーク オーダーの承認に必須詳細を返します。 | ワーク オーダー/ワーク オーダー詳細 | GET ~/services/program/work_orders/v2/work_orders/{id}/
|
SOW詳細を取得
トリガ イベント/シナリオ | の API名 | API |
|---|---|---|
SOW を使用 id イベント/変更フィードバックAPIからアクセスし、 SOWを承認するために必須詳細を返します。 | 作業明細書/作業明細書の詳細 | GET ~/services/program/sows/v2/sows/{id}/
|
調達調達依頼リクエストが調達システムによって承認または却下されるまで、ワーク オーダーの更新は無効になります。
タイムシートと請求書の送信
ワーク オーダーの請求コードに対してタイムシートと請求書を送信できます。このプロセスにより、労務費と経費を正確に追跡できるようになり、請求と支払のワークフローが効率化されます。次を参照してください。例: 調達システムのカスタム請求書レポートの作成 -
VNDLY Custom Reports API は、請求書の確認と承認に必要な請求書の詳細を調達システムがクエリーできるようにするために使用されます。時間の入力時および送信時に、従業員の
タイムシート サマリ
に請求コード情報が自動入力されます。API を使用した請求書データの取得、確認、承認
API を使用して、承認待ちの請求請求書のリストを取得できます。その後に、API を使用して請求書ステータスを調達システムから確認済または承認済として取得できます。これらのアクションにより、請求書のアクティビティ ログが更新され、調達システムから提供された請求書ステータスがユーザーに通知されます。
参照 IDを使用して、請求書を調達システムと追跡し、同期できます。
invoice_request_ref_id
請求書リクエスト リストと請求書リクエスト詳細
トリガ イベント/シナリオ | の API名 | API |
|---|---|---|
Get Invoice Request List VNDLY で承認待ちの請求書が送信されている場合。 | 請求書/請求書リクエスト リスト | GET ~/services/program/invoices/v2/invoice_requests/ リクエスト本文 limit : ページごとに返す結果の数。offset : 結果を返す最初のインデックス。ワーク オーダーのクエリーに使用される ID を返します。 invoice_request_ref_number カスタム レポートAPI をクエリーして、請求書に関連付けられている予算と請求コードの詳細を取得するのに使用されます。invoice_request_ref_id 請求請求書の確認と承認に使用されます。 |
Get Invoice Request Details VNDLY で承認待ちの請求書が送信されている場合。 | 請求書/請求書リクエストの詳細 | GET ~/services/program/invoices/v2/invoice_requests/{id} リクエスト本文: id : 請求書リクエストの参照 ID |
カスタム レポートAPIを使用した請求書詳細の取得
現在の実装では、VNDLY カスタム レポートAPIを使用して請求書の詳細を取得します。次を参照してください。例: 調達システムのカスタム請求書レポートの作成 -
トリガ イベント/シナリオ | の API名 | API |
|---|---|---|
カスタム レポートを使用 id とカスタム レポートパラメータを使用して、請求書の詳細を取得します。 | カスタム レポート/カスタム レポートの実行 | GET ~/services/program/custom_reports/v2/custom_reports/ カスタム レポートには、正しいパラメータ名を使用してください。 パラメータは保存済レポートで事前定義され、パラメータ クエリー パラメータを介して渡されます。パラメータ文字列には、パラメータ名と "保存済レポート パラメータ" に適用される値が含まれている必要があります。 |
請求書の確認と承認
トリガ イベント/シナリオ | の API名 | API |
|---|---|---|
確認 - 調達システムが請求書の詳細を受信しました。 調達システムは、リクエストの受領を VNDLY に送信できます。アクティビティ ログを更新し、請求書が調達システムに正常に受領されたことを示します。 | 請求書/請求書リクエストの確認 | POST: ~/services/program/invoices/v2/invoicerequests/acknowledge/ |
を承認 : 調達システムが請求書を承認します。 | 請求書/請求書リクエストの承認 | POST: ~/services/program/invoices/v2/invoicerequests/approve/
|
無効化または却下する請求書
標準の請求書無効化プロセスは調達から支払までのインテグレーションに対応していますが、自動化されたプロセスではなく手動プロセスのままです。請求書のステータスが常に一致するようにするには、請求書をまず VNDLY で無効化してから、調達システムで却下されるようにしてください。
VNDLY ユーザー インターフェイスを使用して、請求書を無効化できます。請求書が無効になると、"請求書" > "請求書の詳細" データセットと "ステータス" フィールドを使用して、カスタム レポートAPI を使用して照会することができます。これにより、調達請求書ステータスを適宜更新し、両方のシステムを同期されたままにすることができます。
ワーク オーダーの更新と承認のリクエスト
ワーク オーダーの更新は、請求コードの予算に影響する可能性があります。ワーク オーダーの修正版は、予算の整合性を確保するために、調達システムによって承認または却下される必要があります。ワーク オーダーのリクエストのステータス (
承認待ち、確認済、承認済、または却下済
) は、ワーク オーダー アクティビティ ログに反映されます。発注変更リクエストのリストは、イベント/変更フィードバックAPIを使用して利用できます。
ワーク オーダーの変更リクエストの取得
トリガ イベント/シナリオ | の API名 | API |
|---|---|---|
変更されたワーク オーダーのリストを返します。 | イベント/フィードバックの変更 | GET ~/services/program/events/v2/change_feed/ カテゴリ: purchase_order_change.requested |
ワーク オーダーのリビジョン リクエストが行われると、調達システムがリクエストを承認または却下するまで、ワーク オーダーはリビジョンできなくなります。これにより、システムと調達システムの間の同期が確保されます。APIエンドポイントは、ワーク オーダーの更新の確認、承認、却下に使用できます。
ワーク オーダーの更新リクエストの確認、承認、または却下
トリガ イベント/シナリオ | の API名 | API |
|---|---|---|
確認 : 調達システムが発注変更を受け取りました。調達システムは、リクエストの受領を VNDLY に送信できます。 アクティビティ ログを更新し、ワーク オーダーのリクエストが調達システムによって正常に受領されたことを示します。 | 発注変更の確認 | POST ~/services/program/purchase_orders/v2/purchase_order_changes/acknowledge/
|
承認 : ワーク オーダーのリクエストが承認されたことを示す、ワーク オーダーのアクティビティ ログを更新します。 変更はワーク オーダーに反映されます。 ワーク オーダーがロック解除されています。 | 発注変更の承認 | POST ~/services/program/purchase_orders/v2/purchase_order_changes/approve/
|
却下 : ワーク オーダーのリクエストが却下されたことを示すために、ワーク オーダーのアクティビティ ログを更新します。 ワーク オーダーに変更は加えられません。 ワーク オーダーがロック解除されています。 | 発注変更の却下 | POST ~/services/program/purchase_orders/v2/purchase_order_changes/reject/
|