Search
K
New Business - Annuity

InitialPurchase

object
grossAmountnumber(double)required

Total Gross Amount

Example:238500.5

netAmountnumber(double)required

Total Net Amount

Example:100.5

paymentsarray[object]required
Show Child Parameters
Example

Fund

object
fundCodestringrequired

Zinnia will provide specific Fund code for individual funds per Product. Duplicate Fund codes will be rejected.

Example:XXX000

amountTypestringrequired

Type of the Amount

Allowed values:AMTPCTUNITSPRORATAEARNINGSONLYMODEARNINGSONLYMAXFREEWDAMTGUARENTEEDWITHDRAWBENEFITLIFEEXPECTANCYWDUNITBASISNONEAUTOMAINTAINFACEADJUSTFACENEWAMTFACECHANGENONFINANCIALMAXFREECOMBOPCTAVPRORATAVARRESERVEADJPARTIALREBALANCEDOLLARLIQUIDFIRSTDOLLARLIQUIDLASTCHOICEDOLLARCHOICEMAXFREEEARNLIQUIDFIRSTEARNLIQUIDLASTPCTLIQUIDFIRSTPCTLIQUIDLASTBONUSDOLLARBONUSPCTPRORATAFIXTHENVARPRORATAALLSINGLEGWMBJOINTGWMBPECKINGORDERDIVREQUESTNOCONTVALREDUCTGMWBANNUALLIMITPRIMARYJOINTGMWBRECALCANNUALLIMITBAILOUTONLYWINDOWPERIODONLYGMWBANNUALPECKINGGMWBRECALCPECKINGRIAFEEPCTRIAFEEDOLLARGWMBANNUALLIMITLEVELGMWBALLEVELPECKINGSPOUSALDEFAULTFIXEDMODIFIEDEARNPRORATANEWMONEYACCUMALATEDEARNCONTRACTYEAREARNCALENDARYEAREARNACCELERATEDJOINTGMWBACCELERATEDSINGLEGMWB

Example:PCT

amountnumber(double)required

Total percentage of all funds should be 100%.

Example:50.55

Example

Feature

object
riderCodestringrequired

Rider Code will be provided by Zinnia for the respective Products

Example:ABC0000000

Example

Role

object
roleTypestringrequired

Role type. Owner, Annuitant, Servicing Agent and Writing Agent are mandatory.

Allowed values:OWNJNTOWNPRIMBENECONTBENEMRDDESGBENEEXCCOMPANYANNJNTANNPAYORPAYEEASSIGNEEPRIMWRITAGTADDWRITAGTNONCOMAGTPRIMSERAGT

Example:OWN

rolePercentagestringrequired

string($9(01) V9(09) for percentage. Total percentage of a role should be 100%.

Example:100

nameTypestringrequired

The name type associated with the role.

Allowed values:INDORGTRUSTOTHERUGMACOMPANY

Example:IND

firstNamestring

First name of the party role

Example:firstName when name type is Natural/Individual

middleNamestring

Middle 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. Mandatory for Owner and Annuitant (with pattern “yyyy-mm-dd”).

Match pattern:([0-9]{4})-([0-9]{2})-([0-9]{2})

Example:2023-12-19

sexstringrequired

Any one of the possible value for the gender.Mandatory for Owner and Annuitant.

Allowed values:MALEFEMALEUNISEXOTHER

Example:MALE

citizenshipCountrystringrequired

Country codes, Mandatory for Owner and Annuitant.

Allowed values:ADAEAFAGAIALAMANAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSAUYUZVAVCVEVGVIVNVUWFWSXKYEYTZAZMZW

taxIdstring

9 digit Social Security number. Mandatory for Owner , Annuitant and Agent.

Match pattern:\d{9}

>= 9 characters<= 9 characters

Example:123456789

agentCRDstring

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

Example:123456

agentNPNstring

NPN number for the agent, used as Agent Identifier.

Example:123456

agentDistributorAgentAssignedIdstring

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

Example:ABC0000000

agentCarrierAgentAssignedIdstring

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

Example:ABC0000000

agentExternalIdstring

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

Example:ABC0000000

phonesarray[object]required

One phone is mandatory for Owner and Annuitant

Show Child Parameters
relationshipstring

Relationship code

Allowed values:TRUSTEETRUSTEEOFMINORBROTHERCHILDDAUGHTERFATHERFIANCEEGRANDCHILDLIFEPARTNERMOTHERSISTERSONSPOUSESTEPFATHERSTEPMOTHERSELFOTHERGRANDFATHERGRANDMOTHERDOMPARTNERAUNTNEPHEWNIECEHUSBANDWIFEUNCLEEMPLOYERGRANDPARENTLEGALGUARDIANTRUSTEEOFINCOMPPWROFATTRNYCNTRLNGPRSNOFENTEXECUTORSASSOCIATEPARTNERESTATETRUSTGRANDSONGRANDDAUGHTERPARENTNONSPOUSECHILDRENEQUALLYCHILDRENPERSTIRPESPERSTIRPESSURVIVNGSPOUSE

Example:SELF

addressesarray[object]required

One address is mandatory for Owner and Annuitant

Show Child Parameters
trustTypestring

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

Allowed values:INDIVIDUALCORPORATE

Example:INDIVIDUAL

eDeliverystringrequired

eDelivery is required/not for the role

Allowed values:YESNO

Example:YES

emailstring(email)

Email for associated party, email when eDelivery is ‘Y’.

Example:abc@zinnia.com

bankInformationobject
Show Child Parameters
dodstring

Date of Death (with pattern “yyyy-mm-dd”)

Match pattern:([0-9]{4})-([0-9]{2})-([0-9]{2})

Example:2023-12-19

Example

SpecialProgram

object
specialProgramTypestringrequired

specialProgramType selected

Allowed values:PAYOUTRMDSYSWITHDRAWALPREMIUMDEFAULTDOLLARCOSTAVERAGESYSPARTIALWITHDRAWGROSSAUTOREBALANCEMINREQUIREDDISTEFTDRAWANNUITYPAYMENTDEFAULTSCHARGEDEDUCTIONEFTLOANREPAYREGINVESTADVISORFEERIDERCHARGECOVEREDPERSONAGEBAND60DAYHHCDRECERTLETTER45DAYHHCDRECERTLETTER60DAYGMWBROLLUPRNWLNOTICE45DAYGMWBROLLUPRNWLNOTICE60DAYGMDBROLLUPRNWLNOTICE45DAYGMDBROLLUPRNWLNOTICE72TQDISTGMIBTERMIBGROWTHLOCKDATELOANREPAY

Example:PAYOUT

startDatestring(date)required

Effective date of Special program (with pattern “yyyy-mm-dd”).

Match pattern:([0-9]{4})-([0-9]{2})-([0-9]{2})

Example:2023-12-19

modestringrequired

Frequency of special program

Allowed values:DLYBIWKLYMNTHLYSEMIANNQTRLYANNUALSNGLPMTBIMNTHLY

Example:DLY

amountTypestringrequired

amountType of special program

Allowed values:AMTPCTMAXFREEWDAMTWDUNITBASISPRORATA

Example:AMT

amountnumber(double)required

Stores the allocated percent to the specific fund

Example:50.5

distribCodestring

Distribution Code

Allowed values:DEFPRMTRDISTERLYDISTEXCEPAPPDISBDTHCLMDTHEXCPROHIBTRANSSEC1035EXCNRMLDISBEXCSCNTRIBCURRYRTXPS58COSTS10YRTAXOPTEXCSCONTRIB2YRPRIORTXEXCSANNADDNLASSEC415CHARGIFTANNDIRROLLIRADIRROLLQUALPLNTSADISTFROMROTHIRALOANSASDISTQUALLOANNDISTPRMTRLOANDISTDISTFROMEDIRAEXCSCONTRIB1YRPRIOREXCSCONTRIBPLUSEARNRECHARIRAPREVYRERLYDISTRIBSIMPLESEPSERVTRSTTOTRSTIRATOROTHQDROROLLIRADTHROLLIRADTHTRANSQDROLIKETOLIKEQDROPMTTOSPSEFRSTHMBYRIRAONLYEDCTNEXPMEDEXPNONTAXEVNTGROSSPDATRNYOTHERINCNONEMPCOMPPRMTREXROYALTIESDIRTRANSROTHIRANORMDISTRIBRECHARIRACURRYRFEEADMINFEEASSETFEECONTRIBFEELUMPSUMDEATHFEELUMPSUMDISBFEELUMPSUMPURCHANNFEELUMPSUMOTHFEELNEWRETPERPMNTFEEEXISTINGRETINFORCEFEECONTFEEEXISTINGRETINCFEETHIRDPARTYLUMPSUMDEATHLUMPSUMDISBLUMPSUMPURCHANNLUMPSUMOTHFEEIPGEXPFROMFUNDRELRESRVHEALTHDEDFEEMRKTVALFEEANNADMINSECT1035EXCPARTQDRONORMDISBQDROSEC1035DESGROTHACCTDISTREPDTHBEN6050YDISTTRADINDVNOTFMVDIVDISTEMPSTK404KCOSTCURRLIFEINSURPROTECTDISTUNDEREMPLOYEEPLANSCOMPLRESSYSEXCSCONTRIBPLUSEARN2024FEELONGTERMCAREINSURQUALPLANLOANOFFSETQUALROTHINDVARRDISTROTHIRADISTEXCEPAPPLIES

Example:DEF

durationstringrequired

Specifies how many times special program will be run

Example:5

fundsarray[object]required
Show Child Parameters
bankInformationobject
Show Child Parameters
firstPaymentDatestring(date)required

Date (with pattern “yyyy-mm-dd”).

Match pattern:([0-9]{4})-([0-9]{2})-([0-9]{2})

Example:2023-12-19

firstPaymentYearstring

First payment year.

Example:2025

grossDisbursementstring

Gross disbursment.

Example:10000

waiveChargesstring

Waive charges.

Example:1000

nextDatestring

Date (with pattern “yyyy-mm-dd”).

Match pattern:([0-9]{4})-([0-9]{2})-([0-9]{2})

Example:2023-12-19

priorRMDAmtType(string)

Prior RMD amount type.

Example:-999

priorRMDAmtnumber(double)

Prior RMD amount.

Example:100

Example