--- title: "AccountingEntries" url: "https://developers.zinnia.com/apis/policy-service-0-1-0/versions/8306e031-b41c-452a-a7ed-d73d65602086/schemas/AccountingEntries" --- > Full API specification: https://developers.zinnia.com/apis/policy-service-0-1-0/versions/8306e031-b41c-452a-a7ed-d73d65602086.md # AccountingEntries ## OpenAPI definition ```yaml openapi: 3.0.0 info: title: Policy Service version: 0.0.21 servers: - url: https://qa.api.zinnia.io components: schemas: AccountingEntries: type: object properties: id: type: string description: The ID of the entry example: 65a867a326d49513ae85c2d3 timestamp: type: string description: The timestamp of the entry example: 2024-01-17T23:49:55.090Z carrierId: type: string description: The Carrier ID is a unique identifier assigned to an insurance company (carrier) that issues and underwrites a policy. It helps track, manage, and differentiate insurance providers within industry databases, regulatory systems, and digital platforms example: EVGL planCode: type: string description: The Plan Code is a carrier-assigned unique identifier used to distinguish a specific product, rate structure, and version of a life insurance or annuity policy. It ensures accurate policy tracking, pricing, and administration example: PLAN001 policyNumber: type: string description: The Policy Number is a unique identifier assigned to a life insurance or annuity contract by the insurance carrier. It serves as the official reference number for tracking, managing, and servicing the policy throughout its lifetime example: POLICY1234567890 qualificationType: type: string enum: - INDIVIDUALRETIREMENTACCOUNTREGULAR - INDIVIDUALRETIREMENTACCOUNTSPOUSAL - INDIVIDUALRETIREMENTACCOUNTROLLOVER - ROTHINDIVIDUALRETIREMENTACCOUNT - CUSTODIALINDIVIDUALRETIREMENTACCOUNT - CUSTODIALROTHINDIVIDUALRETIREMENTACCOUNT - CUSTODIALROLLOVERINDIVIDUALRETIREMENTACCOUNT - QUALIFIED - NONQUALIFIED - SIMPLIFIEDEMPLOYEEPENSIONINDIVIDUALRETIREMENTACCOUNT - INHERITEDINDIVIDUALRETIREMENTACCOUNT - INHERITEDROTHINDIVIDUALRETIREMENTACCOUNT - NONQUALIFIEDSTRETCH - INDIVIDUALRETIREMENTACCOUNTSIMPLE - Q403B - Q401K - Q401A - Q457B - PENSIONPLAN - CONVERTEDINDIVIDUALRETIREMENTACCOUNT - ROTH403B - CUSTODIALINDIVIDUALRETIREMENTACCOUNTSIMPLIFIEDEMPLOYEEPENSION - KEOGH10 - CORPORATEPENSION - GROUPTAXSHELTEREDANNUITY - PROFITSHARING - TARGETBENEFIT - CORPORATEDEFERREDCOMPENSATION404 - EDUCATIONALINDIVIDUALRETIREMENTACCOUNT - QN457B - CONVERTED - SPOUSAL - CUSTODIAL - UNIFORMGIFTSORTRANSFERSTOMINORACT - CUSTODIALQUALIFIEDLONGEVITYANNUITYCONTRACTINDIVIDUALRETIREMENTACCOUNT - CUSTODIALSIMPLEINDIVIDUALRETIREMENTACCOUNT - MONEYPURCHASEPENSIONPLAN - Q401G - Q412E3 - QUALIFIEDLONGEVITYANNUITYCONTRACTINDIVIDUALRETIREMENTACCOUNT - ROTH401K - VARIABLEUNIVERSALLIFENONQUALIFIED description: The Qualification Type in life insurance and annuities refers to the tax law provision or regulatory classification that governs a policy or contract, indicating whether it falls under a tax-advantaged retirement plan (IRA, 401(k), 403(b)) or a non-qualified account accountEntryType: type: string description: Account Entry Type refers to the categorization of a financial entry within an accounting system that indicates the nature or purpose of the entry being recorded. It helps define what the transaction represents and how it should be processed or interpreted in the general ledger example: DEBIT accountNumber: type: string description: Account Number refers to a unique numeric or alphanumeric identifier assigned to a general ledger account within the chart of accounts for an insurance carrier. It is used to classify and record financial transactions such as premiums, claims, commissions, reserves, or administrative expenses example: "299032" accountPeriod: type: number description: Accounting Period refers to the specific span of time during which financial transactions are recorded, summarized, and reported in the accounting system. It is used to group entries within a defined time frame for financial reporting, reconciliation, and audit purposes. example: 1 format: int32 ledgerType: type: string description: Ledger Type refers to the classification of the general ledger (GL) in which a financial transaction is recorded, based on the purpose, scope, or basis of accounting. It determines where and how transactions are captured, reported, and reconciled within an insurance company’s financial systems example: ACTUAL ledgerGroup: type: string description: Ledger Group refers to a collection of related general ledger (GL) accounts grouped together under a common identifier for financial reporting, accounting rule application, and system processing. In insurance and annuity systems, it helps organize and manage posting logic, financial segmentation, and parallel accounting structures (e.g., statutory, GAAP, tax). example: ACTUAL sourceSystem: type: string description: Source System refers to the originating system or platform from which a financial transaction, policy event, or accounting entry is generated and passed into the general ledger or accounting engine. It identifies where the data came from, helping to track, validate, and audit entries across integrated insurance systems example: ZAH state: type: string description: In the context of accounting entries or insurance policy administration, State refers to the U.S. state or jurisdiction associated with a policy, transaction, or party. This field is critical for determining regulatory, tax, and reporting requirements, as insurance is regulated at the state level in the U.S. example: TX currency: type: string description: Currency refers to the monetary unit in which a financial transaction, policy value, or accounting entry is denominated. In insurance and annuity accounting systems, the Currency field specifies the legal tender used for recording and reporting transactions such as premiums, claims, fees, commissions, and investments example: USD amount: type: number description: Amount refers to the numerical value of a financial transaction recorded in an accounting entry. In insurance and annuity systems, it represents the monetary value applied to a specific debit or credit line within a journal entry, and is typically expressed in the designated currency of the transaction example: 80 generalLedgerPlanCode: type: string description: GL Product Code refers to a unique identifier used to classify financial transactions in the general ledger (GL) based on the insurance or annuity product type. It links each accounting entry to a specific product line, allowing for accurate reporting, reconciliation, and financial analysis at the product level example: V2201 fundId: type: string description: Fund ID refers to a unique identifier assigned to a specific investment fund or account within an insurance or annuity product structure. It is used to track, allocate, and report financial activity related to investment-linked products, such as variable annuities, variable universal life (VUL), or separate account products example: FundAccount1 distributionChannel: type: string description: Distribution Channel refers to the method or pathway through which insurance and annuity products are marketed, sold, and delivered to customers. In the context of accounting entry rules and policy administration, it helps identify how the business was acquired and may influence commission structures, financial reporting, and accounting treatments example: D accountingMethod: type: string description: Accounting Method refers to the approach or set of rules used to recognize, record, and report financial transactions in the accounting system. In the context of insurance and annuity accounting entry rules, it determines when and how revenues, expenses, assets, and liabilities are recorded, and is essential for ensuring regulatory compliance and financial accuracy example: C transactionDate: type: string description: Transaction Date refers to the actual date on which a financial or business event occurred that results in an accounting entry. In insurance and annuity systems, this is the date the transaction (e.g., premium payment, claim payout, commission, fee, or reserve adjustment) was executed or became effective, and it serves as a key reference point for financial reporting and auditing example: 2024-01-17 transactionId: type: string description: Transaction ID is a unique identifier assigned to each financial or policy-related transaction within an insurance or annuity system. It serves as a reference key to track, audit, and link the transaction across systems—such as policy administration, billing, claims, and general ledger example: "15" transactionType: type: string enum: - Activation - AddOwner - AddressChange - AgentChange - AnnuitantChange - Anniversary - AnnualPolicyRefreshAndRecalculation - AssigneeChange - BankAccountChange - BeneficiaryChange - CalendarProcessing - CancelNoPremium - ClaimPayout - CommunicationPreferenceChange - ConversionActivation - CostOfInsurance - CoverageCharge - CoverageCredit - DeathClaim - DeliveryDateSetup - Disbursement - EmailChange - ExistingPartyNameChange - ExpenseCharge - FaceAmountChange - FaceAmountDecrease - FaceAmountIncrease - FeatureChange - ForceOut - FreeLookExpiration - FreeLookCancellation - FullSurrender - FundAllocationsChange - FundTransfer - GrantorChange - PaymentInitialPremium - IdentifierChange - InitialPremium - InterestCredit - InterestCreditLoan - InterestCreditMatch - InterestLoan - Issuance - Lapse - LapseAssessment - LoanAnniversaryTrueUp - LoanRepaymentOneTime - MatchBonusVesting - MultipleBeneficiaryChange - MultipleEmailChange - MultiplePayeeChange - MultipleAgentChange - MultipleOwnerChange - MultipleAnnuitantChange - MultiplePhoneNumberChange - NewLoan - NotificationOfDeathClaim - OneTimePremium - OwnerChange - PartialWithdrawalOneTime - PolicyDetailsChange - PayeeChange - PaymentExpiration - PaymentLoanRepaymentOneTime - PaymentOneTimePremium - PaymentSystematicLoanRepayment - PayorChange - PhoneNumberChange - RateRenewal - RemoveOwner - Rescission - PowerOfAttorneyChange - PreferredMailingAddressChange - Reinstatement - ReinstatementApproved - Reissuance - RequiredMinimumDistributionOneTime - SubsequentPayment - SubsequentPremium - Sweep - SystematicLoanRepayment - SystematicLoanRepaymentSetup - SystematicPartialWithdrawal - SystematicPartialWithdrawalSetup - SystematicRequiredMinimumDistribution - SystematicRequiredMinimumDistributionSetup - SystematicPaymentSetup - SystematicAnnuityPayout - SystematicAnnuityPayoutSetup - SystematicProgramUpdate - TPDChange - TrusteeChange - UnitExpenseCharge - ValueAdjustment - YearBeginningRefreshAndRecalculation - WithdrawnApplication - DollarCostAverage - ProcessingDate - ServiceCharge - TransferCharge - RiderAddition - Annuitization - AnnuityBenefitReduction - Reclassification - FlatExtraChange - Commutation - Dividend - DividendFeatureCharge - MarketTimerFee - InterimAnnualProcessing - HardshipWithdrawal - HardshipEnd - ResetBenefitAmounts - GuaranteedAccumulationBenefitPeriodEnd - GainLossChargeBack - SpousalContinuation - PeriodicCharge - DeathBenefitLockIn - RatchetLockIn - GrowthDeathBenefitLockIn - DateOfDeath - BenefitAmountAutoAdjustment - NotificationOfRiderClaimStart - LongTermCareBenefitStartStop - DailyRatchet - AnnuitizationAnniversary - DeclineFeeChange - GuaranteedWithdrawalBenefitPaymentLockIn - ExcessInterestCredit - LongTermCareWithdrawal - GuaranteedWithdrawalBenefitInterestAdjustment - InvestmentAdvisorFee - PayoutAmountChange - AdditionalBenefitStart - AdditionalBenefitEnd - RiderActivationAnniversary - AdditionalBenefitRenew - QualifiedPlanChange - AdvanceAnnuityPayment - PartialCommutation - GuaranteedIndexRates - BailoutRenewal - NonLifeAnnuitization - AdditionalBenefitReCertification - CostBasisReceived - FreeWithdrawalRecalculation - YearEndGain - LongTermCareCertificationDate - QuarterlyProcessing - BenefitBaseAdjustment - RiderBenefitBaseLockIn - GuaranteedDeathBenefitRollUpRenew - GuaranteedWithdrawalBenefitRollUpRenew - RiderCharge - LongTermCareFeeStartStop - LongTermCareAssessmentCharge - RoleBirthday - PendingUnclaimedProperty - PendingPartialUnclaimedProperty - LiquidatedUnclaimedProperty - SystematicRiderClaimWithdrawalSetup - SystematicRiderClaimWithdrawal - TaxWithholdingChange - MultipleTrusteeChange - MultiplePowerOfAttorneyChange - OtherInterestedPartyChange - MultipleAuthorizedSignatoryChange - AuthorizedSignatoryChange - ExchangeCompanyChange - BillingFeatureChange - GWBPhaseChange description: Specifies the type of transaction being performed, such as Premium Payment, Loan Repayment, Anniversary etc unit: type: string description: Unit refers to the standardized measure used to represent a quantity of insurance coverage, investment participation, or transactional value within an insurance, annuity, or accounting system. It is typically used to calculate coverage amounts, charges, benefits, or allocations based on a per-unit basis example: "110" ```