Search
K
New Business - Annuity

Roles

object
roleTypestringrequired

Role type

Allowed values:38360-1-2-3-4-5-6-7-8-9-10-11-12-13-14-15-16-17-18-19-20-21-22-23-24-25-26-50-51-60-70-71-72-80-81-82-83-84-85-86-87-88-89-90-91-999

Example:0

roleOptionstringrequired

Role Option associated with the respective Role Type

Allowed values:-6-5-101234567

naturalNameIndicatorstringrequired

Allowed values:YN

nameTypestringrequired

Allowed values:COINOTTRUG

firstNamestring

First name of the party role

Example:firstName when name type is Natural/Individual

middleNamestring

Moddle name of the party role

Example:B

lastNamestringrequired

Last name of the party role

Example:Doe

prefixstring

Prefix

Example:Dr

suffixstring

Suffix

Example:Sr

dobstring(date)required

Date of birth of party role. Applicable in case of Individual. (with pattern “yyyy-mm-dd”). Regex Expression ^\d{4}-((0\d)|(1[012]))-(([012]\d)|3[01])$.

Example:2023-12-19

sexstringrequired

Any one of the possible value for the gender.

Allowed values:MFO

taxIdstring

9 digit Social Security number

Match pattern:\d{9}

>= 9 characters<= 9 characters

Example:123456789

crdNumberstring

CRD number for the party role, used as Agent Identifier.

Example:when party is an agent and one of the agent specific identifier in MCS is mandatory

nationalProducerNumberstring

NPN number for the agent, used as Agent Identifier.

Example:when party is an agent and one of the agent specific identifier in MCS is mandatory

distributorAgentAssignedIdstring

Distributor assigned Id for an agent, used as Agent Identifier.

Example:when party is an agent and one of the agent specific identifier in MCS is mandatory

carrierAgentAssignedIdstring

Internal identifier assigned to the agent by carrier, used as Agent Identifier.

Example:when party is an agent and one of the agent specific identifier in MCS is mandatory

externalIdstring

Unique number assigned by the MCS system, used as Agent Identifier.

Example:when party is an agent and one of the agent specific identifier in MCS is mandatory

phonesarray[object]required
Show Child Parameters
relationshipstring

Relationship code

Allowed values:-99912345678910111213141516171819202122232425100101102103104105106

addressesarray[object]required
Show Child Parameters
trustTypestring

Type of trust & TrustType is required when the role is a trust

Allowed values:12

Example:1

eDeliverystringrequired

eDelivery is required/not for the role

Allowed values:YN

emailstring

Email for associated party

Example:email when eDelivery is 'Y'

bankInformationobject
Show Child Parameters
dodstring

Date of Death. (with pattern “yyyy-mm-dd”). Regex Expression ^\d{4}-((0\d)|(1[012]))-(([012]\d)|3[01])$.

Example

SpecialPrograms

object
specialProgramTypestringrequired

specialProgramType selected

Allowed values:01234568910

Example:0

startDatestring(date)required

Effective date of Special program

modestringrequired

Frequency of special program

Allowed values:AMQSW24T910

amountTypestringrequired

amountType of special program

Allowed values:-101234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556

amountstringrequired

Stores the allocated percent to the specific fund

distribCodestring

Distribution Code

Allowed values:123456789ADEFGHJLMPRSAAABAC2G4G4HADAEAFAGAHAKTNZAZBZCZDZEZFZGZHZIZJZKZLZMZNZOZPZQZRZSZTZVZU6AALAMW

durationstringrequired

Specifies how many times special program will be run

Example:5

fundsarray[object]required
Show Child Parameters
bankInformationobject
Show Child Parameters
moneySrcIdstring(int32)

Allowed values:0123456789

firstPaymentDatestring(date)required
firstPaymentYearstring
calculationstring

Derived by Zinnia

grossDisbursementstring
waiveChargesstring
nextDatestring

Derived by Zinnia

priorRMDAmtTypestring
priorRMDAmtnumber(double)
Example

ExchangeReplaces

object

For any payment that is a replacement/exchange

companyNamestringrequired

Name of the Company

taxIdstringrequired

Company Tax ID

Match pattern:\d{9}

Example:123456789

typestringrequired

Type of the company

Allowed values:COINOTTRUG

emailstring

Company email address

addressobjectrequired
Show Child Parameters
amountRequestednumber(double)required

This field stores the requested amount.

signedDatestring(date)required

Agent submit date

sourcePolicyNumberstringrequired

This field stores the source policy number

previousPlanTypestringrequired

This field stores the plan type which was used on previous policy - Refer qualificationflag for types

applyRateLockstringrequired

This field stores determines whether to apply Rate Lock or not

rateLockStartDatestring(date)required

Agent submit date

overrideDatestring(date)

If Rate Lock is not followed and needs override

advanceDatestring

This field gets enable when advance commission is true.

replacementIndicatorstringrequired

Allowed values:YN

advanceCommissionstringrequired

This is a flag to selected when the advance commision to agent is applicable.

Allowed values:YN

Example

Withholdings

object
withholdingAmountstringrequired

The amount to be withheld if withholding is selected

Example:0

withholdingAmountQualiferstringrequired

Qualifies the withholding amount. Either as dollars or a percentage

Allowed values:DP

withholdingAmountTypestring

This will be used to indicate the type of withholding information for this instance of the Withholding Amount. This is in reference to the IRS W-4P and W-4R tax withholding forms

Allowed values:ABCDEFGH

withholdingAuthoritystringrequired

Defines the withholding authority for which is being withheld

Allowed values:StateFederal

Example

Payments

object
idstringrequired

Unique Id to tag to respective payment records

paymentMethodstringrequired

Payment methods

Allowed values:CWE

moneySourcestringrequired

Money Source

Allowed values:-9991234567891011171819202122232425

grossAmountnumber(double)required

Gross Amount for the individual payment

Example:238500

netAmountnumber(double)required

Net Amount for the individual payment

taxInfoobject
Show Child Parameters
currentAllocstringrequired

Funds to be considered for Future Allocations or not

Allowed values:YN

moneySrcIdstring(int32)

Allowed values:0123456789

waivePremiuminteger(int32)

waivePremium

distributorIdstringrequired

Unique number assigned to the application by broker

costBasisUnknownIndbooleanrequired

This is a flag to checked and unchecked depending upon the Cost basis.

exchangeReplaceobject

For any payment that is a replacement/exchange

Show Child Parameters
Example