Update custom Suprema times

updateCustomSupremaTimes(p_companyID, p_useCustomSupremaTimes, p_customSupremaStartTime, p_customSupremaEndTime)

 

You can use this endpoint to update the configurations to use Custom Suprema times. These times are used when syncing users to Suprema modules.

⚠️ Warning: Changing the default custom Suprema times does not automatically trigger synchronization.

Therefore, whenever these times are modified, a delete sync must be performed for the Suprema devices to ensure that users are updated with the correct times.

Otherwise, previously synced users will retain the old times on their devices.

Parameters

Name Type Required Description
p_companyID string Yes The security code you have been provided with, string (32)
p_useCustomSupremaTimes string Yes 0 or 1
p_customSupremaStartTime string Yes The start time for Suprema devices. Format hh:ii
p_customSupremaEndTime string Yes The end time for Suprema devices. Format hh:ii

Return values

ERROR_UNKNOWN_SECURITY_HASH – no company found based on the security hash used as parameter

ERROR_NO_SECURITY_HASH – no security hash has been provided when the call was made

INVALID_TIME_FORMAT - the values for p_customSupremaStartTime or p_customSupremaEndTime are not in the right format.

CAN_NOT_SAVE_CONFIGURATIONS - an error occured and the configurations can not be saved.

UPDATED - the configurations have been updated.

Sample

<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:uen="uen:esws">
<soapenv:Header/>
<soapenv:Body>
<uen:Esws.updateCustomSupremaTimes soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<p_companyID xsi:type="xsd:string">^4p;tU0Q+#dEIhTWkuj5FnLD^aKWqVu0</p_companyID>
<p_useCustomSupremaTimes xsi:type="xsd:string">1</p_useCustomSupremaTimes>
<p_customSupremaStartTime xsi:type="xsd:string">1</p_customSupremaStartTime>
<p_customSupremaEndTime xsi:type="xsd:string">1</p_customSupremaEndTime>
</uen:Esws.updateCustomSupremaTimes>
</soapenv:Body>
</soapenv:Envelope>

Response

<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:Esws.updateCustomSupremaTimesResponse xmlns:ns1="uen:esws">
<return xsi:type="xsd:string">cVRLYpk9uq5g6WZbzHrC2Kx7Sd3nXiQy</return>
</ns1:Esws.updateCustomSupremaTimesResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>