For release to public

SOAP API Documentation:

ETX 901 (latest)

9_0_1_eTimeXpressWebServicesAPI.pdf

9_0_1_eTimeXpressWebServicesAPI_Datasets.pdf

9_0_1_eTimeXpressWebServicesAPI_Examples.pdf

ETX 814 (sunset but is supported)

8_0_10_eTimeXpressWebServicesAPI.pdf

8_0_10_eTimeXpressWebServicesAPI_Datasets.pdf

8_0_10_eTimeXpressWebServicesAPI_Examples.pdf

Setup

Simple video on how to test and run SOAP services using free SOAP UI tool

Run_Login_SOAP_Service.mp4

New Fields added in 901

Details of each field can be found in 9_0_1_eTimeXpressWebServicesPAI_Datasets.pdf

dsCustomer Dataset (ttCustomer)

Field name	Label	Description
geolocation	Geo-location coordinates	Customer Contact - Geo-location coordinates

dsEmployee Dataset (ttEmployee)

Field name	Label	Description
alertsmsphone	Alert SMS	Employee Contact - Alert SMS
automobile	Owns automobile	Owns automobile
carstcddesc	Registered	Employee Automobile - Registered in
cycddesc	Country	Employee Contact Information - Country
defsid	Default [%site%] ID	Default Site ID
defsidname	Default [%site%]	Default Site
defuid	Default [%Customer%] ID	Default Customer ID
defuidname	Default [%customer%]	Default Customer
depcddesc	Department	Employee Pay settings - Department
emailconsent	Email consent	Employee Qualifications - Email consent
embackgrdesc	Ethnicity	Employee Profile - Ethnicity code
emmrstcddesc	Marital Status	Employee Profile - Marital Status
emphone	Emergency contact phone	Emergency contact phone
emposcddesc	[%Position%]	Employee Pay Settings - Position
emsrtydesc	Default [%service%]	Employee Pay Settings - Service type
loginid	Login ID	WebXP Login ID (User Name)
maxdhours_disp	Display daily max hours	Employee Contact - Display daily max hours
maxdhours_json	Daily max hours in JSON format	Daily max hours in JSON format
maxmhours_disp	Display monthly max hours	Employee Contact - Display monthly max hours
maxmhours_json	Monthly max hours in JSON format	Daily max hours in JSON format
maxwhours_disp	Display weekly max hours	Employee Contact - Display weekly max hours
maxwhours_json	Weekly max hours in JSON format	Daily max hours in JSON format
payrates_disp	Display pay rates	Employee Pay Rates - Pay rates
payrates_json	Pay rates in JSON format	Employee Pay Rates - Pay rates in JSON format
pyfrcddesc	Pay Cycle	Employee Pay Settings - Pay Cycle
qualif_disp	Display qualifications	Employee Qualifications - Qualifications
qualif_json	Qualifications in JSON format	Employee Qualifications - Qualifications in JSON format
recaccgrpdesc	Managed by record access groups	Employee managed by record access groups
recaccgrpid	Managed by record access group IDs	Employee managed by record access group ID
sendEmail	Send email	Send email
sendSms	Send SMS	Send SMS
smsconsent	SMS consent	SMS consent
stcddesc	State/Province	Employee Contact - State/Province
teamid	Team	Team ID
teltype1desc	Phone type	Employee Contact - Phone type
termrcdesc	Termination reason	Employee History - Termination
timezoneid	Time zone code	Time zone code
timezoneiddesc	Time zone	Time zone
txppassword	Team Xpress account password	Employeee Accounts - Team Xpress account password
txpstatus	Team Xpress account status	Employeee Accounts - Team Xpress account status
txpstatuscode	Team Xpress account status code	Employeee Accounts - Team Xpress account status code
txpusername	Team Xpress account username	Employeee Accounts - Team Xpress account username
vxpephpwd	Voice Xpress account phone password	Employeee Accounts - Voice Xpress account phone password
vxpphoneid	Voice Xpress account phone ID	Employeee Accounts - Voice Xpress account phone ID
vxpstatus	Voice Xpress account status	Employeee Accounts - Voice Xpress account status
vxpstatuscode	Voice Xpress account status code	Employeee Accounts - Voice Xpress account status code
webgrpcd	Security Group code	Security Group code
webgrpname	Security group	Security group
workdays_disp	Disply Work Days	Employee work days

dsEmpWebAc Dataset (ttEmpWebAc)

Field name	Label	Description
acctStat	Account status	Account Status: "N" - not active, new; "I" - not acive, invite sent; "A" - active; "D" - disabled
chatAcctCreated	Chat Account Created	Chat Account Created
hasLoggedIn	Has logged in	User has logged in before

dsSrvType Dataset (ttSrvtype)

Field name	Label	Description
authorized_qualification	[%Service%] authorized qualifications	Service Qualifications - Authorized qualifications
qualification_rule_descriptions	General qualifications	General qualifications
qualification_rule_ids	Qualification Codes	List of qualification codes

dsSite Dataset (ttSite)

Field name	Label	Description
allowactions	Allow employees to perform actions	Allow employees to perform actions
authorized_qualification	[%Site%] Authorized Qualifications	Site Qualifications - Authorized qualifications
billrates_disp	[%Site%] Display BillRates	Bill Settings - Bill Rates
billrates_json	[%Site%] BillRates in JSON format	Bill Rates in JSON format
csname
geofenceradius	Geo-fence Radius	Geo-fence Radius
geolocation	Geo-location coordinates	Site Geofencing - Geo-location coordinates
gpstracking	GPS tracking	Site Geofencing - For verifying clock actions using phone's GPS
maxdhours_disp	Display daily max hours	Site Max hours - Display daily max hours
maxdhours_json	Daily max hours in JSON format	Daily max hours in JSON format
maxmhours_disp	Display monthly max hours	Site Max hours - Display monthly max hours
maxmhours_json	Monthly max hours in JSON format	Monthly max hours in JSON format
maxwhours_disp	Display weekly max hours	Site Max hours - Display weekly max hours
maxwhours_json	Weekly max hours in JSON format	Weekly max hours in JSON format
qualification_rule_descriptions	General qualifications	General qualifications
qualification_rule_ids	Qualification Codes	List of qualification codes
registredphones	Registered phone numbers	Site Geofencing - Use the specified phone numbers for Voice Xpress
staticipaddresses	Static IP address	Site Geofencing - Static IP address

Examples

Login request

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
                   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <SOAP-ENV:Body xmlns:s0="urn:L1340384D62:eTimeWS" 
                 xmlns:s1="http://www.w3.org/2001/XMLSchema">
    <s0:apSrv>
      <dsContext>
        <ttContext>
         <contextGroup>PARAM</contextGroup>
         <contextName>pcUserID</contextName>
         <contextValue>wsdl</contextValue>
         <contextOperator />
         <contextType />
        </ttContext>

        <ttContext>
         <contextGroup>PARAM</contextGroup>
         <contextName>pcPassword</contextName>
         <contextValue>_____PUT_THE_CORRECT_PASSWORD_HERE_____</contextValue>
         <contextOperator />
         <contextType />
        </ttContext>
      </dsContext>
    </s0:apSrv>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

To receive pcSessionID

Create New Employee Record Request

In order to create new employee record, the minimum fields that need to be passed to service are set in the pcUpdateRequestFieldsList context parameter are cid,bid,eid,emnamel,emnamef,emshort,rstat,emnerev + add at record level <cChkNew>A</cChkNew>:

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
                   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <SOAP-ENV:Body xmlns:s0="urn:L1340384D62:eTimeWS" 
                  xmlns:s1="http://www.w3.org/2001/XMLSchema">
      <s0:apSrvEmpSave>
         <dsContext>
            <ttContext>
               <contextGroup>PARAM</contextGroup>
               <contextName>pcAction</contextName>
               <contextValue>ADD_UPDATE</contextValue>
               <contextOperator />
               <contextType />
            </ttContext>

            <ttContext>
               <contextGroup>PARAM</contextGroup>
               <contextName>pcSessionID</contextName>
               <contextValue>_____SUBSTITUTE_pcSessionID_received_here_____</contextValue>
               <contextOperator />
               <contextType />
            </ttContext>

            <ttContext>
               <contextGroup>PARAM</contextGroup>
               <contextName>pcUserID</contextName>
               <contextValue>wsdl</contextValue>
               <contextOperator />
               <contextType />
            </ttContext>

            <ttContext>
               <contextGroup>PARAM</contextGroup>
               <contextName>piCompanyID</contextName>
               <contextValue>2</contextValue> <!-- PUT CORRECT IDs HERE -->
               <contextOperator />
               <contextType />
            </ttContext>

            <ttContext>
               <contextGroup>PARAM</contextGroup>
               <contextName>piBranchID</contextName>
               <contextValue>1</contextValue> <!-- PUT CORRECT IDs HERE -->
               <contextOperator />
               <contextType />
            </ttContext>

            <ttContext>
               <contextGroup>PARAM</contextGroup>
               <contextName>pcUpdateRequestFieldsList</contextName>
               <contextValue>cid,bid,eid,emnamel,emnamef,emshort,rstat,emnerev</contextValue> <!-- ADD ADDITIONAL NAMES OF FIELDS TO BE UPDATED HERE; See documentation for name of fields -->
               <contextOperator />
               <contextType />
            </ttContext>            
         </dsContext>

         <dsEmployee>
            <ttEmployee>
               <!-- Add values for each additional field here --> 
               <cid>2</cid>
               <bid>1</bid>
               <eid>999</eid>
               <cChkNew>A</cChkNew> <!-- TO ADD RECORD -->
               <emnamel>Last</emnamel>
               <emnamef>First</emnamef>
               <emshort>Celayix</emshort>
               <rstat>A</rstat>
               <emnerev>0101</emnerev>
            </ttEmployee>
         </dsEmployee>
      </s0:apSrvEmpSave>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Update employee record

If we want to update the following field:

In this case we use registration panel that supports a custom label

So, the TAM fields corresponds to Reg.2 field:

So, the minimum fields that need to be pass to service are set in the pcUpdateRequestFieldsList context parameter includes key fields + required field, i.e. cid,bid,eid,emstateid:

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
                   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <SOAP-ENV:Body xmlns:s0="urn:L1340384D62:eTimeWS" 
                  xmlns:s1="http://www.w3.org/2001/XMLSchema">
      <s0:apSrvEmpSave>
         <dsContext>
            <ttContext>
               <contextGroup>PARAM</contextGroup>
               <contextName>pcAction</contextName>
               <contextValue>ADD_UPDATE</contextValue>
               <contextOperator />
               <contextType />
            </ttContext>

            <ttContext>
               <contextGroup>PARAM</contextGroup>
               <contextName>pcSessionID</contextName>
               <contextValue>_____SUBSTITUTE_pcSessionID_received_here_____</contextValue>
               <contextOperator />
               <contextType />
            </ttContext>

            <ttContext>
               <contextGroup>PARAM</contextGroup>
               <contextName>pcUserID</contextName>
               <contextValue>wsdl</contextValue>
              <contextOperator />
               <contextType />
            </ttContext>

            <ttContext>
               <contextGroup>PARAM</contextGroup>
               <contextName>piCompanyID</contextName>
               <contextValue>2</contextValue> <!-- PUT CORRECT IDs HERE -->
               <contextOperator />
               <contextType />
            </ttContext>            

            <ttContext>
               <contextGroup>PARAM</contextGroup>
               <contextName>piBranchID</contextName>
               <contextValue>1</contextValue> <!-- PUT CORRECT IDs HERE -->
               <contextOperator />
               <contextType />
            </ttContext>

            <ttContext>
               <contextGroup>PARAM</contextGroup>
               <contextName>pcUpdateRequestFieldsList</contextName>
               <contextValue>cid,bid,eid,emstateid</contextValue> <!-- ADD ADDITIONAL NAMES OF FIELDS TO BE UPDATED HERE; See documentation for name of fields -->
               <contextOperator />
               <contextType />
            </ttContext>            
         </dsContext>

         <dsEmployee>
            <ttEmployee>
               <!-- Add values for each additional field here --> 
               <cid>2</cid>
               <bid>1</bid>
               <eid>999</eid>               
               <emstateid>TAM TEST VALUE</emstateid>
            </ttEmployee>
         </dsEmployee>
      </s0:apSrvEmpSave>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

to get

Custom labels used reference fields

Custom labels:

are defined here:

and correspond to ref1 & ref2 fields in request.

Celayix SOAP API - For Public Distribution