Upsert Location Parameters
post
/config/sim/v2/hierarchy/upsertLocationParameters
Updates the provided fields when Location Parameters exist; otherwise, returns an error.
Request
Supported Media Types
- multipart/form-data
- application/json
Header Parameters
-
Simphony-AuditTrailRef: string
Detail that identifies, who made the change.
Partially updates an existing Location Parameters record. taiwanGUIParameters, timekeeping, calendar, and serialNumberInfo cannot be null when supplied.
Root Schema : schema
Type:
Show Source
object-
calendar:
object LocationParams_calendarv2
An object containing the calendar settings for the location
-
emailConfiguration:
object LocationParams_emailConfiguration
An object containing the email configuration for the location
-
hierUnitId(required):
integer
Unique reference of the hierarchy unit of the locationExample:
1 -
language:
object LocationParams_languageV2CUD
An object containing a language available at the property.
-
ldsNLUGroup:
integer
The number of the Menu Item NLU Group to be used by menu items posted by the LDSExample:
0 -
numDaystoSaveCABatchFiles:
integer
The number of days to retain Credit Authorization batch files and log files. Value must lie between 1 and 999 (both inclusive).Example:
1 -
options:
string
A string value of 0s & 1s of length 128 representing options for location parameters.Example:
00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 -
optionsExt:
object LocationParams_optionsExt
An object containing the descriptive options list associated with the location parameter.
-
postingOptions:
string
A string value of 0s & 1s of length 8 reprsenting posting options for location parameters.Example:
00000000 -
postingOptionsExt:
object LocationParams_postingOptionsExt
An object containing the descriptive options list associated with the location parameter.
-
reportingLanguageObjNum:
integer
The object number of the language to use when posting data to Reporting and Analytics.Example:
1 -
secondaryPrintLanguageObjNum:
integer
Object number of the language to print under the Default Language on a guest check or customer receiptExample:
0 -
security:
object LocationParams_securityv2CUD
An object containing the credentials of the property's workstations.
-
serialNumberInfo:
object LocationParams_serialNumberInfo
An object containing the details of the system serial numbers
-
serviceHosts:
array serviceHosts
An array of service hosts associated with the location. Each service type can appear only once. Services omitted from the supplied array have their host assignments cleared, port reset to 8080, and URL reset to EGateway/EGateway.asmx. Null or an empty array resets all services.
-
simphonyEssentials:
object LocationParams_simphonyEssentials
Object containing the configuration settings for Simphony Essentials enabled organization
-
taiwanGUIParameters:
object LocationParams_taiwanGUIParameters
An object containing the Taiwan tax number prefix and the end of range tax threshold
-
timekeeping:
object LocationParams_timekeeping
An object containing the timekeeping configuration for the location
-
wlsStrengthOfflineThreshold:
integer
Minimum Value:
0Maximum Value:99The percentage amount to be used to determine if communications should be suspended for wireless workstations, until network signal strength is improved.Example:0 -
wlsStrengthReconnectThreshold:
integer
Minimum Value:
0Maximum Value:99The percentage amount of signal strength to be used to determine at which point the system attempts to reconnect wireless workstations to the network.Example:0 -
workstationOptions:
object LocationParams_workstationOptionsv2
An object containing the workstation options associated with the location
Nested Schema : LocationParams_calendarv2
Type:
objectAn object containing the calendar settings for the location
Show Source
-
currentBusinessDate:
string
Current business date of the locationExample:
12/20/21 -
manualSODSafetyCatchTime:
string
the time the application automatically increments the business date if manually SOD is not run.Example:
00:00 -
startedAt:
string
Time at which the current business date started at the location.Example:
12/20/21 03:00:00 AM -
startOfDaySettings(required):
array startOfDaySettings
An array of the start of day settings for the business week. Weekdays omitted from the supplied array reset to manual start of day with no PC Autosequence assigned. An empty array resets all weekdays.
-
startOfPeriodSettings(required):
object LocationParams_startOfPeriodSettingsv2
An object containing the start of period settings for the location
Nested Schema : LocationParams_emailConfiguration
Type:
objectAn object containing the email configuration for the location
Show Source
-
backupSMTPServer:
object LocationParams_backupSMTPServer
An object containing the backup SMTP server details for email configuration of the property.
-
htmlFormatting:
object LocationParams_htmlFormatting
An object containing the text formatting settings of the email configuration of the location.
-
primarySMTPServer:
object LocationParams_primarySMTPServer
An object containing the primary SMTP server settings of the location.
-
sendHTMLEmail:
boolean
A flag indicating if the mail format is in HTML.Example:
false -
textFormatting:
object LocationParams_textFormatting
An object containing the text formatting settings of the email configuration of the location.
Nested Schema : LocationParams_languageV2CUD
Type:
objectAn object containing a language available at the property.
Show Source
-
languageNum:
integer
Minimum Value:
1Maximum Value:4The index of the language configured (1 to 4).Example:1 -
languageObjNum:
integer
Object number of an existing language at the organization root.Example:
1
Nested Schema : LocationParams_optionsExt
Type:
objectAn object containing the descriptive options list associated with the location parameter.
Show Source
-
acceptGenericEmployeeIDCard:
boolean
A flag indicating if the site uses its own employee ID cards.Example:
false -
disableDSTOnKDSDisplayControllers:
boolean
disable Daylight Saving Time on KDS Controllers. Deselect to synchronize Daylight Saving Time settings between the CAL Server and KDS Controllers in the property.Example:
false - disableP2PCheckSharingWhenCAPSUnavailable: boolean
-
doNotShowNegativeTareWeight:
boolean
A remove negative tare weights from the POS client, checks, and receipts.Example:
false -
doNotShowtareWeight:
boolean
prevent tare weight from appearing on the POS client, checks, and receipts.Example:
false -
dontCheckMacroLoopLimit:
boolean
A disable the limit of 20 consecutive macro iterations.Example:
false -
enableClockInRequirementForAuthorization:
boolean
require that employees clock-in to authorize workstation actions.Example:
false -
enableEUROCurrencySystem:
boolean
A make the Euro functionality and all requirements available in the system.Example:
false -
enableEventsReporting:
boolean
A associate transactions with events and to use event reporting.Example:
false -
enableNoDefaultAreaSelectedOption:
boolean
A allow a privileged workstation operator to select No default area selected, rather than a default area.Example:
false -
enableSalesRecordingModule:
boolean
A flag indicating for Quebec sites required to use a Sales Recording Module (SRM) device.Example:
false -
enableSeatNumberInJournal:
boolean
A include the seat number on the journal output.Example:
false -
enableWorkstationAlerting:
boolean
A enable generation of alerts that will be displayed on workstations within the property.Example:
false -
euroCurrencyConversionReportingFeature:
boolean
A print change due on the customer receipt in both the local and Euro currency.Example:
false -
euroIsBaseCurrency:
boolean
make the Euro dollar the base currency for the systemExample:
false -
extendedEventDate:
boolean
send extra summary details to the VSS interface.Example:
false -
eybs:
boolean
A create a separate log to track database changes made for Weights and Measures.Example:
false -
hrgasPMSCompatability:
boolean
A void tenders on a check that have been posted to the PMS when the check is reopened and the first tender is voided.Example:
false -
issueChangeInNationalCurrency:
boolean
issue change in the national currency.Example:
false -
itemDiscountsNetSubTotalDiscountItemizers:
boolean
A post the subtotal discount against the total amount of the itemizer, regardless of item discounts.Example:
false -
postNonTaxableSlaesTotalsNetOfDiscounts:
boolean
A include discounts in calculating the non-taxable sales total that appears on System Tax Reports.Example:
false -
postVoidsToLDS:
boolean
send negative postings to the Oracle suspense file and to the LDSExample:
false -
printAltSummaryTotalsBeforeBase:
boolean
A reverse the print order of the Base and Alternate Summary Totals sections on Euro checks and receipts.Example:
false -
printSimplifiedAltSummaryTotals:
boolean
A reduce the Alternate Summary Totals section to the section header and a single Amount Due/Payment.Example:
false -
printSODValidationChit:
boolean
print a validation chit when the user runs Start of Day from the POS client.Example:
false -
runSODFromOPS:
boolean
allow a user to run Start of Day from the POS clientExample:
false -
sendCashierNumberInsteadOfOperatorNumber:
boolean
A store the cashier number in the Credit Card Batch, rather than the operator number.Example:
false -
showItemWeightInKilos:
boolean
A print and show the weight of weighed menu items in kilograms.Example:
false -
showItemWeightInOunces:
boolean
print and show the weight of weighed menu items in ouncesExample:
false -
use24HourClock:
boolean
A print and show time in 24-hour formatExample:
false -
useDDMMYYYYFormat:
boolean
A print and show dates with the day first.Example:
false
Nested Schema : LocationParams_postingOptionsExt
Type:
objectAn object containing the descriptive options list associated with the location parameter.
Show Source
-
hostFinancialReportFormat:
boolean
A flag indicating for systems installed at Host sitesExample:
false -
isSynchronousConnectionForClockInOutPunch:
boolean
A allow Clock In/ Out to communicate with Labor Management instantly, instead of scheduled requests.Example:
false -
postFoodCostTotalsNetOfItemDiscounts:
boolean
A post food cost totals net of item discounts.Example:
false -
postOfflineTransactionsWithActualTransactionTime:
boolean
A post Offline checks to the database with the actual time stamp of the transaction.Example:
false -
postSalesNetOfVAT:
boolean
A post menu items, discounts, and service charges net of VAT.Example:
false
Nested Schema : LocationParams_securityv2CUD
Type:
objectAn object containing the credentials of the property's workstations.
Show Source
-
adminUser:
string
Admin Username for the property's workstations. Changes take effect when the workstations are restarted.Example:
user -
adminUserPassword:
string
The admin password for the property's workstations. Changes take effect when the workstations are restarted.Example:
cfsdf@343% -
dbUser:
string
The Database Username for the property's workstations.Example:
user -
dbUserPassword:
string
The Database Password for the property's workstations.Example:
cfsdf@343% -
installSecurityUser:
string
Install Security Username for the property's workstations.Example:
user -
installSecurityUserPassword:
string
Install Security password for the property's workstations.Example:
cfsdf@343%
Nested Schema : LocationParams_serialNumberInfo
Type:
objectAn object containing the details of the system serial numbers
Show Source
-
maxSerialNum1(required):
integer
The maximum value for system serial #1 (2 to 99999).Example:
99999 -
maxSerialNum2(required):
integer
The maximum value for system serial #2 (2 to 99999).Example:
99999 -
minSerialNum1(required):
integer
The minimum value for system serial #1 (1 to 99998).Example:
1 -
minSerialNum2(required):
integer
The minimum value for system serial #2 (1 to 99998).Example:
1
Nested Schema : serviceHosts
Type:
arrayAn array of service hosts associated with the location. Each service type can appear only once. Services omitted from the supplied array have their host assignments cleared, port reset to 8080, and URL reset to EGateway/EGateway.asmx. Null or an empty array resets all services.
Show Source
Nested Schema : LocationParams_simphonyEssentials
Type:
objectObject containing the configuration settings for Simphony Essentials enabled organization
Show Source
-
fiscalLocationName:
string
Name of the Country associated with the Fiscal location.Example:
Mexico -
fiscalLocationNum:
integer
Minimum Value:
0Maximum Value:2Select the Fiscal Location for this Property.Example:1
Nested Schema : LocationParams_taiwanGUIParameters
Type:
objectAn object containing the Taiwan tax number prefix and the end of range tax threshold
Show Source
-
endOfRangeThreshold(required):
integer
The end of range tax threshold.Example:
25 -
taxNumPrefix:
string
The Taiwan tax number prefix. Maximum string length allowed is 2.Example:
TU
Nested Schema : LocationParams_timekeeping
Type:
objectAn object containing the timekeeping configuration for the location
Show Source
-
enableLaborManagement(required):
boolean
Indicates whether Labor Management is enabled for employee configuration.Example:
false -
printAccumulatedLaborShiftTotalsInClockInOutChits:
boolean
A print a single labor shift total hours worked by employees on clock-in/out chits.Example:
false -
printWTDTotalsInClockInOutChits:
boolean
A print week-to-date total hours worked by employees on clock-in/out chits.Example:
false -
propertyLaborManagementURL:
string
The URL if workstations use an external address when connecting to the Simphony Labor web service.Example:
myLabor.orcle.com
Nested Schema : LocationParams_workstationOptionsv2
Type:
objectAn object containing the workstation options associated with the location
Show Source
-
dbUpdateFrequency:
integer
The number of seconds the workstation and KDS Controllers wait to retrieve updates from the database.Example:
1800 -
defaultTransactionHelpScreenObjNum:
integer
Object number of the Help Screen to show when the Help key is pressed on workstations.Example:
0 -
linesPerWSReportPage:
integer
The number of lines to print per page on workstation reports.Example:
0 -
onDemandReplayFrequencyCheck:
integer
The number of seconds for workstations to wait before checking for initiation of an on demand replay.Example:
0
Nested Schema : startOfDaySettings
Type:
arrayAn array of the start of day settings for the business week. Weekdays omitted from the supplied array reset to manual start of day with no PC Autosequence assigned. An empty array resets all weekdays.
Show Source
Nested Schema : LocationParams_startOfPeriodSettingsv2
Type:
objectAn object containing the start of period settings for the location
Show Source
-
otherPeriod1:
array otherPeriod1
An array of dates for the Other Period 1.
-
otherPeriod1PCAutoSeqObjNum:
integer
Object number of the PC autosequence of Other Totals period 1.Example:
1 -
otherPeriod2:
array otherPeriod2
An array of dates for the Other Period 2.
-
otherPeriod2PCAutoSeqObjNum:
integer
Object number of the PC autosequence of Other Totals period 2.Example:
1 -
otherPeriod3:
array otherPeriod3
An array of dates for the Other Period 3.
-
otherPeriod3PCAutoSeqObjNum:
integer
Object number of the PC autosequence of Other Totals period 3.Example:
1 -
sOMAlternateDates:
array sOMAlternateDates
An array of alternate dates for the start of month.
-
sOMPCAutoSeqObjNum:
integer
Object number of the PC autosequence of start of month.Example:
1 -
sOPPCAutoSeqObjNum:
integer
Object number of the PC autosequence of start of period.Example:
1 -
sOQAlternateDates:
array sOQAlternateDates
An array of alternate dates for the start of quarter. Applicable only if useSOQAlternateDates = true
-
sOQPCAutoSeqObjNum:
integer
Object number of the PC autosequence of start of quarter.Example:
1 -
sOWPCAutoSeqObjNum:
integer
Object number of the PC autosequence of start of week.Example:
1 -
sOYAlternateDates:
array sOYAlternateDates
An array of dates for the start of year
-
sOYPCAutoSeqObjNum:
integer
Object number of the PC autosequence of start of year.Example:
1 -
startOfMonth:
integer
The day of the month that represents the start of the business month.Example:
1 -
startOfPayPeriod:
object startOfPayPeriod
Localized name representing the start of pay period.
-
startOfQuarter:
string
A string representing the start dates for the quarter in MM/DD formatExample:
1/4 , 4/1, 7/1, 10/1 -
startOfWeek:
integer
The day of the week that represents the start of the business week.Example:
1 -
startOfYear:
integer
Month for the start of the yearExample:
1 -
useSOMAlternateDates:
boolean
A use user-defined dates for this period, instead of standard calendar periodsExample:
false -
useSOQAlternateDates:
boolean
A use user-defined dates for this period, instead of standard calendar periods.Example:
false -
useSOYAlternateDates:
boolean
Use user-defined dates for the start of year instead of standard calendar periods.Example:
false
Nested Schema : LocationParams_startOfDaySettingsv2
Type:
Show Source
object-
dayOfWeek:
integer
A number representing the day of the weekExample:
1 -
pcAutoSequenceObjNum:
integer
Object number of the PC Autosequence to run immediately after the given business day begins.Example:
1 -
runManually:
boolean
A manually run the start of day for this business date.Example:
false -
time:
string
The start time of the start of day for given day of the week.Example:
03:00
Nested Schema : sOMAlternateDates
Type:
arrayAn array of alternate dates for the start of month.
Show Source
Nested Schema : sOQAlternateDates
Type:
arrayAn array of alternate dates for the start of quarter. Applicable only if useSOQAlternateDates = true
Show Source
Nested Schema : startOfPayPeriod
Type:
objectLocalized name representing the start of pay period.
Example:
{
"en-US":"Biweekly"
}Nested Schema : LocationParameters_AlternateDates
Type:
Show Source
object-
date:
string
Date in DD/MM/YYYY format.Example:
12/01/2021 -
number:
integer
Sequence number of the date within the period.Example:
1
Nested Schema : LocationParams_backupSMTPServer
Type:
objectAn object containing the backup SMTP server details for email configuration of the property.
Show Source
-
isSSL:
boolean
A require secure Internet communication.Example:
false -
name:
string
The business name or name to appear along with the email in the sender field.Example:
Admin -
password:
string
The password associated with the email user name.Example:
aaddsfgf@34 -
port:
integer
The port number for the SMTP email server. A default port of 587 works for most SMTP servers.Example:
587 -
server:
string
URL of the email server or service.Example:
smtp.mail.com -
sourceEmail:
string
The full email address to appear as the sender in the emailed receipt.Example:
admin@oracle.com -
username:
string
The user name of the email address that sends receipts.Example:
test
Nested Schema : LocationParams_htmlFormatting
Type:
objectAn object containing the text formatting settings of the email configuration of the location.
Show Source
-
emailBody:
string
Text in rich text format to appear as the body of email receipts.Example:
HTML Email Body -
emailSubject:
string
Text in rich text format to appear as the subject line of email receipts.Example:
Subject
Nested Schema : LocationParams_primarySMTPServer
Type:
objectAn object containing the primary SMTP server settings of the location.
Show Source
-
bccList:
string
The email addresses to receive a blind carbon copy of the email receipt that is sent to the guest.Example:
admin2@oracle.com; admin3@oracle.com -
isSSL:
boolean
A require secure Internet communication.Example:
false -
name:
string
The business name or name to appear along with the email in the sender field.Example:
Admin -
password:
string
The password associated with the email user name.Example:
aaddsfgf@34 -
port:
integer
The port number for the SMTP email server. A default port of 587 works for most SMTP servers.Example:
587 -
server:
string
URL of the email server or service.Example:
smtp.mail.com -
sourceEmail:
string
The full email address to appear as the sender in the emailed receipt.Example:
admin@oracle.com -
username:
string
The user name of the email address that sends receipts.Example:
test
Nested Schema : LocationParams_textFormatting
Type:
objectAn object containing the text formatting settings of the email configuration of the location.
Show Source
-
emailBody:
string
Text in rich text format to appear as the body of email receipts.Example:
Email Body -
emailSubject:
string
Text in rich text format to appear as the subject line of email receipts.Example:
Subject
Nested Schema : LocationParams_serviceHostsv2
Type:
Show Source
object-
port:
integer
Port of the service host associated with the location.Example:
8080 -
serviceHostObjNum:
integer
Object number of the service host associated with the locationExample:
4715 -
serviceID:
integer
Unique ID of the service. Returned by the get operation.Example:
4715 -
type:
string
Allowed Values:
[ "SIM File Access File Service", "Check and Posting", "Check and Posting BackUp", "Distributed CAL" ]Type of the service host.Example:Check and Posting -
url:
string
URL of the service host associated with the locationExample:
EGateway/EGateway.asmx
Response
Supported Media Types
- application/json
200 Response
Location Parameters Updated.
Root Schema : schema
Type:
Show Source
object-
hierUnitId:
integer
Unique hierarchy unit value of the location.Example:
3604