作業員割り当てAPI

割り当ての確認、終了、開始日、終了日、ジョブの役割などの主要フィールドの変更などの従業員データを取得し、必要に応じてプロビジョニングワークフローのトリガー、資産配布の管理、アクセスの終了を行うことができます。

アクション

動詞パスアクション説明
GET/api/worker_assignmentsインデックスすべての作業員の割り当てを取得。
GET/api/worker_assignments /: id/show_historyshow_historyワーカーの割り当ての履歴を取得します。
GET/api/worker_assignments /: id表示単一の作業員の割り当てデータを取得。
PATCH/api/worker_assignments /: id更新

ワーカーの割り当てを更新します。

POSTapi/worker_assignments /: id作成

新しいワーカーの割り当てを作成します。

PUT/api/worker_assignments /: id更新作業員割り当てを更新
PUT/api/worker_assignments /: id/cancelcancel課題のステータスを キャンセル済み に変更し、課題の履歴にキャンセルのレコードを追加します。

必須要素： キャンセル理由

PUT/api/worker_assignments /: id/closeclose終了日が今日または過去の場合、課題のステータスを Closed に更新します。 今後の終了日については、ステータスが Pending Closeに変更されます。

必須要素： 閉じる理由

PUT/api/worker_assignments /: id/confirm確定すべての必須のオンボーディングアクティビティが承認されると、従業員の割り当てを確認します。 確認されると、課題のステータスは アクティブに更新されます。 開始日が将来の場合、ステータスは Scheduledに更新されます。

Elements

要素説明必須一意許容値入力出力データタイプ

allow-worker-entered-price

割り当てのサービスシートを送信する作業員が手動で価格設定を指定できるかどうかを示します

yes


boolean

auto-close

自動完了

yes


boolean

auto-confirm

自動確認

yes


boolean

close-authority

ユーザーが割り当てを手動で閉じるために必要な権限を持っているかどうかを示す

yes


整数

confirm-authority

権限を確認

yes


整数

作成日時

作成日

yes


datetime

created-by

作成したユーザー

yes


ユーザー

終了日

End Date

yes


yes


datetime

external-reference-identifier

外部参照識別子

yes


string(255)

ID

Coupaの内部ID

yes


整数

job-role-association

割り当てに関連付けられた役割オブジェクト

yes


ReferenceData::JobRole::JobRoleAssociation

resource-manager

作業員マネージャー

yes


ユーザー

service-manager-email

サプライヤー担当者のメールアドレス

yes


yes


string(255)

service-sheet-submission-owner

サービスシート送信オーナー

yes


string(255)

sourceable

発注明細の追加明細属性は、申請明細などの他のタイプでは異なる場合があります。

yes


ExtraLineAttributes::OrderLineAttribute

sourceable-type

発注明細や申請明細など、作業員割り当てのソース可能なタイプ

yes


string(255)

start-date

Start Date

yes


yes


datetime

status

作業員割り当てのステータス

yes


yes


string(255)

supplier-contact-email

サービスマネージャーのメールアドレス

yes


string(255)

updated-at

更新日

yes


datetime

updated-by

更新したユーザー

yes


ユーザー

worker

作業員

yes


Worker::Worker

作業員割り当てを取得

メソッド

取得 /api/worker_assignments

cURLリクエスト例
curl -- location 'https ://<your-instance>.com/api/worker_assignments '\-- header' Accept: application/xml '\-- header 'Accept: application/json '\-- header' Accept: application/octet - stream '\-- header '承認: • • • • • •'
レスポンス例
<?xml version="1.0" encoding="UTF-8"?> <worker-assignments type="array"> <worker-assignment> <id type="integer">1</id> <created-at type="dateTime">2024-11-20T15:39:20-05:00</created-at> <updated-at type="dateTime">2024-11-20T15:39:20-05:00</updated-at> <status>pending_confirmation</status> <start-date type="dateTime">2024-10-31T20:00:00-04:00</start-date> <end-date type="dateTime">2024-11-29T19:00:00-05:00</end-date> <external-reference-identifier nil="true"/> <confirm-authority>buyer</confirm-authority> <close-authority>buyer</close-authority> <service-sheet-submission-owner>supplier</service-sheet-submission-owner> <allow-worker-entered-price nil="true"/> <auto-confirm type="boolean">false</auto-confirm> <auto-close type="boolean">false</auto-close> <supplier-contact-email>test@coupa.com</supplier-contact-email> <worker> <id type="integer">1</id> <created-at type="dateTime">2024-11-20T15:36:25-05:00</created-at> <updated-at type="dateTime">2025-02-15T20:00:30-05:00</updated-at> <first-name>John</first-name> <last-name>Travolta</last-name> <middle-name nil="true"/> <active type="boolean">true</active> <status>open</status> <current-title></current-title> <total-experience-in-years type="decimal">10.0</total-experience-in-years> <portal-access>Not Registered</portal-access> <gender-code>m</gender-code> <gender>Male</gender> <supplier> <id type="integer">1468</id> <name>Art Supply</name> <display-name>Art Supply (DO NOT EDIT)</display-name> </supplier> <worker-addresses type="array"> <worker-address> <id type="integer">6669</id> <created-at type="dateTime">2024-11-20T15:36:25-05:00</created-at> <updated-at type="dateTime">2024-11-20T15:38:05-05:00</updated-at> <street1>542 Southwest Natura Avenue</street1> <street2></street2> <street3></street3> <street4></street4> <city>Orlando</city> <state>FL</state> <state-iso-code></state-iso-code> <postal-code>22331</postal-code> <active type="boolean">true</active> <worker-address-purpose> <id type="integer">33</id> <code>Home</code> <name>Home</name> </worker-address-purpose> </worker-address> </worker-addresses> <external-identifiers type="array"/> <worker-phone-numbers type="array"> <worker-phone-number> <id type="integer">1</id> <created-at type="dateTime">2024-11-20T15:36:25-05:00</created-at> <updated-at type="dateTime">2024-11-20T15:36:25-05:00</updated-at> <phone-type>work</phone-type> <phone-number> <number>9546556861</number> <extension></extension> <country-code>US</country-code> </phone-number> </worker-phone-number> </worker-phone-numbers> </worker> <resource-manager> <id type="integer">4179</id> <login>a.belin2</login> <employee-number></employee-number> <firstname>aaron</firstname> <lastname>belin</lastname> </resource-manager> <sourceable> <id type="integer">671</id> <created-at type="dateTime">2024-11-20T15:35:11-05:00</created-at> <updated-at type="dateTime">2024-11-20T15:35:11-05:00</updated-at> <type>ExtraLineAttributes::DeliverableOrderLineAttribute</type> <order-line> <id type="integer">3258</id> <status>created</status> <description>Reimbursable Expense</description> <line-num>2</line-num> <service-sheet-required type="boolean">false</service-sheet-required> <start-date nil="true"/> <end-date nil="true"/> <supplier-contact-email></supplier-contact-email> <manager nil="true"/> <commodity nil="true"/> <order-header> <id type="integer">2542</id> <created-at type="dateTime">2024-11-20T15:35:11-05:00</created-at> <updated-at type="dateTime">2024-11-20T15:35:22-05:00</updated-at> <po-number>2542</po-number> <status>issued</status> </order-header> </order-line> </sourceable> <job-role-association nil="true"/> <created-by> <id type="integer">80</id> <login>user@email.com</login> <employee-number nil="true"/> </created-by> <updated-by> <id type="integer">80</id> <login>user@email.com</login> <employee-number nil="true"/> </updated-by> </worker-assignment> </worker-assignments>