Struct Transaction 

pub struct Transaction {

    pub id: TransactionId,
    pub account_id: AccountId,
    pub date: NaiveDate,
    pub amount: Money,
    pub payee_id: Option<PayeeId>,
    pub payee_name: String,
    pub category_id: Option<CategoryId>,
    pub splits: Vec<Split>,
    pub memo: String,
    pub status: TransactionStatus,
    pub transfer_transaction_id: Option<TransactionId>,
    pub import_id: Option<String>,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
}

A financial transaction

Fields

id: TransactionId

Unique identifier

account_id: AccountId

The account this transaction belongs to

date: NaiveDate

Transaction date

amount: Money

Amount (positive for inflow, negative for outflow)

payee_id: Option<PayeeId>

Payee ID (optional)

payee_name: String

Payee name (stored for display, even if payee_id is set)

category_id: Option<CategoryId>

Category ID (None if this is a split transaction or transfer)

splits: Vec<Split>

Split transactions - if non-empty, category_id should be None

memo: String

Memo/notes

status: TransactionStatus

Transaction status

transfer_transaction_id: Option<TransactionId>

If this is a transfer, the ID of the linked transaction in the other account

import_id: Option<String>

Import ID for duplicate detection during CSV import

created_at: DateTime<Utc>

When the transaction was created

updated_at: DateTime<Utc>

When the transaction was last modified

Implementations

impl Transaction

pub fn new(account_id: AccountId, date: NaiveDate, amount: Money) -> Self

Create a new transaction

pub fn with_details( account_id: AccountId, date: NaiveDate, amount: Money, payee_name: impl Into<String>, category_id: Option<CategoryId>, memo: impl Into<String>, ) -> Self

Create a transaction with all common fields

pub fn is_split(&self) -> bool

Check if this is a split transaction

pub fn is_transfer(&self) -> bool

Check if this is a transfer

pub fn is_inflow(&self) -> bool

Check if this is an inflow (positive amount)

pub fn is_outflow(&self) -> bool

Check if this is an outflow (negative amount)

pub fn is_locked(&self) -> bool

Check if this transaction is locked

pub fn set_status(&mut self, status: TransactionStatus)

Set the status

pub fn clear(&mut self)

Clear the transaction (mark as cleared)

pub fn reconcile(&mut self)

Mark as reconciled

pub fn add_split(&mut self, split: Split)

Add a split

pub fn set_category(&mut self, category_id: CategoryId)

Clear all splits and set a single category

pub fn splits_total(&self) -> Money

Get the total of all splits (should equal transaction amount)

pub fn validate(&self) -> Result<(), TransactionValidationError>

Validate the transaction

pub fn generate_import_id(&self) -> String

Generate an import ID for duplicate detection

Trait Implementations

impl Clone for Transaction

fn clone(&self) -> Transaction

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Transaction

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Transaction

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Transaction

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

Formats the value using the given formatter.

impl Serialize for Transaction

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

where __S: Serializer,

Serialize this value into the given Serde serializer.