Description
Return positive amount when tokens match and negative otherwise.
Financial accounting arithmetic tracks amounts, balances, fees and allocations on a declared currency and sign basis. An algebraically consistent result does not authorize a transaction or establish an amount legally due.
Return positive amount when tokens match and negative otherwise.
When to use this tool
Use Finance: Cash Flow Payment Sign Convention when you need a specified monetary balance or allocation calculation.
How to use the tool and how it works
- Enter amount, direction, perspective. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read result. Expand result to inspect the returned fields.
Require nonnegative amount and borrower/lender direction and perspective tokens. Return positive amount when tokens match and negative otherwise.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| amount | Amount | Required. Finite number. |
| direction | Party toward whom the cash transfer is directed. | Required. Text; one of "borrower", "lender". Implementation limit: 8192 Unicode code points and 16384 UTF-16 code units. |
| perspective | Party whose cash inflow is counted positive. | Required. Text; one of "borrower", "lender". Implementation limit: 8192 Unicode code points and 16384 UTF-16 code units. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| result | Object containing the calculated members; expand to inspect the fields below. | Required. Object. |
| result.signedCashFlow | Signed Cash Flow | Calculated result member: number. |
{
"input": {
"amount": 10,
"direction": "borrower",
"perspective": "lender"
},
"output": {
"result": {
"signedCashFlow": -10
}
}
}Limitations and assumptions
- Direction denotes the party receiving the cash under this formatter's convention, not an assumed loan repayment. No loan event, amount due or actual transfer is inferred.
- Outputs are nested inside result. Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
- Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.
Alternative or Complementary methods
Reconcile source ledgers and governing agreements using the intended currency precision and accounting policy. Include omitted fees, tax, timing and legal requirements before acting on a result.
References
Similar or alternative tools
- Finance: Trade Cash Flow With Fixed Fee
Return positive sale proceeds or negative purchase cost, always subtracting the fixed fee.
- Finance: Cash Discount Deadline Date Offset Tool
Resolve a calendar-day cash-discount deadline excluding the invoice day, without business-day adjustment or legal payment advice.