HelperStable

Fetch invoice balance

Calculates the current balance of a customer invoice, taking its settlement situation at execution time into account.

Invoice
Fetch invoice balance
Computed projection
Invoice balance

Vue d’ensemble

fetch_invoice_balance provides a current financial view of the invoice rather than copying nominal amounts. It is useful when payments, applications, or adjustments may have changed what remains due.

Exemple

Before a D+7 reminder, recalculate the invoice balance so you do not chase an amount that has already been paid or partially applied.

Parameters 1

invoiceRequisInvoice
Customer invoice whose balance must be recalculated. The node expects an addressable invoice and rejects a credit note used as the root document.

Outputs 1

invoice_balanceInvoice balance
platform.invoice_balance projection representing the invoice's current balance at calculation time.

Behavior

Validate the invoice

The node requires a platform.invoice with an ID and does not accept a credit note as the root document.

Calculate the balance

Ormuz evaluates the balance from the invoice's current settlement situation.

Use the projection

The invoice_balance output can feed a decision, reminder, or downstream check.

Limits and responsibilities

  • The result is time-dependent: a new payment allocation may change the balance after this node.
  • The node does not change invoice status and performs no reconciliation.
  • For a company-wide aggregate view, use fetch_receivable rather than manually summing isolated balances.