bank_balances
ChatGPTCurrent balance for every bank account on the active team (банкови салда, наличности по банкови сметки, парични средства в банка). Returns each account with its IBAN so accounts at the same bank/currency can be told apart, plus server-computed per-currency totals — NEVER add balances across currencies and never sum rows yourself; answer aggregate questions from totals. Optionally filter by name substring or currency code.
cancel_accounting_treatment_rule_change_draft
ChatGPTDiscard a pending supplier-treatment rule change previewed with change_accounting_treatment_rule_draft. The current rule stays as it is and no accounting data changes.
cancel_accounting_treatment_rule_disable_draft
ChatGPTDiscard a pending preview from disable_accounting_treatment_rule_draft. The rule stays active and keeps being used in future document reviews; no accounting data changes.
cancel_accounting_treatment_rule_draft
ChatGPTDiscard a pending new supplier-treatment rule previewed with create_accounting_treatment_rule_draft, without saving the rule or changing accounting data.
cancel_bill_draft
ChatGPTDiscard a pending bill preview without posting anything to the books.
cancel_bill_update_draft
ChatGPTDiscard a pending bill-update preview without applying any changes.
cancel_expense_draft
ChatGPTDiscard a pending expense preview without posting anything to the books.
cancel_invoice_draft
ChatGPTDiscard a pending invoice preview without posting anything to the books. Requires the draft_id and the action_token returned by the create_invoice_draft response; both are mandatory and cannot be guessed or omitted.
cancel_invoice_payment_draft
ChatGPTDiscard a pending customer-payment preview without posting anything to the books. Requires the draft_id and the action_token returned by the record_invoice_payment_draft response; both are mandatory and cannot be guessed or omitted.
cancel_invoice_update_draft
ChatGPTDiscard a pending invoice-update preview without applying any changes. Requires the draft_id and the action_token returned by the update_invoice_draft response; both are mandatory and cannot be guessed or omitted.
cancel_ocr_document_removal_draft
ChatGPTKeep the duplicate OCR upload in the queue and cancel its removal draft.
change_accounting_treatment_rule_draft
ChatGPTPrepare a change to one active supplier accounting treatment rule: a new inventory item, purchase account or VAT treatment for the same supplier and line description. Find the rule with list_accounting_treatment_rules. On confirmation the current rule is retired and its successor is used in future document reviews; posted bills and journal entries are not changed. Nothing is saved until the user explicitly confirms with confirm_accounting_treatment_rule_change. A preview changes no saved data and never changes or cancels another preview. To change a preview, make a new one with all its values and cancel the old one with the matching cancel tool.
confirm_accounting_treatment_rule_change
ChatGPTApply a supplier-treatment rule change previewed with change_accounting_treatment_rule_draft, after the user explicitly approves it. The current rule is retired and its successor is used in future document reviews. Posted bills and journal entries are not changed.
confirm_accounting_treatment_rule_disable
ChatGPTStop using a supplier-treatment rule, as previewed with disable_accounting_treatment_rule_draft, after the user explicitly approves it. Future document reviews no longer apply the rule; it stays in the history as disabled, and posted bills and journal entries are not changed.
confirm_accounting_treatment_rule_draft
ChatGPTSave a new NULA supplier-treatment rule previewed with create_accounting_treatment_rule_draft, after the user explicitly approves it. This teaches future document reviews and does not post a bill or journal entry.
confirm_bill_draft
ChatGPTPost a previewed incoming bill to the books. Use this only after the user has reviewed and approved the preview from create_bill_draft.
confirm_bill_update
ChatGPTApply the previewed changes to an existing bill. Use this only after the user has reviewed and approved the preview from update_bill_draft.
confirm_expense_draft
ChatGPTPost a previewed cash expense to the books. Use this only after the user has reviewed and approved the preview from log_expense_draft.
confirm_invoice_draft
ChatGPTPost a previewed outgoing invoice to the books. Use this only after the user has reviewed and approved the preview from create_invoice_draft. Requires the draft_id and the action_token returned by that create_invoice_draft response; both are mandatory and cannot be guessed or omitted.
confirm_invoice_payment
ChatGPTCommit a record_invoice_payment_draft. Re-validates the draft against current state (invoice ownership, currency match, status, fiscal year, amount), re-checks the invoice target fingerprint, then posts the BankTransaction + journal entry and transitions the invoice status. Returns the same shape as record_invoice_payment. Requires the draft_id and the action_token returned by that record_invoice_payment_draft response; both are mandatory and cannot be guessed or omitted. Bookkeeping only: it records a payment the customer already made and moves no money.
confirm_invoice_update
ChatGPTApply the previewed changes to an existing invoice. Use this only after the user has reviewed and approved the preview from update_invoice_draft. Requires the draft_id and the action_token returned by that update_invoice_draft response; both are mandatory and cannot be guessed or omitted.
confirm_ocr_document_removal_draft
ChatGPTConfirm removal of one selected OCR purchase from the queue without changing any existing purchase or journal entry.
create_accounting_treatment_rule_draft
ChatGPTPrepare a new supplier accounting treatment rule: which inventory item, purchase account and VAT treatment future purchase lines with this description from this supplier receive. Consumer-facing references such as supplier name, invoice number, item name, and account number are resolved within the selected company. Nothing is saved until the user explicitly confirms with confirm_accounting_treatment_rule_draft. To change an existing rule use change_accounting_treatment_rule_draft; to stop using one, disable_accounting_treatment_rule_draft. A preview changes no saved data and never changes or cancels another preview. To change a preview, make a new one with all its values and cancel the old one with the matching cancel tool.
create_bill_draft
ChatGPTPreview an incoming bill from a vendor before posting. Pass an exact purchase:<id> document_key to build the draft from a reviewed OCR document without copying fields. OCR-backed drafts preserve the source attachment and accounting preview and can be confirmed after explicit approval when posting_available=true. Manual drafts can also be confirmed through the existing flow. A preview changes no saved data and never changes or cancels another preview. To change a preview, make a new one with all its values and cancel the old one with the matching cancel tool.
create_invoice_draft
ChatGPTPreview an outgoing invoice before posting. Builds the invoice so the user can review the customer, totals, VAT, due date, and line items, and only commits to the books when the user confirms. Use this whenever the user is creating an invoice — never post in one step. Omit number unless the user asked for a specific invoice number: the number shown in a preview is only the expected next number. A preview changes no saved data and never changes or cancels another preview. To change a preview, make a new one with all its values and cancel the old one with the matching cancel tool.
create_journal_entry
ChatGPTPost a manual double-entry accounting article (journal entry / счетоводен запис) to a company's books. Provide a posting date, a memo, and balanced debit and credit lines — total debit must equal total credit, and one side must have a single line (one debit to many credits, or many debits to one credit; split a many-to-many posting into several entries). Each line references an account by its number (from get_chart_of_accounts / search_accounts) and a positive amount in the company currency. Requires accounting-edit permission.
create_ocr_document_removal_draft
ChatGPTPrepare removal of one selected OCR purchase from the accounting queue. This removes only the uploaded OCR source and never changes an existing purchase or journal entry. A preview changes no saved data and never changes or cancels another preview. To change a preview, make a new one with all its values and cancel the old one with the matching cancel tool.
disable_accounting_treatment_rule_draft
ChatGPTPrepare to stop using one supplier accounting treatment rule in future document reviews. Find the rule with list_accounting_treatment_rules. The rule stays in the history as disabled; posted bills and journal entries are not changed. Nothing is saved until the user explicitly confirms with confirm_accounting_treatment_rule_disable. A preview changes no saved data and never changes or cancels another preview. To change a preview, make a new one with all its values and cancel the old one with the matching cancel tool.
export_report
ChatGPTGenerate a downloadable accounting-report file (експорт на счетоводна справка към Excel или PDF — сваляне на баланс, ОПР, отчет за собствения капитал, ОПП, дълготрайни активи, оборотна ведомост, главна книга, хронологичен регистър, амортизационен план, амортизационна квота, инвентарна книга, дневник на продажбите, дневник на покупките, аналитичен регистър, аналитична ведомост, отворени позиции по сметка, справка продажби, доставки, оборот на стоково-материални запаси, среднопретеглена стойност като файл). Returns the real NULA product export file. Generation is asynchronous: the response is either status="ready" with a download_url, or status="pending" with an export_id to poll via get_report_export_status. Supported report_type: balance_sheet, income_statement, cash_flow_statement, statement_of_equity, long_term_assets, trial_balance, main_book, chronological_register, depreciation_schedule, depreciation_report, asset_register, sales_register, purchases_register, account_transactions, daily_account_movements, account_open_items, sales_report, deliveries_report, inventory_movements, average_values_report. Point-in-time reports (balance_sheet, statement_of_equity) need as_of; account_open_items (отворени позиции по точна сметка и всички аналитичности) needs account_number + as_of. Period reports (income_statement, cash_flow_statement, long_term_assets, trial_balance, main_book, chronological_register) need date_from and date_to. daily_account_movements (аналитична ведомост — per-day opening/turnover/closing balances of one account or group) takes account_number + date_from + date_to and optional group_by_month. main_book (главна книга) and sales_report (справка продажби — invoice-line sales list, NOT the VAT дневник на продажбите) are excel-only. sales_report takes date_from and date_to, optional account_number (701 = 701 и подсметките ѝ, 70 = цялата група) and optional group_by: "item" for the количествено-стойностна справка по артикули (по количество и стойност за всеки артикул), "account" for the справка, обобщено по сметка. depreciation_schedule and asset_register take as_of; depreciation_report takes year; without them they are drawn up at the company's last depreciation run (its year for depreciation_report). depreciation_schedule and depreciation_report accept is_tax (tax vs accounting); asset_register accepts an optional tag. The VAT registers (sales_register, purchases_register) take month (1-12) and year. account_transactions (аналитичен регистър) takes account_number (exact number or group prefix like 70) plus date_from and date_to. chronological_register accepts optional debit_account / credit_account filters (дебит 503 / кредит 411). Pass language ("bg" or "en") to control the file language — default it to the conversation language and honor explicit user requests.
get_account_balances
ChatGPTClosing balance and period turnover for SPECIFIC accounting accounts, for ONE OR MANY companies in a single call (крайно салдо по сметка към дата, салда по сметки, обороти по сметка, дебитен/кредитен оборот, справка по сметки за няколко фирми едновременно). THE tool for questions like "какво е салдото по сметка 501 към 30.06 за тези 10 фирми" or "дебитен оборот по 425 за юни" — never derive balances from ledger-line listings or turnover-only reports. Returns per company × per account: opening balance, debit/credit turnover, closing balance. Accepts exact account numbers (501) or group prefixes (70 = whole group). An account missing from a company's chart is flagged found=false — that is NOT a zero balance. Balances are cumulative from the fiscal-year start of as_of unless date_from is given.
get_account_open_items
ChatGPTOpen ledger positions under one EXACT accounting account and all of its analytical descendants (отворени позиции по сметка и аналитичностите ѝ, вземания по 411, задължения по 401 според оборотната ведомост). This is the ledger/trial-balance source of truth for a specific account as of a date, not an invoice-status list. It returns invoice- and bill-linked positions when available, plus imported balances, direct root or intermediate balances, and generic analytical positions that have no linked document. Use it when the user asks for the remaining balance under 411/401 and its analytics. Answer totals from totals, never by summing one page. Follow next_cursor until has_more=false; if reconciliation.reconciled=false, report the discrepancy instead of presenting the positions as a complete reconciliation. For a complete Excel or PDF file, call export_report with report_type="account_open_items", the same exact account_number and as_of date.
get_account_transactions
ChatGPTList posted transactions for one accounting account OR an account group/section over a date range — the analytical/chronological ledger (аналитичен регистър, аналитичен регистър на сметка или група, движения по сметка, група 70, раздел 7, account ledger). Accepts an exact account number (501) or a 1-2 digit group/section prefix (70, 7) that aggregates all matching accounts. Returns bounded ledger lines with post date, debit, credit, memo, and first counterparty account when available. The response includes server-computed totals (debit/credit turnover over ALL transactions in the period, not just the returned page) — ALWAYS answer turnover/aggregate questions from totals, never by summing rows.
get_accounting_document_file
ChatGPTFetch a short-lived signed URL for the original PDF or image attached to an OCR accounting document. Pass the exact document_key returned by list_accounting_documents_for_review. The URL is valid for 15 minutes and live access is checked again when downloaded.
get_accounting_document_review
ChatGPTGet the normalized OCR review model for one purchase or sales document before accounting. Purchase reviews include deterministic proposals from active explicit rules and verified history, alternatives, evidence, conflicts, and a balanced journal preview when all mappings resolve. Pass the exact document_key returned by list_accounting_documents_for_review. This is read-only and does not save, post, or modify accounting data.
get_ap_aging_report
ChatGPTAccounts Payable aging (задължения по падеж) — open vendor bills bucketed by days past due (current, 1-30, 31-60, 61-90, 90+) as of a date. Totals are reported per settlement currency and never summed across currencies. Also lists the largest open payables so you can plan supplier payments.
get_ar_aging_report
ChatGPTAccounts Receivable aging (вземания по падеж) — open customer receivables bucketed by days past due (current, 1-30, 31-60, 61-90, 90+) as of a date. Totals are reported per settlement currency and never summed across currencies. Also lists the largest open items so you can prioritise collections.
get_asset_details
ChatGPTFull detail for a single fixed asset (дълготраен актив): acquisition cost, accumulated depreciation, current book value, НСС category, useful life, acquisition date, last depreciation date and currency. Acquisition cost, accumulated depreciation and book value are the figures the NULA asset page shows for the user's selected fiscal year: valued at the last depreciation booked in that year (as_of; 31.12 when none was booked), in that year's reporting currency (BGN up to 2025, EUR from 2026) returned in currency; an asset disposed of by the end of that year has a book value of 0. Always state as_of when quoting the figures. last_depreciation_date is the last depreciation posted for this asset; company_last_depreciation_date is the end of the company's last depreciation run.
get_asset_register
ChatGPTAsset inventory book (инвентарна книга) as of a date, the company's last depreciation run unless as_of is given, or the assets as entered when no depreciation was ever run (as_of, dated_at, last_depreciation_date, dating_note) — per asset: acquisition value, total annual depreciation, end-of-depreciation date and accounting journal, plus the grand total. total_amount and asset_count cover EVERY asset in the book as of that date, while the assets listing is capped at limit rows — answer "how many assets / what is the total" from those two fields, never by counting or summing the returned rows. Money is reported in the company reporting currency for the period.
get_balance_sheet
ChatGPTBalance Sheet (Счетоводен баланс) for a company as of a date — assets, liabilities, and equity, cumulative from the start of the as-of date's fiscal year. Returns statement lines (code, label, level, amount) in the company reporting currency. Provide as_of (YYYY-MM-DD).
get_bill
ChatGPTFetch a single supplier bill by id within the active team (фактура от доставчик, покупна фактура, разходна фактура). Returns a flat summary, line items, and posted accounting entries.
get_bill_pdf
ChatGPTFetch a download URL for the PDF on file for a bill the team received (свали фактура от доставчик като PDF, изтегли разходен документ). Bills are vendor-supplied documents — this returns the PDF that was uploaded with the bill. If no PDF is on file, returns a clean message saying so. The URL is signed and valid for 15 minutes.
get_cash_flow_statement
ChatGPTCash Flow Statement (Отчет за паричните потоци, ОПП) for a company over a period — operating, investing, and financing activities. Returns statement lines (code, label, level, amount) in the company reporting currency. Provide date_from and date_to (YYYY-MM-DD).
get_chart_of_accounts
ChatGPTList the company chart of accounts (сметкоплан, индивидуален сметкоплан, списък на счетоводните сметки). Returns account number, name, and cached current balance in the company reporting currency. Optionally filter by account-number prefix.
get_company_key_figures
ChatGPTKey financial figures of ONE company per closed calendar year, for screening companies against thresholds the user gives (категория по чл. 19 ЗСч — микро/малко/средно/голямо, SAF-T, регистрация по ДДС и др.). For a portfolio, call it once per company (team ids from list_teams). Per year, in EUR (years kept in BGN are converted at the fixed 1.95583, like the web report in EUR): net_revenue = the income statement line „Нетни приходи от продажби“ exactly as the web ОПР shows it; total_assets = „Сума на актива“ of the balance sheet at 31.12; average_staff = average monthly number of staff on employment contracts in the payroll statements kept in Nula (part-time by their share of full time, the year's sum divided by 12; payroll_months = months with a statement); nap_net_receipts (taxes and social security paid to НАП minus refunds) is not computed by Nula and is always null. Also the legal form and the current VAT registration status. A figure Nula cannot support is null with its reason in missing — never read a null as zero. Reasons: year_not_closed, no_postings_in_year (Nula has neither postings in that year nor balances brought into it), no_payroll_in_nula, not_computed, not_tracked_in_nula (Nula does not keep the VAT registration date), not_in_company_record, report_line_missing, unsupported_currency, country_not_set, time_budget_exceeded (ask again for fewer years), computation_failed.
get_counterparty_balance
ChatGPTСалдо на контрагент — клиент или доставчик — от счетоводството към дата, по аналитичност, както е в оборотната ведомост на NULA (салдо на контрагент, салдо на доставчик, салдо на клиент, какво дължи, какво му дължим, разлика между двете салда). Контрагентът се търси по име (цяло или част от него, на кирилица или латиница) или по ЕИК / ДДС номер. За всяка разчетна сметка, под която контрагентът има аналитичност — 401 Доставчици, 411 Клиенти и другите сметки от група 4, ако има — връща крайното салдо със страната му (дебит или кредит) към края на as_of, със същото изчисление като оборотната ведомост за периода от 1 януари до as_of. В totals: колко той дължи на нас (дебитните салда), колко ние му дължим (кредитните салда) и разликата между тях. Отговаряй от totals, не събирай редовете сам. Ако търсенето съвпада с няколко контрагента, отговорът е result=multiple_matches със списък за избор, без салда и без сбор: попитай потребителя кой от тях има предвид и извикай отново със същия counterparty и counterparty_key на избрания. Салдата са от счетоводството, не от статуса на фактурите; отделните фактури под аналитичността дава get_account_open_items.
get_current_draft_audit
ChatGPTExplain the decisions made on the current pending draft in plain business language. Use this when the user asks why a draft looks the way it does, or to review auto-resolved choices (e.g. which bank account, which inventory item) before confirming.
get_depreciation_report
ChatGPTDepreciation quota report (амортизационна квота) — the monthly and annual depreciation booked per asset, broken down by year and month, for the year of the company's last depreciation run unless year is given, or the year the assets stand as entered when no depreciation was ever run (dated_at, last_depreciation_date, dating_note). Pass is_tax=true for the tax (данъчна) quota; defaults to the accounting (счетоводна) quota. Money is reported in major units in the asset reporting currency.
get_depreciation_schedule
ChatGPTDepreciation schedule (амортизационен план) as of a date — per asset: depreciable value, accrued (accumulated) depreciation, remaining book value, year-to-date depreciation, useful life and annual rate, plus per-currency totals, drawn up at the company's last depreciation run unless as_of is given, or the assets as entered when no depreciation was ever run (as_of, dated_at, last_depreciation_date, dating_note). Pass is_tax=true for the tax (данъчен) schedule; defaults to the accounting (счетоводен) schedule. Money is reported per currency.
get_draft_status
ChatGPTCheck whether the user has a pending draft ready to confirm. Returns a short business-language status (none / one ready / multiple pending). Use this when the user asks "do I have anything in flight?" or before suggesting they start a new draft.
get_fixed_assets_inventory
ChatGPTFixed-assets inventory list (инвентаризационен опис на ДМА) as of a date, the company's last depreciation run unless as_of is given, or the assets as entered when no depreciation was ever run (as_of, dated_at, last_depreciation_date, dating_note) — per asset: accounting journal, acquisition value, accumulated depreciation, book value, depreciation charged this year and end-of-depreciation date. Only assets acquired by that date and not disposed of before it are included. asset_count and totals (per column, per currency) cover EVERY asset in the list, while the assets listing is capped at limit rows — answer "how many / what is the total" from those fields, never by counting or summing rows. Money is reported in the reporting currency of the date (BGN up to 2025, EUR from 2026).
get_income_statement
ChatGPTProfit & Loss / Income Statement / P&L (Отчет за приходите и разходите, ОПР) for a company over a period. This is the single source for any REVENUE, INCOME, EXPENSE, COST, or PROFIT figure, including individual expense or income line items such as "outside services" (външни услуги), materials, raw materials, personnel/salary costs, depreciation, other operating expenses, net sales revenue, financial income/expenses, and the resulting profit or loss. Returns the statement lines — code, label, hierarchy level, and amount — in the company reporting currency. Figures are net accounting amounts derived from the posted double-entry ledger. Use this (NOT journal entries or the trial balance) whenever the user asks for a specific expense, cost, revenue, or income line over a date range. Provide date_from and date_to (YYYY-MM-DD).
get_inventory_batch_stock
ChatGPTBatch quantities in ONE company warehouse as of a date. Requires read-bills. Uses dated opening balances and movements at that warehouse. Each row is a distinct batch; duplicate lot numbers are not combined. Zero-quantity batches with historical activity are included. For accounting value use get_inventory_stock; for transaction history use list_warehouse_movements.
get_inventory_stock
ChatGPTStock quantities and accounting value in ONE warehouse as of a date. Select a warehouse by location_id; if omitted, returns accessible warehouse choices. Rows use the same opening balances, transactions, and currency conversion as the NULA warehouse report. totals cover the returned page; when has_more is true they are not totals for the entire filtered warehouse. Never add quantities across different units.
get_invoice
ChatGPTFetch a single invoice by id within the active team (фактура към клиент, продажна фактура, изходяща фактура). Returns a flat summary plus line items (what was invoiced — name, quantity, price, description).
get_invoice_pdf
ChatGPTFetch a fresh download URL for an invoice PDF in the active team (нов линк за сваляне, свали фактура като PDF, изтегли фактурата, фактура в PDF). Resolve it by invoice_number and optional customer_name when the user provides consumer-facing details; invoice_id is supported only when copied from list_invoices. The URL is signed and valid for 15 minutes.
get_journal_entry
ChatGPTFetch one posted journal entry with its debit and credit lines (счетоводен запис, счетоводна статия, мемориален ордер). Lines include account number, account name, debit, and credit in major units. account_name is always the name of the GL account itself; when a line posts to a per-document analytic sub-account, that sub-account's narration is reported separately as line_detail — it is not the account name and often repeats the entry memo.
get_long_term_assets_report
ChatGPTLong-term assets statement (справка за дълготрайните активи, part of the annual financial statements / ГФО) for a period — per asset group (intangible, tangible, financial, deferred taxes, and the grand total of all four in total) its cost at the beginning, receipts, disposals, cost at the end, revaluation, depreciation at the beginning, accrued, written off and at the end, and the carrying amount at the end (the 15 columns of the official form, named in columns). Defaults to 1 January to the company's last depreciation run of that year, or the assets as entered when no depreciation was ever run (dated_at, last_depreciation_date, dating_note). Rows that are zero in every column are left out (zero_rows_omitted). Money is in the company reporting currency of the period unless currency is given.
get_management_report
ChatGPTManagement / budget-vs-actuals reports — user-defined report templates (custom rows of accounts × period columns, e.g. budget vs actual, month-over-month). Call without report_id to list the saved templates for the company; call with report_id to run one and get its computed grid (columns with periods, rows with a value per column). Money values are in the company currency.
get_purchases_register
ChatGPTPurchases VAT register / дневник на покупките for a monthly tax period — the per-document list of received bills that feed the VAT return. Each row carries the document's NAP cell codes and values (taxable base, input VAT with full/partial/no credit). Use columns to interpret the cell codes. The response includes server-computed totals (per money column, over ALL rows in the period) and a summary with the period's taxable bases and input VAT — ALWAYS answer aggregate questions from totals/summary, never by summing the paginated rows. Provide month (1-12) and year. Rows are paginated.
get_report_export_status
ChatGPTCheck the status of an accounting-report export started by export_report (проверка на статуса на експорта на справка). Returns status="pending"|"processing"|"ready"|"failed"; when "ready" it includes a fresh download_url.
get_sales_register
ChatGPTSales VAT register / дневник на продажбите for a monthly tax period — the per-document list of issued sales that feed the VAT return. Each row carries the document's NAP cell codes and values (taxable base, VAT charged, exempt/zero-rated amounts). Use columns to interpret the cell codes. The response includes server-computed totals (per money column, over ALL rows in the period) and a summary with the period's total taxable base and total VAT charged — ALWAYS answer aggregate questions from totals/summary, never by summing the paginated rows. Provide month (1-12) and year. Rows are paginated.
get_sales_report
ChatGPTСправка продажби (sales report, Бизнес > Справка продажби) за фирма и период — продадените артикули по редове от фактури: дата, документ, сметка за продажба, код и име на артикула, мерна единица, клиент, количество, единична цена и стойност в основната валута. За количествено-стойностна справка по артикули (по количество и стойност за всеки артикул) подай group_by="item"; за справка, обобщено по сметка за продажба — group_by="account". account_number ограничава справката до една сметка: 701 включва 701 и подсметките ѝ (701/…), 70 — цялата група. totals са сборовете за целия период, изчислени на сървъра: отговаряй на въпроси за общо количество и стойност само от тях и никога не сумирай редове или групи сам. Количествата се събират само в рамките на една мерна единица (totals.by_unit) — никога не събирай м2, MWh, брой и т.н. в едно число. Без проформи и анулирани документи, както уеб справката. За Excel файл със същите редове или същото обобщение използвай export_report с report_type="sales_report" и същите group_by и account_number.
get_trial_balance
ChatGPTTrial Balance (оборотна ведомост) for a company over a period — for each account that moved in the period: opening balance, debit turnover, credit turnover, closing balance, in the company reporting currency. Total debit turnover equals total credit turnover (balanced double-entry). Accounts are returned largest-turnover first. Use before period close to spot anomalies. Provide date_from and date_to (YYYY-MM-DD).
get_vat_register_counts
ChatGPTNumber of entries (брой записи) in the purchases and sales VAT registers (дневник покупки / дневник продажби) for ONE OR MANY companies for a monthly tax period, plus their sum per company and across all companies. THE tool for "колко записа има в дневниците", "брой документи по ДДС дневници за всички фирми", "кои дружества имат над 120 записа", billing an accounting firm's clients by register volume. Pass every target company in one call (up to 500 team ids from list_teams) and never split the list yourself; the server reports as many companies as fit its time budget and returns the rest in remaining_team_ids. Companies not registered for VAT are listed in not_vat_registered instead of being shown as zero. The counts equal the total of get_purchases_register and get_sales_register for the same company and month.
get_vat_return
ChatGPTVAT return / ДДС справка-декларация for a monthly tax period (Bulgarian VAT is filed monthly). Returns the declaration cells — code, label, value — covering taxable bases, output VAT charged, input VAT credit, and the VAT payable or refundable for the period. Every amount in fields is in currency (ISO 4217 code), the currency the return for that month is kept in: BGN for periods before 01.01.2026, EUR from 01.01.2026 for a Bulgarian company. Read it from the response instead of assuming the company's current currency, and compare these amounts with another report only when both are in the same currency. Provide month (1-12) and year. To cover a quarter, call once per month and sum. A company that is not registered for VAT has no VAT return: the tool answers error="not_vat_registered" instead of a declaration, and that answer means no return is due for the period — never present it as a zero declaration. A month that has not begun is not a tax period either: it answers error="period_not_started", which means the question is invalid, NOT that the return is zero. When a declaration IS returned, period_status says whether the month is closed (final) or still in_progress (provisional), declaration_filed says whether a declaration is actually stored for the period. When every cell is zero, zero_reason says WHY: "unfinished_period" (the month is not over), "filed_nil_return" (a stored declaration reports nil), or "no_records" (nothing is recorded for the period at all — an absence of records, NOT a reported nil position and NOT proof that nothing was due). Read these as different statements; all of them used to look like the same all-zero form.
get_vies_return
ChatGPTVIES return / VIES декларация for a monthly tax period — the per-document list of intra-community supplies (sales to VAT-registered counterparties in other EU member states) reported to NAP alongside the VAT return. Each row carries the document's NAP cell codes and values. Use columns to interpret the cell codes. The response includes server-computed totals (per money column, over ALL rows in the period) — ALWAYS answer aggregate questions from totals, never by summing the paginated rows. Provide month (1-12) and year. Rows are paginated. An empty rows set means no intra-community supplies for the period.
list_accounting_documents_for_review
ChatGPTList all active OCR purchase and sales documents waiting for final accounting save in Nula. Pass one team_id, or scope=all_accessible for one globally paginated queue across every live company this connection may read. Saving OCR fields does not remove a document from this queue; creating the Bill or Invoice does. The list includes every OCR extraction state. Use document_key and its team.id from this response with get_accounting_document_review. Results omit extracted OCR text and storage paths.
list_accounting_treatment_rules
ChatGPTList persisted supplier accounting treatment rules and their lifecycle lineage. Use this before change_accounting_treatment_rule_draft or disable_accounting_treatment_rule_draft to resolve the exact active rule id.
list_bank_transactions
ChatGPTLatest bank transactions for ONE bank account from the Banking module — the real bank-feed movements (банкови транзакции, движения по банкова сметка, извлечение, последни плащания по сметката), NOT accounting ledger entries. The user MUST specify which bank account first: pass iban (preferred, from bank_balances), account_id, or account_name; when the account is not specified or several accounts match, show the user the accounts by IBAN and ask which one they mean — IBAN is the identifier users recognise, account_id is internal. Returns the most recent transactions with date (the bank booking date — the same date Nula shows in its bank and reconciliation screens; use it whenever you cite a transaction date), value_date (the operation date — for card/POS payments it is usually 1–2 days before date, and the exact time often appears inside the description), counterparty/description, amount, direction (incoming/outgoing), currency, and whether the transaction is booked/reconciled in accounting, plus server-computed totals (incoming/outgoing/net over the returned window) — ALWAYS answer aggregate questions from totals and the account balance, never by summing rows.
list_bills
ChatGPTList supplier bills (accounts payable; задължения към доставчици, фактури от доставчици, покупни фактури) for the active team, filtered by number, status, vendor, or date range. status=unpaid is a derived predicate for every not-fully-paid bill (the full open-payables set, regardless of due date). status=overdue narrows that to unpaid + past due_at. The response includes has_more (true when further pages exist) and next_cursor — to capture ALL results, pass next_cursor back as cursor until has_more is false; do NOT walk with page, which can silently skip a bill when documents are written between two calls. The response also includes server-computed totals (document totals per currency over the ENTIRE filtered set, not just the returned page) — ALWAYS answer aggregate questions from totals, never by summing rows. For REMAINING amounts owed (partially-paid aware) use get_ap_aging_report. To MIRROR bills into another system, use updated_since instead of a date range: it sweeps by modification time, so a document entered or corrected today but dated earlier is still seen, and it is the only mode that reports DELETED bills (as a tombstone) — without it a mirror can never learn a bill was removed. It excludes totals and refuses the other filters — walk it with next_cursor, checkpoint on the highest updated_at, and upsert by id. During the one repeated hour of the autumn DST rollback the stored local time is ambiguous; overlap that checkpoint by an hour, or rely on the upsert.
list_fixed_assets
ChatGPTThe company's fixed-asset list (дълготрайни активи) exactly as the NULA Assets page shows it for the user's selected fiscal year: number, name, НСС category with its default rate, acquisition date, acquisition cost, accumulated depreciation and residual (book) value, plus whether the asset is active, sold or written off. Every amount is valued at the last depreciation booked in that fiscal year (as_of; 31.12 when none was booked) in that year's reporting currency (BGN up to 2025, EUR from 2026); an asset disposed of by the end of that year has a residual value of 0. Always state as_of when quoting the figures, and last_depreciation_date (the end of the company's last depreciation run, null when none was run) when asked how current they are. Ordered by asset number, highest first, like the page. Filter by name/number, tag, category, acquisition year or date range, and active/sold/written off. total counts every matching asset; the per-currency totals cover only the RETURNED rows — answer aggregate questions from totals, never by summing rows; for the authoritative full register with grand total use get_asset_register.
list_inventory_items
ChatGPTList products and materials in one company inventory catalog, including SKU, unit, and tracking flags. Search by name, SKU, or barcode. This is a catalog, not a stock balance; use get_inventory_stock for quantities and value in a warehouse.
list_invoices
ChatGPTList invoices (фактури към клиенти, продажни фактури, вземания от клиенти) for the active team, filtered by number, status, customer, or date range. status=unpaid is a derived predicate for every open receivable (issued + not fully paid, regardless of due date; unissued drafts, proformas and credit notices excluded). status=overdue narrows that to past-due receivables. The response includes has_more (true when further pages exist) and next_cursor — to capture ALL results, pass next_cursor back as cursor until has_more is false; do NOT walk with page, which can silently skip an invoice when documents are written between two calls. Results are flat summaries — call get_invoice for full detail. The response includes server-computed totals (document totals per currency over the ENTIRE filtered set, not just the returned page) — ALWAYS answer aggregate questions from totals, never by summing rows. For REMAINING amounts owed (partially-paid aware) use get_ar_aging_report. To MIRROR invoices into another system, use updated_since instead of a date range: it sweeps by modification time, so a document entered or corrected today but dated earlier is still seen. It excludes totals and refuses the other filters — walk it with next_cursor, checkpoint on the highest updated_at, and upsert by id. During the one repeated hour of the autumn DST rollback the stored local time is ambiguous; overlap that checkpoint by an hour, or rely on the upsert.
list_journal_entries
ChatGPTList posted journal entries for a company over a date range (счетоводни записи, журнал на операциите, статии, дневник на операциите). Returns bounded journal groups with post date, memo, and total debit in major units, plus server-computed totals (entry count and debit turnover over ALL entries in the period, not just the returned page) — ALWAYS answer aggregate questions from totals, never by summing rows.
list_teams
ChatGPTList the companies this connection can act on. Always call this first. Each row includes: company_name (the legal name of the company — this is the name the user sees in NULA and the one they will call it by; it can differ from name/display_name, which are the team's own labels; null when the team has no company), default_currency (the company's invoicing currency this fiscal year), default_currency_for_year (a 3-year map — Bulgarian companies switch BGN→EUR on 2026-01-01), company_eik (legal identifier / ЕИК / БУЛСТАТ), vat_id (VAT registration number, null when not VAT-registered), and is_vat_registered (whether the company is VAT-registered). IMPORTANT: when more than one company is returned, active_team_id is null and requires_team_selection is true — there is NO default company. Ask the user which company they mean and pass its id as team_id on every call; do not guess. Only when a single company is returned is it the implicit default.
list_vendors
ChatGPTList vendors for the active team (доставчици, контрагенти-доставчици), optionally filtered by name substring. Includes total unpaid balance per vendor in the team default currency, plus server-computed totals (sum of the RETURNED page unpaid balances) — answer aggregate questions from totals, never by summing rows; for the full AP picture use get_ap_aging_report.
list_warehouse_movements
ChatGPTDated incoming and outgoing inventory transactions in ONE company warehouse. Requires read-bills. Omit location_id for warehouse choices. Filter by item or exact batch. Opening balances are excluded. Accounting-amount and quantity totals cover only the returned page, grouped by currency and unit; use get_inventory_stock for as-of stock.
log_expense_draft
ChatGPTPreview a cash-paid expense before posting. Builds the expense receipt so the user can review the vendor, total, VAT, and date, and only commits to the books when the user confirms. Use this whenever the user is logging a cash expense. Bookkeeping only: it records an expense that was already paid and moves no money. A preview changes no saved data and never changes or cancels another preview. To change a preview, make a new one with all its values and cancel the old one with the matching cancel tool.
mark_bill_paid
ChatGPTMark a vendor bill as paid without creating a payment, bank transaction, or bank transfer. Use only when the user explicitly wants to update the bill status without recording how it was settled. Bookkeeping only: it changes the bill status and moves no money.
mark_invoice_paid
ChatGPTMark a customer invoice as paid without recording a specific bank or cash payment leg. Use only when the user has settled the invoice off-the-books and just wants the status updated. Prefer record_invoice_payment for real bank-received invoices. Bookkeeping only: it changes the invoice status and moves no money.
record_invoice_payment_draft
ChatGPTPreview a customer bank payment against an outstanding invoice before posting. Validates the invoice and bank account and shows the resulting invoice status (paid or partially paid) so the user can review before committing. Bookkeeping only: it records a payment the customer already made and moves no money. A preview changes no saved data and never changes or cancels another preview. To change a preview, make a new one with all its values and cancel the old one with the matching cancel tool.
retry_accounting_document_ocr
ChatGPTRetry OCR extraction for one exact failed or stalled purchase or sales document. This does not create or post accounting records. Pass the exact document_key from list_accounting_documents_for_review.
search_accounting_document_inventory_items
ChatGPTSearch existing purchasable inventory items for one processed purchase OCR document. Results include the purchase account derived from each item and whether it can safely be selected for the requested source line. This is read-only and never creates or changes items, rules, bills, or journal entries.
search_accounting_document_vendors
ChatGPTSearch existing active vendors for one processed purchase OCR document. Results expose stable vendor record identifiers and matching evidence for explicit UI selection. This is read-only and never creates or changes vendors, documents, bills, rules, or journal entries.
search_accounts
ChatGPTТърсене на сметка по номер или име в сметкоплана на избраната фирма (намери сметка по номер или име), включително аналитичностите на контрагенти — клиенти и доставчици под 401, 411 и другите разчетни сметки. Номерът съвпада точно или по начало: 41 намира 410, 410/1 и 411. Подредба: точен номер, после начало на номер, после име на сметка, после аналитичност на контрагент с пътя си (kind=counterparty_analytic, path например „401 / ИМЕ ЕООД“) и накрая аналитичните партиди на стоки, така че сметкопланът не се зарива. Търсене по номер не връща партиди на стоки и аналитичности по име, и казва ясно, ако няма сметка с този номер. Отделните фактури под аналитичностите не се връщат. Връща до 50 резултата с кешираното текущо салдо; за салдо на контрагент към дата от оборотната ведомост ползвай get_counterparty_balance.
send_invoice_email
ChatGPTEmail an invoice PDF to one or more recipients. Use only when the user has approved sending — and verified the recipient addresses are correct.
top_debtors
ChatGPTTop customers with the largest outstanding (unpaid) balance for the active team (най-големи длъжници, вземания от клиенти, кой ми дължи най-много). Each debtor carries amounts_by_currency — the outstanding balance per settlement currency, never summed across currencies. total_owed is that same debtor converted into the team reporting currency (reporting_currency) for ranking, and is null when part of the balance has no trustworthy rate.
update_accounting_document_review
ChatGPTApply explicitly confirmed document-detail, vendor, payment, and inventory-item accounting corrections to one processed purchase OCR review. Vendor identity and the purchase account are derived from selected existing records. This changes only OCR staging data and never creates a vendor, item, rule, bill, or journal entry.
update_bill_draft
ChatGPTPreview changes to an existing incoming bill before posting them. Shows what would change so the user can review before committing. Use this whenever the user asks to edit a bill. A preview changes no saved data and never changes or cancels another preview. To change a preview, make a new one with all its values and cancel the old one with the matching cancel tool.
update_invoice_draft
ChatGPTPreview a patch to an existing outgoing invoice before saving it. Resolve the invoice by consumer-facing invoice_number and optional customer_name, then pass only the fields the user asked to change: every change requested so far for that invoice, including the changes of an earlier unconfirmed preview this one replaces. Omitted fields and lines are preserved. Returns explicit before/after changes for review. A preview changes no saved data and never changes or cancels another preview. To change a preview, make a new one with all its values and cancel the old one with the matching cancel tool.