| POST | /Initiation/Transferee | Initiates a transferee. |
|---|
import datetime
import decimal
from marshmallow.fields import *
from servicestack import *
from typing import *
from dataclasses import dataclass, field
from dataclasses_json import dataclass_json, LetterCase, Undefined, config
from enum import Enum, IntEnum
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class TransfereeInitiationResponse:
response_status: Optional[ResponseStatus] = None
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class CustomField:
# @ApiMember(Description="Custom field name", IsRequired=true)
field_name: Optional[str] = None
"""
Custom field name
"""
# @ApiMember(Description="Custom field value")
field_value: Optional[str] = None
"""
Custom field value
"""
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class Location:
title: Optional[str] = None
city: Optional[str] = None
state_code: Optional[str] = None
country_code: Optional[str] = None
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class Address(Location):
line1: Optional[str] = None
line2: Optional[str] = None
line3: Optional[str] = None
postal_code: Optional[str] = None
class MaritalStatus(str, Enum):
SINGLE = 'Single'
MARRIED = 'Married'
DOMESTIC_PARTNER = 'DomesticPartner'
DIVORCEE = 'Divorcee'
DEFACTO = 'Defacto'
OTHER = 'Other'
SEPARATED = 'Separated'
INTERDEPENDENT = 'Interdependent'
WIDOWED = 'Widowed'
DIVORCED = 'Divorced'
class HomeOwnerStatus(str, Enum):
HOMEOWNER = 'Homeowner'
RENTER = 'Renter'
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class SpousePartner:
first_name: Optional[str] = None
last_name: Optional[str] = None
birth_date: Optional[datetime.datetime] = None
class DependentAssigneeRelationship(str, Enum):
CHILD = 'Child'
OTHER = 'Other'
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class Dependent:
first_name: Optional[str] = None
last_name: Optional[str] = None
birth_date: Optional[datetime.datetime] = None
# @ApiMember(IsRequired=true, Name="RelationshipToAssignee")
relationship_to_assignee: Optional[DependentAssigneeRelationship] = None
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class ServiceData:
# @ApiMember(Description="Service data field name", IsRequired=true)
field_name: Optional[str] = None
"""
Service data field name
"""
# @ApiMember(Description="Service data field value", IsRequired=true)
field_value: Optional[str] = None
"""
Service data field value
"""
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class Service:
# @ApiMember(Description="Service name", IsRequired=true)
name: Optional[str] = None
"""
Service name
"""
# @ApiMember(Description="Service data")
data: Optional[List[ServiceData]] = None
"""
Service data
"""
# @ApiMember(Description="Cancel")
cancel: Optional[str] = None
"""
Cancel
"""
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class TransfereeInitiation:
# @ApiMember(Description="Client ID")
client_id: Optional[str] = None
"""
Client ID
"""
# @ApiMember(Description="External ID. This must be unique to the intiation's parent client", IsRequired=true)
external_id: Optional[str] = None
"""
External ID. This must be unique to the intiation's parent client
"""
# @ApiMember(Description="Transferee first name", IsRequired=true)
first_name: Optional[str] = None
"""
Transferee first name
"""
# @ApiMember(Description="Transferee last name", IsRequired=true)
last_name: Optional[str] = None
"""
Transferee last name
"""
# @ApiMember(Description="Assignment type")
assignment_type: Optional[str] = None
"""
Assignment type
"""
# @ApiMember(Description="Is this transferee pre-decision")
pre_decision: Optional[bool] = None
"""
Is this transferee pre-decision
"""
# @ApiMember(Description="Is this transferee a VIP")
vip: Optional[bool] = None
"""
Is this transferee a VIP
"""
# @ApiMember(Description="Custom fields")
custom_fields: Optional[List[CustomField]] = None
"""
Custom fields
"""
# @ApiMember(Description="Employee ID")
employee_id: Optional[str] = None
"""
Employee ID
"""
# @ApiMember(Description="Start date")
start_date: Optional[datetime.datetime] = None
"""
Start date
"""
# @ApiMember(Description="End date")
end_date: Optional[datetime.datetime] = None
"""
End date
"""
# @ApiMember(Description="Origin work location", IsRequired=true)
origin_work_location: Optional[Location] = None
"""
Origin work location
"""
# @ApiMember(Description="Origin home address", IsRequired=true)
origin_home_address: Optional[Address] = None
"""
Origin home address
"""
# @ApiMember(Description="Destination work location", IsRequired=true)
destination_work_location: Optional[Location] = None
"""
Destination work location
"""
# @ApiMember(Description="Repat")
repat: Optional[str] = None
"""
Repat
"""
# @ApiMember(Description="Repat From City")
repat_from_city: Optional[str] = None
"""
Repat From City
"""
# @ApiMember(Description="Repat From State code")
repat_from_state_code: Optional[str] = None
"""
Repat From State code
"""
# @ApiMember(Description="Repat From Country Code")
repat_from_country_code: Optional[str] = None
"""
Repat From Country Code
"""
# @ApiMember(Description="Repat To City")
repat_to_city: Optional[str] = None
"""
Repat To City
"""
# @ApiMember(Description="Repat To State Code")
repat_to_state_code: Optional[str] = None
"""
Repat To State Code
"""
# @ApiMember(Description="Repat To Country Code")
repat_to_country_code: Optional[str] = None
"""
Repat To Country Code
"""
# @ApiMember(Description="Transferee citizenship country")
citizenship_country: Optional[str] = None
"""
Transferee citizenship country
"""
# @ApiMember(Description="Transferee dual citizenship country")
dual_citizenship_country: Optional[str] = None
"""
Transferee dual citizenship country
"""
# @ApiMember(Description="Policy", IsRequired=true)
policy: Optional[str] = None
"""
Policy
"""
# @ApiMember(Description="Job title")
job_title: Optional[str] = None
"""
Job title
"""
# @ApiMember(Description="Marital status", Name="MaritalStatus")
marital_status: Optional[MaritalStatus] = None
"""
Marital status
"""
# @ApiMember(Description="Pay grade")
pay_grade: Optional[str] = None
"""
Pay grade
"""
# @ApiMember(Description="Assignment family size")
assignment_family_size: Optional[int] = None
"""
Assignment family size
"""
# @ApiMember(Description="Home owner status", Name="HomeOwnerStatus")
home_owner_status: Optional[HomeOwnerStatus] = None
"""
Home owner status
"""
# @ApiMember(Description="Line of business", IsRequired=true)
line_of_business: Optional[str] = None
"""
Line of business
"""
# @ApiMember(Description="HostCurrency")
host_currency: Optional[str] = None
"""
HostCurrency
"""
# @ApiMember(Description="ServiceLevel")
service_level: Optional[str] = None
"""
ServiceLevel
"""
# @ApiMember(Description="CompanyCodePrimary")
company_code_primary: Optional[str] = None
"""
CompanyCodePrimary
"""
# @ApiMember(Description="CompanyCodeSecondary")
company_code_secondary: Optional[str] = None
"""
CompanyCodeSecondary
"""
# @ApiMember(Description="CostCenterPrimary")
cost_center_primary: Optional[str] = None
"""
CostCenterPrimary
"""
# @ApiMember(Description="CostCenterSecondary")
cost_center_secondary: Optional[str] = None
"""
CostCenterSecondary
"""
# @ApiMember(Description="CostCenterTertiary")
cost_center_tertiary: Optional[str] = None
"""
CostCenterTertiary
"""
# @ApiMember(Description="Is the assignment confidential")
confidential: Optional[bool] = None
"""
Is the assignment confidential
"""
# @ApiMember(Description="Special Instructions")
special_instructions: Optional[str] = None
"""
Special Instructions
"""
# @ApiMember(Description="Destination entity legal name")
destination_entity_legal_name: Optional[str] = None
"""
Destination entity legal name
"""
# @ApiMember(Description="Transferee mobile phone number", IsRequired=true)
mobile_phone_number: Optional[str] = None
"""
Transferee mobile phone number
"""
# @ApiMember(Description="Transferee work phone number")
work_phone_number: Optional[str] = None
"""
Transferee work phone number
"""
# @ApiMember(Description="Transferee home phone number")
home_phone_number: Optional[str] = None
"""
Transferee home phone number
"""
# @ApiMember(Description="Transferee primary email", IsRequired=true)
primary_email: Optional[str] = None
"""
Transferee primary email
"""
# @ApiMember(Description="Transferee secondary email")
secondary_email: Optional[str] = None
"""
Transferee secondary email
"""
# @ApiMember(Description="HR Contact First Name")
hr_contact_first_name: Optional[str] = None
"""
HR Contact First Name
"""
# @ApiMember(Description="HR Contact Last Name")
hr_contact_last_name: Optional[str] = None
"""
HR Contact Last Name
"""
# @ApiMember(Description="HR contact full name")
hr_contact_full_name: Optional[str] = None
"""
HR contact full name
"""
# @ApiMember(Description="Transferee annual salary")
annual_salary: Optional[str] = None
"""
Transferee annual salary
"""
# @ApiMember(Description="Transferee spouse/partner")
spouse_partner: Optional[SpousePartner] = None
"""
Transferee spouse/partner
"""
# @ApiMember(Description="Transferee dependents")
dependents: Optional[List[Dependent]] = None
"""
Transferee dependents
"""
# @ApiMember(Description="Assignment Services")
services: Optional[List[Service]] = None
"""
Assignment Services
"""
# @ApiMember(Description="Relocation Status")
relocation_status: Optional[str] = None
"""
Relocation Status
"""
# @ApiMember(Description="Cancel")
cancel: Optional[str] = None
"""
Cancel
"""
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class TransfereeInitiationRequest(IRequireClientScoped, IPost):
# @ApiMember(Description="Transferee initiation info needed for creation.", IsRequired=true, ParameterType="body")
initiation_info: Optional[TransfereeInitiation] = None
"""
Transferee initiation info needed for creation.
"""
Python TransfereeInitiationRequest DTOs
To override the Content-type in your clients, use the HTTP Accept Header, append the .csv suffix or ?format=csv
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-pen.sirva.com
Accept: text/csv
Content-Type: text/csv
Content-Length: length
{"initiationInfo":{"clientId":"String","externalId":"String","firstName":"String","lastName":"String","assignmentType":"String","preDecision":false,"vip":false,"customFields":[{"fieldName":"String","fieldValue":"String"}],"employeeId":"String","startDate":"0001-01-01T00:00:00.0000000","endDate":"0001-01-01T00:00:00.0000000","originWorkLocation":{"title":"String","city":"String","stateCode":"String","countryCode":"String"},"originHomeAddress":{"line1":"String","line2":"String","line3":"String","postalCode":"String","title":"String","city":"String","stateCode":"String","countryCode":"String"},"destinationWorkLocation":{"title":"String","city":"String","stateCode":"String","countryCode":"String"},"repat":"String","repatFromCity":"String","repatFromStateCode":"String","repatFromCountryCode":"String","repatToCity":"String","repatToStateCode":"String","repatToCountryCode":"String","citizenshipCountry":"String","dualCitizenshipCountry":"String","policy":"String","jobTitle":"String","maritalStatus":"Single","payGrade":"String","assignmentFamilySize":0,"homeOwnerStatus":"Homeowner","lineOfBusiness":"String","hostCurrency":"String","serviceLevel":"String","companyCodePrimary":"String","companyCodeSecondary":"String","costCenterPrimary":"String","costCenterSecondary":"String","costCenterTertiary":"String","confidential":false,"specialInstructions":"String","destinationEntityLegalName":"String","mobilePhoneNumber":"String","workPhoneNumber":"String","homePhoneNumber":"String","primaryEmail":"String","secondaryEmail":"String","hrContactFirstName":"String","hrContactLastName":"String","hrContactFullName":"String","annualSalary":"String","spousePartner":{"firstName":"String","lastName":"String","birthDate":"0001-01-01T00:00:00.0000000"},"dependents":[{"firstName":"String","lastName":"String","birthDate":"0001-01-01T00:00:00.0000000","relationshipToAssignee":"Child"}],"services":[{"name":"String","data":[{"fieldName":"String","fieldValue":"String"}],"cancel":"String"}],"relocationStatus":"String","cancel":"String"}}
HTTP/1.1 200 OK
Content-Type: text/csv
Content-Length: length
{"responseStatus":{"errorCode":"String","message":"String","stackTrace":"String","errors":[{"errorCode":"String","fieldName":"String","message":"String","meta":{"String":"String"}}],"meta":{"String":"String"}}}