作業員割り当てAPI

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

アクション

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

ワーカーの割り当てを更新します。
POST api/worker_assignments /: id 作成

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

必須要素： キャンセル理由
PUT /api/worker_assignments /: id/close close 終了日が今日または過去の場合、課題のステータスを 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>