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.

export class TransfereeInitiationResponse
{
    public responseStatus: ResponseStatus;

    public constructor(init?: Partial<TransfereeInitiationResponse>) { (Object as any).assign(this, init); }
}

export class CustomField
{
    /** @description Custom field name */
    // @ApiMember(Description="Custom field name", IsRequired=true)
    public fieldName: string;

    /** @description Custom field value */
    // @ApiMember(Description="Custom field value")
    public fieldValue: string;

    public constructor(init?: Partial<CustomField>) { (Object as any).assign(this, init); }
}

export class Location
{
    public title: string;
    public city: string;
    public stateCode: string;
    public countryCode: string;

    public constructor(init?: Partial<Location>) { (Object as any).assign(this, init); }
}

export class Address extends Location
{
    public line1: string;
    public line2: string;
    public line3: string;
    public postalCode: string;

    public constructor(init?: Partial<Address>) { super(init); (Object as any).assign(this, init); }
}

export enum MaritalStatus
{
    Single = 'Single',
    Married = 'Married',
    DomesticPartner = 'DomesticPartner',
    Divorcee = 'Divorcee',
    Defacto = 'Defacto',
    Other = 'Other',
    Separated = 'Separated',
    Interdependent = 'Interdependent',
    Widowed = 'Widowed',
    Divorced = 'Divorced',
}

export enum HomeOwnerStatus
{
    Homeowner = 'Homeowner',
    Renter = 'Renter',
}

export class SpousePartner
{
    public firstName: string;
    public lastName: string;
    public birthDate?: string;

    public constructor(init?: Partial<SpousePartner>) { (Object as any).assign(this, init); }
}

export enum DependentAssigneeRelationship
{
    Child = 'Child',
    Other = 'Other',
}

export class Dependent
{
    public firstName: string;
    public lastName: string;
    public birthDate?: string;
    // @ApiMember(IsRequired=true, Name="RelationshipToAssignee")
    public relationshipToAssignee: DependentAssigneeRelationship;

    public constructor(init?: Partial<Dependent>) { (Object as any).assign(this, init); }
}

export class ServiceData
{
    /** @description Service data field name */
    // @ApiMember(Description="Service data field name", IsRequired=true)
    public fieldName: string;

    /** @description Service data field value */
    // @ApiMember(Description="Service data field value", IsRequired=true)
    public fieldValue: string;

    public constructor(init?: Partial<ServiceData>) { (Object as any).assign(this, init); }
}

export class Service
{
    /** @description Service name */
    // @ApiMember(Description="Service name", IsRequired=true)
    public name: string;

    /** @description Service data */
    // @ApiMember(Description="Service data")
    public data: ServiceData[];

    /** @description Cancel */
    // @ApiMember(Description="Cancel")
    public cancel: string;

    public constructor(init?: Partial<Service>) { (Object as any).assign(this, init); }
}

export class TransfereeInitiation
{
    /** @description Client ID */
    // @ApiMember(Description="Client ID")
    public clientId: string;

    /** @description 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)
    public externalId: string;

    /** @description Transferee first name */
    // @ApiMember(Description="Transferee first name", IsRequired=true)
    public firstName: string;

    /** @description Transferee last name */
    // @ApiMember(Description="Transferee last name", IsRequired=true)
    public lastName: string;

    /** @description Assignment type */
    // @ApiMember(Description="Assignment type")
    public assignmentType: string;

    /** @description Is this transferee pre-decision */
    // @ApiMember(Description="Is this transferee pre-decision")
    public preDecision?: boolean;

    /** @description Is this transferee a VIP */
    // @ApiMember(Description="Is this transferee a VIP")
    public vip?: boolean;

    /** @description Custom fields */
    // @ApiMember(Description="Custom fields")
    public customFields: CustomField[];

    /** @description Employee ID */
    // @ApiMember(Description="Employee ID")
    public employeeId: string;

    /** @description Start date */
    // @ApiMember(Description="Start date")
    public startDate?: string;

    /** @description End date */
    // @ApiMember(Description="End date")
    public endDate?: string;

    /** @description Origin work location */
    // @ApiMember(Description="Origin work location", IsRequired=true)
    public originWorkLocation: Location;

    /** @description Origin home address */
    // @ApiMember(Description="Origin home address", IsRequired=true)
    public originHomeAddress: Address;

    /** @description Destination work location */
    // @ApiMember(Description="Destination work location", IsRequired=true)
    public destinationWorkLocation: Location;

    /** @description Repat */
    // @ApiMember(Description="Repat")
    public repat: string;

    /** @description Repat From City */
    // @ApiMember(Description="Repat From City")
    public repatFromCity: string;

    /** @description Repat From State code */
    // @ApiMember(Description="Repat From State code")
    public repatFromStateCode: string;

    /** @description Repat From Country Code */
    // @ApiMember(Description="Repat From Country Code")
    public repatFromCountryCode: string;

    /** @description Repat To City */
    // @ApiMember(Description="Repat To City")
    public repatToCity: string;

    /** @description Repat To State Code */
    // @ApiMember(Description="Repat To State Code")
    public repatToStateCode: string;

    /** @description Repat To Country Code */
    // @ApiMember(Description="Repat To Country Code")
    public repatToCountryCode: string;

    /** @description Transferee citizenship country */
    // @ApiMember(Description="Transferee citizenship country")
    public citizenshipCountry: string;

    /** @description Transferee dual citizenship country */
    // @ApiMember(Description="Transferee dual citizenship country")
    public dualCitizenshipCountry: string;

    /** @description Policy */
    // @ApiMember(Description="Policy", IsRequired=true)
    public policy: string;

    /** @description Job title */
    // @ApiMember(Description="Job title")
    public jobTitle: string;

    /** @description Marital status */
    // @ApiMember(Description="Marital status", Name="MaritalStatus")
    public maritalStatus?: MaritalStatus;

    /** @description Pay grade */
    // @ApiMember(Description="Pay grade")
    public payGrade: string;

    /** @description Assignment family size */
    // @ApiMember(Description="Assignment family size")
    public assignmentFamilySize?: number;

    /** @description Home owner status */
    // @ApiMember(Description="Home owner status", Name="HomeOwnerStatus")
    public homeOwnerStatus?: HomeOwnerStatus;

    /** @description Line of business */
    // @ApiMember(Description="Line of business", IsRequired=true)
    public lineOfBusiness: string;

    /** @description HostCurrency */
    // @ApiMember(Description="HostCurrency")
    public hostCurrency: string;

    /** @description ServiceLevel */
    // @ApiMember(Description="ServiceLevel")
    public serviceLevel: string;

    /** @description CompanyCodePrimary */
    // @ApiMember(Description="CompanyCodePrimary")
    public companyCodePrimary: string;

    /** @description CompanyCodeSecondary */
    // @ApiMember(Description="CompanyCodeSecondary")
    public companyCodeSecondary: string;

    /** @description CostCenterPrimary */
    // @ApiMember(Description="CostCenterPrimary")
    public costCenterPrimary: string;

    /** @description CostCenterSecondary */
    // @ApiMember(Description="CostCenterSecondary")
    public costCenterSecondary: string;

    /** @description CostCenterTertiary */
    // @ApiMember(Description="CostCenterTertiary")
    public costCenterTertiary: string;

    /** @description Is the assignment confidential */
    // @ApiMember(Description="Is the assignment confidential")
    public confidential?: boolean;

    /** @description Special Instructions */
    // @ApiMember(Description="Special Instructions")
    public specialInstructions: string;

    /** @description Destination entity legal name */
    // @ApiMember(Description="Destination entity legal name")
    public destinationEntityLegalName: string;

    /** @description Transferee mobile phone number */
    // @ApiMember(Description="Transferee mobile phone number", IsRequired=true)
    public mobilePhoneNumber: string;

    /** @description Transferee work phone number */
    // @ApiMember(Description="Transferee work phone number")
    public workPhoneNumber: string;

    /** @description Transferee home phone number */
    // @ApiMember(Description="Transferee home phone number")
    public homePhoneNumber: string;

    /** @description Transferee primary email */
    // @ApiMember(Description="Transferee primary email", IsRequired=true)
    public primaryEmail: string;

    /** @description Transferee secondary email */
    // @ApiMember(Description="Transferee secondary email")
    public secondaryEmail: string;

    /** @description HR Contact First Name */
    // @ApiMember(Description="HR Contact First Name")
    public hrContactFirstName: string;

    /** @description HR Contact Last Name */
    // @ApiMember(Description="HR Contact Last Name")
    public hrContactLastName: string;

    /** @description HR contact full name */
    // @ApiMember(Description="HR contact full name")
    public hrContactFullName: string;

    /** @description Transferee annual salary */
    // @ApiMember(Description="Transferee annual salary")
    public annualSalary: string;

    /** @description Transferee spouse/partner */
    // @ApiMember(Description="Transferee spouse/partner")
    public spousePartner: SpousePartner;

    /** @description Transferee dependents */
    // @ApiMember(Description="Transferee dependents")
    public dependents: Dependent[];

    /** @description Assignment Services */
    // @ApiMember(Description="Assignment Services")
    public services: Service[];

    /** @description Relocation Status */
    // @ApiMember(Description="Relocation Status")
    public relocationStatus: string;

    /** @description Cancel */
    // @ApiMember(Description="Cancel")
    public cancel: string;

    public constructor(init?: Partial<TransfereeInitiation>) { (Object as any).assign(this, init); }
}

export class TransfereeInitiationRequest implements IRequireClientScoped, IPost
{
    /** @description Transferee initiation info needed for creation. */
    // @ApiMember(Description="Transferee initiation info needed for creation.", IsRequired=true, ParameterType="body")
    public initiationInfo: TransfereeInitiation;

    public constructor(init?: Partial<TransfereeInitiationRequest>) { (Object as any).assign(this, init); }
}

TypeScript 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-test.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>