negative_ledgers
Return Tally's own Negative Ledgers list with each ledger's side and amount for a financial-year window; empty or unchecked answers are flagged, not treated as proof.
Instructions
Return Tally's own Negative Ledgers list for a window: the ledgers on Tally's Negative Ledgers list, each with its side (debit or credit) and its amount. The list is Tally's own and is returned as it is: the rule by which Tally lists a ledger is not established and is not derived here (on three books each listed ledger's balance sat on the side opposite its group; on the first, a ledger under Suspense A/c with a credit balance was not listed), and it is not compared with the trial balance or any other report, so a ledger Tally did not list is not shown to be absent and a listed amount is not shown to equal the ledger's closing balance elsewhere (the result's checks say not_checked). Each ledger name is masked under mask_parties. An empty list is returned as empty with state not_established: Tally's empty answer cannot be told from a report that was not rendered, so it does not say that no ledger is negative (negative_ledgers_empty_answer_is_not_a_finding). side is the side of the closing balance Tally carried the ledger on. from and to are the window of Tally's screen; only a whole financial year (1 April to 31 March) on one synthetic company was measured, and any other window is named in unmeasured_in_this_answer. The window must not start before the book (negative_ledgers_before_books); Education mode is refused (negative_ledgers_education_unqualified); an answer that is not exactly one signed amount per listed ledger, or that names a ledger twice, is refused (the call fails as negative_ledgers_read_failed and error.cause is negative_ledgers_balance_unexpected or negative_ledgers_ledger_repeated). The report's cost on a large book is not known and the report is one paired read (two requests), never retried: ask for one financial year first, and if a call times out do not repeat it. Each call appends metadata-only receipt lines (tool, company, counts, request and response fingerprints; no book content) to ComplyEaze Bridge's local log on this computer; it writes nothing to Tally.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | The last day of the window (YYYYMMDD or YYYY-MM-DD), on or after from. Only a whole financial year was measured: how Tally dates the closing balance of a part-year window was not. | |
| from | Yes | The first day of the window (YYYYMMDD or YYYY-MM-DD). Only a whole financial year, 1 April to 31 March, was measured: ask for that first. | |
| company_guid | Yes | The company's company_guid, as list_companies returns it. |