Update Location Parameters
post
/config/sim/v1/hierarchy/updateLocationParameters
Updates the parameters for a location in the specified organization. If parameter is not found is not found, it creates a new parameter record for the location.
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 : LocationParameters
Type:
Show Source
object
-
calendar(optional):
object LocationParams_calendar
An object containing the calendar settings for the location
-
emailConfiguration(optional):
object LocationParams_emailConfiguration
An object containing the email configuration for the location
-
hierUnitId:
integer
Unique reference of the hierarchy unit of the locationExample:
1
-
language(optional):
object LocationParams_language
An array of languages that are available at the property.
-
ldsNLUGroup(optional):
integer
The number of the Menu Item NLU Group to be used by menu items posted by the LDSExample:
0
-
locName(optional):
object locName
Additional Properties Allowed: additionalPropertiesA group of string objects representing the name of the location configured languages
-
numDaystoSaveCABatchFiles(optional):
integer
The number of days to retain Credit Authorization batch files and log files.Example:
0
-
objectNum:
integer
Object number of the locationExample:
1
-
options(optional):
string
Options with the location parameter.Example:
000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
-
optionsExt(optional):
object LocationParams_optionsExt
An object containing the descriptive options list associated with the location parameter.
-
postingOptions(optional):
string
Options with the location parameter.Example:
000000
-
postingOptionsExt(optional):
object LocationParams_postingOptionsExt
An object containing the descriptive options list associated with the location parameter.
-
reportingLanguage(optional):
string
The name of the language to use when posting data to Reporting and Analytics.Example:
English
-
reportingLanguageObjNum(optional):
integer
The object number of the language to use when posting data to Reporting and Analytics.Example:
1
-
reportingOrgId(optional):
integer
the ID of the organization to which this property belongs in the reporting databasesExample:
11866
-
secondaryPrintLanguageName(optional):
string
Name of the language to print under the Default Language on a guest check or customer receipt.Example:
English
-
secondaryPrintLanguageObjNum(optional):
integer
Object number of the language to print under the Default Language on a guest check or customer receiptExample:
0
-
security(optional):
object LocationParams_security
An object containing the attributes of the credentials of the system
-
serialNumberInfo(optional):
object LocationParams_serialNumberInfo
An object containing the details of the system serial numbers
-
serviceHosts(optional):
array serviceHosts
An array of service hosts associated with the location.
-
simphonyEssentials(optional):
object LocationParams_simphonyEssentials
Object containing the configuration settings for Simphony Essentials enabled organization
-
taiwanGUIParameters:
object LocationParams_taiwanGUIParameters
-
timekeeping(optional):
object LocationParams_timekeeping
An object containing the timekeeping configuration for the location
-
wlsStrengthOfflineThreshold(optional):
number
The percentage amount to be used to determine if communications should be suspended for wireless workstations, until network signal strength is improved.Example:
0
-
wlsStrengthReconnectThreshold(optional):
number
the 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(optional):
object LocationParams_workstationOptions
An object containing the workstation options associated with the location
Nested Schema : LocationParams_calendar
Type:
object
An object containing the calendar settings for the location
Show Source
-
currentBusinessDate(optional):
string
Current business date of the locationExample:
12/20/21
-
manualSODSafetyCatchTime(optional):
string
the time the application automatically increments the business date if manually SOD is not run.Example:
00:00
-
startedAt(optional):
string
Time at which the current business date started at the location.Example:
12/20/21 03:00:00 AM
-
startOfDaySettings(optional):
array startOfDaySettings
An array of the start of day settings for the business week.
-
startOfPeriodSettings(optional):
object LocationParams_startOfPeriodSettings
An object containing the start of period settings for the location
Nested Schema : LocationParams_emailConfiguration
Type:
object
An object containing the email configuration for the location
Show Source
-
backupSMTPServer(optional):
object LocationParams_backupSMTPServer
An object containing the backup SMTP server details for email configuration of the property.
-
htmlFormatting(optional):
object LocationParams_htmlFormatting
An object containing the text formatting settings of the email configuration of the location.
-
primarySMTPServer(optional):
object LocationParams_primarySMTPServer
An object containing the primary SMTP server settings of the location.
-
sendHTMLEmail(optional):
boolean
A flag indicating if the mail format is in HTML.Example:
false
-
textFormatting(optional):
object LocationParams_textFormatting
An object containing the text formatting settings of the email configuration of the location.
Nested Schema : LocationParams_language
Type:
object
An array of languages that are available at the property.
Show Source
-
languageName(optional):
string
The name of the language.Example:
English
-
languageNum(optional):
integer
The index of the language configured.Example:
1
-
languageObjNum(optional):
integer
Object number of the language.Example:
1
Nested Schema : locName
Type:
object
Additional Properties Allowed
Show Source
A group of string objects representing the name of the location configured languages
Example:
{
"en-US":"Enterprise",
"es-SS":"Empresa",
"lt=LT":"?mon?"
}
Nested Schema : LocationParams_optionsExt
Type:
object
An object containing the descriptive options list associated with the location parameter.
Show Source
-
acceptGenericEmployeeIDCard(optional):
boolean
A flag indicating if the site uses its own employee ID cards.Example:
false
-
disableDSTOnKDSDisplayControllers(optional):
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(optional): boolean
-
doNotShowNegativeTareWeight(optional):
boolean
A remove negative tare weights from the POS client, checks, and receipts.Example:
false
-
doNotShowtareWeight(optional):
boolean
prevent tare weight from appearing on the POS client, checks, and receipts.Example:
false
-
dontCheckMacroLoopLimit(optional):
boolean
A disable the limit of 20 consecutive macro iterations.Example:
false
-
enableClockInRequirementForAuthorization(optional):
boolean
require that employees clock-in to authorize workstation actions.Example:
false
-
enableEUROCurrencySystem(optional):
boolean
A make the Euro functionality and all requirements available in the system.Example:
false
-
enableEventsReporting(optional):
boolean
A associate transactions with events and to use event reporting.Example:
false
-
enableNoDefaultAreaSelectedOption(optional):
boolean
A allow a privileged workstation operator to select No default area selected, rather than a default area.Example:
false
-
enableSalesRecordingModule(optional):
boolean
A flag indicating for Quebec sites required to use a Sales Recording Module (SRM) device.Example:
false
-
enableSeatNumberInJournal(optional):
boolean
A include the seat number on the journal output.Example:
false
-
enableWorkstationAlerting(optional):
boolean
A enable generation of alerts that will be displayed on workstations within the property.Example:
false
-
euroCurrencyConversionReportingFeature(optional):
boolean
A print change due on the customer receipt in both the local and Euro currency.Example:
false
-
euroIsBaseCurrency(optional):
boolean
make the Euro dollar the base currency for the systemExample:
false
-
extendedEventDate(optional):
boolean
send extra summary details to the VSS interface.Example:
false
-
eybs(optional):
boolean
A create a separate log to track database changes made for Weights and Measures.Example:
false
-
hrgasPMSCompatability(optional):
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(optional):
boolean
issue change in the national currency.Example:
false
-
itemDiscountsNetSubTotalDiscountItemizers(optional):
boolean
A post the subtotal discount against the total amount of the itemizer, regardless of item discounts.Example:
false
-
postNonTaxableSlaesTotalsNetOfDiscounts(optional):
boolean
A include discounts in calculating the non-taxable sales total that appears on System Tax Reports.Example:
false
-
postVoidsToLDS(optional):
boolean
send negative postings to the Oracle suspense file and to the LDSExample:
false
-
printAltSummaryTotalsBeforeBase(optional):
boolean
A reverse the print order of the Base and Alternate Summary Totals sections on Euro checks and receipts.Example:
false
-
printSimplifiedAltSummaryTotals(optional):
boolean
A reduce the Alternate Summary Totals section to the section header and a single Amount Due/Payment.Example:
false
-
printSODValidationChit(optional):
boolean
print a validation chit when the user runs Start of Day from the POS client.Example:
false
-
runSODFromOPS(optional):
boolean
allow a user to run Start of Day from the POS clientExample:
false
-
sendCashierNumberInsteadOfOperatorNumber(optional):
boolean
A store the cashier number in the Credit Card Batch, rather than the operator number.Example:
false
-
showItemWeightInKilos(optional):
boolean
A print and show the weight of weighed menu items in kilograms.Example:
false
-
showItemWeightInOunces(optional):
boolean
print and show the weight of weighed menu items in ouncesExample:
false
-
use24HourClock(optional):
boolean
A print and show time in 24-hour formatExample:
false
-
useDDMMYYYYFormat(optional):
boolean
A print and show dates with the day first.Example:
false
Nested Schema : LocationParams_postingOptionsExt
Type:
object
An object containing the descriptive options list associated with the location parameter.
Show Source
-
hostFinancialReportFormat(optional):
boolean
A flag indicating for systems installed at Host sitesExample:
false
-
isSynchronousConnectionForClockInOutPunch(optional):
boolean
A allow Clock In/ Out to communicate with Labor Management instantly, instead of scheduled requests.Example:
false
-
postFoodCostTotalsNetOfItemDiscounts(optional):
boolean
A post food cost totals net of item discounts.Example:
false
-
postOfflineTransactionsWithActualTransactionTime(optional):
boolean
A post Offline checks to the database with the actual time stamp of the transaction.Example:
false
-
postSalesNetOfVAT(optional):
boolean
A post menu items, discounts, and service charges net of VAT.Example:
false
Nested Schema : LocationParams_security
Type:
object
An object containing the attributes of the credentials of the system
Show Source
-
adminUser(optional):
string
Admin Username for the property's workstations. Changes take effect when the workstations are restarted.Example:
user
-
adminUserPassword(optional):
string
The admin password for the property's workstations. Changes take effect when the workstations are restartedExample:
cfsdf@343%
-
adminUserPasswordCompliance(optional):
string
The current Admin User Password compliance status.Example:
Compliance Not Met
-
dbUser(optional):
string
The Database Username for the property's workstations.Example:
user
-
dbUserPassword(optional):
string
The Database Password for the property's workstations.Example:
cfsdf@343%
-
dbUserPasswordCompliance(optional):
string
The current Database User Password compliance status.Example:
Compliance Not Met
-
installSecurityUser(optional):
string
Install Security Username for the property's workstations.Example:
user
-
installSecurityUserPassword(optional):
string
Install Security password for the property's workstations.Example:
cfsdf@343%
-
installSecurityUserPasswordCompliance(optional):
string
the current Install Security Password compliance status.Example:
Compliance Not Met
Nested Schema : LocationParams_serialNumberInfo
Type:
object
An object containing the details of the system serial numbers
Show Source
-
maxSerialNum1(optional):
integer
The maximum value for system serial #1 (2 to 99999).Example:
maxSerialNum1
-
maxSerialNum2(optional):
integer
The maximum value for system serial #2 (2 to 99999).Example:
99999
-
minSerialNum1(optional):
integer
The minimum value for system serial #1 (1 to 99998).Example:
1
-
minSerialNum2(optional):
integer
The minimum value for system serial #2 (1 to 99998).Example:
1
Nested Schema : serviceHosts
Type:
array
An array of service hosts associated with the location.
Show Source
Nested Schema : LocationParams_simphonyEssentials
Type:
object
Object containing the configuration settings for Simphony Essentials enabled organization
Show Source
-
fiscalLocationName(optional):
string
Name of the Country associated with the Fiscal location.Example:
Mexico
-
fiscalLocationNum(optional):
integer
Select the Fiscal Location for this Property.Example:
1
Nested Schema : LocationParams_taiwanGUIParameters
Type:
Show Source
object
-
endOfRangeThreshold:
string
The end of range tax threshold.Example:
A23
-
taxNumPrefix(optional):
string
The Taiwan tax number prefix.Example:
TUI
Nested Schema : LocationParams_timekeeping
Type:
object
An object containing the timekeeping configuration for the location
Show Source
-
enableLaborManagement(optional):
boolean
A use Labor Management for employee configuration.Example:
false
-
printAccumulatedLaborShiftTotalsInClockInOutChits(optional):
boolean
A print a single labor shift total hours worked by employees on clock-in/out chits.Example:
false
-
printWTDTotalsInClockInOutChits(optional):
boolean
A print week-to-date total hours worked by employees on clock-in/out chits.Example:
false
-
propertyLaborManagementURL(optional):
string
The URL if workstations use an external address when connecting to the Simphony Labor web service.Example:
myLabor.orcle.com
Nested Schema : LocationParams_workstationOptions
Type:
object
An object containing the workstation options associated with the location
Show Source
-
dbUpdateFrequencyInSecs(optional):
integer
The number of seconds the workstation and KDS Controllers wait to retrieve updates from the database.Example:
1800
-
defaultTransactionHelpScreenName(optional):
object TranslatedStringdefaultTransactionHelpScreenName
A string that contains translations of defaultTransactionHelpScreenName into multiple languages
-
defaultTransactionHelpScreenObjNum(optional):
integer
Object number of the Help Screen to show when the Help key is pressed on workstations.Example:
0
-
linesPerWSReportPage(optional):
integer
The number of lines to print per page on workstation reports.Example:
0
-
onDemandReplayFrequencyCheck(optional):
integer
The number of seconds for workstations to wait before checking for initiation of an on demand replay.Example:
0
Nested Schema : startOfDaySettings
Type:
array
An array of the start of day settings for the business week.
Show Source
Nested Schema : LocationParams_startOfPeriodSettings
Type:
object
An object containing the start of period settings for the location
Show Source
-
otherPeriod1(optional):
array otherPeriod1
An array of dates for the Other Period 1.
-
otherPeriod1PCAutoSeqName(optional):
otherPeriod1PCAutoSeqName
Name of the PC autosequence of the Other Totals period 1.
-
otherPeriod1PCAutoSeqObjNum(optional):
integer
Object number of the PC autosequence of Other Totals period 1.Example:
1
-
otherPeriod2(optional):
array otherPeriod2
An array of dates for the Other Period 2.
-
otherPeriod2PCAutoSeqName(optional):
otherPeriod2PCAutoSeqName
Name of the PC autosequence of the Other Totals period 2.
-
otherPeriod2PCAutoSeqObjNum(optional):
integer
Object number of the PC autosequence of Other Totals period 2.Example:
1
-
otherPeriod3(optional):
array otherPeriod3
An array of dates for the Other Period 3.
-
otherPeriod3PCAutoSeqName(optional):
otherPeriod3PCAutoSeqName
Name of the PC autosequence of the Other Totals period 3.
-
otherPeriod3PCAutoSeqObjNum(optional):
integer
Object number of the PC autosequence of Other Totals period 3.Example:
1
-
sOMAlternateDates(optional):
array sOMAlternateDates
An array of alternate dates for the start of month.
-
sOMPCAutoSeqName(optional):
sOMPCAutoSeqName
Name of the PC autosequence of start of month.
-
sOMPCAutoSeqObjNum(optional):
integer
Object number of the PC autosequence of start of month.Example:
1
-
sOPPCAutoSeqName(optional):
sOPPCAutoSeqName
Name of the PC autosequence of start of period.
-
sOPPCAutoSeqObjNum(optional):
integer
Object number of the PC autosequence of start of period.Example:
1
-
sOQAlternateDates(optional):
array sOQAlternateDates
An array of alternate dates for the start of quarter. Applicable only if useSOQAlternateDates = true
-
sOQPCAutoSeqName(optional):
sOQPCAutoSeqName
Name of the PC autosequence of start of quarter.
-
sOQPCAutoSeqObjNum(optional):
integer
Object number of the PC autosequence of start of quarter.Example:
1
-
sOWPCAutoSeqName(optional):
sOWPCAutoSeqName
Name of the PC autosequence of start of week
-
sOWPCAutoSeqObjNum(optional):
integer
Object number of the PC autosequence of start of week.Example:
1
-
sOYAlternateDates(optional):
array sOYAlternateDates
An array of dates for the start of year
-
sOYPCAutoSeqName(optional):
sOYPCAutoSeqName
Name of the PC autosequence of start of year.
-
sOYPCAutoSeqObjNum(optional):
integer
Object number of the PC autosequence of start of year.Example:
1
-
startOfMonth(optional):
integer
The day of the month that represents the start of the business month.Example:
1
-
startOfPayPeriod(optional):
string
String representing the start of pay periodExample:
BiWeekly
-
startOfQuarter(optional):
string
A string representing the start dates for the quarter in MM/DD formatExample:
1/4 , 4/1, 7/1, 10/1
-
startOfWeek(optional):
integer
The day of the week that represents the start of the business week.Example:
1
-
startOfYear(optional):
integer
Month for the start of the yearExample:
1
-
useSOMAlternateDates(optional):
boolean
A use user-defined dates for this period, instead of standard calendar periodsExample:
false
-
useSOQAlternateDates(optional):
boolean
A use user-defined dates for this period, instead of standard calendar periods.Example:
false
Nested Schema : LocationParams_startOfDaySettings
Type:
Show Source
object
-
dayOfWeek(optional):
integer
A number representing the day of the weekExample:
1
-
pcAutoSequenceName(optional):
pcAutoSequenceName
Name of the PC Autosequence to run immediately after the given business day begins
-
pcAutoSequenceObjNum(optional):
integer
Object number of the PC Autosequence to run immediately after the given business day begins.Example:
0
-
runManually(optional):
boolean
A manually run the start of day for this business date.Example:
false
-
time(optional):
string
The start time of the start of day for given day of the week.Example:
03:00
Nested Schema : pcAutoSequenceName
Name of the PC Autosequence to run immediately after the given business day begins
Match All
Show Source
Nested Schema : TranslatedString_SequenceName
Type:
object
Example:
{
"en-US":"Sequence",
"de-DE":"Reihenfolge",
"ar-AR":"??????????????????"
}
Nested Schema : otherPeriod1PCAutoSeqName
Name of the PC autosequence of the Other Totals period 1.
Match All
Show Source
Nested Schema : otherPeriod2PCAutoSeqName
Name of the PC autosequence of the Other Totals period 2.
Match All
Show Source
Nested Schema : otherPeriod3PCAutoSeqName
Name of the PC autosequence of the Other Totals period 3.
Match All
Show Source
Nested Schema : sOMAlternateDates
Type:
array
An array of alternate dates for the start of month.
Show Source
Nested Schema : sOMPCAutoSeqName
Name of the PC autosequence of start of month.
Match All
Show Source
Nested Schema : sOPPCAutoSeqName
Name of the PC autosequence of start of period.
Match All
Show Source
Nested Schema : sOQAlternateDates
Type:
array
An array of alternate dates for the start of quarter. Applicable only if useSOQAlternateDates = true
Show Source
Nested Schema : sOQPCAutoSeqName
Name of the PC autosequence of start of quarter.
Match All
Show Source
Nested Schema : sOYPCAutoSeqName
Name of the PC autosequence of start of year.
Match All
Show Source
Nested Schema : LocationParameters_AlternateDates
Type:
Show Source
object
-
date(optional):
string
Date of the start of monthExample:
12/01/2021
-
number(optional):
integer
Sequence number of the date of the start of monthExample:
1
Nested Schema : LocationParams_backupSMTPServer
Type:
object
An object containing the backup SMTP server details for email configuration of the property.
Show Source
-
isSSL(optional):
boolean
A require secure Internet communication.Example:
false
-
name(optional):
string
The business name or name to appear along with the email in the sender field.Example:
Admin
-
password(optional):
string
The password associated with the email user name.Example:
aaddsfgf@34
-
port(optional):
integer
The port number for the SMTP email server. A default port of 587 works for most SMTP servers.Example:
587
-
server(optional):
string
URL of the email server or service.Example:
smtp.mail.com
-
sourceEmail(optional):
string
The full email address to appear as the sender in the emailed receipt.Example:
admin@oracle.com
-
username(optional):
string
The user name of the email address that sends receipts.Example:
test
Nested Schema : LocationParams_htmlFormatting
Type:
object
An object containing the text formatting settings of the email configuration of the location.
Show Source
-
emailBody(optional):
string
Text in rich text format to appear as the body of email receipts.Example:
HTML Email Body
-
emailSubject(optional):
string
Text in rich text format to appear as the subject line of email receipts.Example:
Subject
Nested Schema : LocationParams_primarySMTPServer
Type:
object
An object containing the primary SMTP server settings of the location.
Show Source
-
bccList(optional):
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(optional):
boolean
A require secure Internet communication.Example:
false
-
name(optional):
string
The business name or name to appear along with the email in the sender field.Example:
Admin
-
password(optional):
string
The password associated with the email user name.Example:
aaddsfgf@34
-
port(optional):
integer
The port number for the SMTP email server. A default port of 587 works for most SMTP servers.Example:
587
-
server(optional):
string
URL of the email server or service.Example:
smtp.mail.com
-
sourceEmail(optional):
string
The full email address to appear as the sender in the emailed receipt.Example:
admin@oracle.com
-
username(optional):
string
The user name of the email address that sends receipts.Example:
test
Nested Schema : LocationParams_textFormatting
Type:
object
An object containing the text formatting settings of the email configuration of the location.
Show Source
-
emailBody(optional):
string
Text in rich text format to appear as the body of email receipts.Example:
Email Body
-
emailSubject(optional):
string
Text in rich text format to appear as the subject line of email receipts.Example:
Subject
Nested Schema : LocationParams_serviceHosts
Type:
Show Source
object
-
port(optional):
integer
Port of the service host associated with the location.Example:
8080
-
serviceHostName(optional):
object TranslatedString_serviceHostName
A string that contains translations of serviceHostName into multiple languages
-
serviceHostObjNum(optional):
integer
Object number of the service host associated with the locationExample:
4715
-
serviceID(optional):
integer
Unique ID of the service host.Example:
4715
-
type(optional):
integer
Type of the service hostExample:
1
-
url(optional):
string
URL of the service host associated with the locationExample:
egateway/egateway.asmx
Nested Schema : TranslatedString_serviceHostName
Type:
object
A string that contains translations of serviceHostName into multiple languages
Example:
{
"en-US":"Service Host",
"de-DE":"Service-Host",
"ar-AR":"?????????????? ????????????"
}
Nested Schema : TranslatedStringdefaultTransactionHelpScreenName
Type:
object
A string that contains translations of defaultTransactionHelpScreenName into multiple languages
Example:
{
"en-US":"Help Screen",
"de-DE":"Hilfebildschirm",
"ar-AR":"???????? ????????????????"
}
Response
Supported Media Types
- application/json
200 Response
A response body for Location Parameters
Root Schema : LocationParametersResponse
Type:
Show Source
object
-
hierUnitId:
integer
Unique hierarchy unit value.Example:
1
400 Response
400 Bad Request
Root Schema : ErrorDetails
Type:
object
Response 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