HR Import 2.0 Technical Detail and Examples

Enhanced Employee Gender Playbook

Version
R2025.1.0
HR Import 2.0 Technical Detail and Examples

HR Import XSD - Gender

Copy
<xs:element xmlns:xs="http://www.w3.org/2001/XMLSchema" name="EmployeeGender" minOccurs="0" maxOccurs="unbounded">
    <xs:complexType>
        <xs:sequence>
            <xs:element name="CountryCode" minOccurs="1" nillable="false" type="CountryCodeType"/>
            <xs:element name="StateCode" minOccurs="0" nillable="true" type="StateCodeType"/>
            <xs:element name="AssignedSexXrefCode" minOccurs="0" nillable="true">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:minLength value="1"/>
                        <xs:maxLength value="256"/>
                    </xs:restriction>
                </xs:simpleType>
            </xs:element>
            <xs:element name="GenderIdentityXrefCode" minOccurs="0">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:minLength value="1"/>
                        <xs:maxLength value="256"/>
                    </xs:restriction>
                </xs:simpleType>
            </xs:element>
            <xs:element name="EffectiveStart" minOccurs="0">
                <xs:simpleType>
                    <xs:restriction base="xs:date">
                        <xs:minInclusive value="1900-01-01"/>
                        <xs:maxInclusive value="2079-06-06"/>
                    </xs:restriction>
                </xs:simpleType>
            </xs:element>
            <xs:element name="EffectiveEnd" minOccurs="0" nillable="true">
                <xs:simpleType>
                    <xs:restriction base="xs:date">
                        <xs:minInclusive value="1900-01-01"/>
                        <xs:maxInclusive value="2079-06-06"/>
                    </xs:restriction>
                </xs:simpleType>
            </xs:element>
            <xs:element name="IsFederal" type="xs:boolean" minOccurs="0" nillable="true"/>
        </xs:sequence>
    </xs:complexType>
</xs:element>

Example Data 1

Employee is in the United Kingdom with a single binary record and effective dating is off:

Copy
<?xml version="1.0" encoding="UTF-8"?>
<EmployeeImport xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Employee>
    <XRefCode>12345</XRefCode>
    <NewXRefCode/>
    <EmployeeNumber>123456</EmployeeNumber>
    <FirstName>Employee1</FirstName>
    <SocialSecurityNumber>12345679</SocialSecurityNumber>
    <HireDate>2024-01-01</HireDate>
    <OriginalHireDate>2024-01-01</OriginalHireDate>
    <BirthDate>1990-01-01</BirthDate>
    <StartDate>2024-01-01</StartDate>
    <SeniorityDate>2024-01-01</SeniorityDate>
  <EmployeeGender>
    <CountryCode>GBR</CountryCode>
    <AssignedSexXrefCode>M</AssignedSexXrefCode>
    <GenderIdentityXrefCode></GenderIdentityXrefCode>
  </EmployeeGender>
</Employee>

Example Data 2

Employee is in France with a single non-binary record and effective dating is off. Note that the reference code has been defined in the Gender administration screen.

Copy
<?xml version="1.0" encoding="UTF-8"?>
<EmployeeImport xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Employee>
    <XRefCode>12345</XRefCode>
    <NewXRefCode/>
    <EmployeeNumber>123456</EmployeeNumber>
    <FirstName>Employee1</FirstName>
    <SocialSecurityNumber>12345679</SocialSecurityNumber>
    <HireDate>2024-01-01</HireDate>
    <OriginalHireDate>2024-01-01</OriginalHireDate>
    <BirthDate>1990-01-01</BirthDate>
    <StartDate>2024-01-01</StartDate>
    <SeniorityDate>2024-01-01</SeniorityDate>
  <EmployeeGender>
    <CountryCode>FRA</CountryCode>
    <AssignedSexXrefCode>Non-Binary_FRA</AssignedSexXrefCode>
    <GenderIdentityXrefCode>Non-Binary_FRA</GenderIdentityXrefCode>
  </EmployeeGender>
</Employee>

Example Data 3

Employee is in the United States, in Florida, with a single binary record. Effective dating is off. In this situation, the federal event creates the federal record automatically, and doesn’t require any intervention.

Copy
<?xml version="1.0" encoding="UTF-8"?>
<EmployeeImport xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Employee>
    <XRefCode>12345</XRefCode>
    <NewXRefCode/>
    <EmployeeNumber>123456</EmployeeNumber>
    <FirstName>Employee1</FirstName>
    <SocialSecurityNumber>12345679</SocialSecurityNumber>
    <HireDate>2024-01-01</HireDate>
    <OriginalHireDate>2024-01-01</OriginalHireDate>
    <BirthDate>1990-01-01</BirthDate>
    <StartDate>2024-01-01</StartDate>
    <SeniorityDate>2024-01-01</SeniorityDate>
  <EmployeeGender>
    <CountryCode>USA</CountryCode>
    <StateCode>FL</StateCode>
    <AssignedSexXrefCode>F</AssignedSexXrefCode>
    <GenderIdentityXrefCode>F</GenderIdentityXrefCode>
  </EmployeeGender>
</Employee>

Example Data 4

Employee is in the United States with two records: one binary and one non-binary. Effective dating is off. In this situation, the federal event needs the federal record to be imported.

Copy
<?xml version="1.0" encoding="UTF-8"?>
<EmployeeImport xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Employee>
    <XRefCode>12345</XRefCode>
    <NewXRefCode/>
    <EmployeeNumber>123456</EmployeeNumber>
    <FirstName>Employee1</FirstName>
    <SocialSecurityNumber>12345679</SocialSecurityNumber>
    <HireDate>2024-01-01</HireDate>
    <OriginalHireDate>2024-01-01</OriginalHireDate>
    <BirthDate>1990-01-01</BirthDate>
    <StartDate>2024-01-01</StartDate>
    <SeniorityDate>2024-01-01</SeniorityDate>
  <EmployeeGender>
    <CountryCode>USA</CountryCode>
    <StateCode>FL</StateCode>
    <AssignedSexXrefCode>F</AssignedSexXrefCode>
    <GenderIdentityXrefCode></GenderIdentityXrefCode>
  </EmployeeGender>
  <EmployeeGender>
    <CountryCode>USA</CountryCode>
    <StateCode>CA</StateCode>
    <AssignedSexXrefCode>Non-Binary_USA_CA</AssignedSexXrefCode>
    <GenderIdentityXrefCode>Non-Binary_USA_CA</GenderIdentityXrefCode>
  </EmployeeGender>
  <EmployeeGender>
    <CountryCode>USA</CountryCode>
    <AssignedSexXrefCode>F</AssignedSexXrefCode>
    <isFederal>1</isFederal>
  </EmployeeGender>
</Employee>

Example Data 5

Employee is in Germany and effective dating is enabled. The employee is providing two records, with effective dates between them.

Copy
<?xml version="1.0" encoding="UTF-8"?>
<EmployeeImport xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Employee>
    <XRefCode>12345</XRefCode>
    <NewXRefCode/>
    <EmployeeNumber>123456</EmployeeNumber>
    <FirstName>Employee1</FirstName>
    <SocialSecurityNumber>12345679</SocialSecurityNumber>
    <HireDate>2024-01-01</HireDate>
    <OriginalHireDate>2024-01-01</OriginalHireDate>
    <BirthDate>1990-01-01</BirthDate>
    <StartDate>2024-01-01</StartDate>
    <SeniorityDate>2024-01-01</SeniorityDate>
  <EmployeeGender>
    <CountryCode>DEU</CountryCode>
    <AssignedSexXrefCode>F</AssignedSexXrefCode>
    <EffectiveStart>1988-01-01</EffectiveStart>
    <EffectiveEnd>2022-12-31</EffectiveEnd>
  </EmployeeGender>
    <EmployeeGender>
    <CountryCode>DEU</CountryCode>
    <AssignedSexXrefCode>U</AssignedSexXrefCode>
    <EffectiveStart>2023-01-01</EffectiveStart>
  </EmployeeGender>
</Employee>