tally_make_workpaper
Run an audit procedure or capture a TallyPrime report and render it as a Markdown workpaper for the audit file. Re-fetches data from TallyPrime so every figure comes from the books.
Instructions
Run one audit procedure and render it as a workpaper: a Markdown document carrying the objective, the population, the method and its parameters, the results, the limitations, and the exact call that reproduces it.
TWO KINDS OF PAPER, and the document says which it is:
test— an audit PROCEDURE this server performed over the voucher population (same values as tally_test_vouchers). The paper states the population, what was excluded and why, and the parameters applied.report— one of TALLYPRIME'S OWN report views, recorded as Tally produced it (same values as tally_get_report). There is no population and nothing was selected or tested: the rule deciding what appears on it is TallyPrime's. The paper says so in its own header, because a report printout filed as though it were a performed procedure overstates the work done. Give exactly one of the two. Supplying both, or neither, is refused rather than defaulted.
WHEN TO USE: when the output has to go into an audit file rather than just answer a question in conversation. Use tally_test_vouchers to explore; use this once you know which procedure you are documenting.
IT RE-RUNS THE PROCEDURE. It does not accept figures and format them — it queries TallyPrime again and renders what came back, so every number in the document is from the books rather than from this conversation. Do NOT paste results into it; pass the same parameters you would pass to tally_test_vouchers and let it fetch. If the figures differ from an earlier run, the books changed, and that is worth knowing.
IT DOES NOT WRITE THE CONCLUSION. Supply conclusion if you have reached one. If you do not, the document says the conclusion was not recorded, rather than inventing one — an unsigned workpaper should look unsigned. Never fill this parameter with your own inference from the results; it is the auditor's to write.
RETURNS: markdown, the rendered document, plus the structured result it was rendered from so nothing is lost. Save the markdown to the audit file.
Read-only: nothing here can modify TallyPrime.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| test | No | Which procedure to run and document. Same values as tally_test_vouchers. Give either this or `report`, not both. | |
| party | No | Restrict to vouchers with this party. | |
| query | No | Restrict to vouchers matching this text. | |
| ledger | No | Restrict to vouchers against this ledger. | |
| report | No | Document one of TallyPrime's own report views instead of running a procedure. Same values as tally_get_report. Give either this or `test`, not both. The document is rendered differently and says plainly that it records a report as TallyPrime produced it, not a procedure this server performed — see the tool description. | |
| toDate | No | End of the period, ISO YYYY-MM-DD. Must be on or after fromDate. | |
| company | No | Company name. Omit to use whichever company TallyPrime has loaded. If given and it is not the loaded one, the call fails with TALLY_COMPANY_NOT_LOADED rather than returning another company's data. | |
| fromDate | No | Start of the period, ISO YYYY-MM-DD. Omit both dates for the financial year containing today; the resolved range is echoed back. | |
| maxAmount | No | Restrict to vouchers at most this large. | |
| minAmount | No | Restrict to vouchers at least this large. | |
| objective | Yes | What this procedure was performed to establish, in your words. Required — a workpaper without a stated objective cannot be reviewed, because there is no way to judge whether the work done was the work needed. | |
| reference | No | Your working paper reference, e.g. "C-140". Rendered in the header. | |
| threshold | No | journal_screen only: normally your materiality figure. | |
| conclusion | No | What you concluded from the results. Optional, and NEVER to be filled in on the auditor's behalf: omitted renders as "not recorded", which is the honest state of a paper nobody has signed off. | |
| cutoffDays | No | cutoff only. | |
| preparedBy | No | Who performed the procedure. Renders as "not recorded" when omitted. | |
| sampleSeed | No | sample only: pass to reproduce. | |
| sampleSize | No | sample only. | |
| voucherType | No | Restrict the population to this type. | |
| sampleMethod | No | ||
| benfordDigits | No | ||
| relatedParties | No | ||
| roundMultipleOf | No | What counts as round. |