Cloudbee

Sa Companies

List the SmartAccounts companies this connector is configured for, each with its bank accounts (name + IBAN). CALL THIS FIRST to know which company to use and to verify the right IBAN before posting. Every other sa_* tool requires a `company` argument.

Sa Clients

List/fetch clients (customers) of `company`. No id = list (paginated); filter by name/regcode or modified date.

Sa Client Balance

Get a client's balance (receivables) by client id, for `company`.

Sa Client Invoices

List sales (client) invoices of `company`. Filter by date range + date_type (date|entrydate|duedate|modifydate), client, invoice number, or payment_status (unpaid|overdue). Paginated.

Sa Vendor Invoices

List purchase (vendor) invoices = expenses of `company`. Filter by date range + date_type, invoice number, or payment_status (unpaid|overdue). Paginated.

Sa Articles

List articles/items (products & services) of `company`; optional code filter.

Sa Payments

List/fetch payments of `company`. Filter by date range + date_type, account_type (BANK|CASH), account_name, partner_type, partner_id, or a specific id. fetch_rows=true gives the invoice-link rows (REQUIRED before editing a payment).

Sa Payment Add

WRITE (scoped): post a bank/cash transaction as a payment for `company`, optionally linked to invoice(s). REQUIRES `confirm_iban` = the statement's bank account number (in the filename) — the connector refuses to post unless it matches one of the company's bank accounts, so you cannot post to the wrong company. Use the company's own exact account_name (see sa_companies). rows[].type = CLIENT_INVOICE|VENDOR_INVOICE|VAT_RETURN|PREPAYMENT_PAYMENT|SALARY, rows[].id = invoice id. HIGH-CONFIDENCE matc

Sa Payment Edit

WRITE (scoped): correct an existing payment of `company` (wrong supplier/partner, wrong invoice link). REQUIRES `confirm_iban` (statement account, must match the company). Send the WHOLE object: fetch via sa_payments (id + fetch_rows), edit, pass the complete object incl id. Audit-logged.

Sa Vendor Add

WRITE: create a new vendor (supplier) in `company`. Use ONLY when a statement names a vendor that sa_vendor_invoices / sa_clients shows does NOT exist yet (check first). name required. By DEFAULT it auto-enriches from the Estonian Business Register (ariregister): an Estonian company is created under its official legal name + reg code; an ambiguous name returns candidates (re-call with reg_code). A foreign/non-Estonian vendor isn't in the register, so it's created bare under the name you give. Re

Sa Vendor Invoice Edit

WRITE (scoped): on a PURCHASE invoice, set the Objekt (`object`, e.g. PM) on the header AND/OR mark it PAID via a payment method (`payment_method`, e.g. 'Aruandev isik' = accountable person — a non-bank method the payments API cannot reach). It ONLY changes objectId + paymentMethod/paymentAmount; all other invoice fields are preserved. RULE (enforced): marking paid via a payment method REQUIRES an object on the header. Find the invoice id with sa_vendor_invoices. Cannot change amounts, vendor or

Sa Company Lookup

Look up an Estonian company in the Estonian Business Register (ariregister / RIK) by name OR reg code — the same data the SmartAccounts UI autofills when you create a vendor: official name, reg code, legal address, status (R=active). ESTONIA ONLY (foreign companies are not in this register). Read-only; does NOT touch SmartAccounts. Use it to verify a supplier or fetch a reg code before sa_vendor_add.

Sa Payment Delete

WRITE - DELETION, REQUIRES PEETER'S EXPLICIT APPROVAL. Permanently delete a payment by id (e.g. to undo a wrong prepayment). NEVER call without first asking Peeter in Slack and getting an explicit yes for THAT payment; then pass peeter_approved=true + a reason. Blocked otherwise. Audit-logged.

Sa Accounts

List the CHART OF ACCOUNTS of `company` (code, Estonian + English name, type ASSET/LIABILITY/INCOME/EXPENSE). Optional `search` filters by code or name. Use a code with sa_account_ledger to see that account's transactions.

Sa Account Ledger

ACCOUNT CARD (kontokaart) for `company`: every general-ledger transaction on one `account` over a date range — date, description, source document, object, debit, credit, and a running balance (like the SmartAccounts account report). Requires account + date_from + date_to. Find the code with sa_accounts. Keep the range tight (it scans all ledger entries).