CashCtrl MCP by usefulapi

The chart of accounts: number, name, category and the balance for the fiscal period. Not paged. GET /account/list.json.

One account of the chart of accounts by id. GET /account/read.json.

The balance of one account at the end of a day (default: the last day of the current fiscal period). GET /account/balance.

The categories of the chart of accounts (assets, liabilities, expenses, revenue and their sub-categories). GET /account/category/list.json.

Takes no parameters.

The bank accounts set up in CashCtrl (name, IBAN, linked ledger account). GET /account/bank/list.json.

Takes no parameters.

Book entries of the journal (date, title, debit and credit account, amount, reference), newest first, for the current fiscal period unless fiscal_period_id is set. GET /journal/list.json.

One book entry by id, with its items for a collective entry. GET /journal/read.json.

Sales or purchase documents (quotes, order confirmations, invoices, delivery notes, credit notes, vendor bills) with number, date, customer, status and total. Newest first. GET /order/list.json.

One order (invoice, quote, purchase document) by id, with its items, totals and status. GET /order/read.json.

The order categories (Quote, Invoice, Credit note, Purchase invoice and so on) with their statuses (Draft, Open, Paid) and the default accounts and sequence numbers. Use it to find category_id and status_id (type PURCHASE for purchase documents). GET /order/category/list.json.

Customers, vendors, employees and other contacts (name, company, number, roles, addresses). GET /person/list.json.

One person or company by id, with addresses, contact data and bank accounts. GET /person/read.json.

Inventory articles (products and services) with number, name, price, stock and accounts. GET /inventory/article/list.json.

One inventory article by id. GET /inventory/article/read.json.

Payroll statements (employee, date, status, gross and net amounts), newest first. Sensitive personal data. GET /salary/statement/list.json.

One payroll statement by id, with its salary items. Sensitive personal data. GET /salary/statement/read.json.

All fiscal periods (id, name, start, end, current flag). The id is the fiscal_period_id of the other tools. GET /fiscalperiod/list.json.

Takes no parameters.

The VAT tax codes (id, code, name, rates). The id is the tax_id of the write tools. GET /tax/list.json.

Takes no parameters.

The number sequences (for journal references, order numbers, customer numbers). The id is the sequence_number_id of the write tools. GET /sequencenumber/list.json.

Takes no parameters.

The currencies set up in CashCtrl with their exchange rates. GET /currency/list.json.

Takes no parameters.

The reports set up in CashCtrl (balance sheet, income statement, and so on) as a tree of collections and elements. The element id is the input of cashctrl_get_report_data. GET /report/tree.json.

Takes no parameters.

The data of one report element (for example the balance sheet or the income statement) for a fiscal period or a date range. GET /report/element/data.json.

WRITE: changes the accounting records. Makes one request that is never repeated; check the result before trying again. Creates a manual book entry in the journal. Either a simple entry (debit_account_id, credit_account_id, amount) or a collective entry (items, whose debit and credit sums must match). POST /journal/create.json.

WRITE: changes the accounting records. Makes one request that is never repeated; check the result before trying again. DELETES manual journal entries by id (entries created by orders or salary statements cannot be deleted this way). Deleted entries are gone from the books; confirm the ids with the user first. POST /journal/delete.json.

WRITE: changes the accounting records. Makes one request that is never repeated; check the result before trying again. Creates ONE order document for ONE customer or vendor: a quote, invoice, credit note, purchase bill and so on, depending on category_id. Without status_id the first status of the category is used; a booking status (for example Open) also creates journal entries, so use a draft status unless the user asks otherwise. No e-mail is sent. POST /order/create.json.

WRITE: changes the accounting records. Makes one request that is never repeated; check the result before trying again. Sets the status of 1-20 orders (for example Draft to Open, or Open to Paid). A status can book journal entries or move stock, so the books change. POST /order/update_status.json.

WRITE: changes the accounting records. Makes one request that is never repeated; check the result before trying again. DELETES orders (invoices, quotes, purchase documents) by id, with the journal entries they created. Deleted documents are gone; confirm the ids with the user first. POST /order/delete.json.

WRITE: changes the accounting records. Makes one request that is never repeated; check the result before trying again. Creates a customer, vendor or other contact. Give company, first_name or last_name (at least one). Search first with cashctrl_list_persons so no duplicate is created. POST /person/create.json.