Update Employee Properties
post
/config/sim/v1/employees/updateProperties
Updates the property assigned to the Employee at the specified hierarchy unit. If Employee property is not found, it assigns the property to the Employee.
Request
Supported Media Types
- application/json
- multipart/form-data
Header Parameters
-
Simphony-AuditTrailRef: string
Detail that identifies, who made the change.
-
Simphony-OrgShortName: string
The ShortName of the organization
Request body
Root Schema : EmployeeProperty
Type:
Show Source
object-
empClassName(optional):
object EmployeeClassNameTranslatedString
A string that contains translations of Employee class name into multiple languages
-
empClassObjNum(optional):
integer
Object number of the class of the employee at the property.Example:
1 -
inTraining(optional):
boolean
Flag indicating if employee is in training at the property.Example:
false -
jobCodes(optional):
array jobCodes
Array of job codes assigned to the employee at the property
-
lateClockInGrace(optional):
integer
The number of minutes that the employee can clock in late without being prompted or requiring authorization.Example:
1 -
ldsId(optional):
integer
unique ID number to identify the employee in a Liquor Dispensing System.Example:
1 -
objectNum:
integer
Unique reference of the employee in the system.Example:
1 -
operators(optional):
array operators
Array of revenue center operators records for the employees
-
options:
string
A string value of 0???s & 1???s representing the enablement or disablement of the options associated with the employee property assignment.Example:
0000 -
optionsExt(optional):
object Employee_properties_optionsExt
-
propertyHierUnitId:
integer
Unique hierarchy unit value associated with the propertyExample:
1 -
propertyName(optional):
object PropertyNameTranslatedString
A string that contains translations of property name into multiple languages
-
propertyObjNum(optional):
integer
Hierarchy unit object number associated with the propertyExample:
1 -
rvcHierUnitId(optional):
integer
Unique hierarchy unit value associated with the RVC.Example:
1 -
rvcName(optional):
object PropertyNameTranslatedString
A string that contains translations of property name into multiple languages
-
rvcObjNum(optional):
integer
Hierarchy unit object number associated with the RVC.Example:
1
Nested Schema : EmployeeClassNameTranslatedString
Type:
objectA string that contains translations of Employee class name into multiple languages
Example:
{
"en-US":"Employee class",
"de-DE":"Mitarbeiterklasse",
"ar-AR":"?????? ????????????"
}Nested Schema : jobCodes
Type:
arrayArray of job codes assigned to the employee at the property
Show Source
Nested Schema : operators
Type:
arrayArray of revenue center operators records for the employees
Show Source
Nested Schema : Employee_properties_optionsExt
Type:
Show Source
object-
disableWorkstationOnlinePrompt(optional):
boolean
Flag indicating to allow offline workstations to automatically re-establish communication with the data center.Example:
false -
limitClkInToWorkstationsInTheClkInRVC(optional):
boolean
Flag indicating to prevent the employee from clocking in unless the revenue center of the Clock-In Cycle matches the revenue center on the workstation.Example:
false -
limitClkOutToWorkstationsInTheClkOutRVC(optional):
boolean
Flag indicating to prevent the employee from clocking out, unless the Current RVC field for the employee matches the revenue center on the workstation.Example:
false
Nested Schema : PropertyNameTranslatedString
Type:
objectA string that contains translations of property name into multiple languages
Example:
{
"en-US":"Property",
"de-DE":"Eigentum",
"ar-AR":"??????????"
}Nested Schema : Employee_properties_jobCodes
Type:
Show Source
object-
jobCodeName(optional):
object JobCodeNameTranslatedString
A string that contains translations of employee job code name into multiple languages
-
jobCodeObjNum(optional):
integer
Object number of the job codeExample:
1 -
otPayRate(optional):
number
Overtime pay rate for the employee in the specified job codeExample:
2.5 -
regularPayRate(optional):
number
Regular pay rate for the employee in the specified job codeExample:
1.23
Nested Schema : JobCodeNameTranslatedString
Type:
objectA string that contains translations of employee job code name into multiple languages
Example:
{
"en-US":"job code1",
"ar-AR":"?????? ??????????????"
}Nested Schema : Employee_properties_operators
Type:
Show Source
object-
cashDrawerObjNum(optional):
integer
Object number of the cash drawer that is permanently assigned to each workstation operator.Example:
1 -
cashierName(optional):
object CashierNameTranslatedString
A string that contains translations of Employee property job codes into multiple languages
-
cashierObjNum(optional):
integer
Object number of the cashier linked to the workstation operator.Example:
1 -
cmAccountingMethodName(optional):
object CmAccountingMethodNameTranslatedString
A string that contains translations of cmAccountingMethodName into multiple languages
-
cmAccountingMethodObjNum(optional):
integer
Object number of Cash Management session type the employee uses to record Cash Management related transactions within the revenue centerExample:
1 -
operatorType(optional):
integer
Guest check printing method for operators assigned to this Employee Class.Example:
1 -
options(optional):
string
A string value of 0???s & 1???s representing the enablement or disablement of the options associated with the employee operator record at the property.Example:
0000 -
optionsExt(optional):
object Employee_operators_optionsExt
-
overrideEmployeeClassOptions(optional):
boolean
A flag indicating whether the workstation operator record uses Employee Class Options or Operator Options to determine transaction behavior.Example:
true -
rvcHierUnitId(optional):
integer
Unique hierarchy unit value of the revenue centerExample:
1 -
rvcName(optional):
object HierUnitNameTranslatedString
A string that contains translations of hierarchy unit name into multiple languages
-
rvcObjNum(optional):
integer
Hierarchy unit object number associated with the revenue centerExample:
1 -
serverBankingTemplateObjNum(optional):
integer
Object number of the default template to use when opening a server bank.Example:
1 -
serverEfficiency(optional):
integer
Efficiency of the server.Example:
1 -
tableCount(optional):
integer
The number of tables each operator serves.Example:
1 -
tmsColorObjName(optional):
object TmsColorObjNameTranslatedString
A string that contains translations of cmAccountingMethodName into multiple languages
-
tmsColorObjNum(optional):
integer
Object number of the color to distinguish the employee from others when using TMS.Example:
1
Nested Schema : CashierNameTranslatedString
Type:
objectA string that contains translations of Employee property job codes into multiple languages
Example:
{
"en-US":"Cashier",
"de-DE":"Kassierer",
"ar-AR":"???????? ??????????????"
}Nested Schema : CmAccountingMethodNameTranslatedString
Type:
objectA string that contains translations of cmAccountingMethodName into multiple languages
Example:
{
"en-US":"Till Banking",
"de-DE":"Bis zum Bankwesen",
"ar-AR":"?????? ????????????????"
}Nested Schema : Employee_operators_optionsExt
Type:
Show Source
object-
allowAssignedReceptacleAccess(optional):
boolean
Flag indicating to allow workstation operators to view and perform transactions for till and server bank receptacles when the workstation operator is not the owner or assigned user.Example:
false -
cannotPerformFastTransactions(optional):
boolean
Flag indicating to require opening a check to begin each transaction.Example:
false -
enableAutoPopUpEntryForStaydownOperator(optional):
boolean
Flag indicating to automatically sign out a staydown operator based on the Automatic Operator Popup Interval setting in Control Parameters. Deselect to allow staydown operators to remain signed on to the workstation.Example:
false -
isPopupOperator(optional):
boolean
Flag indicating to sign the operator out of the workstation at the end of a transaction.Example:
false -
preventMultipleReceptacleCounts(optional):
boolean
Flag indicating to prevent workstation operators from counting a till or server bank receptacle more than once.Example:
false -
preventTransactionsOnceCountIsPerformed(optional):
boolean
Flag indicating to prevent operator from performing transactions once a count has occurred when option 27 (Prevent multiple receptacle counts) is enabled.Example:
false -
requireCheckEmpNumberForNewChecks(optional):
boolean
Flag indicating to require assignment of a check employee when beginning a check.Example:
false -
requireGuestCheckId(optional):
boolean
Flag indicating to require checks opened or picked up by the workstation operator to have a Guest Check ID.Example:
false -
requireNumberOfGuestsEntryForNewChecks(optional):
boolean
Flag indicating to require number of guests entry when beginning a check.Example:
false -
requireSeatNumberEntry(optional):
boolean
Flag indicating to require the operator to have an active seat number when beginning a transaction.Example:
false -
requireTableNumberEntryToBeginOrPickupChecks(optional):
boolean
Flag indicating to require table number entry when beginning a check.Example:
false -
sortGuestCheckSLUByTableName(optional):
boolean
Flag indicating to sort the Open Checks SLU for the workstation operator by Table Name.Example:
false -
useEmpNumberToOpenCheckForAnotherEmployee(optional):
boolean
Flag indicating to require entry of the Employee Number of the workstation operator for whom the check is being started. Deselect to require Employee ID entry of the other workstation operator.Example:
false -
viewBlindTotals(optional):
boolean
Flag indicating to allow workstation operators to view over and under calculations on count sheets.Example:
false
Nested Schema : HierUnitNameTranslatedString
Type:
objectA string that contains translations of hierarchy unit name into multiple languages
Example:
{
"en-US":"Property",
"de-DE":"Eigentum",
"ar-AR":"??????????"
}Nested Schema : TmsColorObjNameTranslatedString
Type:
objectA string that contains translations of cmAccountingMethodName into multiple languages
Example:
{
"en-US":"White",
"de-DE":"Wei??",
"ar-AR":"????????"
}Response
Supported Media Types
- application/json
200 Response
Response Object
Nested Schema : 0
Type:
objectNested Schema : EmployeePropertyResponse
Type:
Show Source
object-
objectNum:
integer
Unique reference of the EmployeeExample:
1 -
propertyHierUnitId:
integer
Unique hierarchy unit value of the propertyExample:
1
400 Response
400 Bad Request
Root Schema : ErrorDetails
Type:
objectResponse body when the request returns an error.
Show Source
-
detail(optional):
string
A short, human-readable summary of the problem.Example:
Specified Data is invalid -
errorDetails(optional):
string
A human-readable explanation specific to this occurrence of the problem.Example:
Entity Does Not Exist -
o:errorCode(optional):
integer
Error code of the problemExample:
55223 -
status(optional):
integer
HTTP status code.Example:
400 -
title(optional):
string
A short, human-readable summary of the problem type.Example:
VALIDATION ERROR -
type(optional):
string
A URI reference that identifies the problem type. When this member is not present, its value is assumed to be "about:blank".Example:
http://www.abc.org/xyz.html