Jaz Accounting

Bank reconciliation rule: auto-matches bank records. Use directly on request; don't just list existing. Required: name, appliesToReconciliationAccount (bank account UUID, no "ResourceId" suffix), configuration. configuration MUST nest under reconcileWithDirectCashEntry: reference (REQUIRED), amountAllocationType ("PERCENTAGE" | "FIXED"; don't send "FIXED_AND_PERCENTAGE"), percentageAllocation[] / fixedAllocation[] of { organizationAccountResourceId, amount }. Advanced: column-value mapping; amountSourceColumnKey + the *Map fields drive amount/account/tax/classifier/contact/tags from a bank column (amount XOR amountSourceColumnKey). searchFilter = the WHEN side; without it the rule is never suggested. Optional fields, the minimum payload, the mapping shape and the condition grammar: jaz-api skill (bank rules, 90d). Dynamic strings: {{bankReference}}, {{bankPayee}}, {{bankDescription}}. If this action involved a judgment call, record it (jot field or jot tool).

create_bank_rule

Create a new bill. Same rules as create_invoice: name not description, saveAsDraft defaults true, accountResourceId REQUIRED on lineItems for finalized bills (search accounts first, e.g. Operating Expense). When selecting a tax profile, use search_tax_profiles with appliesTo "purchase"; sales-only profiles cause 422. reference MUST be unique; use the SUPPLIER'S OWN invoice number. If the document genuinely has none, set autoReference:true for the org's next number. Never invent one. A duplicate guard (supplier + date + currency + amount) returns `_guard: duplicate_suspected` with the existing bill instead of creating; show it, retry with allowDuplicate only once the user confirms it is separate. If this action involved a judgment call, record it (jot field or jot tool).

create_bill

Record money received INTO a bank account from an EXTERNAL source (customer payment, refund received, deposit). For inter-account moves use create_cash_transfer. accountResourceId MUST be a Bank/Cash account (from list_bank_accounts); any other type fails. Cannot appear in lines (API enforces separation). lines = offsetting entries: { accountResourceId, amount }. NO 'type' field; cash-in credits every offset line, decided by the endpoint. Offset accounts must be regular P&L or balance-sheet accounts (revenue, expense, asset, liability), NOT bank/cash and NOT controlled accounts (AR/AP). If this action involved a judgment call, record it (jot field or jot tool).

create_cash_in

Record money paid OUT FROM a bank account to an EXTERNAL party (expense, supplier payment, reimbursement, withdrawal). For inter-account moves use create_cash_transfer. accountResourceId MUST be a Bank/Cash account (from list_bank_accounts). Cannot appear in lines (API enforces separation; error: "CashOut journal account cannot be in CashIn Entries"). lines = offsetting entries: { accountResourceId, amount > 0 }. NO 'type' field; cash-out debits every offset line, decided by the endpoint. Offset accounts must be regular P&L or balance-sheet accounts, NOT bank/cash and NOT controlled accounts (AR/AP). Example: { accountResourceId: "<expense-acct>", amount: 100 }. If this action involved a judgment call, record it (jot field or jot tool).

create_cash_out

Move money between TWO OF YOUR OWN bank/cash accounts (petty-cash top-up, inter-account, FX between own accounts). NOT for external parties; use create_cash_in (receiving) / create_cash_out (paying). cashOut = source, cashIn = destination. Each side needs accountResourceId + amount. reference auto-generated if omitted. Do NOT send currency/exchangeRate (derived server-side). Posts ACTIVE, not a draft. Refuses locally (`_guard: invalid_transfer`, nothing written) when both sides name the same account, or the leg amounts differ; re-read direction and amount with the user, do not retry. If this action involved a judgment call, record it (jot field or jot tool).

create_cash_transfer

Create a new contact. Auto-checks for duplicates by name; returns existing contact if found instead of creating a duplicate. If this action involved a judgment call, record it (jot field or jot tool).

create_contact

Create a customer credit note. Saves as draft by default. - Status when finalized is UNAPPLIED (not APPROVED). - Line items use "name" for item description. - reference MUST be unique. Never invent one; set autoReference:true to take the org's next number. Omitting both is an error. If this action involved a judgment call, record it (jot field or jot tool).

create_customer_credit_note

Create invoice. lineItem text field = `name` (not "description"). saveAsDraft defaults true; false only on "finalize". accountResourceId per lineItem required only when finalizing. lineItem minimum: `{ name, unitPrice, quantity, accountResourceId }`. Currency: `{ sourceCurrency: "USD" }`; see the exchangeRate param for rate direction. Dates YYYY-MM-DD. reference MUST be unique per org. Never invent one; set autoReference:true to take the organization's next number. Omitting both is an error. Duplicate → 422. If this action involved a judgment call, record it (jot field or jot tool).

create_invoice

Create a new item. Auto-checks for duplicates by itemCode; returns existing item if found. - saleItemName/purchaseItemName are auto-set from internalName if not provided. - Set appliesToSale and/or appliesToPurchase to control where the item can be used. If this action involved a judgment call, record it (jot field or jot tool).

create_item

Create a journal entry. IMPORTANT: - Each entry needs accountResourceId, type (DEBIT or CREDIT), and amount. - Total debits MUST equal total credits; the API rejects unbalanced journals. - Search accounts first to get the correct resourceIds. - Foreign currency: pass the currency object and enter every amount in that currency, NOT the org base. - Double-check your math: sum all DEBIT amounts and all CREDIT amounts; they must be equal. If this action involved a judgment call, record it (jot field or jot tool).

create_journal

Create a new chart of accounts entry. Auto-checks for duplicates by name; returns existing account if found. Code must be unique. Account class is inferred from accountType. If this action involved a judgment call, record it (jot field or jot tool).

create_account

Create a Purchase Request or Purchase Order (pick via documentType). lineItem text field = `name`. Dates YYYY-MM-DD. `reference` unique per org; set autoReference:true for the org's next number. PURCHASE_REQUEST: DRAFT by default. Lifecycle DRAFT → (issue) → ACTIVE → (accept_purchase_request) → ACCEPTED. A DRAFT request can't be linked or accepted: issue it via update_purchase_order isDraftToActivePurchaseRequest:true, never a second request. PURCHASE_ORDER: DRAFT by default (saveAsDraft:false → ACTIVE). Link a request via purchaseRequestResourceId: it MUST be ACTIVE or ACCEPTED. Lifecycle DRAFT → ACTIVE → CONFIRMED (confirm_purchase_order). Jaz Magic orders start PENDING (activate via update_purchase_order). A linked order must use its request's currency. accountResourceId is required on each lineItem when not a draft. Bill it with convert_purchase_order_to_bill. If this action involved a judgment call, record it (jot field or jot tool).

create_purchase_order

Create a Sale Quote or Sale Order (pick via documentType). lineItem text field = `name`. Dates YYYY-MM-DD. `reference` unique per org; set autoReference:true for the org's next number. SALE_QUOTE: DRAFT by default. Lifecycle DRAFT → (issue) → CREATED → (accept_sale_quote) → ACCEPTED. A DRAFT quote can't be linked or accepted: issue it via update_sale_order isDraftToActiveSaleQuote:true, never a second quote. SALE_ORDER: created directly as CREATED (no draft state). Link to a quote via saleQuoteResourceId: the quote MUST be CREATED or ACCEPTED (not DRAFT/VOID). Lifecycle CREATED → CONFIRMED (confirm_sale_order). Jaz Magic orders start PENDING (activate via update_sale_order). A linked order must use its quote's currency. accountResourceId is required on each lineItem when the document is not a draft. Invoice it with convert_sale_order_to_invoice. If this action involved a judgment call, record it (jot field or jot tool).

create_sale_order

Create a supplier credit note. Saves as draft by default. - Status when finalized is UNAPPLIED (not APPROVED). - Line items use "name" for item description. If this action involved a judgment call, record it (jot field or jot tool).

create_supplier_credit_note

Create a business transaction (invoice/bill/credit note/quote/order/purchase request) from a SINGLE file (max 10 MB), a URL, or raw HTML (e.g. an email body) using AI extraction. Processing is async. Quotes/orders land DRAFT/PENDING: relay the result `next`. When the host conversation provides a file with the call, omit all source arguments; the file is used automatically. For a FOLDER, a .zip, a Dropbox/Drive/OneDrive folder share link, or several/mixed documents at once, use classify_documents (then extract_documents) instead, not this per-file. If this action involved a judgment call, record it (jot field or jot tool).

create_transaction_from_document

Deletes a DRAFT bill; VOIDs an active one and KEEPS it. force: true hard-deletes either. If this action involved a judgment call, record it (jot field or jot tool).

delete_bill

Delete (void) a cash-in entry. Uses parentEntityResourceId from create response. If this action involved a judgment call, record it (jot field or jot tool).

delete_cash_in

Deletes a DRAFT customer credit note; VOIDs an active one and KEEPS it. force: true hard-deletes either. If this action involved a judgment call, record it (jot field or jot tool).

delete_customer_credit_note

Deletes a DRAFT invoice; VOIDs an active one and KEEPS it. force: true hard-deletes either. If this action involved a judgment call, record it (jot field or jot tool).

delete_invoice

Deletes a DRAFT journal; VOIDs an active one and KEEPS it. force: true hard-deletes either. `status`: SUCCEEDED = deleted, VOID = voided. If this action involved a judgment call, record it (jot field or jot tool).

delete_journal

Delete (void) a payment record. The associated invoice/bill balance is restored. If this action involved a judgment call, record it (jot field or jot tool).

delete_payment

Delete a DRAFT Purchase Request or Purchase Order. Anything issued: void_purchase_order. If this action involved a judgment call, record it (jot field or jot tool).

delete_purchase_order

Delete a DRAFT Sale Quote or Sale Order. Anything issued: void_sale_order. If this action involved a judgment call, record it (jot field or jot tool).

delete_sale_order

Deletes a DRAFT supplier credit note; VOIDs an active one and KEEPS it. force: true hard-deletes either. If this action involved a judgment call, record it (jot field or jot tool).

delete_supplier_credit_note

Download a bill as PDF. Returns { fileUrl } (may be pending/empty if the document is not yet rendered).

download_bill_pdf

Download an invoice as PDF. Returns { fileUrl } (may be pending/empty if the document is not yet rendered).

download_invoice_pdf

Analytical / financial / audit report file (XLSX or PDF). Returns { fileName, fileUrl } (pre-signed, ~5 min). Use this tool, not export_records, for anomaly / audit / risk analyses, statements, aging, summaries, ledgers, statement-of-account. Per-type date / scope (wrong set → 422 "X is required"): - balance-sheet → snapshotDate - cashflow, equity-movement → primaryStartDate + primaryEndDate (secondary* optional) - bank-closing-balance → reportDate - bank-reconciliation-* → startDate + endDate + bankAccountResourceId - fixed-assets-reconciliation-summary → startDate + endDate + accountResourceId (fixed-asset UUIDs; search fixed_assets first) - statement-of-account-export → contactResourceId (dates optional; omitted = all-time) - trial-balance, cash-balance, ar-report, ap-report, ar-details-report, ap-details-report → endDate - other summaries (P&L, GL, sales/purchase, tax, fixed-assets-register, etc.) → startDate + endDate For raw entity rows use export_records; for ad-hoc SELECT use preview_pseudo_sql / run_pseudo_sql_and_download. Cashflow returns the IAS 7 templated report (404 template_not_found if none configured, jaz-api Rule 147).

download_export

Kick off an async CSV export of a pseudo-SQL SELECT against the curated reporting schema. Returns { jobId, status }. Same DSL constraints as preview_pseudo_sql (SELECT-only, ≤16384 chars, single statement). Poll status via get_pseudo_sql_export; terminal states are COMPLETED (downloadUrl present, ~15min S3 expiry), FAILED, or EXPIRED. For one-shot "give me the CSV" use run_pseudo_sql_and_download instead. Supply idempotencyKey to dedupe across retries; same key + DIFFERENT query returns the prior job's result (server-side primary).

export_pseudo_sql

Create draft transactions from a classified document collection (see classify_documents). Uploads each file to the right AI-extraction endpoint (invoices/bills/credit notes via business-transaction extraction, bank statements via statement import), de-duplicates identical files, and returns the workflow ids to poll with wait_for_magic_workflows. Processing is async; drafts appear once the workflows reach a terminal state. Pass the collectionId from classify_documents. Returns `whereToSee[]`: the screen each landed type appears on + its uploaded/failed split (+ `next` for quotes/orders): relay those links (no `navigate`) and say drafts are still arriving. An unbuildable link is omitted, named in `partialFailures`. If this action involved a judgment call, record it (jot field or jot tool).

extract_documents

Finalize a draft bill (set saveAsDraft=false). Can optionally update fields in the same call. IMPORTANT: Every lineItem MUST have accountResourceId. If the draft was created without it, pass lineItems with accountResourceId added (search accounts first, e.g. Operating Expense for purchases). If this action involved a judgment call, record it (jot field or jot tool).

finalize_bill

Finalize a draft invoice (set saveAsDraft=false). Can optionally update fields in the same call. IMPORTANT: Every lineItem MUST have accountResourceId. If the draft was created without it, pass lineItems with accountResourceId added (search accounts first, e.g. Operating Revenue for sales). If this action involved a judgment call, record it (jot field or jot tool).

finalize_invoice

Aged Payables as at endDate, by supplier: what is outstanding per contact, in aging buckets. For payment runs and supplier follow-up.

generate_aged_payables

Aged Payables Summary as at endDate: the summary report the dashboard shows under that name. For payment runs and supplier follow-up; for the breakdown per supplier, use generate_aged_payables.

generate_aged_payables_summary

Aged Receivables as at endDate, by customer: what is outstanding per contact, in aging buckets. For credit control, collections and customer payment follow-up.

generate_aged_receivables

Aged Receivables Summary as at endDate: the summary report the dashboard shows under that name. For credit control, collections and customer payment follow-up; for the breakdown per customer, use generate_aged_receivables.

generate_aged_receivables_summary

Generate a balance sheet report.

generate_balance_sheet

Generate bank balance summary report: snapshot of all bank account balances at a point in time.

generate_bank_balance_summary

Generate bank reconciliation summary for a specific bank account. Essential for month-end close; call this for each in-scope bank account for the current entity and reporting period. Use for bank recon status, unreconciled items count, or reconciliation summaries.

generate_bank_reconciliation_summary

Generate a cash balance report showing cash position at a specific date. PREFERRED for cash position questions: use this (NOT balance sheet) when asked about total cash, cash on hand, available cash, or cash position across all bank accounts.

generate_cash_balance

Generate a cashflow report.

generate_cashflow