Global Employee New Hire Service

Introduction

With UKG Pro Web Services, you can leverage your UKG Pro data for solving business application and integration needs.

This document describes how to use the Global Employee New Hire Web service and is intended for individuals who are familiar with software development and Web service technologies.

Global Employee New Hire Service API

The UKG Pro Global Employee New Hire Service API enables the user to programmatically hire an employee into a Global UKG Pro company. In addition, the API allows you to edit employees after they are hired in UKG Pro.

Overview

This document describes the methods of the service and provides code examples using Microsoft’s Visual Studio 2010 using C# and XML (.NET Framework 3.0 or higher).

The following information describes the service requirements.


Service Specifications

Protocol	Simple Object Access Protocol (SOAP) 1.2
SSL Support	Required


Signup and Licensing

Account Required	UKG Pro Service Account or UKG Pro Web User with Web Services Permissions

Using an UKG Pro Service Account is recommended. For information regarding establishing and maintaining an UKG Pro Service Account, please refer to the document Maintaining Service Accounts located in the UKG Pro Technical Content section of the Ultimate Library under UKG Pro Web Services and APIs.

Employee Global New Hire Object

The employee New Hire object includes the following properties.

Property	Required	Type	Description
AddressLine1		String	Address line 1
AddressLine2		String	Address line 2
AlternateEmailAddress		String	Alternate email address
AlternateTitle		String	Alternate job title
BenefitGroup	Yes	Code list	Deduction / Benefit group code
BenefitSeniorityDate	Yes	Date	Benefit seniority date
BirthDate	Yes	Date	Birth date
City		String	Address city
CompanyIdentifier	Yes	Reference	Identifier that represents an UKG Pro component company. Select Company Code or Import code and provide the value.
Country		Code list	A valid country code
County		String	Address county
Currency	Yes	Code list	Currency type code
EmailAddress		String	Primary Email address
EmployeeNumber		String	Employee number. If the company employee number method is setup as Time clock number or automatic, this field will be ignored.
EmployeeType		Code list	Employee type code
FirstName	Yes	String	First name
FormerLastName		String	Former last name
FullOrPartTime	Yes	Code list	Employee status F = Full time P = Part time
Gender		Code list	Gender code. System Delivered M = Male F = Female Custom The code for any custom gender defined by your company. Validation M and F are valid for all countries. Other custom genders are country-specific, as defined by your System Administrator. If the gender is defined for all countries, no further country validation is performed. If the gender is defined for a specific country, that country must match the Country property. If Country is not defined, the gender’s country must match the Company’s Operating Country.
HireDate		Date	Date of hire
HomePhone		String	Home phone number. Exclude dashes and parentheses.
HourlyOrSalaried		Code list	Employee’s pay type H = Hourly S = Salaried
JobCode	Yes	Code list	Job code
LastName	Yes	String	Last name
LocationCode		String
MailStop		String	Mail stop
MiddleName		String	Middle name
NationalID	Yes	String	National ID
HireDate	Yes	Date	Date of original hire
OrgLevel1		Code list	Organizational 1 code
OrgLevel2		Code list	Organizational 2 code
OrgLevel3		Code list	Organizational 3 code
OrgLevel4		Code list	Organizational 4 code
PayGroup	Yes	Code list	Pay group
PaymentsPerYear		Integer
PayRate	Yes	Decimal	Employee’s rate of pay. Set the PayRateType accordingly.
PayRateType	Yes	Code list	Type of pay rate entered in the PayRate property. H=Hourly P=Period W=Weekly Y=Yearly (Annual)
PostalCode		String	Zip / Postal code
PreferredFirstName		String	Preferred first name
Prefix		Code list	Prefix name code
ScheduledHours	Yes	Decimal	Scheduled number of hours for employee
SeniorityDate	Yes	Date	Date of seniority
StateOrProvince		Code list	State or Province code
Suffix		Code list	Suffix name code
Supervisor		Reference	ID that represents a person that is the supervisor for this employee
WeeklyHours		Decimal
WorkExtension		String	Work phone extension
WorkPhone		String	Work phone. Exclude dashes and parentheses.

Employee Global View and Update Object

In addition to the new hire object properties, the global view and edit provides the following additional properties that are available.

Property	Required	Type	Description
EmployeeIdentifier		Reference	ID that represents a person
EffectiveDate		Date	Effective date of the change. Only applicable for an update. Required when changing an employee value.
LastHireDate	Yes	Date	Date of last hire
ReasonCode		Code list	Reason code for the change. Only applicable for an update. Required when changing an employee value.
Status	Yes	Code list	A=Active T=Terminated
TerminationDate		Date	Required when Status is changed to Terminated
TerminationReasonCode		Code list	Required when Status is changed to Terminated

Quick Start

This section provides steps for creating a sample application in your development environment to hire a global employee, retrieve their information, and update the employee information.

Prerequisites

In order to use the service, you will need the following items:

An UKG Pro Service Account username and password OR an UKG Pro Web User username and password
The Customer API key from the UKG Pro Web Service administrative page
If you use an UKG Pro Service Account:
- You will need the User API key from the Service Account administrative page.
- You must have appropriate permissions granted to the Service Account for the Global Employee New Hire service on the Service Account administrative page.
If you use an UKG Pro Web User account:
- You will need the User API key from the Web Service administrative page.

Methods

This section describes the API methods for the Employee Global New Hire Web Service.

NewHireGlobal

This method provides a way to hire an employee to a global company in UKG Pro. You must provide the minimum required fields listed in the new hire object in order to successfully hire an employee.

GetGlobalEmployeeByEmployeeIdentifier

This method allows you to retrieve an individual employee record by providing an employee identifier. This is helpful if you are designing an application that is aware of the employees to retrieve or when you plan to execute an update of some of the employee information.

You can identify global employees by the following identifiers.

Description	Identifier
Employee number	EmployeeNumberIdentifier
National ID	NationalIdentifier
Email address	EmailAddressIdentifier

UpdateGlobalEmployee

This method allows you to update the employee information. We recommend executing a get to retrieve the employee information first, then submitting the object to the update method since the method requires a global employee object.

C# Example

Generate the Service Reference

Once you have a user and API keys, you need to create a service reference to the Login Service and the Global New Hire Service. In your development environment, add the service references.

In Visual Studio, select the Add Service Reference menu item from the Project menu. Once you enter the service information you should have the references display in the solution explorer.

Created service reference
Created service reference

Example Code

The following code is an example of adding a new employee and updating the employee information in a console application. Copy the entire contents to a C# console application and update the following values to build an operable application.

UserName = "YOUR SERVICE ACCOUNT OR WEB USER NAME ",
Password = "YOUR PASSWORD",
UserAPIkey = "YOUR USER API KEY",
CustomerAPIkey = "YOUR CUSTOMER API KEY"

//Example Quick Start Code Begin


using System;
using System.Linq;


namespace GlobalNewHireSample
{
    using System.ServiceModel;
    using System.ServiceModel.Channels;
    using EmployeeGlobalNewHire;
    using LoginService;


    public class Program
    {
        private static void Main(string[] args)
        {
            // Setup your user credentials.
            const string userName = "YOUR WEB USER NAME";
            const string password = "YOUR PASSWORD";
            const string userApiKey = "YOUR USER API KEY";
            const string customerApiKey = "YOUR CUSTOMER API KEY";


            // Create a proxy to the login service.
            LoginServiceClient loginClient = new LoginServiceClient("WSHttpBinding_ILoginService");
            try
            {
                // Submit the login request to authenticate the user.
                string message = "";
                string authenticationToken = "";
                AuthenticationStatus loginStatus =
                    loginClient.Authenticate(
                        customerApiKey,
                        password,
                        userApiKey,
                        userName,
                        out message,
                        out authenticationToken);


                if (loginStatus == AuthenticationStatus.Ok)
                {
                    // User is authenticated and the authentication token is provided.
                    Console.WriteLine("User authentication was successful.\n");


                    // Create Global New Hire
                    Console.WriteLine("----------Start Create----------");
                    CreateGlobalNewHire(customerApiKey, authenticationToken);
                    Console.WriteLine("----------End Create----------\n");


                    // Get Global New Hire
                    Console.WriteLine("----------Start Get----------");
                    GetGlobalNewHire(customerApiKey, authenticationToken);
                    Console.WriteLine("----------End Get----------\n");


                    // Update Global New Hire
                    Console.WriteLine("----------Start Update----------");
                    UpdateGlobalEmployee(customerApiKey, authenticationToken);
                    Console.WriteLine("----------End Update----------\n");
                }
                else
                {
                    // User authentication has failed. Review the message for details.
                    Console.WriteLine("User authentication failed: " + message);
                }


                loginClient.Close();


                Console.WriteLine("Press a key to exit");
                Console.ReadKey(true);


            }
            catch (Exception e)
            {
                Console.WriteLine(e);
                loginClient.Abort();
            }
        }


        private static void CreateGlobalNewHire(string customerApiKey, string authenticationToken)
        {
            EmployeeGlobalNewHireClient proxy = new EmployeeGlobalNewHireClient("WSHttpBinding_IEmployeeGlobalNewHire");


            try
            {
                // Add the headers for the Customer api key and authentication token.
                using (new OperationContextScope(proxy.InnerChannel))
                {
                    OperationContext.Current.OutgoingMessageHeaders
                        .Add(MessageHeader.CreateHeader("ultiproToken", "http://www.ultimatesoftware.com/foundation/authentication/ultiproToken",                                                        authenticationToken));


                    OperationContext.Current.OutgoingMessageHeaders
                        .Add(MessageHeader.CreateHeader("ClientAccessKey", "http://www.ultimatesoftware.com/foundation/authentication/clientaccesskey",                                                        customerApiKey));
                    // Define new hire
                    var newHire = new GlobalNewHire
                                      {
                                          AddressLine1 = "123 Main St",
                                          AddressLine2 = string.Empty,
                                          AlternateEmailAddress = string.Empty,
                                          AlternateTitle = "Sales Rep",
                                          BenefitGroup = "ADG1",
                                          BenefitSeniorityDate = new DateTime(2012, 4, 1),
                                          BirthDate = new DateTime(1970, 1, 1),
                                          City = "Sydney",
                                          CompanyIdentifier = new CompanyCodeIdentifier {CompanyCode = "AUSC2"},
                                          Country = "AUS",
                                          County = string.Empty,
                                          Currency = "AUD",
                                          EmailAddress = "[email protected]",
                                          EmployeeNumber = "68947",
                                          EmployeeType = "REG",
                                          FirstName = "Jacob",
                                          FormerLastName = string.Empty,
                                          FullOrPartTime = "F",
                                          Gender = "M",
                                          HireDate = new DateTime(2012, 4, 1),
                                          HomePhone = "249910900",
                                          HourlyOrSalaried = "S",
                                          JobCode = "GBAUS1",
                                          LastName = "Smith",
                                          LocationCode = "Loc",
                                          MailStop = string.Empty,
                                          MiddleName = "R",
                                          NationalID = "B93045",
                                          OrgLevel1 = "SE",
                                          OrgLevel2 = string.Empty,
                                          OrgLevel3 = string.Empty,
                                          OrgLevel4 = string.Empty,
                                          PayGroup = "AUSMTH",
                                          PaymentsPerYear = 15,
                                          PayRate = 30500.00m,
                                          PayRateType = "Y",
                                          PostalCode = "2000",
                                          PreferredFirstName = "Jay",
                                          Prefix = "",
                                          ScheduledHours = 40,
                                          SeniorityDate = new DateTime(2012, 4, 1),
                                          StateOrProvince = "SA",
                                          Supervisor = new EmployeeNumberIdentifier { EmployeeNumber = "1" },
                                          WeeklyHours = 40.0m
                                          WorkExtension = "289",
                                          WorkPhone = "249910900",
                                      };


                    // Create new hire
                    GlobalEmployeeCreateResponse createResponse = proxy.NewHireGlobal(new[] { newHire });


                    // Check the result to see if operation was successful
                    if (createResponse.HasErrors)
                    {
                        if (createResponse.OperationResult.HasErrors)
                        {
                            // Review each operation error.
                            foreach (OperationMessage message in createResponse.OperationResult.Messages)
                            {
                                Console.WriteLine("Operation Error Message: " + message.Message);
                            }
                        }


                        // Review each result error.
                        foreach (Result result in createResponse.Results.Where(r => r.HasErrors))
                        {
                            Console.WriteLine("Result " + result.RequestNumber + ":");


                            // Review messages for this result error.
                            foreach (OperationMessage message in result.Messages)
                            {
                                Console.WriteLine("\n\tMessage:");
                                Console.WriteLine("\tError Code: " + message.Code);
                                Console.WriteLine("\tError Message: " + message.Message);
                                Console.WriteLine("\tError PropertyName: " + message.PropertyName);
                            }
                        }
                    }
                    else
                    {
                        // The create was successful.
                        Console.WriteLine("NewHire was successful.");
                    }
                }


                proxy.Close();
            }
            catch (Exception e)
            {
                Console.WriteLine(e);
                proxy.Abort();
            }
        }


        private static void GetGlobalNewHire(string customerApiKey, string authenticationToken)
        {
            EmployeeGlobalNewHireClient proxy = new EmployeeGlobalNewHireClient("WSHttpBinding_IEmployeeGlobalNewHire");
            try
            {
                // Add the headers for the Customer api key and authentication token.
                using (new OperationContextScope(proxy.InnerChannel))
                {
                    OperationContext.Current.OutgoingMessageHeaders
                        .Add(MessageHeader.CreateHeader("ultiproToken",
                            "http://www.ultimatesoftware.com/foundation/authentication/ultiproToken",
                            authenticationToken));
                    OperationContext.Current.OutgoingMessageHeaders
                        .Add(MessageHeader.CreateHeader("ClientAccessKey",
                            "http://www.ultimatesoftware.com/foundation/authentication/clientaccesskey",
                            customerApiKey));


                    // Define global employee to retrieve
                    EmployeeIdentifier employeeIdentifier = new NationalIdentifier()
                    {
                        CompanyCode = "AUSC2",
                        NationalId = "B93045"
                    };


                    // Get the global employee.
                    GlobalEmployeeGetResponse response =
                        proxy.GetGlobalEmployeeByEmployeeIdentifier(employeeIdentifier);


                    // Check the results of the get to see if there are any errors.
                    if (response.OperationResult.HasErrors)
                    {
                        // Review each error.
                        foreach (OperationMessage message in response.OperationResult.Messages)
                        {
                            Console.WriteLine("Error message: " + message.Message);
                        }
                    }
                    else
                    {
                        // If we did not get any errors then 1 global employee
                        // or no global employee was found.
                        if (response.Results.Length > 0)
                        {
                            // One global employee was found.
                            GlobalEmployee globalEmployee = response.Results[0];


                            Console.WriteLine("Global Employee:");
                            Console.WriteLine("\tFirst Name: " + globalEmployee.FirstName);
                            Console.WriteLine("\tLast Name: " + globalEmployee.LastName);
                            Console.WriteLine("\tEmployee Number: " + globalEmployee.EmployeeNumber);
                            Console.WriteLine("\tNationalID: " + globalEmployee.NationalID);


                            Console.WriteLine("\nGet was successful.");
                        }
                        else
                        {
                            // No global employee was found.
                            Console.WriteLine(string.Format("No global employee was found with Employee Number = {0} and Company Code = {1}",
                                ((EmployeeNumberIdentifier)employeeIdentifier).EmployeeNumber, employeeIdentifier.CompanyCode));
                        }
                    }
                }


                proxy.Close();
            }
            catch (Exception e)
            {
                Console.WriteLine(e);
                proxy.Abort();
            }
        }


        private static void UpdateGlobalEmployee(string customerApiKey, string authenticationToken)
        {
            EmployeeGlobalNewHireClient proxy = new EmployeeGlobalNewHireClient("WSHttpBinding_IEmployeeGlobalNewHire");


            try
            {
                // Add the headers for the Customer api key and authentication token.
                using (new OperationContextScope(proxy.InnerChannel))
                {
                    OperationContext.Current.OutgoingMessageHeaders
                        .Add(MessageHeader.CreateHeader("ultiproToken",                                                        "http://www.ultimatesoftware.com/foundation/authentication/ultiproToken",                                                        authenticationToken));
                    OperationContext.Current.OutgoingMessageHeaders
                        .Add(MessageHeader.CreateHeader("ClientAccessKey",                                                        "http://www.ultimatesoftware.com/foundation/authentication/clientaccesskey",                                                        customerApiKey));


                    // Define global employee to update
                    EmployeeIdentifier employeeIdentifier = new NationalIdentifier()
                    {
                        CompanyCode = "AUSC2",
                        NationalId = "B93045"
                    };


                    // Get the global employee.
                    GlobalEmployeeGetResponse getResponse =
                        proxy.GetGlobalEmployeeByEmployeeIdentifier(employeeIdentifier);


                    // Check the results of the get to see if there are any errors.
                    if (getResponse.OperationResult.HasErrors)
                    {
                        // Review each error.
                        foreach (OperationMessage message in getResponse.OperationResult.Messages)
                        {
                            Console.WriteLine("Error message: " + message.Message);
                        }
                    }
                    else
                    {
                        // If we did not get any errors then 1 global employee
                        // or no global employee was found.
                        if (getResponse.Results.Length > 0)
                        {
                            // One global employee was found.
                            GlobalEmployee globalEmployee = getResponse.Results[0];


                            Console.WriteLine("Global employee to be updated was found.");


                            // Update global employee.
                            globalEmployee.MiddleName = "Ronald";
                            globalEmployee.JobCode = "GBAS";
                            globalEmployee.Supervisor = new EmployeeNumberIdentifier { EmployeeNumber = "2" };
                            globalEmployee.EffectiveDate = DateTime.Now;
                            globalEmployee.ReasonCode = "301";
                            globalEmployee.PayGroup = "AUSPG";
                            globalEmployee.PaymentsPerYear = 0;
                            globalEmployee.ScheduledHours = 50;


                            GlobalEmployeeUpdateResponse updateResponse = proxy.UpdateGlobalEmployee(new[] { globalEmployee });


                            // Check the result to see if operation was successful
                            if (updateResponse.HasErrors)
                            {
                                if (updateResponse.OperationResult.HasErrors)
                                {
                                    // Review each operation error.
                                    foreach (OperationMessage message in updateResponse.OperationResult.Messages)
                                    {
                                        Console.WriteLine("Operation Error Message: " + message.Message);
                                    }
                                }


                                // Review each result error.
                                foreach (Result result in updateResponse.Results.Where(r => r.HasErrors))
                                {
                                    Console.WriteLine("Result " + result.RequestNumber + ":");


                                    // Review messages for this result error.
                                    foreach (OperationMessage message in result.Messages)
                                    {
                                        Console.WriteLine("\n\tMessage:");
                                        Console.WriteLine("\tError Code: " + message.Code);
                                        Console.WriteLine("\tError Message: " + message.Message);
                                        Console.WriteLine("\tError PropertyName: " + message.PropertyName);
                                    }
                                }
                            }
                            else
                            {
                                // The update was successful.
                                Console.WriteLine("Update was successful.");
                            }
                        }
                        else
                        {
                            // No global employee was found.
                            Console.WriteLine(string.Format("No global employee was found with Employee Number = {0} and Company Code = {1}",
                                ((EmployeeNumberIdentifier)employeeIdentifier).EmployeeNumber, employeeIdentifier.CompanyCode));
                        }
                    }
                }


                proxy.Close();
            }
            catch (Exception e)
            {
                Console.WriteLine(e);
                proxy.Abort();
            }
        }
    }
}


// Example Quick Start Code End

XML Examples

GetGlobalEmployeeByEmployeeIdentifier

  <s:Envelope xmlns:a="http://www.w3.org/2005/08/addressing" xmlns:s="http://www.w3.org/2003/05/soap-envelope">
  <s:Header>
<a:Action s:mustUnderstand="1">http://www.ultimatesoftware.com/services/employeeglobalnewhire/IEmployeeGlobalNewHire/GetGlobalEmployeeByEmployeeIdentifier</a:Action> 
<ultiproToken xmlns="http://www.ultimatesoftware.com/foundation/authentication/ultiproToken">81b07b8b-f373-488d-8e86-b9e098798613</ultiproToken> 
<ClientAccessKey xmlns="http://www.ultimatesoftware.com/foundation/authentication/clientaccesskey">CAN12</ClientAccessKey> 
</s:Header>
  <s:Body>
  <GetGlobalEmployeeByEmployeeIdentifier xmlns="http://www.ultimatesoftware.com/services/employeeglobalnewhire">
  <employeeIdentifier xmlns:b="http://www.ultimatesoftware.com/contracts" xmlns:i="http://www.w3.org/2001/XMLSchema-instance" i:type="b:EmployeeNumberIdentifier">
<b:CompanyCode>BEL</b:CompanyCode> 
<b:EmployeeNumber>00000006</b:EmployeeNumber> 
</employeeIdentifier>
</GetGlobalEmployeeByEmployeeIdentifier>
</s:Body>
</s:Envelope>

NewHireGlobal

<s:Envelope xmlns:a="http://www.w3.org/2005/08/addressing" xmlns:s="http://www.w3.org/2003/05/soap-envelope">
<s:Header>
<a:Action s:mustUnderstand="1">http://www.ultimatesoftware.com/services/employeeglobalnewhire/IEmployeeGlobalNewHire/NewHireGlobal</a:Action> 
<ultiproToken xmlns="http://www.ultimatesoftware.com/foundation/authentication/ultiproToken">b431cc9e-1c70-4768-9d90-82264e467cb6</ultiproToken> 
<ClientAccessKey xmlns="http://www.ultimatesoftware.com/foundation/authentication/clientaccesskey">CAN12</ClientAccessKey> 
</s:Header>
   <s:Body>
   <NewHireGlobal xmlns="http://www.ultimatesoftware.com/services/employeeglobalnewhire">
   <entities xmlns:b="http://www.ultimatesoftware.com/contracts" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
   <b:GlobalNewHire>
<b:AddressLine1>123 Maple Dr</b:AddressLine1> 
<b:AddressLine2 /> 
<b:AlternateEmailAddress /> 
<b:AlternateTitle /> 
<b:BenefitGroup>NONE</b:BenefitGroup> 
<b:BenefitSeniorityDate>2013-04-13T00:00:00</b:BenefitSeniorityDate> 
<b:BirthDate>2013-04-13T00:00:00</b:BirthDate> 
<b:City>Fort Lauderdale</b:City> 
<b:Country>USA</b:Country> 
<b:County /> 
<b:Currency /> 
<b:EmailAddress /> 
<b:EmployeeNumber>12345</b:EmployeeNumber> 
<b:EmployeeType /> 
<b:FirstName>John</b:FirstName> 
<b:FormerLastName /> 
<b:FullOrPartTime>F</b:FullOrPartTime> 
<b:Gender>M</b:Gender> 
<b:HireDate>2013-04-13T00:00:00</b:HireDate> 
<b:HomePhone>5551112222</b:HomePhone> 
<b:HourlyOrSalaried>S</b:HourlyOrSalaried> 
<b:JobCode>BELADMIN</b:JobCode> 
<b:LastName>Tester</b:LastName>
  <b:LocationCode />
<b:MailStop /> 
<b:MiddleName>Doe</b:MiddleName> 
<b:NationalID>123456789</b:NationalID> 
<b:OrgLevel1 /> 
<b:OrgLevel2 /> 
<b:OrgLevel3 /> 
<b:OrgLevel4 /> 
<b:PayGroup i:nil="true" /> 
<b:PayRate>600000</b:PayRate> 
<b:PayRateType /> 
<b:PaymentsPerYear>0</b:PaymentsPerYear> 
<b:PostalCode>33328</b:PostalCode> 
<b:PreferredFirstName /> 
<b:Prefix /> 
<b:ScheduledHours>0</b:ScheduledHours> 
   <b:SelfServiceProperties xmlns:c="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
   <c:KeyValueOfstringstring>
<c:Key /> 
<c:Value /> 
</c:KeyValueOfstringstring>
</b:SelfServiceProperties>
<b:SeniorityDate>2013-04-13T00:00:00</b:SeniorityDate> 
<b:StateOrProvince>FL</b:StateOrProvince> 
<b:Suffix /> 
<b:Supervisor i:nil="true" />
  <b:WeeklyHours>40</b:WeeklyHours>
<b:WorkExtension>4444</b:WorkExtension> 
<b:WorkPhone>5552223333</b:WorkPhone> 
   <b:CompanyIdentifier i:type="b:CompanyCodeIdentifier">
<b:CompanyCode i:nil="true" /> 
</b:CompanyIdentifier>
</b:GlobalNewHire>
</entities>
</NewHireGlobal>
</s:Body>
</s:Envelope>

UpdateGlobalEmployee

<s:Envelope xmlns:a="http://www.w3.org/2005/08/addressing" xmlns:s="http://www.w3.org/2003/05/soap-envelope">
 <s:Header>
<a:Action s:mustUnderstand="1">http://www.ultimatesoftware.com/services/employeeglobalnewhire/IEmployeeGlobalNewHire/UpdateGlobalEmployee</a:Action> 
<ultiproToken xmlns="http://www.ultimatesoftware.com/foundation/authentication/ultiproToken">b431cc9e-1c70-4768-9d90-82264e467cb6</ultiproToken> 
<ClientAccessKey xmlns="http://www.ultimatesoftware.com/foundation/authentication/clientaccesskey">CAN12</ClientAccessKey> 
</s:Header>
  <s:Body>
  <UpdateGlobalEmployee xmlns="http://www.ultimatesoftware.com/services/employeeglobalnewhire">
  <entities xmlns:b="http://www.ultimatesoftware.com/contracts" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <b:GlobalEmployee>
<b:AddressLine1>123 Maple Drive</b:AddressLine1> 
<b:AddressLine2 /> 
<b:AlternateEmailAddress /> 
<b:AlternateTitle /> 
<b:BenefitGroup>NONE</b:BenefitGroup> 
<b:BenefitSeniorityDate>2013-04-13T00:00:00</b:BenefitSeniorityDate> 
<b:BirthDate>1980-04-13T00:00:00</b:BirthDate> 
<b:City>Fort Lauderdale</b:City> 
<b:Country>USA</b:Country> 
<b:County /> 
<b:Currency /> 
<b:EmailAddress /> 
<b:EmployeeNumber>12345</b:EmployeeNumber> 
<b:EmployeeType /> 
<b:FirstName>John</b:FirstName> 
<b:FormerLastName /> 
<b:FullOrPartTime>F</b:FullOrPartTime> 
<b:Gender>M</b:Gender> 
<b:HireDate>2013-04-13T00:00:00</b:HireDate> 
<b:HomePhone>5551112222</b:HomePhone> 
<b:HourlyOrSalaried>S</b:HourlyOrSalaried> 
<b:JobCode>BELADMIN</b:JobCode> 
<b:LastName>Tester</b:LastName> 
<b:MailStop /> 
<b:MiddleName>Doe</b:MiddleName> 
<b:NationalID>123456789</b:NationalID> 
<b:OrgLevel1 /> 
<b:OrgLevel2 /> 
<b:OrgLevel3 /> 
<b:OrgLevel4 /> 
<b:PayGroup i:nil="true" /> 
<b:PayRate>60000</b:PayRate> 
<b:PayRateType /> 
<b:PaymentsPerYear>0</b:PaymentsPerYear> 
<b:PostalCode>33328</b:PostalCode> 
<b:PreferredFirstName /> 
<b:Prefix /> 
<b:ScheduledHours>0</b:ScheduledHours> 
  <b:SelfServiceProperties xmlns:c="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
  <c:KeyValueOfstringstring>
<c:Key /> 
<c:Value /> 
</c:KeyValueOfstringstring>
</b:SelfServiceProperties>
<b:SeniorityDate>2013-04-13T00:00:00</b:SeniorityDate> 
<b:StateOrProvince>FL</b:StateOrProvince> 
<b:Suffix /> 
<b:Supervisor i:nil="true" /> 
<b:WorkExtension>4444</b:WorkExtension> 
<b:WorkPhone>5552223333</b:WorkPhone> 
<b:EffectiveDate>2013-04-19T00:00:00</b:EffectiveDate> 
<b:EmployeeIdentifier i:nil="true" /> 
<b:LastHireDate>2013-04-13T00:00:00</b:LastHireDate> 
<b:ReasonCode /> 
<b:Status>A</b:Status> 
<b:TerminationDate>0001-01-01T00:00:00</b:TerminationDate> 
<b:TerminationReasonCode /> 
</b:GlobalEmployee>
</entities>
</UpdateGlobalEmployee>
</s:Body>
</s:Envelope>