Search
K
New Business - Annuity

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

ExchangeReplace

object

For any payment that is a replacement/exchange

productTypestringrequired

Exchange policy product type

Allowed values:ANNUITYLIFEBROKERAGECASH

Example:ANNUITY

companyNamestringrequired

Name of the Company

Example:ABC

taxIdstring

Company Tax ID

Match pattern:\d{9}

>= 9 characters<= 9 characters

Example:123456789

typestringrequired

Type of the Exchange/Replacement

Allowed values:INT1035EXT1035EXTDIRTRANINTDIRTRANEXTROLLQUALINTROLLQUALEXTROTHROLLINTROTHTROLLEXTROTHDIRTRANINTROTHDIRTRANCLIENTINITTRANBENPRCDSEXT1035PARTINT1035PARTBIRTHRPMTNOLOAEXTDIRECTTRANSFREPINTDIRECTTRANSFREPREINSTATEMENTDEFAULT

Example:INT1035

emailstring

Company email address

Example:abc@zinnia.com

addressobjectrequired
Show Child Parameters
amountRequestednumber(double)required

This field stores the requested amount.

Example:5000.55

signedDatestring(date)required

Signed date (with pattern “yyyy-mm-dd”).

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

Example:2023-12-19

sourcePolicyNumberstringrequired

This field stores the source policy number

Example:123456

originalCostBasisstring

This field stores the Original Cost Basis

Example:1000

previousPlanTypestringrequired

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

Example:NONQUAL

applyRateLockstringrequired

This field stores determines whether to apply Rate Lock or not

Allowed values:YESNO

Example:YES

replacementIndicatorstringrequired

Allowed values:YESNO

Example:YES

mecIndicatorstring

Source of ER policy is MEC/not

Allowed values:YESNO

Example:YES

Example

Withholding

object
withholdingAmountnumber(double)required

The amount to be withheld if withholding is selected

Example:100.5

withholdingAmountQualiferstringrequired

Qualifies the withholding amount. Either as dollars or a percentage

Allowed values:DOLLARPERCENT

Example:DOLLAR

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:JOBORPENEXTRAOTHRDEDOTHRINCCLMSNCREDDEFAULTNOWITHUSEVALUES

Example:JOBORPEN

withholdingAuthoritystringrequired

Defines the withholding authority for which is being withheld

Allowed values:STFEDLOCALNRABACKUP

Example:FED

Example