Search
K
New Business - Annuity

TaxInformation

object
currentContribAmountnumber(double)

Current Contribution Amount

priorContribAmountnumber(double)

Prior Contribution Amount

taxYearstring

tax year

totalBasisnumber(double)

Total Cost basis amount

pretefraBasisnumber(double)

Pre Tefra basis amount

posttefraBasisnumber(double)

Post Teefra basis amount

post88Amountnumber(double)

Post 88 Amount

Example

Payout

object
payoutOptionstringrequired
livesTypestringrequired
increasePctstring
primarySurvivorAdjTypestring
primarySurvivorAdjPctstring
jointSurvivorAdjTypestring
jointSurvivorAdjPctstring
proofOfBirthVerifiedstring
annuityFrequencyCodestringrequired
certainPeriodQualifierstring
certainPeriodstringrequired
payoutStartDatestring(date)required
FixedPaymentAmountstring(integer)
Example

Application

object
effectiveDatestring(date)required

e-App submitted date to Zinnia (with pattern “yyyy-mm-dd”).

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

Example:2023-12-19

keynumber

Zinnia Unique idenitifer for a case. [Derived by Zinnia]

Example:1234567

sourceCdstring

Zinnia Identifier for a client.[Derived by Zinnia]

Example:ZIN_ABC

correlationIdstring

Zinnia Unique Identifier for a case.[Derived by Zinnia]. This is not required for Paper Apps , only eApps.

Example:0ca10708-4b53-464c-b745-355c8f6f0edb

zinniaCaseIdstring

Zinnia Unique Identifier for a case.[Derived by Zinnia]. This is required for Paper Apps, not eApps and will be sent via Orion Application.

Example:CA0123456789

transmittingCompanyIdentifierstringrequired

An identifer that represents Transmitting Company which is of 4 char.

Example:1234

transmittingCompanyNamestringrequired

Transmitting Company Name

Example:ABC

receivingCompanyNamestringrequired

Receiving Company Name, Derived by Zinnia based on the set up in Zinnia Systems.

Example:ABC

submitterNSCCIdstring

The NSCC assigned membership ID for the firm initiating the transactions.Only applicable for DTCC cases.

Example:0075

submitterNSCCNamestring

Name of the Submitter (Settling Firm).Only applicable for DTCC cases.

Example:LPL

asidstring

Identifier assigned by a clearing firm/service provider to a firm that clears business through them.Only applicable for DTCC cases.

Example:0075

asidNamestring

Name of associated firm.Only applicable for DTCC cases.

Example:LPL

firmExternalIdstring

External ID in MCS [Zinnia Commission System] that belongs to the Firm. firmExternalId or firmTaxId or firmNPN is mandatory.

Example:Q01530

firmTaxIdstring

9 digit Tax ID in MCS [Zinnia Commission System] that belongs to the Firm. firmExternalId or firmTaxId or firmNPN is mandatory.

Match pattern:\d{9}

>= 9 characters<= 9 characters

Example:123456789

firmNPNstring

NPN in MCS [Zinnia Commission System] that belongs to the Firm. firmExternalId or firmTaxId or firmNPN is mandatory.

Example:294128

agentSubmitDatestring(date)required

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

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

Example:2023-12-19

applicationSignedCountystring

Application Signed County, Only for Florida if required by Business Processing System for running rules.

Example:Dade

planCodestringrequired

Product code assigned by Zinnia Admin system

Example:111

applicationDatestring(date)required

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

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

Example:2023-12-19

policyDatestring(date)

Client Agreement Date/Issue Date (with pattern “yyyy-mm-dd”).

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

Example:2023-12-19

solicitationDatestring(date)

The date in which the Agent first proposes to the client the use of an insurance product, which may or may not be in response to an engagement/planning process. (with pattern “yyyy-mm-dd”).

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

Example:2023-12-19

quoteStartDatestring(date)

The start (run) date of the illustration or quote (with pattern “yyyy-mm-dd”).

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

Example:2023-12-19

quoteIdstring

The ID for the illustration or quote.

Example:12345

ownerSignedDatestring(date)

This date represents when the natural owner electronically signed the application and any supporting documentation. (with pattern “yyyy-mm-dd”).

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

Example:2023-12-19

jointOwnerSignedDatestring(date)

This date represents when the joint owner electronically signed the application and any supporting documentation. (with pattern “yyyy-mm-dd”).

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

Example:2023-12-19

annuitantSignedDatestring(date)

This date represents when the Annuitant electronically signed the application and any supporting documentation. (with pattern “yyyy-mm-dd”).

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

Example:2023-12-19

jointAnnuitantSignedDatestring(date)

This date represents when the joint Annuitant electronically signed the application and any supporting documentation. (with pattern “yyyy-mm-dd”).

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

Example:2023-12-19

trusteeSignedDatestring(date)

This date represents when the trustee/representative electronically signed the application and any supporting documentation. (with pattern “yyyy-mm-dd”).

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

Example:2023-12-19

beneficiarySignedDatestring(date)

This date represents when the Beneficiary electronically signed the application and any supporting documentation. (with pattern “yyyy-mm-dd”).

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

Example:2023-12-19

spouseSignedDatestring(date)

This date represents when the Spouse electronically signed the application and any supporting documentation. (with pattern “yyyy-mm-dd”).

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

Example:2023-12-19

igoDatestring(date)

Stores the IGO date. It is mandatory when contract have trust Date (with pattern “yyyy-mm-dd”).

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

Example:2023-12-19

appIdstringrequired

Unique Identifier against an e-App application. First 4 letters represent the receiving company, next 3 letters represent the firm, next 8 positions represent the date eApp is submitted, next 10 positions represents the sequential number of the eApps from the eApp instance.

>= 25 characters

Example:XXXXEDJ041120240000000001

versionstringrequired

Version for that case - 3 digits, incremental if same case if submitted more than once in case of errors.

Example:000

contractNbrstring

Unique number of the policy.

Example:000

contractStatestringrequired

Contract State. State code

Allowed values:AAAEAKALAPARAZCACOCTDCDEFLGAHIIAIDILINKSKYLAMAMDMEMIMNMOMSMTNCNDNENHNJNMNVNYOHOKORPARISCSDTNTXUTVAVTWAWIWVWY

Example:NJ

solicitationStatestring

Solicitation State. State code

Allowed values:AAAEAKALAPARAZCACOCTDCDEFLGAHIIAIDILINKSKYLAMAMDMEMIMNMOMSMTNCNDNENHNJNMNVNYOHOKORPARISCSDTNTXUTVAVTWAWIWVWY

Example:NJ

qualificationFlagstringrequired

Qualification Codes

Allowed values:IRAREGIRASPSLIRAROLLNONQUALROTHIRAIRASIMPLE403B401K401A457BPENPLNHR10KEOGHINHERITIRANONQUALSTRPLNINHERITROTHIRA401GROTH401KROTH403BEDUIRAPROFSHRPLNMONEYPURCHPENSPLNTARGTBENFTPLNCUSTIRACUSTROTHIRACUSTROLLIRAQUALIFIED401SCHEDA412EROTHIRACONVCORPDEFERCOMPCORPPENSCUSTINHERITIRACUSTINHERITROTHIRACUSTSARSEPIRACUSTSIMPLEIRACUSTSPOUSALIRACUSTIRASEPCUSTQLACIRADEFAULTGROUPTSAIRASEPNON457DEFCOMPIRAQLACUGMAUTMAVULNQ

Example:IRAREG

custodialstring

Describes whether the case is custodial or not

Allowed values:YESNO

Example:YES

appIndicatorstringrequired

To determine whether the request is via eApp or Paper App

Allowed values:ELECTPAPER

Example:ELECT

suitabilityAppIndicatorstringrequired

To determine whether the Suitability request is via eApp or Paper App. Select NA if Suitability is not being done via Zinnia.

Allowed values:NAELECTPAPER

Example:ELECT

ofacIndicatorstringrequired

To determine whether the OFAC request is being sent electronically to Zinnia. Select NO if OFAC is not being done via Zinnia electronically.

Allowed values:NOYES

Example:YES

commissionOptionstring

Commission Options will be provided by Zinnia for the respective Product

Example:A

binNbrstring

Brokerage Identification Number

Example:ABC0DF

telePrivilegesstring

Tele privileges value

Allowed values:NONEALLEXCONLYQTONLYOWNONLYAGTONLYDIARYNT

Example:NONE

signatureMethodstringrequired

signatureMethod

Allowed values:NONEVOICESIGNPADWETSIGBIOCLICKTHRU

Example:NONE

documentControlNumberstring

documentControlNumber is an NSCC data point, Will be derived by Zinnia.

Example:1000ABC00000000000

totalAttachmentCountintegerrequired

totalAttachmentCount expected in Attachment payload

Example:1

fileInceptionTimestring(date-time)required

Time when the case is received within ETP

Example:2025-06-26T00:00:00.000Z

policyValuesobject
Show Child Parameters
initialPurchaseobjectrequired
Show Child Parameters
fundsarray[object]required

funds that sums upto 100%

>= 1 items

Show Child Parameters
featuresarray[object]

feature for any feature/rider selected by user

>= 0 items

Show Child Parameters
rolesarray[object]required

roles that sums every role option to 100%

>= 1 items

Show Child Parameters
specialProgramsarray[object]

specialPrograms if any recurring transaction needs to be set up

>= 0 items

Show Child Parameters
payoutsarray[object]

payouts if it needs to be set up for the policy

Show Child Parameters
errorsarray[string]

Derived by Zinnia

Example:Error 1

Example

PolicyValues

object
fedMaritalStatusstringrequired

Fed marital status

Allowed values:DEFSNGLMRRDHOHQUALWIDOWWITHDEPCHILDDOMESTICPARTNERDIVORCED

Example:MRRD

stateMaritalStatusstringrequired

State marital status

Allowed values:DEFSNGLMRRDHOHQUALWIDOWWITHDEPCHILDDOMESTICPARTNERDIVORCED

Example:MRRD

withholdingarray[object]
Show Child Parameters
contribTypestring

Contribution type

Allowed values:NAEMPVOLEMPDISC

Example:EMPVOL

Example

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