SAP Knowledge Base Article - Public

2863231 - Error Message "Work Order details are mandatory, should match with active Work Agreement Job Dates" Displayed While Using SOAP API


When creating or updating workforce data using the API WORKFORCEPERSONMASTERDATAREPLI, the following error message appears in the response:




   <Note>Worker: XXXX - Work Order ist mandatory.</Note>



SAP S/4 HANA Cloud

Reproducing the Issue

  1. Configure the communication arrangement SAP_COM_0301. For more information about creating communication arrangements, refer to  Communication Arrangement.
  2. Use the API WORKFORCEPERSONMASTERDATAREPLI to upload the HR master data.
  3. In the WorkAgreementInformation section, specify the PersonWorkAgreementType as 3 (Service Performer).
  4. Post the API.
  5. See the response.


The work order details were not entered.


The work order details are mandatory for a service performer. Add the missing WorkOrder node, specifying the parameters ValidityPeriod and Supplier and post the API again.

See Also

2646803 - How to maintain employees data in an S/4HANA Cloud

1FD - Scope Item


API, Service Performer , KBA , CA-WFD-INT , S/4HANA Cloud Workforce Domain Integration , How To


SAP S/4HANA Cloud 1908