Update the details of a Web Employer Contact.
A Web Employer Contact is a person (Client) who is assigned as a contact for an Employer Enrolment.
An Employer Web Enrolment must have previously been created, see AddEmployerWebEnrolment, and the Contact must have been added, see AddWebEmployerContact.
A Web Client ID (iWecl_ID) is passed as a parameter. iWecl_ID should be the ID returned by the AddWebEmployerContact function.
UpdateWebEmployee should not be used to update details of clients enrolled as individuals, or as part of an Employer Web Enrolment. In these cases, use UpdateWebClient or UpdateWebEmployee.
It is not possible to change the Contact's fundamental data (surname, given name, Date of Birth or Code) which was used to add him/her to the employer's enrolment.
The developer of the Web Application is encouraged to perform any desired validation of user entered data, prior to submitting data to the API via functions like AddWebEmployerContact.
A token is passed for authentication. If the authentication fails, or other errors occur, nothing is updated . The result of the authentication is represented by a TAuthenticate object.
The only mandatory parameters are sToken and iWecl_ID. An empty string can be passed for any other parameters.
Requires a valid registration key entry for the Bookings feature.
This function has security level "Protected", and can only be accessed by users that have explicitly been granted permission to the API.
[WebMethod(Description = "Records the specified additional data against the existing employer contact specified by the web client ID")] public TAuthenticate UpdateWebEmployerContact(string sToken, int iWecl_ID, string sOther, string sTitle, string sGender, string sAddr, string sCity, string sPCode, string sShortState, string sHomePhone, string sWorkPhone, string sMobilePhone, string sEmail, string postalAddr, string postalCity, string postalPCode, string postalShortState, int? divisionId, string usi, TAddress usualAddress, TAddress postalAddress);
Parameters |
Description |
string sToken |
String containing a token. |
int iWecl_ID |
Integer ID of Contact who is part of a Employer Web Enrolment. |
string sOther |
String containing the Client's Other Name. Maximum length 50 characters. |
string sTitle |
String containing the Client's Title - eg. Mr, Mrs, Miss, Dr etc. Maximum length 10 characters. |
string sGender |
String - Gender of Client. Valid Gender Values are:
|
string sAddr |
WARNING: This field is deprecated and will be removed in a future version of the API. You should use usualAddress.Building, usualAddress.UnitDetails, usualAddress.StreetNumber and usualAddress.StreetName instead. String - Residential Address for Client. Maximum length 170 characters. |
string sCity |
WARNING: This field is deprecated and will be removed in a future version of the API. You should use usualAddress.City instead. String - City of Client's Residential Address. Maximum length 50 characters. |
string sPCode |
WARNING: This field is deprecated and will be removed in a future version of the API. You should use usualAddress.Postcode instead. String - Post Code of Client's Residential Address. Maximum length 4 characters. |
string sShortState |
WARNING: This field is deprecated and will be removed in a future version of the API. You should use usualAddress.State instead. String - State Short Name for Client's Residential Address. See GetStateList. Valid Short Names are:
|
string sHomePhone |
String - Home Phone Number of Client. Maximum length 20 characters. For AVETMISS compliance, this should include the area code (thus, contain at least 10 digits) |
string sWorkPhone |
String - Work Phone Number of Client. Maximum length 20 characters. For AVETMISS compliance, this should include the area code (thus, contain at least 10 digits) |
string sMobilePhone |
String - Mobile Phone Number of Client. Maximum length 20 characters. For AVETMISS compliance, this should contain at least 10 digits |
string sEmail |
String - Email Address of Client. Maximum length 100 characters. |
string postalAddr |
WARNING: This field is deprecated and will be removed in a future version of the API. You should use postalAddress.Building, postalAddress.UnitDetails, postalAddress.StreetNumber, postalAddress.StreetName and postalAddress.POBox instead. String - Postal Address for Client. Maximum length 170 characters. |
string postalCity |
WARNING: This field is deprecated and will be removed in a future version of the API. You should use postalAddress.City instead. String - City of Client's Postal Address. Maximum length 50 characters. |
string postalPCode |
WARNING: This field is deprecated and will be removed in a future version of the API. You should use postalAddress.Postcode instead. String - Post Code of Client's Postal Address. Maximum length 4 characters. |
string postalShortState |
WARNING: This field is deprecated and will be removed in a future version of the API. You should use postalAddress.State instead. String - State Short Name for Client's Postal Address. See GetStateList. Valid Short Names are:
|
int? divisionId |
Integer - ID of division to link the client to. Use functions such as GetDivisions to get a list of valid divisions. Specify null or 0 to link them to the same division as the occurrence they are enrolling into. |
string usi |
String - Optional Unique Student Identifier for the client. If specified, must be 10 characters, must be upper case (allowed characters are 2-9, and A-Z except I and O), and must have a valid Luhn Mod N check character. Use the ValidateUSI function to check whether a USI is valid. |
TAddress usualAddress |
TAddress : The usual/residential address of the client. This is the preferred way to specify the address. If this object is specified, the sAddr, sCity, sPCode and sShortState fields will be ignored. |
TAddress postalAddress |
TAddress : The postal address of the client. This is the preferred way to specify the address. If this object is specified, the postalAddr, postalCity, postalPCode and postalShortState fields will be ignored. |
TAuthenticate : an Authenticate Object containing the result of the update.
Copyright (c) VETtrak 2022. All rights reserved.
|