SIRVA.Relocation.Services.InitiationGateway

<back to all web services

TransfereeInitiationRequest

Requires Authentication
The following routes are available for this service:
POST/Initiation/TransfereeInitiates a transferee.
import java.math.*
import java.util.*
import net.servicestack.client.*
import com.google.gson.annotations.*
import com.google.gson.reflect.*


open class TransfereeInitiationRequest : IRequireClientScoped, IPost
{
    /**
    * Transferee initiation info needed for creation.
    */
    @ApiMember(Description="Transferee initiation info needed for creation.", IsRequired=true, ParameterType="body")
    var initiationInfo:TransfereeInitiation? = null
}

open class TransfereeInitiation
{
    /**
    * Client ID
    */
    @ApiMember(Description="Client ID")
    var clientId:String? = null

    /**
    * External ID. This must be unique to the intiation's parent client
    */
    @ApiMember(Description="External ID. This must be unique to the intiation's parent client", IsRequired=true)
    var externalId:String? = null

    /**
    * Transferee first name
    */
    @ApiMember(Description="Transferee first name", IsRequired=true)
    var firstName:String? = null

    /**
    * Transferee last name
    */
    @ApiMember(Description="Transferee last name", IsRequired=true)
    var lastName:String? = null

    /**
    * Assignment type
    */
    @ApiMember(Description="Assignment type")
    var assignmentType:String? = null

    /**
    * Is this transferee pre-decision
    */
    @ApiMember(Description="Is this transferee pre-decision")
    var preDecision:Boolean? = null

    /**
    * Is this transferee a VIP
    */
    @ApiMember(Description="Is this transferee a VIP")
    var vip:Boolean? = null

    /**
    * Custom fields
    */
    @ApiMember(Description="Custom fields")
    var customFields:ArrayList<CustomField> = ArrayList<CustomField>()

    /**
    * Employee ID
    */
    @ApiMember(Description="Employee ID")
    var employeeId:String? = null

    /**
    * Start date
    */
    @ApiMember(Description="Start date")
    var startDate:Date? = null

    /**
    * End date
    */
    @ApiMember(Description="End date")
    var endDate:Date? = null

    /**
    * Origin work location
    */
    @ApiMember(Description="Origin work location", IsRequired=true)
    var originWorkLocation:Location? = null

    /**
    * Origin home address
    */
    @ApiMember(Description="Origin home address", IsRequired=true)
    var originHomeAddress:Address? = null

    /**
    * Destination work location
    */
    @ApiMember(Description="Destination work location", IsRequired=true)
    var destinationWorkLocation:Location? = null

    /**
    * Repat
    */
    @ApiMember(Description="Repat")
    var repat:String? = null

    /**
    * Repat From City
    */
    @ApiMember(Description="Repat From City")
    var repatFromCity:String? = null

    /**
    * Repat From State code
    */
    @ApiMember(Description="Repat From State code")
    var repatFromStateCode:String? = null

    /**
    * Repat From Country Code
    */
    @ApiMember(Description="Repat From Country Code")
    var repatFromCountryCode:String? = null

    /**
    * Repat To City
    */
    @ApiMember(Description="Repat To City")
    var repatToCity:String? = null

    /**
    * Repat To State Code
    */
    @ApiMember(Description="Repat To State Code")
    var repatToStateCode:String? = null

    /**
    * Repat To Country Code
    */
    @ApiMember(Description="Repat To Country Code")
    var repatToCountryCode:String? = null

    /**
    * Transferee citizenship country
    */
    @ApiMember(Description="Transferee citizenship country")
    var citizenshipCountry:String? = null

    /**
    * Transferee dual citizenship country
    */
    @ApiMember(Description="Transferee dual citizenship country")
    var dualCitizenshipCountry:String? = null

    /**
    * Policy
    */
    @ApiMember(Description="Policy", IsRequired=true)
    var policy:String? = null

    /**
    * Job title
    */
    @ApiMember(Description="Job title")
    var jobTitle:String? = null

    /**
    * Marital status
    */
    @ApiMember(Description="Marital status", Name="MaritalStatus")
    var maritalStatus:MaritalStatus? = null

    /**
    * Pay grade
    */
    @ApiMember(Description="Pay grade")
    var payGrade:String? = null

    /**
    * Assignment family size
    */
    @ApiMember(Description="Assignment family size")
    var assignmentFamilySize:Int? = null

    /**
    * Home owner status
    */
    @ApiMember(Description="Home owner status", Name="HomeOwnerStatus")
    var homeOwnerStatus:HomeOwnerStatus? = null

    /**
    * Line of business
    */
    @ApiMember(Description="Line of business", IsRequired=true)
    var lineOfBusiness:String? = null

    /**
    * HostCurrency
    */
    @ApiMember(Description="HostCurrency")
    var hostCurrency:String? = null

    /**
    * ServiceLevel
    */
    @ApiMember(Description="ServiceLevel")
    var serviceLevel:String? = null

    /**
    * CompanyCodePrimary
    */
    @ApiMember(Description="CompanyCodePrimary")
    var companyCodePrimary:String? = null

    /**
    * CompanyCodeSecondary
    */
    @ApiMember(Description="CompanyCodeSecondary")
    var companyCodeSecondary:String? = null

    /**
    * CostCenterPrimary
    */
    @ApiMember(Description="CostCenterPrimary")
    var costCenterPrimary:String? = null

    /**
    * CostCenterSecondary
    */
    @ApiMember(Description="CostCenterSecondary")
    var costCenterSecondary:String? = null

    /**
    * CostCenterTertiary
    */
    @ApiMember(Description="CostCenterTertiary")
    var costCenterTertiary:String? = null

    /**
    * Is the assignment confidential
    */
    @ApiMember(Description="Is the assignment confidential")
    var confidential:Boolean? = null

    /**
    * Special Instructions
    */
    @ApiMember(Description="Special Instructions")
    var specialInstructions:String? = null

    /**
    * Destination entity legal name
    */
    @ApiMember(Description="Destination entity legal name")
    var destinationEntityLegalName:String? = null

    /**
    * Transferee mobile phone number
    */
    @ApiMember(Description="Transferee mobile phone number", IsRequired=true)
    var mobilePhoneNumber:String? = null

    /**
    * Transferee work phone number
    */
    @ApiMember(Description="Transferee work phone number")
    var workPhoneNumber:String? = null

    /**
    * Transferee home phone number
    */
    @ApiMember(Description="Transferee home phone number")
    var homePhoneNumber:String? = null

    /**
    * Transferee primary email
    */
    @ApiMember(Description="Transferee primary email", IsRequired=true)
    var primaryEmail:String? = null

    /**
    * Transferee secondary email
    */
    @ApiMember(Description="Transferee secondary email")
    var secondaryEmail:String? = null

    /**
    * HR Contact First Name
    */
    @ApiMember(Description="HR Contact First Name")
    var hrContactFirstName:String? = null

    /**
    * HR Contact Last Name
    */
    @ApiMember(Description="HR Contact Last Name")
    var hrContactLastName:String? = null

    /**
    * HR contact full name
    */
    @ApiMember(Description="HR contact full name")
    var hrContactFullName:String? = null

    /**
    * Transferee annual salary
    */
    @ApiMember(Description="Transferee annual salary")
    var annualSalary:String? = null

    /**
    * Transferee spouse/partner
    */
    @ApiMember(Description="Transferee spouse/partner")
    var spousePartner:SpousePartner? = null

    /**
    * Transferee dependents
    */
    @ApiMember(Description="Transferee dependents")
    var dependents:ArrayList<Dependent> = ArrayList<Dependent>()

    /**
    * Assignment Services
    */
    @ApiMember(Description="Assignment Services")
    var services:ArrayList<Service> = ArrayList<Service>()

    /**
    * Relocation Status
    */
    @ApiMember(Description="Relocation Status")
    var relocationStatus:String? = null

    /**
    * Cancel
    */
    @ApiMember(Description="Cancel")
    var cancel:String? = null
}

open class CustomField
{
    /**
    * Custom field name
    */
    @ApiMember(Description="Custom field name", IsRequired=true)
    var fieldName:String? = null

    /**
    * Custom field value
    */
    @ApiMember(Description="Custom field value")
    var fieldValue:String? = null
}

open class Location
{
    var title:String? = null
    var city:String? = null
    var stateCode:String? = null
    var countryCode:String? = null
}

open class Address : Location()
{
    var line1:String? = null
    var line2:String? = null
    var line3:String? = null
    var postalCode:String? = null
}

enum class MaritalStatus
{
    Single,
    Married,
    DomesticPartner,
    Divorcee,
    Defacto,
    Other,
    Separated,
    Interdependent,
    Widowed,
    Divorced,
}

enum class HomeOwnerStatus
{
    Homeowner,
    Renter,
}

open class SpousePartner
{
    var firstName:String? = null
    var lastName:String? = null
    var birthDate:Date? = null
}

open class Dependent
{
    var firstName:String? = null
    var lastName:String? = null
    var birthDate:Date? = null
    @ApiMember(IsRequired=true, Name="RelationshipToAssignee")
    var relationshipToAssignee:DependentAssigneeRelationship? = null
}

enum class DependentAssigneeRelationship
{
    Child,
    Other,
}

open class Service
{
    /**
    * Service name
    */
    @ApiMember(Description="Service name", IsRequired=true)
    var name:String? = null

    /**
    * Service data
    */
    @ApiMember(Description="Service data")
    @SerializedName("data") var Data:ArrayList<ServiceData> = ArrayList<ServiceData>()

    /**
    * Cancel
    */
    @ApiMember(Description="Cancel")
    var cancel:String? = null
}

open class ServiceData
{
    /**
    * Service data field name
    */
    @ApiMember(Description="Service data field name", IsRequired=true)
    var fieldName:String? = null

    /**
    * Service data field value
    */
    @ApiMember(Description="Service data field value", IsRequired=true)
    var fieldValue:String? = null
}

open class TransfereeInitiationResponse
{
    var responseStatus:ResponseStatus? = null
}

Kotlin TransfereeInitiationRequest DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /Initiation/Transferee HTTP/1.1 
Host: initiation-api.sirva.com 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<TransfereeInitiationRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SIRVA.Relocation.Services.InitiationGateway.ServiceModel">
  <InitiationInfo xmlns:d2p1="http://schemas.datacontract.org/2004/07/SIRVA.Relocation.Services.InitiationGateway.ServiceModel.Types">
    <d2p1:AnnualSalary>String</d2p1:AnnualSalary>
    <d2p1:AssignmentFamilySize>0</d2p1:AssignmentFamilySize>
    <d2p1:AssignmentType>String</d2p1:AssignmentType>
    <d2p1:Cancel>String</d2p1:Cancel>
    <d2p1:CitizenshipCountry>String</d2p1:CitizenshipCountry>
    <d2p1:ClientId>String</d2p1:ClientId>
    <d2p1:CompanyCodePrimary>String</d2p1:CompanyCodePrimary>
    <d2p1:CompanyCodeSecondary>String</d2p1:CompanyCodeSecondary>
    <d2p1:Confidential>false</d2p1:Confidential>
    <d2p1:CostCenterPrimary>String</d2p1:CostCenterPrimary>
    <d2p1:CostCenterSecondary>String</d2p1:CostCenterSecondary>
    <d2p1:CostCenterTertiary>String</d2p1:CostCenterTertiary>
    <d2p1:CustomFields>
      <d2p1:CustomField>
        <d2p1:FieldName>String</d2p1:FieldName>
        <d2p1:FieldValue>String</d2p1:FieldValue>
      </d2p1:CustomField>
    </d2p1:CustomFields>
    <d2p1:Dependents>
      <d2p1:Dependent>
        <d2p1:BirthDate>0001-01-01T00:00:00</d2p1:BirthDate>
        <d2p1:FirstName>String</d2p1:FirstName>
        <d2p1:LastName>String</d2p1:LastName>
        <d2p1:RelationshipToAssignee>Child</d2p1:RelationshipToAssignee>
      </d2p1:Dependent>
    </d2p1:Dependents>
    <d2p1:DestinationEntityLegalName>String</d2p1:DestinationEntityLegalName>
    <d2p1:DestinationWorkLocation>
      <d2p1:City>String</d2p1:City>
      <d2p1:CountryCode>String</d2p1:CountryCode>
      <d2p1:StateCode>String</d2p1:StateCode>
      <d2p1:Title>String</d2p1:Title>
    </d2p1:DestinationWorkLocation>
    <d2p1:DualCitizenshipCountry>String</d2p1:DualCitizenshipCountry>
    <d2p1:EmployeeId>String</d2p1:EmployeeId>
    <d2p1:EndDate>0001-01-01T00:00:00</d2p1:EndDate>
    <d2p1:ExternalId>String</d2p1:ExternalId>
    <d2p1:FirstName>String</d2p1:FirstName>
    <d2p1:HRContactFirstName>String</d2p1:HRContactFirstName>
    <d2p1:HRContactFullName>String</d2p1:HRContactFullName>
    <d2p1:HRContactLastName>String</d2p1:HRContactLastName>
    <d2p1:HomeOwnerStatus>Homeowner</d2p1:HomeOwnerStatus>
    <d2p1:HomePhoneNumber>String</d2p1:HomePhoneNumber>
    <d2p1:HostCurrency>String</d2p1:HostCurrency>
    <d2p1:JobTitle>String</d2p1:JobTitle>
    <d2p1:LastName>String</d2p1:LastName>
    <d2p1:LineOfBusiness>String</d2p1:LineOfBusiness>
    <d2p1:MaritalStatus>Single</d2p1:MaritalStatus>
    <d2p1:MobilePhoneNumber>String</d2p1:MobilePhoneNumber>
    <d2p1:OriginHomeAddress>
      <d2p1:City>String</d2p1:City>
      <d2p1:CountryCode>String</d2p1:CountryCode>
      <d2p1:StateCode>String</d2p1:StateCode>
      <d2p1:Title>String</d2p1:Title>
      <d2p1:Line1>String</d2p1:Line1>
      <d2p1:Line2>String</d2p1:Line2>
      <d2p1:Line3>String</d2p1:Line3>
      <d2p1:PostalCode>String</d2p1:PostalCode>
    </d2p1:OriginHomeAddress>
    <d2p1:OriginWorkLocation>
      <d2p1:City>String</d2p1:City>
      <d2p1:CountryCode>String</d2p1:CountryCode>
      <d2p1:StateCode>String</d2p1:StateCode>
      <d2p1:Title>String</d2p1:Title>
    </d2p1:OriginWorkLocation>
    <d2p1:PayGrade>String</d2p1:PayGrade>
    <d2p1:Policy>String</d2p1:Policy>
    <d2p1:PreDecision>false</d2p1:PreDecision>
    <d2p1:PrimaryEmail>String</d2p1:PrimaryEmail>
    <d2p1:RelocationStatus>String</d2p1:RelocationStatus>
    <d2p1:Repat>String</d2p1:Repat>
    <d2p1:RepatFromCity>String</d2p1:RepatFromCity>
    <d2p1:RepatFromCountryCode>String</d2p1:RepatFromCountryCode>
    <d2p1:RepatFromStateCode>String</d2p1:RepatFromStateCode>
    <d2p1:RepatToCity>String</d2p1:RepatToCity>
    <d2p1:RepatToCountryCode>String</d2p1:RepatToCountryCode>
    <d2p1:RepatToStateCode>String</d2p1:RepatToStateCode>
    <d2p1:SecondaryEmail>String</d2p1:SecondaryEmail>
    <d2p1:ServiceLevel>String</d2p1:ServiceLevel>
    <d2p1:Services>
      <d2p1:Service>
        <d2p1:Cancel>String</d2p1:Cancel>
        <d2p1:Data>
          <d2p1:ServiceData>
            <d2p1:FieldName>String</d2p1:FieldName>
            <d2p1:FieldValue>String</d2p1:FieldValue>
          </d2p1:ServiceData>
        </d2p1:Data>
        <d2p1:Name>String</d2p1:Name>
      </d2p1:Service>
    </d2p1:Services>
    <d2p1:SpecialInstructions>String</d2p1:SpecialInstructions>
    <d2p1:SpousePartner>
      <d2p1:BirthDate>0001-01-01T00:00:00</d2p1:BirthDate>
      <d2p1:FirstName>String</d2p1:FirstName>
      <d2p1:LastName>String</d2p1:LastName>
    </d2p1:SpousePartner>
    <d2p1:StartDate>0001-01-01T00:00:00</d2p1:StartDate>
    <d2p1:VIP>false</d2p1:VIP>
    <d2p1:WorkPhoneNumber>String</d2p1:WorkPhoneNumber>
  </InitiationInfo>
</TransfereeInitiationRequest>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<TransfereeInitiationResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SIRVA.Relocation.Services.InitiationGateway.ServiceModel">
  <ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types">
    <d2p1:ErrorCode>String</d2p1:ErrorCode>
    <d2p1:Message>String</d2p1:Message>
    <d2p1:StackTrace>String</d2p1:StackTrace>
    <d2p1:Errors>
      <d2p1:ResponseError>
        <d2p1:ErrorCode>String</d2p1:ErrorCode>
        <d2p1:FieldName>String</d2p1:FieldName>
        <d2p1:Message>String</d2p1:Message>
        <d2p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:KeyValueOfstringstring>
            <d5p1:Key>String</d5p1:Key>
            <d5p1:Value>String</d5p1:Value>
          </d5p1:KeyValueOfstringstring>
        </d2p1:Meta>
      </d2p1:ResponseError>
    </d2p1:Errors>
    <d2p1:Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:KeyValueOfstringstring>
        <d3p1:Key>String</d3p1:Key>
        <d3p1:Value>String</d3p1:Value>
      </d3p1:KeyValueOfstringstring>
    </d2p1:Meta>
  </ResponseStatus>
</TransfereeInitiationResponse>