Struct JournalEntry 

pub struct JournalEntry {
    pub header: JournalEntryHeader,
    pub lines: SmallVec<[JournalEntryLine; 4]>,
}

Complete journal entry with header and line items.

Represents a balanced double-entry bookkeeping transaction where total debits must equal total credits.

Uses SmallVec<[JournalEntryLine; 4]> for line items: entries with 4 or fewer lines (the common case) are stored inline on the stack, avoiding heap allocation. Entries with more lines spill to the heap transparently.

Fields

header: JournalEntryHeader

Header with document metadata

lines: SmallVec<[JournalEntryLine; 4]>

Line items (debit and credit postings). Inline for ≤4 lines (common case), heap-allocated for >4.

Implementations

impl JournalEntry

pub fn new(header: JournalEntryHeader) -> Self

Create a new journal entry with header and empty lines.

pub fn new_simple( document_number: String, company_code: String, posting_date: NaiveDate, description: String, ) -> Self

Create a new journal entry with basic parameters (convenience constructor).

This is a simplified constructor for backwards compatibility that creates a journal entry with the specified document number, company code, posting date, and description.

pub fn add_line(&mut self, line: JournalEntryLine)

Add a line item to the journal entry.

Automatically sets the line’s document_id to match the header’s document_id.

pub fn total_debit(&self) -> Decimal

Get the total debit amount.

pub fn total_credit(&self) -> Decimal

Get the total credit amount.

pub fn is_balanced(&self) -> bool

Check if the journal entry is balanced (debits = credits).

pub fn balance_difference(&self) -> Decimal

Get the out-of-balance amount (should be zero for valid entries).

pub fn line_count(&self) -> usize

Get the number of line items.

pub fn has_even_line_count(&self) -> bool

Check if the line count is even.

pub fn debit_credit_counts(&self) -> (usize, usize)

Get the count of debit and credit lines.

pub fn has_equal_debit_credit_counts(&self) -> bool

Check if debit and credit line counts are equal.

pub fn unique_accounts(&self) -> Vec<&str>

Get unique GL accounts used in this entry.

pub fn has_suspense_posting(&self) -> bool

Check if any line posts to a suspense account.

pub fn company_code(&self) -> &str

Get the company code.

pub fn document_number(&self) -> String

Get the document number (document_id as string).

pub fn posting_date(&self) -> NaiveDate

Get the posting date.

pub fn document_date(&self) -> NaiveDate

Get the document date.

pub fn fiscal_year(&self) -> u16

Get the fiscal year.

pub fn fiscal_period(&self) -> u8

Get the fiscal period.

pub fn currency(&self) -> &str

Get the currency.

pub fn is_fraud(&self) -> bool

Check if this entry is marked as fraud.

pub fn has_sod_violation(&self) -> bool

Check if this entry has a SOD violation.

pub fn description(&self) -> Option<&str>

Get the description (header text).

pub fn set_description(&mut self, description: String)

Set the description (header text).

Trait Implementations

impl Clone for JournalEntry

fn clone(&self) -> JournalEntry

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for JournalEntry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for JournalEntry

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for JournalEntry

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.