Mandatory/Preferred/Excluded Employees (MPX)

The offer and booking SOAP APIs allow for employees to be specified as:

• Must do the job (i.e. Mandatory, or M);
• Are Preferred (or P) to do the job; or
• Must not do the job (i.e. Excluded, or X).

Accordingly, the Mandatory, Preferred and Excluded options are referred to simply as MPX.

MPX requirements are specified using the EmpMPX data type.

In the offer and booking SOAP APIs it is possible to specify up to a maximum of 10 MPX employees. There may be a mixture of Excluded and Preferred/PreferredOrdered but no other combination is valid.

• If there is more than one Preferred or Mandatory employee it is possible to state whether some are more preferred than others, via the Preferred/PreferredOrdered or Mandatory/MandatoryOrdered (see the EmpMPX data type). If the supplied value is Mandatory, the appointments offered will be for the supplied EmpIDs only.
• If EmpMPX is Preferred, the appointments offered could (depending on cost) be for the preferred EmpIDs and for any other operatives who can also meet the other criteria supplied.
• If EmpMPX is MandatoryNot (excluded), no appointments will be offered for the supplied EmpID.