Struct JournalEntry 

pub struct JournalEntry {

    pub id: Uuid,
    pub organization_id: Uuid,
    pub building_id: Option<Uuid>,
    pub entry_date: DateTime<Utc>,
    pub description: Option<String>,
    pub document_ref: Option<String>,
    pub journal_type: Option<String>,
    pub expense_id: Option<Uuid>,
    pub contribution_id: Option<Uuid>,
    pub lines: Vec<JournalEntryLine>,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    pub created_by: Option<Uuid>,
}

Journal Entry represents a complete accounting transaction with balanced debit and credit lines (double-entry bookkeeping).

Each entry contains multiple lines (JournalEntryLine) where:

• Sum of debits = Sum of credits (enforced by database trigger)
• Each line affects one account

Example: Recording a 1,210€ utility expense (1,000€ + 210€ VAT 21%):

• Debit: 6100 (Utilities) 1,000€
• Debit: 4110 (VAT Recoverable) 210€
• Credit: 4400 (Suppliers) 1,210€

Fields

id: Uuid

organization_id: Uuid

building_id: Option<Uuid>

Optional link to building for building-specific accounting

entry_date: DateTime<Utc>

Date when the transaction occurred (not when recorded)

description: Option<String>

Human-readable description (e.g., “Facture eau janvier 2025”)

document_ref: Option<String>

Reference to source document (invoice number, receipt, etc.)

journal_type: Option<String>

Journal type: ACH (Purchases), VEN (Sales), FIN (Financial), ODS (Miscellaneous) Inspired by Noalyss journal categories

expense_id: Option<Uuid>

Optional link to the expense that generated this entry

contribution_id: Option<Uuid>

Optional link to the owner contribution that generated this entry

lines: Vec<JournalEntryLine>

Lines composing this entry (debits and credits)

created_at: DateTime<Utc>

updated_at: DateTime<Utc>

created_by: Option<Uuid>

Implementations

impl JournalEntry

pub fn new( organization_id: Uuid, building_id: Option<Uuid>, entry_date: DateTime<Utc>, description: Option<String>, document_ref: Option<String>, journal_type: Option<String>, expense_id: Option<Uuid>, contribution_id: Option<Uuid>, lines: Vec<JournalEntryLine>, created_by: Option<Uuid>, ) -> Result<Self, String>

Create a new journal entry with validation

Arguments

• organization_id: Organization owning this entry
• entry_date: Transaction date
• description: Human-readable description
• lines: Debit and credit lines (must balance)

Returns

• Ok(JournalEntry) if lines balance (within 0.01€ tolerance)
• Err(String) if validation fails

pub fn total_debits(&self) -> f64

Calculate total debits for this entry

pub fn total_credits(&self) -> f64

Calculate total credits for this entry

pub fn is_balanced(&self) -> bool

Check if this entry is balanced (debits = credits)

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.