Search
K
MarketConnect-OrderEntry

ErrorInfo

object
* Additional properties are NOT allowed.
codestringrequired

Backend error codes returned by the Order Entry API indicating validation failures, transaction issues, blueprint generation errors, authorization errors, or unexpected system failures.

Allowed values:VALIDATION_ERRORINVALID_TRANSACTION_IDINVALID_STEP_NAMETRANSACTION_CREATION_FAILEDTRANSACTION_ID_NOT_FOUNDSAVE_TRANSACTION_ERRORSAVE_TRANSACTION_FAILEDINVALID_RESPONSE_FORMATBUILD_BLUEPRINT_ERRORJSON_PARSE_ERRORTRANSFORMER_NULL_RESPONSEEMPTY_BLUEPRINTUNEXPECTED_ERRORSERVICE_ERRORUNAUTHORIZEDFORBIDDENNOT_FOUNDFIRST_STEP_SETUP_FAILED

descriptionstring
detailsstring
timestampstring(date-time)required
Example

ErrorResponse

object
* Additional properties are NOT allowed.
transactionIdstringrequired

>= 1 characters

errorsarray[object]required

Example:{"code":"VALIDATION_ERROR","description":"Input validation failed","details":"One or more input fields are invalid","timestamp":"2024-01-15T10:30:00.000Z"}

* Additional properties are NOT allowed.
Show Child Parameters
Example

EsignatureResponse

object
* Additional properties are NOT allowed.
successboolean

True when signers were retrieved successfully.

messagestring

User-safe message; populated when success is false.

signersarray[object]

DocuSign recipients for the transaction, ordered by signing sequence.

Example:{"recipientId":"11306862","signerName":"EE EE","signerEntityRole":"PrimaryOwner","signerEmail":"anannya.gupta@zinnia.com","signerSequence":"1","signerAccessCode":[],"signerAuthMethod":["Phone","SMS"],"signerCountryCode":"1","signerPhoneNo":"8650827071"}

* Additional properties are NOT allowed.
Show Child Parameters
Example

EsignatureSigner

object
* Additional properties are NOT allowed.
recipientIdstring

DocuSign recipient ID from the recipient proc.

signerNamestring

Display name shown in the signer grid.

signerEntityRolestring

Entity role (for example PrimaryOwner, AgentOfRecord).

signerEmailstring

Signer email; may be empty for some roles.

signerSequencestring

Signing order when routing is sequential.

signerAccessCodearray[string]

Access codes when configured; empty array when none.

signerAuthMethodarray[string]

Array of auth method labels (for example Phone, SMS).

signerCountryCodestring

Country calling code (default 1 for US).

signerPhoneNostring

Phone digits only; stored without dashes in proc.

Example

FieldBlueprint

object
* Additional properties are NOT allowed.
fieldTypestringrequired

The type of field displayed for collecting response values:
money - Currency input field
date - Date selection input field
information - Read-only informational text display field
radio - Single-selection radio button field
input - Free-form text input field
email - Email address input field
dropdown - Selection field with predefined options
phone - Phone number input field
checkboxgroup - Checkbox group field for multiple selections
number - Number input field for numeric values
checkbox - Checkbox field for single selection (value is string)

Allowed values:moneydateinformationradioinputemaildropdownphonecheckboxgroupnumbercheckbox

textobjectrequired

The text associated with a field title, such as descriptions or related notes. Supports localization through language codes (e.g., en, fr)

* Additional properties are NOT allowed.
Show Child Parameters
titleobjectrequired

The field title in multiple languages. Supports localization through language codes (e.g., en, fr)

* Additional properties are NOT allowed.
Show Child Parameters
answerNodeIdstring

A unique identifier used to store and infer a field’s answer, and to build validation and visibility conditions across the order entry blueprint

renderOnarray[object]

Single condition controlling whether a field/section is rendered.

Show Child Parameters
platformsarray[string]

An array of platforms where this field is available (e.g., D2C-only versus advisor-driven experiences)

copyablestring

A comma-separated list of roles (e.g., annuitant, insured, owner, payor) that are allowed to copy this field.

triggerStepNavigationboolean

Indicates whether the field triggers step navigation

layoutobject

Layout options for the field. Used to define the field’s rendered width in the 12-column grid.

* Additional properties are NOT allowed.
Show Child Parameters
displayInCardPreviewboolean

Indicates whether this field should be displayed in card preview mode

applicationModesarray[string]

Array of application modes where this field is available. Helper for filtering what is shown in different modes or channels

placeholderobject

List of localized default text values for the field. When rendered, the appropriate localized text is displayed as the field’s initial answer until modified.

* Additional properties are NOT allowed.
Show Child Parameters
idstringrequired

The unique identifier for the field

>= 1 characters

partNamestringrequired

An identifier (partName) for the field.

>= 1 characters

validateAsstring

Validation type applied to fields such as phone numbers, where the value must contain digits only. These validations exist and are managed through Zinnia UI

selectOptionsarray[object]

Array of options (answers) that can be selected for dropdown, radio, checkbox, or checkboxgroup fields

* Additional properties are NOT allowed.
Show Child Parameters
selectOptionsApplicationContextobject

Application context for select options sourced from subscriber dataset

Example:{"tag":"507602","labelKey":{"en":"Name"},"valuePath":"Value"}

* Additional properties are NOT allowed.
Show Child Parameters
visibleobject

Visibility settings containing a boolean operator and an array of conditions that determine when the field is visible.

Example:{"booleanOperator":"AND","conditions":[{"type":"equality","isEqual":true,"value":"Yes","targetNodeId":"Transaction.SolicitationState"},{"type":"equality","isEqual":true,"value":"Yes","targetNodeId":"Transaction.SolicitationState"}]}

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

An array of validation rules applied to the field (e.g., regex, number range, character count)

Example:{"message":{"en":"Please enter valid email address"},"conditions":{"conditions":[{"type":"matchesRegexCondition","targetNodeId":"Transaction.Beneficiaries[0].EmailAddresses[\"Home\"].Address","regex":"^\\w+([-+.']\\w+)*@\\w+([-.]\\w+)*\\.\\w+([-.]\\w+)*$"}]}}

* Additional properties are NOT allowed.
Show Child Parameters
optionalboolean

Indicates if this field is optional (not required)

disabledboolean

Indicates whether the field is rendered as disabled (read-only) in the form. Emitted when the upstream control carries ReadOnly: 1 / ReadOnly: true. Omitted when the field is not disabled.

Example:true

Example