Caribooks

Give a vendor as payee to purchases that have none, after the user agreed to the vendor for each group. Each assignment names the vendor (vendor_id of an existing vendor, or vendor: a name, matched to an existing vendor regardless of case and created when the company has none by that name) and the purchases: texts (group texts from list_purchases_without_payee) and/or ids. Only purchases with no payee are changed, and only their payee. At most 300 purchases are changed per call; when remaining is above zero, make the same call again. Use the same from and to as the listing. Requires full access on the connection.

give_payee

List saved bookkeeping rules for a connected company, including active rules and proposals awaiting user approval. Returns each rule's id, source and evidence. Read-only.

list_rules

List the QuickBooks companies connected to this Caribooks account, with their access level.

list_connected_companies

List the purchases (bank and card expenses, including bank-feed lines) that have no payee in QuickBooks, grouped by the merchant their bank text names: OPENAI *CHATGPT SUBSCR and OPENAI *CHATGPT SUBSCR 4411 fall in one group, OPENAI CHATGPT. Each group gives its count, totals per currency, first and last date, up to three raw bank texts, and a suggested vendor when there is one: the vendor most purchases with the same bank text were already given, or a vendor whose name is the text's first words. A bank text already given several vendors (a payment provider paying several payees) suggests none: vendors_before names each with its smallest and largest amount, and purchases lists the group's purchases, to give by ids. Transfers and payments are listed apart under left_out. Several groups are often one vendor (OPENAI CHATGPT, OPENAI SAN; CLAUDE AI, ANTHROPIC CLAUDE). Show the user the groups and the vendor you propose for each before calling give_payee. Read-only.

list_purchases_without_payee

The loops this account has for a company, or for every company when none is named: each one's id, whether it is active or paused, the sentence it came from, what it does read back in the user's words, and when it last ran and runs next. Read-only.

list_loops

The questions a company's loops are waiting for the user to answer, or every company's when none is named: each question's id, the items it is about and the answers the loop suggests for each, numbered from 1. Put them to the user and send the user's own answer with answer_question. Read-only.

list_questions

List receipts, invoices and documents uploaded through the Caribooks portal or a drop link, or emailed to the account's or a company's receiving address. Returns each file's upload_id, company, kind, filing status and content preview. Kinds include transaction evidence, monthly statements and reference documents. Read-only; does not create transactions or attachments. include_filed includes filed statements and references. upload_id selects a document for a full-text read; text_offset pages through long documents, and cursor pages through older files. search, from, to, min_total and max_total find documents by the words, date and total read off them, filed receipts included; each line shows the vendor, date, number, total and summary read.

list_receipt_inbox

List a company's proposed or completed bookkeeping changes, newest first. Returns each proposal's id, action type, approval mode, status, summary and supporting evidence. Pending proposals can be approved or rejected by the user in Caribooks Approvals or through the daily digest link. This tool is read-only and cannot approve or reject proposals.

list_proposals

Save a user's bookkeeping preference for a connected company: a categorization, vendor fact, preference or procedure. For example, a categorization can associate a payee with an expense account. Every rule saved here waits for the user's approval in Caribooks Approvals (https://caribooks.com/portal/review) and applies only once approved there; tell the user so. stated_by_user records whether the user said it or it was inferred from a pattern. Rules are company-specific business data; they never change access permissions or confirmation requirements.

remember_rule

Retire an active bookkeeping rule by id, following the user's request. The rule remains in history but is no longer active. A rule still waiting for approval is refused by the user in Caribooks Approvals (https://caribooks.com/portal/review), not here.

retire_rule

Save the payout setup the user chose, by QuickBooks ids from get_payout_setup. It is checked first (the holding account must be a Bank account, each tax code must charge the platform's rates, the start date cannot be inside closed books) and waits for the user to confirm it on the Caribooks Payouts page; nothing is booked before that.

save_payout_setup

Activate an existing paused bookkeeping loop by id after the user approves its configuration. Sets the next run from its schedule. Depending on its approved configuration, a loop can change bookkeeping records or email invoice reminders to external recipients. Preview mode requires approval of proposed actions. The Caribooks portal provides pause controls and approval of proposed changes.

activate_loop

Create an account in QuickBooks Online. Returns the saved record with its SyncToken.

create_account

Create a text note attached to a QuickBooks record. Does not upload a file or render a PDF.

create_attachable

Create a bill in QuickBooks Online. Returns the saved record with its SyncToken.

create_bill

Create a bill payment in QuickBooks Online. An accounting record of a payment to a vendor. It does not initiate a bank or card payment. Returns the saved record with its SyncToken.

create_bill_payment

Create a budget in QuickBooks Online. A profit-and-loss budget with one amount per account per period. Returns the saved record with its SyncToken.

create_budget

Create a class in QuickBooks Online. Returns the saved record with its SyncToken.

create_class

Create a company currency in QuickBooks Online. The currencies the company transacts in; only meaningful with multicurrency enabled. Returns the saved record with its SyncToken.

create_company_currency

Create a credit card payment txn in QuickBooks Online. An accounting record of a bank payment toward a credit card balance. It does not move money. Returns the saved record with its SyncToken.

create_credit_card_payment_txn

Create a credit memo in QuickBooks Online. Returns the saved record with its SyncToken.

create_credit_memo

Create a customer in QuickBooks Online. Returns the saved record with its SyncToken.

create_customer

Create a department in QuickBooks Online. Returns the saved record with its SyncToken.

create_department

Create a deposit in QuickBooks Online. Returns the saved record with its SyncToken.

create_deposit

Create an employee in QuickBooks Online. Returns the saved record with its SyncToken.

create_employee

Create an estimate in QuickBooks Online. Returns the saved record with its SyncToken.

create_estimate

Create an inventory adjustment in QuickBooks Online. Changes the quantity on hand of inventory items and books the valuation difference; US companies on Plus or Advanced only. Returns the saved record with its SyncToken.

create_inventory_adjustment

Create an invoice in QuickBooks Online. Returns the saved record with its SyncToken.

create_invoice

Create an item in QuickBooks Online. Returns the saved record with its SyncToken.

create_item

Create a journal entry in QuickBooks Online. Returns the saved record with its SyncToken.

create_journal_entry

Create a payment in QuickBooks Online. An accounting record of a customer payment already received. Payment processing is not supported; ProcessPayment must be omitted or false. Returns the saved record with its SyncToken.

create_payment

Create a payment method in QuickBooks Online. Returns the saved record with its SyncToken.

create_payment_method

Create a purchase in QuickBooks Online. Returns the saved record with its SyncToken.

create_purchase

Create a purchase order in QuickBooks Online. Returns the saved record with its SyncToken.

create_purchase_order

Create a recurring transaction in QuickBooks Online. A template QuickBooks uses to create a transaction on a schedule, or on request. Returns the saved record with its SyncToken.

create_recurring_transaction

Create a refund receipt in QuickBooks Online. Returns the saved record with its SyncToken.

create_refund_receipt

Create a sales receipt in QuickBooks Online. Returns the saved record with its SyncToken.

create_sales_receipt

Create a tax agency in QuickBooks Online. Returns the saved record with its SyncToken.

create_tax_agency

Create a term in QuickBooks Online. Returns the saved record with its SyncToken.

create_term

Create a time activity in QuickBooks Online. Returns the saved record with its SyncToken.

create_time_activity