Employee API | Administrative - SOAP

• AddEmployee – used to add an employee’s demographic information and to check routing.
• DeleteEmployee – used to remove information about an employee.
• GetEmployee – used to retrieve an employee’s demographic information and to check routing.
• UpdateEmployee – used to update an employee’s demographic information and to check routing.
• SearchEmployees - used to retrieve an employee's demographic information and to check routing.
• UpdateEmployeeHumanResourceInfo – used for updating an employee’s non-discriminatory information.
• GetEmployeeHumanResourceInfo – used for retrieving an employee’s non-discriminatory information.
• AddEmployeeInteraction - This method is used to add new employee interactions.

• 9 TClients shall conform to the WS-I specifications unless otherwise agreed upon by Alegeus Technologies and the 9 T administrator.
• Clients shall format SOAP messages in a Document/Literal format over HTTPS.
• Clients shall have already created a valid user ID and password.
• Clients shall have a valid session ID after being authenticated by the system. The session ID needs to be passed in the proper manner as described in the Account Manager Service Guide.
• If the administrator uses the same user ID and password for all of their clients, the administrator is responsible for managing the security of the data.
• Clients should validate data before submitting a request to this Service. This facilitates better performance and accurate processing on both systems.
• Clients shall not attempt to use this service for batch processing of large amounts of data. The service is designed for synchronous calls that send or retrieve small chunks of data. If batch processing is required, then the EDI process should be used.
• If any method fails, the service returns a SOAP fault describing the problem.

__________________________________________________

AddEmployee

This method is used to add an employee’s demographic information and to check routing.

History
The AddEmployee methods are listed below:

• AddEmployee_2022_10
• AddEmployee_2015_02
• AddEmployee_2012_06
• AddEmployee_2009_04
• AddEmployee_2008_07
• AddEmployee_2007_12
• AddEmployeeRequest

• AddEmployeeResponse

• AddEmployee_2009_04
• AddEmployee_2008_07
• AddEmployee_2007_12
• AddEmployeeRequest

Example of an AddEmployee SOAP request message

<?xml version="1.0" encoding="utf-8" ?> 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<MBISessionHeader xmlns="http://www.medibank.com/MBIWebServices/SoapHeader/">
<MBISessionID>jhcppu45zzo00y45cqi03r55</MBISessionID> 
</MBISessionHeader>
</soap:Header>
<soap:Body>
<AddEmployee xmlns="http://www.medibank.com/MBIWebServices/Employee/Messages/Employee/Request/2004/06/">
<addEmployeeRequest>
<Address1>123 EasternGirls St</Address1> 
<BankAccount>123456</BankAccount> 
<BankAccountTypeCode xmlns="http://www.medibank.com/MBIWebServices/Enums/">Checking</BankAccountTypeCode> 
<BankRoutingNumber>123456789</BankRoutingNumber> 
<BirthDate>1945-01-01</BirthDate> 
<City>WesternWorld</City> 
<EmailAddress /> 
<EmployeeSocialSecurityNumber>444555666</EmployeeSocialSecurityNumber> 
<EmployerId>EASE10</EmployerId> 
<FirstName>Pet</FirstName> 
<Gender xmlns="http://www.medibank.com/MBIWebServices/Enums/">Male</Gender> 
<LastName>Shop</LastName> 
<EmployeeMaritalStatus
xmlns="http://www.medibank.com/MBIWebServices/Enums/">Divorced</EmployeeMaritalStatus> 
<MiddleInitial /> 
<NamePrefix>Mr.</NamePrefix> 
<Phone /> 
<ReimbursementCode xmlns="http://www.medibank.com/MBIWebServices/Enums/">Check</ReimbursementCode> 
<Remarks>This is a test</Remarks> 
<ShippingCountry /> 
<State>MA</State> 
<TpaId>T00209</TpaId> 
<ZipCode>12345</ZipCode> 
</addEmployeeRequest>
</AddEmployee>
</soap:Body>
</soap:Envelope>

Example of an AddEmployee SOAP response message

<?xml version="1.0" encoding="utf-8" ?> 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<MBIMessageIdHeader xmlns="http://www.medibank.com/MBIWebServices/SoapHeader/" /> 
</soap:Header>
<soap:Body>
<AddEmployeeResponse
xmlns="http://www.medibank.com/MBIWebServices/Employee/Messages/Employee/Response/2004/06/">
<AddEmployeeResult /> 
</AddEmployeeResponse>
</soap:Body>
</soap:Envelope>

Example Client Code
The following is an example of the client code (using a .NET proxy class for accessing the service) using the AddEmployee web method.

try
{
// Create the session SOAP header in order to pass the Account Service
// the client’s current session ID.
mbiSessionHeader = new EmployeeServiceNameSpace.MBISessionHeader();
// Create proxy object for the Employee service
proxy = new EmployeeServiceNameSpace.EmployeeService();
// Create request message for method call (input parameters)
request = new EmployeeServiceNameSpace.AddEmployeeRequest();
// Set the input parameters
request.Address1 = _address1.Text;
request.Address2 = _address2.Text;
request.BankAccount = _bankAccount.Text;
request.BankAccountTypeCode = (EmployeeServiceNameSpace.BankAccountType)
_bankAccountTypeCode.SelectedItem;
request.BankRoutingNumber = _bankRoutingNumber.Text;
if(_birthDate.Text.Length > 0)
{
request.BirthDate = Convert.ToDateTime(_birthDate.Text);
}
request.City = _city.Text;
request.Country = _country.Text;
request.EmailAddress = _email.Text;
request.EmployeeMaritalStatus = (EmployeeServiceNameSpace.MaritalStatus)
_maritalStatus.SelectedItem;
request.EmployeeSocialSecurityNumber = _empeSSN.Text;
request.EmployerId = _emprId.Text;
request.FirstName = _firstName.Text;
request.Gender = (EmployeeServiceNameSpace.Gender)_gender.SelectedItem;
request.LastName = _lastName.Text;
request.MiddleInitial = _initial.Text;
request.NamePrefix = _namePrefix.Text;
request.Phone = _phone.Text;
request.ReimbursementCode = (EmployeeServiceNameSpace.ReimbursementMethod)
_reimbursementCode.SelectedItem;
request.Remarks = _remarks.Text;
request.ShippingAddress1 = _shippingAddress1.Text;
request.ShippingAddress2 = _shippingAddress2.Text;
request.ShippingCity = _shippingCity.Text;
request.ShippingCountry = _shippingCountry.Text;
request.ShippingState = _shippingState.Text;
request.ShippingZipCode = _shippingZip.Text;
request.State = _state.Text;
request.TpaId = _tpaId.Text;
request.UserDefinedField = _userDefinedField.Text;
request.ZipCode = _zipCode.Text;
// session ID returned from login method
mbiSessionHeader.MBISessionID = _sessionId.Text;
proxy.MBISessionHeaderValue = mbiSessionHeader;
// Call the method
response = proxy.AddEmployee(request);
MessageBox.Show("Finished.");
}
catch(SoapException se)
{
// perform needed operations
}
catch(Exception ex)
{
// perform needed operations
}

__________________________________________________

DeleteEmployee

This method is used to delete information about an employee from the system.

History

The DeleteEmployee methods are listed below:

• DeleteEmployeeRequest

• DeleteEmployeeResponse

• DeleteEmployeeRequest

Response Message: Empty Message

Example of a DeleteEmployee SOAP request message

<?xml version="1.0" encoding="utf-8" ?> 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<MBISessionHeader xmlns="http://www.medibank.com/MBIWebServices/SoapHeader/">
<MBISessionID>jhcppu45zzo00y45cqi03r55</MBISessionID>
         </MBISessionHeader>
</soap:Header>
<soap:Body>
<DeleteEmployee xmlns="http://www.medibank.com/MBIWebServices/Employee/Messages/Employee/Request/2004/06/">
<deleteEmployeeRequest>
<EmployeeSocialSecurityNumber>444555666</EmployeeSocialSecurityNumber> 
<EmployerId>EASE10</EmployerId> 
<TpaId>T00209</TpaId> 
</deleteEmployeeRequest>
</DeleteEmployee>
</soap:Body>
</soap:Envelope>

Example of a DeleteEmployee SOAP response message

<?xml version="1.0" encoding="utf-8" ?> 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<MBIMessageIdHeader xmlns="http://www.medibank.com/MBIWebServices/SoapHeader/" /> 
</soap:Header>
<soap:Body>
<DeleteEmployeeResponse
xmlns="http://www.medibank.com/MBIWebServices/Employee/Messages/Employee/Response/2004/06/"> <DeleteEmployeeResult /> 
</DeleteEmployeeResponse>
</soap:Body>
</soap:Envelope>

Example Client Code
The following is an example of the client code (using a .NET proxy class to connect with the service) used when calling the DeleteEmployee method.

try
{
// Create the session SOAP header in order to pass the Account Service
// the client’s current session ID.
mbiSessionHeader = new EmployeeServiceNameSpace.MBISessionHeader();
// Create proxy object for the Employee service
proxy = new EmployeeServiceNameSpace.EmployeeService();
// Create request message for method call (input parameters)
request = new EmployeeServiceNameSpace.DeleteEmployeeRequest();
// Set the input parameters
request.EmployeeSocialSecurityNumber = _employeeSocialSecurityNumber.Text;
request.EmployerId = _employerId.Text;
request.TpaId = _tpaId.Text;
// session ID returned from login method
mbiSessionHeader.MBISessionID = _sessionId.Text;
proxy.MBISessionHeaderValue = mbiSessionHeader;
// Call the method
response = proxy.DeleteEmployee(request);
MessageBox.Show("Finished.");
}
catch(SoapException se)
{
// perform needed operations
}
catch(Exception ex)
{
// perform needed operations
}

__________________________________________________

GetEmployee

This method is used to retrieve an employee’s demographic information and to check routing.

History
The GetEmployee methods are listed below:

• GetEmployeeRequest

• GetEmployeeResponse_2012_06
• GetEmployeeResponse_2009_04
• GetEmployeeResponse_2008_07
• GetEmployeeResponse_2007_12
• GetEmployeeResponse

• GetEmployeeRequest

• GetEmployeeResponse_2009_04
• GetEmployeeResponse_2007_12
• GetEmployeeResponse

Example of a GetEmployee SOAP request message

<soapenv:Envelope xmlns:soapenv=http://schemas.xmlsoap.org/soap/envelope/ xmlns:mbi=http://schemas.datacontract.org/2004/07/MBI.WebServices.Wcf.Headers xmlns:v1=http://bensoft.metavante.com/WebServices/Contracts/Employee/2010/04/V1 xmlns:ns=http://bensoft.metavante.com/WebServices/Messages/Employee/Request/2010/04/>
   <soapenv:Header>
      <mbiSessionHeader>
         <!--Optional:-->
         <mbi:MBISessionID>xckprvmlfekgxfzwttwiwxn3</mbi:MBISessionID>
      </mbiSessionHeader>
   </soapenv:Header>
   <soapenv:Body>
      <v1:GetEmployee>
         <!--Optional:-->
         <v1:request xsi:type="ns39:GetEmployeeRequest_2019_07" xmlns:ns717=http://bensoft.metavante.com/WebServices/Messages/Employee/Request/2019/02/ xmlns:ns20=http://bensoft.metavante.com/WebServices/Messages/Employee/Request/2015/10/ xmlns:ns680=http://bensoft.metavante.com/WebServices/Messages/Employee/Request/2015/02/ xmlns:ns619=http://bensoft.metavante.com/WebServices/Messages/Employee/Request/2014/10/ xmlns:ns790=http://bensoft.metavante.com/WebServices/Messages/Employee/Request/2012/06/ xmlns:ns122=http://bensoft.metavante.com/WebServices/Messages/Employee/Request/2013/06/ xmlns:ns39=http://bensoft.metavante.com/WebServices/Messages/Employee/Request/2019/07/ xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance>
   <!--Optional:-->
   <ns:EmployeeId>?</ns:EmployeeId>
   <!--Optional:-->
   <ns:EmployeeSocialSecurityNumber>?</ns:EmployeeSocialSecurityNumber>
   <!--Optional:-->
<ns:EmployerId>AREMPLOYER</ns:EmployerId>
   <!--Optional:-->
<ns:TpaId>T02528</ns:TpaId>
   <!--Optional:-->
   <ns:VerboseMode>?</ns:VerboseMode>
   <!--Optional:-->
   <ns122:CardNumber>?</ns122:CardNumber>
   <!--Optional:-->
   <ns619:EmployeeMarketplaceGUID>?</ns619:EmployeeMarketplaceGUID>
</v1:request>
      </v1:GetEmployee>
   </soapenv:Body>
</soapenv:Envelope>

Example of a GetEmployee SOAP response message

<?xml version="1.0" encoding="utf-8" ?> 
<soap:Envelope xmlns:soap=http://schemas.xmlsoap.org/soap/envelope/
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<MBIMessageIdHeader xmlns="http://www.medibank.com/MBIWebServices/SoapHeader/" /> 
</soap:Header>
<soap:Body>
<GetEmployeeResponse
xmlns="http://www.medibank.com/MBIWebServices/Employee/Messages/Employee/Response/2004/06/">
<GetEmployeeResult>
<Address1>123 EasternGirls St</Address1> 
<Address2 /> 
<BankAccount>123456</BankAccount> 
<BankAccountTypeCode xmlns="http://www.medibank.com/MBIWebServices/Enums/">Checking</BankAccountTypeCode> 
<BankRoutingNumber>123456789</BankRoutingNumber> 
<BirthDate>19450101</BirthDate> 
<City>WesternWorld</City> 
<Country>US</Country> 
<EmailAddress /> 
<EmployeeSocialSecurityNumber>444555666</EmployeeSocialSecurityNumber> 
<EmployeeStatus xmlns="http://www.medibank.com/MBIWebServices/Enums/">New</EmployeeStatus> 
<EmployerId>EASE10</EmployerId> 
<FirstName>Pet</FirstName> 
<Gender xmlns="http://www.medibank.com/MBIWebServices/Enums/">Male</Gender> 
<LastName>Shop</LastName> 
<EmployeeMaritalStatus xmlns="http://www.medibank.com/MBIWebServices/Enums/">Divorced</EmployeeMaritalStatus> 
<MiddleInitial /> 
<NamePrefix>Mr.</NamePrefix> 
<Phone /> 
<ReimbursementCode xmlns="http://www.medibank.com/MBIWebServices/Enums/">Check</ReimbursementCode> 
<Remarks>This is a test</Remarks> 
<ShippingAddress1 /> 
<ShippingAddress2 /> 
<ShippingCity /> 
<ShippingCountry /> 
<ShippingState /> 
<ShippingZipCode /> 
<State>MA</State> 
<TpaId>T00209</TpaId> 
<UserDefinedField /> 
<ZipCode>12345</ZipCode> 
</GetEmployeeResult>
</GetEmployeeResponse>
</soap:Body>
</soap:Envelope>

Example Client Code
The following is an example of the client code (using a .NET proxy class to connect to the service) used when calling the GetEmployee method.

 try
{
_dataset.Tables["Employees"].Clear();  
// Create the session SOAP header in order to pass the Account Service 
// the client’s current session ID.
mbiSessionHeader = new EmployeeServiceNameSpace.MBISessionHeader();
// Create proxy object for the Employee service
proxy = new EmployeeServiceNameSpace.EmployeeService();
// Create request message for method call (input parameters)
request = new EmployeeServiceNameSpace.GetEmployeeRequest();
// Set the input parameters
request.EmployeeSocialSecurityNumber = _employeeSocialSecurityNumber.Text;
request.EmployerId = _employerId.Text; 
request.TpaId = _tpaId.Text;
request.VerboseMode = Convert.ToBoolean(_verboseMode.Text); 
// session ID returned from logon method
mbiSessionHeader.MBISessionID = _sessionId.Text; 
proxy.MBISessionHeaderValue = mbiSessionHeader;
response = proxy.GetEmployee(request); 
if(response != null)
{
_dataset.Tables["Employees"].Rows.Add(new string[] 
{ 
response.Address1,
response.Address2,
response.BankAccount,
response.BankAccountTypeCode.ToString(),
response.BankRoutingNumber,
response.BirthDate,
response.City,
response.Country,
response.EmailAddress,
response.EmployeeMaritalStatus.ToString(),
response.EmployeeSocialSecurityNumber,
response.EmployeeStatus.ToString(),
response.EmployerId,
response.FirstName,
response.Gender.ToString(),
response.LastName,
response.MiddleInitial,
response.NamePrefix,
response.Phone,
response.ReimbursementCode.ToString(), 
response.Remarks,
response.ShippingAddress1,
response.ShippingAddress2,
response.ShippingCity,
response.ShippingCountry,
response.ShippingState,
response.ShippingZipCode,
response.State,
response.TpaId,
response.UserDefinedField,
response.ZipCode 
});
} 
}
catch(SoapException se)
{
// perform needed operations
}
catch(Exception ex)
{
// perform needed operations
}

__________________________________________________

UpdateEmployee

This method is used to update an employee’s demographic information and to check routing.

History
The UpdateEmployee methods are listed below:

• UpdateEmployee_2022_10
• UpdateEmployee_2012_06
• UpdateEmployee_2009_04
• UpdateEmployee_2008_07
• UpdateEmployee_2007_12
• UpdateEmployeeRequest

• UpdateEmployeeResponse

• UpdateEmployee_2022_10
• UpdateEmployee_2012_06
• UpdateEmployee_2009_04
• UpdateEmployee_2008_07
• UpdateEmployee_2007_12
• UpdateEmployeeRequest

Response Message: Empty Message

Example of a UpdateEmployee SOAP request message

<?xml version="1.0" encoding="utf-8" ?> 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<MBISessionHeader xmlns="http://www.medibank.com/MBIWebServices/SoapHeader/">
<MBISessionID>jhcppu45zzo00y45cqi03r55</MBISessionID> 
</MBISessionHeader>
</soap:Header>
<soap:Body>
<UpdateEmployee xmlns="http://www.medibank.com/MBIWebServices/Employee/Messages/Employee/Request/2004/06/">
<updateEmployeeRequest>
<Address1>123 Water</Address1> 
<BankAccount>123455</BankAccount> 
<BankAccountTypeCode xmlns="http://www.medibank.com/MBIWebServices/Enums/">Savings</BankAccountTypeCode> 
<BankRoutingNumber>123456789</BankRoutingNumber> 
<BirthDate>1976-01-01</BirthDate> 
<City>World</City> 
<CurrentEmployeeSocialSecurityNumber>444555666</CurrentEmployeeSocialSecurityNumber> 
<EmailAddress /> 
<EmployeeMaritalStatus xmlns="http://www.medibank.com/MBIWebServices/Enums/">Divorced</EmployeeMaritalStatus> 
<EmployeeStatus xmlns="http://www.medibank.com/MBIWebServices/Enums/">Active</EmployeeStatus> 
<EmployerId>EASE10</EmployerId> 
<FirstName>Movie</FirstName> 
<Gender xmlns="http://www.medibank.com/MBIWebServices/Enums/">None</Gender> 
<LastName>Doe</LastName> 
<MiddleInitial /> 
<NamePrefix>Mr.</NamePrefix> 
<Phone /> 
<ReimbursementCode xmlns="http://www.medibank.com/MBIWebServices/Enums/">Check</ReimbursementCode> 
<Remarks>This is a test</Remarks> 
<ShippingCountry /> 
<State>MA</State> 
<TpaId>T00209</TpaId> 
<ZipCode>34567</ZipCode> 
</updateEmployeeRequest>
</UpdateEmployee>
</soap:Body>
</soap:Envelope>

Example of an UpdateEmployee SOAP response message

<?xml version="1.0" encoding="utf-8" ?> 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<MBIMessageIdHeader xmlns="http://www.medibank.com/MBIWebServices/SoapHeader/" /> 
</soap:Header>
<soap:Body>
<UpdateEmployeeResponse
xmlns="http://www.medibank.com/MBIWebServices/Employee/Messages/Employee/Response/2004/06/">
<UpdateEmployeeResult /> 
</UpdateEmployeeResponse>
</soap:Body>
</soap:Envelope>

Example Client Code
The following is an example of the client code (using a .NET proxy class for the service) used when calling the UpdateEmployee method.

try
{
// Create the session SOAP header in order to pass the Account Service  
// the client’s current session ID.
mbiSessionHeader = new EmployeeServiceNameSpace.MBISessionHeader();
// Create proxy object for the Employee service
proxy = new EmployeeServiceNameSpace.EmployeeService();
// Create request message for method call (input parameters)
request = new EmployeeServiceNameSpace.UpdateEmployeeRequest();
// Set the input parameters
request.Address1 = _address1.Text;
request.Address2 = _address2.Text;
request.BankAccount = _bankAccount.Text;
request.BankAccountTypeCode = (EmployeeServiceNameSpace.BankAccountType)
_bankAccountTypeCode.SelectedItem;
request.BankRoutingNumber = _bankRoutingNumber.Text; 
if(_birthDate.Text.Length > 0) 
{
request.BirthDate = Convert.ToDateTime(_birthDate.Text); 
}
request.City = _city.Text;
request.Country=_country.Text;
request.CurrentEmployeeSocialSecurityNumber = _empeCurrentSSN.Text;  
request.EmailAddress = _email.Text; 
request.EmployeeMaritalStatus = (EmployeeServiceNameSpace.MaritalStatus)
_maritalStatus.SelectedItem;
request.EmployeeStatus = (EmployeeServiceNameSpace.CardholderStatus)
_empeStatus.SelectedItem;
request.EmployerId = _emprId.Text;      
request.FirstName = _firstName.Text;
request.Gender = (EmployeeServiceNameSpace.Gender)_gender.SelectedItem;
request.LastName = _lastName.Text;
request.MiddleInitial = _initial.Text;
request.NamePrefix = _namePrefix.Text;
request.NewEmployeeSocialSecurityNumber = _empeNewSSN.Text;
request.Phone = _phone.Text;  
request.ReimbursementCode = (EmployeeServiceNameSpace.ReimbursementMethod)
_reimbursementCode.SelectedItem;
request.Remarks = _remarks.Text;
request.ShippingAddress1 = _shippingAddress1.Text;
request.ShippingAddress2 = _shippingAddress2.Text;
request.ShippingCity = _shippingCity.Text;
request.ShippingCountry = _shippingCountry.Text;
request.ShippingState = _shippingState.Text;
request.ShippingZipCode = _shippingZip.Text;
request.State = _state.Text;
request.TpaId = _tpaId.Text;
request.UserDefinedField = _userDefinedField.Text;
request.ZipCode = _zipCode.Text;
// session ID returned from login method
mbiSessionHeader.MBISessionID = _sessionId.Text;
proxy.MBISessionHeaderValue = mbiSessionHeader;
// Call the method
response = proxy.UpdateEmployee(request); 
MessageBox.Show("Finished."); 
}
catch(SoapException se)
{
// perform needed operations
}
catch(Exception ex)
{
// perform needed operations
}

__________________________________________________

SearchEmployee

This method is used to search for employee information.

History
The SearchEmployees methods are listed below:

• SearchEmployeesRequest

• SearchEmployeesResponse

• SearchEmployeesRequest

• SearchEmployeesResponse

Example of a SearchEmployees SOAP request message

<?xml version="1.0" encoding="utf-8" ?> 
<soap:Envelope xmlns:soap=http://schemas.xmlsoap.org/soap/envelope/
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<MBISessionHeader xmlns="http://www.medibank.com/MBIWebServices/SoapHeader/">
<MBISessionID>jhcppu45zzo00y45cqi03r55</MBISessionID> 
</MBISessionHeader>
</soap:Header>
<soap:Body>
<SearchEmployees xmlns="http://www.medibank.com/MBIWebServices/Employee/Messages/Employee/Request/2004/06/"> <searchEmployeesRequest>
<EmployeeSocialSecurityNumber>444555666</EmployeeSocialSecurityNumber> 
<EmployerId>EASE10</EmployerId> 
<iId>T00209</TpaId> 
</searchEmployeesRequest>
</SearchEmployees>
</soap:Body>
</soap:Envelope>

Example of a SearchEmployees SOAP response message

<?xml version="1.0" encoding="utf-8" ?> 
<soap:Envelope xmlns:soap=http://schemas.xmlsoap.org/soap/envelope/
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<MBIMessageIdHeader xmlns="http://www.medibank.com/MBIWebServices/SoapHeader/" /> 
</soap:Header>
<soap:Body>
<SearchEmployeesResponse xmlns="http://www.medibank.com/MBIWebServices/Employee/Messages/Employee/Response/2004/06/">
<SearchEmployeesResult>
<EmployeeSocialSecurityNumber>123981312</EmployeeSocialSecurityNumber> 
<EmployeeId>XXX999</EmployeeId> 
<EmployeeStatus xmlns="http://www.medibank.com/MBIWebServices/Enums/">New</EmployeeStatus> 
<EmployerId>EASE10</EmployerId> 
<FirstName>Pet</FirstName> 
<Gender xmlns="http://www.medibank.com/MBIWebServices/Enums/">Male</Gender> 
<LastName>Shop</LastName> 
<EmployeeMaritalStatus xmlns="http://www.medibank.com/MBIWebServices/Enums/">Divorced</EmployeeMaritalStatus> 
<MiddleInitial /> 
<NamePrefix>Mr.</NamePrefix> 
<TpaId>T00209</TpaId> 
</SearchEmployeesResult>
</SearchEmployeesResponse>
</soap:Body>
</soap:Envelope>

Example Client Code
The following is an example of the client code (using a .NET proxy class to connect to the service) used when calling the SearchEmployees method.

try
{
_dataset.Tables["Employees"].Clear();
// Create the session SOAP header in order to pass the Account Service  
// the client’s current session ID.
mbiSessionHeader = new EmployeeServiceNameSpace.MBISessionHeader();
// Create proxy object for the Employee service
proxy = new EmployeeServiceNameSpace.EmployeeService();
// Create request message for method call (input parameters)
request = new EmployeeServiceNameSpace.SearchEmployeesRequest();
// Set the input parameters
request.EmployeeSocialSecurityNumber = _employeeSocialSecurityNumber.Text;  request.EmployerId = _employerId.Text;
request.TpaId = _tpaId.Text;
request.VerboseMode = Convert.ToBoolean(_verboseMode.Text); 
// session ID returned from logon method
mbiSessionHeader.MBISessionID = _sessionId.Text;
proxy.MBISessionHeaderValue = mbiSessionHeader;
response = proxy.SearchEmployees(request); 
if(response != null)
{
  _dataset.Tables["Employees"].Rows.Add(new string[] 
 { 
response.EmployeeMaritalStatus.ToString(),
response.EmployeeSocialSecurityNumber, 
response.EmployeeStatus.ToString(), 
response.EmployeeId.ToString(), 
response.EmployerId, 
response.FirstName, 
response.Gender.ToString(),
response.LastName, 
response.MiddleInitial,
response.NamePrefix,
response.TpaId
});
}                                     
}
catch(SoapException se)
{
// perform needed operations
}
catch(Exception ex)
{
// perform needed operations
}

__________________________________________________

UpdateEmployeeHumanResourceInfo

This method is used to add an employee’s non-discriminatory information. 

History
The UpdateEmployeeHumanResourceInfo methods are listed below:

• UpdateEmployeeHumanResourceInfoRequest

Response Message

• UpdateEmployeeHumanResourceInfoRequest

Response Message: Empty Message

Example of an UpdateEmployeeHumanResourceInfo SOAP request message

<?xml version="1.0" encoding="utf-8" ?> 
<soap:Envelope xmlns:soap=32TUhttp://schemas.xmlsoap.org/soap/envelope/U32T
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<MBISessionHeader xmlns="http://www.medibank.com/MBIWebServices/SoapHeader/">
<MBISessionID>jhcppu45zzo00y45cqi03r55</MBISessionID> 
</MBISessionHeader>
</soap:Header>
<soap:Body>
<UpdateEmployeeHumanResourceInfoRequest
xmlns="http://www.medibank.com/MBIWebServices/Employee/Messages/Employee/Request/">
<updateEmployeeHumanResourceInfoRequest>
<TpaId>T00133</TpaId>
<EmployeeId>Employee1</EmployeeId>
<EmployerId>WST5111</EmployerId>
<AddComp1>1000</AddComp1>
<OrigHireDte>20050103</OrigHireDte>
</updateEmployeeHumanResourceInfoRequest>
</UpdateEmployeeHumanResourceInfoRequest>
</soap:Body>
</soap:Envelope>

Example of an UpdateEmployeeHumanResourceInfo SOAP response message

<?xml version="1.0" encoding="utf-8" ?> 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<MBIMessageIdHeader xmlns="http://www.medibank.com/MBIWebServices/SoapHeader/" /> 
</soap:Header>
<soap:Body>
< UpdateEmployeeHumanResourceInfoResponse
xmlns="http://www.medibank.com/MBIWebServices/Employee/Messages/Employee/Response/">
< UpdateEmployeeHumanResourceInfoResult /> 
</ UpdateEmployeeHumanResourceInfoResponse>
</soap:Body>
</soap:Envelope>

Example Client Code
The following is an example of the client code (using a .NET proxy class to connect to the service) used when calling the UpdateEmployeeHumanResourceInfo method.  

try 
{
  //declare the request and response objects
SmokeTest.Employee_2007_08.UpdateEmployeeHumanResourceInfoRequest req_2007_08;
SmokeTest.Employee_2007_08.UpdateEmployeeHumanResourceInfoResponse resp_2007_08;
SmokeTest.Employee_2007_08.MBISessionHeader es_2007_08_sh;
 //Create objects
es_2007_08_proxy = new SmokeTest.Employee_2007_08.EmployeeService();
es_2007_08_sh = new SmokeTest.Employee_2007_08.MBISessionHeader();
req_2007_08 = new SmokeTest.Employee_2007_08.UpdateEmployeeHumanResourceInfoRequest();
//Required fields
req_2007_08.TpaId = txtTPA.text;
req_2007_08.EmployerId = txtEmployerId.text;
req_2007_08.EmployeeId = txtEmployeeId.text;
req_2007_08.AddComp1 = txtAddComp1.text;
req_2007_08.AddComp2 = txtAddComp2.text;
es_2007_08_sh.MBISessionID = sSession;
es_2007_08_proxy.MBISessionHeaderValue = es_2007_08_sh;
resp_2007_08 = es_2007_08_proxy.UpdateEmployeeHumanResourceInfo(req_2007_08);
 
}
catch(Exception ex)
{
  //If an exception occurred, display to the user   txtResponse.Text = ex.Message;
}
}

__________________________________________________

GetEmployeeHumanResourceInfo

This method is used to get an employee’s non-discriminatory information.

History
The GetEmployeeHumanResourceInformation methods are listed below:

• GetEmployeeHumanResourceInfoRequest

• GetEmployeeHumanResourceInfoResponse_2020_02

• GetEmployeeHumanResourceInfoRequest

• GetEmployeeHumanResourceInfoResponse_2020_02
• GetEmployeeHumanResourceInfoResponse

Example of a GetEmployeeHumanResourceInfo SOAP request message

<?xml version="1.0" encoding="utf-8" ?> 
<soap:Envelope xmlns:soap=32Thttp://schemas.xmlsoap.org/soap/envelope/32T
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<MBISessionHeader xmlns="http://www.medibank.com/MBIWebServices/SoapHeader/">
 <MBISessionID>jhcppu45zzo00y45cqi03r55</MBISessionID> 
</MBISessionHeader>
</soap:Header>
<GetEmployeeHumanResourceInfoRequest xmlns="http://www.medibank.com/MBIWebServices/Employee/Messages/Employee/Request/">
<getEmployeeHumanResourceInfoRequest>
 <TpaId>T00123</TpaId>
<EmployeeId>Employee1</EmployeeId>
<EmployerId>WST1234</EmployerId>
</getEmployeeHumanResourceInfoRequest>
</GetEmployeeHumanResourceInfoRequest>
</soap:Body>
</soap:Envelope>

Example of a GetEmployeeHumanResourceInfo SOAP response message

<?xml version="1.0" encoding="utf-8" ?> 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<MBIMessageIdHeader xmlns="http://www.medibank.com/MBIWebServices/SoapHeader/" /> <MessageId>36565d89-7619-
48be-8c7e-7fb1929d0ded</MessageId></MBIMessageIdHeader>
</soap:Header>
<soap:Body>
<GetEmployeeHumanResourceInfoResponse
xmlns="http://www.medibank.com/MBIWebServices/Employee/Messages/Employee/Response/"><GetEmployeeHumanResourc
eInfoResult>
<AddComp1>70</AddComp1>
<AddComp2>20</AddComp2>
<BaseSalary>95000</BaseSalary>
<BranchCde />
<Cobra>false</Cobra>
<CompOfficer>false</CompOfficer>
<CompOfficerDca>false</CompOfficerDca>
<HireDte />
<OrigHireDte />
<TermDte />
<EligDte />
<OccupCde />
<LocCde />
<DeptCde />
<DivisionKey>-1</DivisionKey>
<SecCde />
<HealthId />
<EvidInsurability />
<HcRelativeSsn/>
<PrevYrTotalComp>0</PrevYrTotalComp>
<StockPct>0</StockPct>
<VacationDays>0</VacationDays>
<UnionMember>false</UnionMember>
<Smoker>false</Smoker>
<NonResidentAlien>false</NonResidentAlien>
<TaxFilingStatusCde>Single</TaxFilingStatusCde>
<EmployTypeCde>FullTime</EmployTypeCde>
<EmpeOptioncde>Total</EmpeOptioncde>
<KeyEmpe>false</KeyEmpe>
<SpouseDepOfOwner>false</SpouseDepOfOwner>
<ElectOtherAmt>0</ElectOtherAmt>
<ElectHealthAmt>0</ElectHealthAmt>
<ElectDentalAmt>0</ElectDentalAmt>
<ElectVisionAmt>0</ElectVisionAmt>
<ElectGrpTermLifeAmt>0</ElectGrpTermLifeAmt>
<ElectOtherHealthAmt>0</ElectOtherHealthAmt>
<ElectLtdAmt>0</ElectLtdAmt>
<ElectStdAmt>0</ElectStdAmt>
<ElectAdoptionAmt>0</ElectAdoptionAmt>
<Elect401kAmt>0</Elect401kAmt>
<ElectHealthFSAAmt>0</ElectHealthFSAAmt>
<ElectDependentcareFSAAmt>0</ElectDependentcareFSAAmt>
<TotalElectAmt>0</TotalElectAmt>
<HcOverride>False</HcOverride>
</GetEmployeeHumanResourceInfoResult>
</GetEmployeeHumanResourceInfoResponse>
</soap:Body>
</soap:Envelope>

Example Client Code
The following is an example of the client code (using a .NET proxy class to connect to the service) used when calling the GetEmployeeHumanResourceInfo method.

try 
{
 //declare the request/response objects
SmokeTest.Employee_2007_08.GetEmployeeHumanResourceInfoRequest req_2007_08;
SmokeTest.Employee_2007_08.GetEmployeeHumanResourceInfoResponse resp_2007_08;
//Create objects
SmokeTest.Employee_2007_08.MBISessionHeader es_2007_08_sh;
//Create objects
es_2007_08_proxy = new SmokeTest.Employee_2007_08.EmployeeService();
es_2007_08_sh = new SmokeTest.Employee_2007_08.MBISessionHeader();   
req_2007_08 = new SmokeTest.Employee_2007_08.GetEmployeeHumanResourceInfoRequest();   
//Required fields   
req_2007_08.TpaId = txtTPA.text;   
req_2007_08.EmployerId = txtEmployerId.text;   
req_2007_08.EmployeeId = txtEmployeeId.text;
//Display session ID on web form   
es_2007_08_sh.MBISessionID = sSession;   
es_2007_08_proxy.MBISessionHeaderValue = es_2007_08_sh;
resp_2007_08 = es_2007_08_proxy.GetEmployeeHumanResourceInfo(req_2007_08);
}
catch (Exception ex)
{
txtResponse.Text = ex.Message;
}
 
}

__________________________________________________

AddEmployeeInteraction

This method is used by administrators to add employee interactions.

History
The AddEmployeeInteraction methods are listed below:

• AddEmployeeInteraction

• AddEmployeeInteraction

• AddEmployeeInteractionRequest

Response message: