Client_Initiations

<back to all web services

ConsumerInitiation

Consumer Initiation Service

Requires Authentication
The following routes are available for this service:
POST/consumerinitiation
namespace Client_Initiations.ServiceModel

open System
open System.Collections
open System.Collections.Generic
open System.Runtime.Serialization
open ServiceStack
open ServiceStack.DataAnnotations

    [<AllowNullLiteral>]
    type ValidateError() = 
        member val ErrorNumber:String = null with get,set
        member val ErrorDescription:String = null with get,set

    [<AllowNullLiteral>]
    type ConsumerInitiationResponse() = 
        ///<summary>
        ///Response message
        ///</summary>
        [<ApiMember(Description="Response message")>]
        member val Message:String = null with get,set

        ///<summary>
        ///File identifier for the created initiation
        ///</summary>
        [<ApiMember(Description="File identifier for the created initiation")>]
        member val FileId:String = null with get,set

        ///<summary>
        ///List of validation errors, if any
        ///</summary>
        [<ApiMember(Description="List of validation errors, if any")>]
        member val Errors:ResizeArray<ValidateError> = new ResizeArray<ValidateError>() with get,set

    [<AllowNullLiteral>]
    type RelocationsRequestFileTransfereeDetails() = 
        ///<summary>
        ///First name of the transferee
        ///</summary>
        [<ApiMember(Description="First name of the transferee", IsRequired=true)>]
        member val FirstName:String = null with get,set

        ///<summary>
        ///Last name of the transferee
        ///</summary>
        [<ApiMember(Description="Last name of the transferee", IsRequired=true)>]
        member val LastName:String = null with get,set

        ///<summary>
        ///Preferred email address
        ///</summary>
        [<ApiMember(Description="Preferred email address", IsRequired=true)>]
        member val PreferredEmail:String = null with get,set

    [<AllowNullLiteral>]
    type AssignmentLocationDetails() = 
        ///<summary>
        ///Work city
        ///</summary>
        [<ApiMember(Description="Work city", IsRequired=true)>]
        member val WorkCity:String = null with get,set

        ///<summary>
        ///Current work location state
        ///</summary>
        [<ApiMember(Description="Current work location state")>]
        member val CurrentWorkState:String = null with get,set

        ///<summary>
        ///Work state or province
        ///</summary>
        [<ApiMember(Description="Work state or province")>]
        member val WorkState:String = null with get,set

        ///<summary>
        ///Destination work location state
        ///</summary>
        [<ApiMember(Description="Destination work location state")>]
        member val DestinationWorkState:String = null with get,set

        ///<summary>
        ///Work country
        ///</summary>
        [<ApiMember(Description="Work country", IsRequired=true)>]
        member val WorkCountry:String = null with get,set

        ///<summary>
        ///Preferred work location state
        ///</summary>
        [<ApiMember(Description="Preferred work location state")>]
        member val PreferredWorkState:String = null with get,set

        ///<summary>
        ///Preferred work location country
        ///</summary>
        [<ApiMember(Description="Preferred work location country")>]
        member val PreferredWorkCountry:String = null with get,set

    [<AllowNullLiteral>]
    type RelocationsRequestFileAssignmentDetails() = 
        ///<summary>
        ///Program name or code
        ///</summary>
        [<ApiMember(Description="Program name or code", IsRequired=true)>]
        member val Program:String = null with get,set

        ///<summary>
        ///Type of assignment
        ///</summary>
        [<ApiMember(Description="Type of assignment", IsRequired=true)>]
        member val AssignmentType:String = null with get,set

        ///<summary>
        ///Assignment start date
        ///</summary>
        [<ApiMember(Description="Assignment start date", IsRequired=true)>]
        member val StartDate:Nullable<DateTime> = new Nullable<DateTime>() with get,set

        ///<summary>
        ///Company name
        ///</summary>
        [<ApiMember(Description="Company name", IsRequired=true)>]
        member val CompanyName:String = null with get,set

        ///<summary>
        ///Contact
        ///</summary>
        [<ApiMember(Description="Contact", IsRequired=true)>]
        member val Contact:String = null with get,set

        ///<summary>
        ///Current assignment location details
        ///</summary>
        [<ApiMember(Description="Current assignment location details", IsRequired=true)>]
        member val Current:AssignmentLocationDetails = null with get,set

        ///<summary>
        ///Destination assignment location details
        ///</summary>
        [<ApiMember(Description="Destination assignment location details", IsRequired=true)>]
        member val Destination:AssignmentLocationDetails = null with get,set

    [<AllowNullLiteral>]
    type RelocationsRequestFile() = 
        ///<summary>
        ///Command type for the request (INITIATE)
        ///</summary>
        [<ApiMember(Description="Command type for the request (INITIATE)", IsRequired=true)>]
        member val Command:String = null with get,set

        ///<summary>
        ///External identifier for the transferee
        ///</summary>
        [<ApiMember(Description="External identifier for the transferee", IsRequired=true)>]
        member val ExternalID:String = null with get,set

        ///<summary>
        ///Details about the transferee
        ///</summary>
        [<ApiMember(Description="Details about the transferee", IsRequired=true)>]
        member val TransfereeDetails:RelocationsRequestFileTransfereeDetails = null with get,set

        ///<summary>
        ///List of addresses associated with the transferee
        ///</summary>
        [<ApiMember(Description="List of addresses associated with the transferee", IsRequired=true)>]
        member val Addresses:RelocationsRequestFileAddress[] = [||] with get,set

        ///<summary>
        ///List of phone numbers associated with the transferee
        ///</summary>
        [<ApiMember(Description="List of phone numbers associated with the transferee", IsRequired=true)>]
        member val Phones:RelocationsRequestFilePhone[] = [||] with get,set

        ///<summary>
        ///Assignment details for the relocation
        ///</summary>
        [<ApiMember(Description="Assignment details for the relocation", IsRequired=true)>]
        member val AssignmentDetails:RelocationsRequestFileAssignmentDetails = null with get,set

    ///<summary>
    ///Consumer Initiation Service
    ///</summary>
    [<Api(Description="Consumer Initiation Service")>]
    [<ApiResponse(Description="Returned when the consumer initiation was successfully processed", StatusCode=200)>]
    [<ApiResponse(Description="Returned if the request validation failed", StatusCode=400)>]
    [<ApiResponse(Description="Returned if the client is not authorized", StatusCode=401)>]
    [<ApiResponse(Description="Returned if an error occurred while processing the request", StatusCode=500)>]
    [<AllowNullLiteral>]
    type ConsumerInitiation() = 
        interface IPost
        ///<summary>
        ///Client identifier
        ///</summary>
        [<ApiMember(Description="Client identifier", IsRequired=true)>]
        member val ClientID:String = null with get,set

        ///<summary>
        ///Consumer relocation request file details
        ///</summary>
        [<ApiMember(Description="Consumer relocation request file details", IsRequired=true)>]
        member val File:RelocationsRequestFile = null with get,set

    type AddressType =
        | CurrentHome = 0
        | DestinationHome = 1
        | CurrentWork = 2
        | DestinationWork = 3

    type YesNo =
        | Y = 0
        | N = 1
        | Item = 2

    [<AllowNullLiteral>]
    type RelocationsRequestFileAddress() = 
        ///<summary>
        ///Type of address (CurrentHome, DestinationHome, CurrentWork, DestinationWork)
        ///</summary>
        [<ApiMember(Description="Type of address (CurrentHome, DestinationHome, CurrentWork, DestinationWork)", IsRequired=true)>]
        member val AddressType:AddressType = new AddressType() with get,set

        ///<summary>
        ///Indicates if this is the primary address
        ///</summary>
        [<ApiMember(Description="Indicates if this is the primary address", IsRequired=true)>]
        member val Primary:YesNo = new YesNo() with get,set

        ///<summary>
        ///Address line 1
        ///</summary>
        [<ApiMember(Description="Address line 1", IsRequired=true)>]
        member val AddressLine1:String = null with get,set

        ///<summary>
        ///City
        ///</summary>
        [<ApiMember(Description="City", IsRequired=true)>]
        member val City:String = null with get,set

        ///<summary>
        ///Country
        ///</summary>
        [<ApiMember(Description="Country", IsRequired=true)>]
        member val Country:String = null with get,set

    [<AllowNullLiteral>]
    type RelocationsRequestFilePhone() = 
        ///<summary>
        ///Phone type (e.g., Mobile, OriginHome)
        ///</summary>
        [<ApiMember(Description="Phone type (e.g., Mobile, OriginHome)", IsRequired=true)>]
        member val Type:String = null with get,set

        ///<summary>
        ///Indicates if this is the primary phone number
        ///</summary>
        [<ApiMember(Description="Indicates if this is the primary phone number", IsRequired=true)>]
        member val Primary:YesNo = new YesNo() with get,set

        ///<summary>
        ///Phone number
        ///</summary>
        [<ApiMember(Description="Phone number", IsRequired=true)>]
        member val Number:String = null with get,set

F# ConsumerInitiation DTOs

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

HTTP + JSV

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

POST /consumerinitiation HTTP/1.1 
Host: initiation-pen.sirva.com 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	ClientID: String,
	File: 
	{
		Command: String,
		ExternalID: String,
		TransfereeDetails: 
		{
			FirstName: String,
			LastName: String,
			PreferredEmail: String
		},
		Addresses: 
		[
			{
				AddressType: CurrentHome,
				Primary: Y,
				AddressLine1: String,
				City: String,
				Country: String
			}
		],
		Phones: 
		[
			{
				Type: String,
				Primary: Y,
				Number: String
			}
		],
		AssignmentDetails: 
		{
			Program: String,
			AssignmentType: String,
			StartDate: 0001-01-01,
			CompanyName: String,
			Contact: String,
			Current: 
			{
				WorkCity: String,
				CurrentWorkState: String,
				WorkState: String,
				DestinationWorkState: String,
				WorkCountry: String,
				PreferredWorkState: String,
				PreferredWorkCountry: String
			},
			Destination: 
			{
				WorkCity: String,
				CurrentWorkState: String,
				WorkState: String,
				DestinationWorkState: String,
				WorkCountry: String,
				PreferredWorkState: String,
				PreferredWorkCountry: String
			}
		}
	}
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	Message: String,
	FileId: String,
	Errors: 
	[
		{
			ErrorNumber: String,
			ErrorDescription: String
		}
	]
}