UOL Účetnictví (unofficial)

Read-only GET of any UOL REST path (spec: https://api.uol.cz/openapi.yaml) for data no other tool covers — e.g. /v1/accounting_records, /v1/bank_movements, /v1/products, /v1/warehouse/statuses, /v1/sales_orders. Returns the raw JSON (amounts as strings, invoice status "valid" = draft); large answers are cut to fit. Prefer the dedicated tools.

Saves the original file of an uploaded document on the machine running uol-mcp and returns its path.

Downloads an issued (sales) invoice rendered by UOL and saves it on the machine running uol-mcp. format=isdoc also returns the ISDOC XML (Czech e-invoice standard), which is readable line by line. ISDOC exists only for issued (confirmed) invoices. Received invoices cannot be exported through the API.

Balances of the company's own bank accounts, per account and summed per currency. UOL stores monthly opening-balance snapshots (1st of the month), not live balances; always quote the as_of date.

"How is the company doing?" in one call: this month vs last month (revenue, expenses, profit, whether booked yet), the VAT period due next and the running one, unpaid and overdue receivables, uploaded documents waiting for the accountant, and bank balances. Sections that fail (e.g. missing permission) are null and listed in errors; sections read only partly are listed in incomplete. Use the dedicated tools for detail.

The accounting entity of this UOL tenant: name, IČO, DIČ, address and VAT filing period. Also a quick check that uol-mcp is connected.

One contact with all addresses, bank accounts and default payment terms.

Revenue (výnosy, class 6), expenses (náklady, class 5) and profit per month from the general ledger — the same basis as the UOL web dashboard, so payroll, rent and other internal documents count, not just invoices. Amounts are net of VAT, in the home currency. The current month is still running, and months the accountant has not booked yet have booked=false — say so instead of reporting zero. Also returns the largest revenue and expense accounts (with names) for the whole window.

One received (purchase) invoice with line items, VAT and payment symbols.

One issued (sales) invoice with line items, VAT, payment symbols, own bank account and payments received. Use export_sales_invoice for the PDF or ISDOC. Earlier invoices to the same buyer show how they are usually issued (DUZP, due days, products, line texts, bank account) — a template for a new one.

One uploaded document with its original file name, tags and the bookkeeping records it was paired with. Pairings identify the record by type and internal gid, not by invoice number.

VAT (DPH) per filing period, newest first: output VAT, input VAT, amount to pay or excess deduction, due date. The filing period (monthly / quarterly) comes from the company settings. Closed periods use UOL's "DPH" closing document (exact). Open periods are estimated from issued invoices — output VAT by DUZP, input VAT by the later of DUZP and the receipt date: proformas skipped, corrective invoices counted as credit notes, internal documents and reverse charge not included.

Reference data (číselníky) used by invoices and documents: currencies, countries, departments (střediska), contracts (zakázky), price lists, product categories, predefined texts, document templates, payment rules, own bank accounts, petty cashes (pokladny), document tags and products (the product_id invoice lines need). Records are returned as UOL sends them, minus audit fields.

Receivables of issued (sales) invoices — pohledávky: totals per currency plus the matching invoices, most overdue first by default. Answers "who owes me money", "what is overdue", "has customer X paid". Covers sales invoices only: the UOL API exposes no payment status for received (purchase) invoices.

Documents uploaded to UOL for the accountant (nahrané doklady: receipts, received invoices as PDF/images), newest first. state=unprocessed lists what the accountant has not processed yet.

Search customers and suppliers (kontakty / adresář) by name, IČO or DIČ. Returns contact_id values for the invoice and receivable filters.

Search received (purchase) invoices — přijaté faktury. UOL ignores issue-date filters on this endpoint, so filter by tax_date_* (DUZP) or received_date_*. The UOL API exposes no payment status for purchase invoices.

Search issued (sales) invoices — vydané faktury — newest first. Each row includes payment status from UOL receivables. Use tax_date_* (DUZP) for accounting-period questions, issue_date_* for "issued in". Drafts and cancelled invoices are listed too; check status. For "who owes me money" prefer list_receivables.