Search
K
New Business - Annuity

ApplicationV3

object
keystring

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

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.

vendorAppIdstring

Application identifier assigned by an external vendor or partner system.

versionNumberstringrequired

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

qlacIndicatorstring

Flag indicating whether the contract is a Qualified Longevity Annuity Contract (QLAC).

Allowed values:YESNO

Example:YES

ofacIndicatorstring

Indicator identifying whether the address is subject to OFAC review or screening.

Allowed values:YESNO

fileInceptionTimestring(date-time)

Time when the case is received within ETP

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

dateQualifiersobjectrequired
Show Child Parameters
submissionTypestringrequired

To determine whether the request is via eApp or Paper App

Allowed values:ELECTRONICPAPER

Example:ELECTRONIC

customerOtherProductsAnswerstring

Indicates whether the applicant has existing life insurance or annuity policies. Valid values are Yes, No, or Unknown.

Example:YES

applicationSignedCountystring

County where the application was signed by the customer.

submitterNsccIdstring

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

submitterNsccNamestring

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

associatedFirmIdstring

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

associatedFirmNamestring

Name of associated firm.Only applicable for DTCC cases.

vendorIdstring

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

vendorNamestring

Transmitting Company Name

Example:FIRELIGHT

carrierNamestringrequired

Name of the U.S. insurance company that is issuing the policy. [Derived by Zinnia]

carrierIdnumber

Carrier Id is DTCC part id for a given insurance carrier such as 4527, 0015.

firmTaxIdstring

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

firmNPNstring

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

firmExternalIdstring

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

replacementIndicatorboolean

Indicates whether the application is submitted as an exchange or replacement of an existing policy.

qualificationTypestringrequired

Indicator showing whether the application meets qualification requirements.

Allowed values:Q401KSOLO401KHEALTHREIMBURSEMENT501C9Q457BHR10KEOGHINHERITEDINDIVIDUALRETIREMENTACCOUNTNONQUALIFIEDSTRETCHINHERITEDROTHINDIVIDUALRETIREMENTACCOUNTINDIVIDUALRETIREMENTACCOUNTREGULARINDIVIDUALRETIREMENTACCOUNTROLLOVERNONQUALIFIEDPENSIONPLANSALARYREDUCTIONSIMPLIFIEDEMPLOYEEPENSIONSIMPLIFIEDEMPLOYEEPENSIONINDIVIDUALRETIREMENTACCOUNTINDIVIDUALRETIREMENTACCOUNTSPOUSALINDIVIDUALRETIREMENTACCOUNTTRANSFERCASHBALANCEPLANDEFINEDCONTRIBUTIONSCASHBALANCEPLANDEFINEDBENEFITSOLODEFINEDBENEFITQ403BQ401GFORMERLY403GQ412IPLANINDIVIDUALRETIREMENTACCOUNTSIMPLEROTHINDIVIDUALRETIREMENTACCOUNTROTH401KROTH403BEDUCATIONALINDIVIDUALRETIREMENTACCOUNTPROFITSHARINGPLANMONEYPURCHASEPLANWELFAREBENEFITPLAN419PLANLONGTERMCARE7702BNOUNITEDSTATESTAXATIONUSEDFOROFFSHOREPRODUCTSQ401ATEXASOPTIONALRETIREMENTPROGRAMTARGETBENEFITPLANQ403BTRANSFERSONLYROTH457CUSTODIALINDIVIDUALRETIREMENTACCOUNTCUSTODIALROTHINDIVIDUALRETIREMENTACCOUNTCUSTODIALROLLOVERINDIVIDUALRETIREMENTACCOUNTCONVERTEDROTHINDIVIDUALRETIREMENTACCOUNTCUSTODIALINHERITEDINDIVIDUALRETIREMENTACCOUNTCUSTODIALINHERITEDROTHINDIVIDUALRETIREMENTACCOUNTCUSTODIALSPOUSEINDIVIDUALRETIREMENTACCOUNTCUSTODIALINDIVIDUALRETIREMENTACCOUNTSIMPLIFIEDEMPLOYEEPENSIONQUALIFIEDUNIFORMGIFTSORTRANSFERSTOMINORACTCONVERTEDINDIVIDUALRETIREMENTACCOUNTCORPORATEPENSIONGROUPTAXSHELTEREDANNUITYCORPORATEDEFERREDCOMPENSATION404QN457BCONVERTEDSPOUSALCUSTODIAL

custodialstring

Flag indicating whether an application is associated with custodian or not.

Allowed values:YESNO

Example:YES

commissionOptionstring

Commission option value provided by Zinnia for the applicable product. This value is used to determine agent commissions.

brokerageIdentificationNumberstring

Client account identifier used by the distributor.

suitabilityAppIndicatorstringrequired

Indicator that a suitability review is required or has been performed.

Allowed values:YESNO

Example:YES

attachmentarray[object]
* Additional properties are NOT allowed.
Show Child Parameters
Example

Attachment

object
* Additional properties are NOT allowed.
signatureMethodstring

Method used to capture the customer’s signature (e.g., electronic, wet)

Allowed values:NONEVOICESIGNATUREPADWETSIGNATURESCANNEDBIOMETRICCLICKTHROUGH

documentControlNumberstring

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

totalAttachmentCountstring

Total Attachment Count expected in Attachment payload

Example

Illustrations

object
* Additional properties are NOT allowed.
quoteIdstring

Unique identifier assigned to a quote for tracking and reference purposes.

solicitationStatestring

State in which the product solicitation occurred.

solicitationDatestring(date)

Date on which the product was solicited or offered to the customer

quoteStartDatestring(date)

Date on which the quoted rates or terms become effective

quoteEndDatestring(date)

Date on which the quoted rates or terms ends

Example

Policy

object
* Additional properties are NOT allowed.
policyNumberstring

Unique policy number that will be assigned to the policy issued from this application.

planCodestringrequired

Provided by Zinnia

productCusipstring

CUSIP number used to uniquely identify the insurance product.

productTypestring

Type of insurance product

Allowed values:INDEXEDUNIVERSALLIFEUNIVERSALLIFETERMANNUITY

policyStatusstring

Status of the policy

Allowed values:APPLIEDFORAPPROVEDSUBMITTEDTOUNDERWRITINGPENDINGDECLINEDQUOTEDRISKNOTACCEPTABLENOTTAKENPENDINGISSUEDISSUEDCLOSEDCANCELLEDEXPIREDCONVERSION

policyEffectiveDatestring(date)

Date from which the policy is effective (with pattern “yyyy-mm-dd”)

issueStatestringrequired

Abbreviated names for states

issueCountrystring

Policy Issue Country (Only US)

initialPurchaseobjectrequired
Show Child Parameters
featurearray[object]
* Additional properties are NOT allowed.
Show Child Parameters
fundDetailsarray[object]required
* Additional properties are NOT allowed.
Show Child Parameters
Example

PaymentV3

object
* Additional properties are NOT allowed.
paymentIdstring(Integer)required

Unique id for the payment made

referenceNumberstring

Reference Numbe for the payment made

netAmountstring(double)required

Premium received (Net Amount)

Example:238500.50

grossAmountstring(double)required

Premium received (Gross Amount)

Example:238500.50

methodstringrequired

Method through which the payment is made

Allowed values:CREDITCARDDEBITCARDCHECKACHDIGITALPAYMENTWIREDTCCEXCHANGEPAYROLLDEDUCTION

internalExchIndicatorstring

DTCC defined Indicator that states whether an exchange type application is internal of external.

Allowed values:YESNO

withdrawalIndicatorstring

Premium received withdrawal indicator

Allowed values:FULLPARTIAL

partialWithdrawTypestring

If Withdrawal indicator is input then Partial Withdrawal Type become mandatory

Allowed values:SPECIFIEDAMOUNTWITHDRAWALPERCENTOFCONTRACTWITHDRAWALPERCENTOFCONTRACTPREMIUMWITHDRAWALPERCENTOFFUNDWITHDRAWALRIDERFREEAMOUNTWITHDRAWALSURRENDERFREEAMOUNTWITHDRAWALPENALTYFREEWITHDRAWALINTERESTONLYWITHDRAWALREQUIREDMINIMUMDISTRIBUTIONWITHDRAWALSUBSTANTIALLYEQUALPAYMENTSINTERESTONLYSURRENDERFREEAMOUNTWITHDRAWALREQUIREMENTMINIMUMDISTRIBUTIONCALCULATEDREQUIREMENTMINIMUMDISTRIBUTIONSPECIFIEDAMOUNT

surrenderingDateInstructionstring

If Withdrawal indicator is input then Partial Withdrawal Type become mandatory

Allowed values:UPONRECEIPTSPECIFICDATE

frequencystring

Frequency of premium payments

Allowed values:DAILYEVERYTWOWEEKSMONTHLYSEMIANNUALQUARTERLYANNUALSINGLEPAYMENT

paymentDatestring(date)

Date when the payment is made (with pattern “yyyy-mm-dd”)

draftDatestring(date)

Date when the payment draft is created (with pattern “yyyy-mm-dd”)

externalTransactionIdstring

Transaction ID from external system

externalArrangementIdstring

Arrangement ID from external system

automaticPaymentboolean

Whhether this payment is automatic - TRUE/FALSE

premTypestring

DTCC-defined code identifying the type of premium payment.

Allowed values:DIRECTROLLOVERINDIRECTROLLOVERCONTRIBUTIONFULL1035EXCHANGEPARTIAL1035EXCHANGEQUALIFIEDTRANSFERNONQUALIFIEDTRANSFEROFASSETSEMPLOYEECONTRIBUTIONEMPLOYERCONTRIBUTION

currentAllocstringrequired

Indicates whether Funds to be considered for Future Allocations or not

Allowed values:YESNO

waivePremiumstring

Indicator specifying whether the premium is waived.

distributorIdstring

This is same as Tracking ID.If there are multiple payments, first payment distributorId will be the TrackingID. This unique system generated number is assigned by the B/D system and sent with each premium to the NSCC, to send to the Insurance Company. This number is assigned by the broker dealer, by which the premium can be located. Required for clearing house and detail level transactions. Broker/dealer would expect this back for chargebacks, reversals, etc. Can be returned on the “FAR” and the “COM” by the insurance carrier to identify the transaction processed.

partyarray[string](uuid)

Party ID associated with this payment.

taxInfoobject
* Additional properties are NOT allowed.
Show Child Parameters
policyHistoryobject
* Additional properties are NOT allowed.
Show Child Parameters
bankInformationobject
* Additional properties are NOT allowed.
Show Child Parameters
Example