add_note
ChatGPTAdds a note, or a question for the user, about something in the business: a transaction, document, import, proposal batch, property, bank account or report, or the business as a whole. The user sees it in Moniaro marked as from the AI app. Changes records: it only adds this note; nothing else changes. Ask a question rather than guessing when something is unclear.
approve_proposal_batch
ChatGPTChanges records: approves the batch and applies its changes to the user's transactions, documents or rules. Only call after the user has said yes to this exact batch. Pass the version and contentHash from get_proposal_batch or the propose_ result you showed the user; if the batch changed since, Moniaro refuses and you must show the user the new batch. Moniaro sends larger or more significant batches to its own review screen instead, and the answer then carries the link to give the user. Approve only some groups with groupIds, or leave items out with excludeItemIds.
calculate_year_end_adjustment
ChatGPTCalculates one year-end adjustment for a rental tax year (home office, motor vehicle, phone and internet, or a cash expense the owner paid personally) from the figures you give and the business's settings. Moniaro does the arithmetic and says which inputs it used, a category to suggest and any warning, for example about changing the vehicle method. The result is a draft for the owner or their accountant to check. Nothing is saved: prepare the result with propose_year_end_adjustment.
check_report_readiness
ChatGPTReads whether the figures of a report are ready to rely on for a period: what Moniaro checked (transactions with no category or not yet reviewed, possible duplicates, suggestions waiting for approval, gaps in imported statements, GST settings and so on), which checks failed, how serious each is and where the user can fix it. The status is blocked, draft or ready, and ready only means no check found anything to fix. Call it before quoting any figure and tell the user the status. Nothing changes.
compare_periods
ChatGPTReads the category totals of one period beside the period before it (the default) or the same period a year earlier, with the change in each category, the totals of income, spending and the net result, and the categories that moved most listed first. Use it in a review to ask the user about a category that jumped, dropped, appeared or stopped. Moniaro pairs the categories and works out every change and percentage: never add up, subtract or round figures yourself, and say each period's readiness before quoting a figure, because the comparison is only a draft until the transactions behind it are reviewed. Spending is shown as a positive amount. Nothing changes.
create_report_download
ChatGPTMakes a short-lived link to a PDF or Excel file of a report and returns it with the file name, when it expires and the readiness of the figures in it. It reads the records and changes none. Give the user the link as it is; it works without signing in until it expires, so say so, and make a new one if it has. Formats: Moniaro Books gst_return and transactions_summary (pdf or xlsx), transactions_by_category (xlsx), financial_statements (pdf); Moniaro Property rental_statement and ir3r (pdf or xlsx), depreciation_schedule (xlsx), financial_statements (pdf). Draft figures only: payments basis, no adjustments, Moniaro does not file returns.
create_review_download
ChatGPTMakes a short-lived link to a PDF or Excel file of the period review (the figures, the findings by section, the questions still open and the answers the user has given) and returns it with the file name, when it expires and the review's status and summary. It reads the records and changes none. Give the user the link as it is, to keep or send to their accountant; it works without signing in until it expires, so say so, and make a new one if it has. The file is a draft for the user and their accountant to check, so say that when handing it over. Draft figures only: payments basis, no adjustments, Moniaro does not file returns.
create_upload_link
ChatGPTMakes a short-lived link the user opens in Moniaro (signed in) to upload a bank statement for one account, or a receipt or invoice for one transaction, themselves. Use it when the file cannot be passed to you directly. Changes records: it only adds this one link, which expires in about half an hour and can be used a few times.
fetch
ChatGPTReads one item found with search as a block of text: a transaction with its category, GST and documents, a document with what Moniaro read from it, a proposal batch with its groups and totals, a property with its rental statement, or a report with whether its figures are ready. Pass the id exactly as search gave it.
get_account_coverage
ChatGPTReads, for each bank account, which dates are covered by imported statements or a bank feed, the gaps between them, statements that overlap, and whether stated balances agree with the books. Defaults to the current financial year up to today. Use it to find which statements are still missing.
get_bank_export_guide
ChatGPTReads the steps for exporting a statement file from the user's bank (the recommended file format, the dates to choose and tips), worded for the bank of one of their accounts when it is known. Bank screens change, so the guide says when its steps have not been checked against the bank. Use it to tell the user what to download before preview_statement_import.
get_briefing
ChatGPTReads the business this connection works on and what needs attention in it: its settings, GST and financial year periods, open items such as uncategorised transactions, duplicates and pending proposals, open questions, recent activity, running jobs, and the bank accounts, imports and documents shared by the products. Call this first in every conversation. access.level says what this connection may do; maxItems and maxTotalAbsAmount apply only when canApproveInChat is true.
get_document
ChatGPTReads one document: what Moniaro read from it (supplier, date, total and GST), what the sender claimed, any place the two disagree, the transactions it most likely belongs to with the reasons for each, the records it is linked to, and a link to open it in Moniaro. Use it after submit_document, or to look at a document from list_documents. Never returns the file itself.
get_gst_draft_guide
ChatGPTReads the draft GST return for a period worked box by box: each box's figure with the part that rests on reviewed transactions and the part that does not, what the box means, links to the transactions behind it, what the figures leave out, and the issues to fix first. With no dates it uses the last complete GST period in the business's settings. Use it to help the user fill in myIR themselves; never say a return is final or filed. When the user has marked the period as submitted the guide says so, with the figures as they stood; never call a return filed or final yourself. Draft figures only: payments basis, no adjustments, Moniaro does not file returns.
get_import_preview
ChatGPTReads a checked statement again by its preview id: its status (a PDF is read in the background, so it may still be analysing), totals, duplicates, statement balances and coverage, and with includeRows every row up to a limit. Use it after preview_statement_import when the status was analysing, or to look at the rows before the user decides.
get_job_status
ChatGPTReads the progress of a background job started by another tool, such as AI categorisation, reading a PDF statement or a large approval: its status, percentage done, how many items were processed, its result when it finished, and the error if it failed. Pass the job id exactly as given, with its books:, property: or platform: prefix. Check again until the status is succeeded, partially_succeeded, failed or cancelled.
get_property
ChatGPTReads one rental property in Moniaro Property: its name and address, purchase date and cost, interest deductibility class (acquired before 27 March 2021, acquired on or after it, or a new build), whether the owner lives in it, property and title type, sizes, notes and its owners with their shares. It lists what is still missing (purchase date, purchase cost, owners, owner shares that do not add up to 100) and which details propose_property_details can change. Nothing changes.
get_proposal_batch
ChatGPTReads one proposal batch: its status, current version and content hash, the groups of changes with their effects on the figures, whether it could be approved in the chat and why not, and the review link. Ask for the items to see each change with its values before and after. Read it again before approving: the version and hash change when anything in the batch changes.
get_rental_year_guide
ChatGPTReads the rental year guide for a rental property owner in Moniaro Property: the steps from the first bank statement to the IR3R rental figures, in order, each marked done, to do, needs attention, optional or not applicable, with what it is for, the tool that does it and a link to the page in Moniaro. It also carries the owners' shares of the year's income and expenses, what each IR3R box means, the filing dates and the limits, all from Moniaro, so never work them out yourself. nextSteps names the first steps still to do. Start with it after get_briefing and follow the steps in order. The figures are drafts for the owner or their accountant to check; Moniaro does not file returns. Nothing changes.
get_settings
ChatGPTReads the business's settings in one product: Moniaro Books has the GST filing period and start month, the financial year start month, the home office claim percentage and areas, the vehicle business use percentage, the withholding tax rate and the capitalisation threshold; Moniaro Property has the financial year start month, the phone and internet claim percentage, the vehicle method and type, the home office areas and whether owner occupied properties count in the position. Also says whether the user has allowed AI reading and which settings propose_settings_change can change. Settings are never changed here.
get_transaction
ChatGPTReads one transaction in full: date, amount, description, account, category, GST or property allocation, whether it has been reviewed, the documents attached to it, and a link to open it in Moniaro. Use an id from search_transactions.
get_year_end_figures
ChatGPTReads the year-end figures entered for one financial year in Moniaro Books or one tax year in Moniaro Property, the figures their financial statements are drawn up from. Moniaro Books: share capital, opening retained earnings, dividends paid, the GST and provisional tax overrides, imputation credits, the year-end balance of each business bank account, the shareholders' year figures and the company profile. Moniaro Property: the bank balance, rent receivable, rent in advance, accounts payable and loan balance at the end of the tax year, the land and buildings cost and any manual category figures, for the whole portfolio or one property. It says which values are still missing (missing), which Moniaro derived as suggestions (hints) and which ones propose_year_end_figures can set (settable). With no financialYear or taxYear it uses the last complete financial year or tax year. Ask the user for every missing value and never estimate one. Nothing changes.
list_bank_accounts
ChatGPTLists the bank accounts of the business with the account number masked to its last four digits, the account type, whether it is a business, personal or cash account, whether a bank feed is connected, and whether the account is switched on in each product this connection includes. Use the ids to filter transactions by account.
list_categories
ChatGPTLists the categories that transactions can be given in one product, with each one's full path, whether it is for income or expenses, whether it has no categories under it, its GST default (Moniaro Books) and its IR3R box (Moniaro Property). Use the ids when searching by category or preparing category changes.
list_chattels
ChatGPTLists the chattels (appliances, carpets, curtains, heat pumps and similar) registered for the rental properties, each with its property, type, purchase date and cost, depreciation method and rate, book value, depreciation so far and any disposal, and the chattel types with their depreciation rates as at today. Disposed chattels are left out unless asked for. Use it before propose_chattel to see what is already registered. Nothing changes.
list_documents
ChatGPTLists the business's receipts and invoices, newest first, with what Moniaro read from each, whether it is linked to a transaction and how well it matched. Use it to see what has been uploaded, then get_document for the detail.
list_missing_documents
ChatGPTLists expenses that have no receipt or invoice attached, with the ones that matter most first: in Moniaro Books the purchases with GST claimed and then the largest, in Moniaro Property the largest claim. Hidden rows, duplicates and transfers are left out. With no dates it covers the current financial or tax year. Use it to tell the user which documents to look for.
list_notes
ChatGPTLists the notes and questions on the business, newest first, with who wrote them, their status and the answer to a question once there is one. Use it to find out whether the user has answered what you asked. Each product contributes up to pageSize notes per page.
list_properties
ChatGPTLists the rental properties of the business with their address, whether each is owner occupied and whether it is active. Use the ids when searching or allocating transactions to a property.
list_proposals
ChatGPTLists proposal batches for the business, newest first: what is waiting for the user's review, what was applied and what failed. Each product contributes up to pageSize batches per page, and document and statement batches are listed with the product they belong to. Use it before retrying a write that timed out, to see whether it was prepared.
list_rules
ChatGPTLists the saved rules that categorise a product's transactions automatically, in priority order, with what each one matches and what it sets. Rules are changed in Moniaro, not here.
list_year_end_adjustments
ChatGPTLists the year-end adjustments entered in Moniaro Property for one tax year: home office, motor vehicle, phone and internet, cash expenses the owner paid personally, and other amounts, each with its property, category, amount, the inputs it was worked out from and any notes. Also describes the five adjustment types. With no taxYear it uses the current tax year by the business's financial year start month. Nothing changes.
preview_statement_import
ChatGPTChecks a bank statement file the user attached (OFX, QIF, CSV or PDF, up to 25 MB) without importing it: which account it belongs to, the rows, dates, money in and out, duplicates of transactions already in Moniaro, the statement's own balances and how it fits the dates already covered. Prepares a proposal: nothing changes until it is approved. The result carries batchId, version and contentHash for approve_proposal_batch, and a reviewUrl for the user. Summarise it for the user and ask before saving. If Moniaro cannot tell the account or the CSV columns, ask the user and call again with the same file and bankAccountId or csvMapping. PDF statements are read with AI. Uses AI reading; needs the user's AI permission in Moniaro.
propose_chattel
ChatGPTPrepares a new chattel for a rental property, a change to one, or the record that one was sold or thrown away (list_chattels shows what is registered and the chattel types). Use only values the user gave you or a document shows. Prepares a proposal: nothing changes until it is approved. A chattel is depreciated rather than claimed in one go, so it always needs the user's approval in Moniaro's review screen, never in the chat. Moniaro works out the depreciation.
propose_document_links
ChatGPTPrepares linking documents (receipts, invoices) to the transactions they belong to. Prepares a proposal: nothing changes until it is approved. Keep version and contentHash for approve_proposal_batch.
propose_duplicate_decision
ChatGPTPrepares flagging transactions as duplicates, or clearing the duplicate flag on transactions that Moniaro flagged but that are genuine. Prepares a proposal: nothing changes until it is approved. A transaction is never removed by this tool; to remove one use propose_transaction_deletion.
propose_new_transaction
ChatGPTPrepares one new transaction on a bank account, for money that never went through an imported statement or the bank feed (cash, a personal card paid for the business, an opening balance line). Use only values the user gave you. Prepares a proposal: nothing changes until it is approved. The user approves it in Moniaro's review screen, or in the chat when it is small enough; the result says which with agentConfirmable and notConfirmableReasons. For anything the bank already has, import the statement or use the bank feed instead, and never invent a transaction to make figures balance.
propose_property_details
ChatGPTPrepares a new rental property, or a change to one, in Moniaro Property: name and address, purchase date and cost, interest deductibility class, owners and their shares, and the other details get_property shows. For a change give only the details that change. Use only values the user gave you or a document shows, and ask for the rest. Prepares a proposal: nothing changes until it is approved. Property details shape the interest claim, the owner split and the financial statements, so they always need the user's approval in Moniaro's review screen, never in the chat.
propose_rule
ChatGPTPrepares a saved rule that files future transactions automatically, or a change to one of the user's own rules (list_rules shows them). Prepares a proposal: nothing changes until it is approved. A rule always needs review in Moniaro. Set applyToExisting to true only when the user wants the rule run over transactions already in Moniaro too; that part cannot be undone.
propose_settings_change
ChatGPTPrepares a change to one or more of the business's settings, for example the home office claim percentage or the vehicle business use (get_settings shows the current values and the names). Give only the settings to change; the rest keep their values. Prepares a proposal: nothing changes until it is approved. A settings change always needs the user's approval in Moniaro's review screen, never in the chat, because settings shape every figure the business reports. The AI permission is not a setting and cannot be changed this way.
propose_split
ChatGPTPrepares a split of one Moniaro Property transaction across categories and properties, for example a combined bill shared by two properties, or the removal of an existing split with an empty list. The parts must add up to the transaction amount exactly. Prepares a proposal: nothing changes until it is approved. A split always needs review in Moniaro.
propose_transaction_changes
ChatGPTPrepares changes to transactions as one batch for the user to review in Moniaro: a category, the GST treatment and amount or business use percentage (Moniaro Books), the property and claim percentage (Moniaro Property), and marking as reviewed. Prepares a proposal: nothing changes until it is approved. Show the user the summary and the reviewUrl. Keep version and contentHash: approve_proposal_batch needs them. Changes to values the user set by hand are prepared too, but they need review in Moniaro rather than in the chat.
propose_transaction_deletion
ChatGPTPrepares permanently deleting transactions (duplicates Moniaro did not catch, mistaken or test rows). Prepares a proposal: nothing changes until it is approved. Deletion is always approved by the user in Moniaro, never in the chat, cannot be undone, and is recorded in the business's activity.
propose_year_end_adjustment
ChatGPTPrepares a year-end adjustment for a rental tax year, or a change to one (list_year_end_adjustments shows what is entered, and calculate_year_end_adjustment works out the amount and suggests a category). Use only amounts the user gave you or Moniaro calculated. Prepares a proposal: nothing changes until it is approved. An adjustment shapes the figures the owner reports, so it always needs the user's approval in Moniaro's review screen, never in the chat.
propose_year_end_figures
ChatGPTPrepares the year-end figures of one financial year in Moniaro Books, for example share capital, opening retained earnings, dividends paid or the closing balance of a bank account, or of one tax year in Moniaro Property: the bank balance, rent receivable, rent in advance, accounts payable and loan balance at year end, the land and buildings cost or manual category figures (get_year_end_figures shows what is entered, what is missing and the names). Give only the figures to set; the rest keep their values. Use only values the user gave you or a document shows. Prepares a proposal: nothing changes until it is approved. Year-end figures shape the financial statements, so they always need the user's approval in Moniaro's review screen, never in the chat.
record_answer
ChatGPTRecords the user's answer to an open question, as they gave it in this conversation. Changes records: it only fills in the answer and marks the question answered; the user sees that it was relayed by the AI app. Never answer a question on the user's behalf.
review_period
ChatGPTReads an accountant-style review of a period in one product: whether each report's figures are ready, months with nothing imported and accounts that went quiet, transactions dated in the future, the same supplier treated two ways, categories that do not fit the money, unusually large amounts and payments with no document, transfers with no matching side, asset purchases and unpaid invoices, and for a whole year the year-end figures still missing. Each finding says how serious it is, what Moniaro found, where the rows are and which tool prepares the fix, and the review ends with questions for the user. Readiness and findings are drafts for the user to check, not a conclusion about the books. Tell the user the status first, work through the questions with them a few at a time, record each answer with add_note, prepare fixes with the propose_ tools and run the review again to see what is left. Nothing changes. Draft figures only: payments basis, no adjustments, Moniaro does not file returns.
run_report
ChatGPTReads a report from the business's records. It checks readiness first and returns it beside the figures, with the parameters used and links that open, or list through search_transactions, the transactions behind the main figures. Moniaro does the arithmetic: never add up, adjust or round figures yourself, and say the readiness status before quoting any figure. The by-category and by-month reports give totals per line; use the drilldowns to see the transactions. Draft figures only: payments basis, no adjustments, Moniaro does not file returns.
run_saved_rules
ChatGPTChanges records: runs the user's saved rules over their transactions now, filing the ones the rules match. Rules never touch transactions the user has reviewed. Give transaction ids or a date range, or neither to run over everything the rules may change. The answer says how many transactions changed and which rules did it. This is not a proposal and has no review step, so only call it when the user asked for the rules to be run.
search
ChatGPTSearches the business's transactions, documents, open proposal batches, properties and reports for the words given and returns the best matches, each with an id to pass to fetch, a title and a link to open it in Moniaro. Use search_transactions instead when you need filters, totals or more than the top matches.
search_transactions
ChatGPTSearches the transactions of the business by text, dates, accounts, category, status, direction and amount, newest first, and returns one page with totals (count, money in, money out, net) over every match, not only the page. Amounts are New Zealand dollars with money out negative; dates are New Zealand dates. Use it to find transactions before reading one or preparing changes; page through with page and pageSize.
submit_document
ChatGPTAdds a receipt or invoice the user attached (PDF, PNG or JPEG, up to 10 MB) to the business's documents, with what you found out about it and where you found it. Give the supplier, date, total and GST you read from it: with a total and a date Moniaro uses your figures as the document's details, does not read the file itself, and links the document to its bank transaction when exactly one transaction has that total close to that date. Without them Moniaro reads the document itself, flags any place its reading differs from your claims, and finds the transaction it belongs to. Use get_document to see the result. The same file sent twice is stored once. Changes records: it adds this document and may link it to the one bank transaction that matches (the user can unlink it in Moniaro); nothing else on any transaction is changed. Uses AI reading; needs the user's AI permission in Moniaro. A document you give a total and a date for needs no reading and no permission; without the permission any other document is kept but not read.
suggest_categories
ChatGPTAsks Moniaro to suggest categories for uncategorised transactions, as the user's own AI categorisation would, and collects the suggestions into a proposal batch for the user to review. Give transaction ids (at most 500) or a date range, or neither for the uncategorised transactions Moniaro finds. Transactions the user categorised or reviewed are left out. Prepares a proposal: nothing changes until it is approved. Uses AI reading; needs the user's AI permission in Moniaro. The answer is a job: follow it with get_job_status until it finishes, then read the batchId in its result with get_proposal_batch.
undo_proposal_batch
ChatGPTChanges records: puts back the values a batch changed, as they were before it was approved. Anything that changed again since is left as it is and listed in conflicts. Only batches approved in the chat can be undone here; others are undone in Moniaro. Only call after the user has said yes to this exact batch.
withdraw_proposal_batch
ChatGPTWithdraws a proposal batch this connection prepared, so it can no longer be approved. Changes records: permanently cancels the prepared batch; existing transactions and documents stay unchanged. Use it when the user changes their mind or the batch was wrong, then prepare a new one.