brc_create_cash_payment
Records a cash payment in Big Red Cloud: pay suppliers, lodge to bank, or allocate to analysis categories. Requires explicit user confirmation before posting.
Instructions
Creates a BRC cash payment. Use supplierId + ledger for supplier payments, bankAccountId + lodgement for bank lodgements, or analysisCategoryId + accountCode for analysed expenses. Analysis categories must be from the Cash Payments book (CP01-CP03) and accountCode must match the category. First call without confirmWrite: true returns confirmation_required and a payload preview — show a plain-English draft in chat, then retry with confirmWrite: true only after explicit user confirmation in a later message. Passing preflight is not confirmation. Also requires confirmCounterpartyExplicit: true once the user has explicitly named or confirmed the customer/supplier in the current conversation. Do not reuse a counterparty from an earlier draft without that confirmation.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | Yes | ||
| total | Yes | ||
| acCode | No | Supplier account code for ledger payments. | |
| ledger | No | Ledger amount; must equal total for supplier payments. | |
| discount | No | ||
| procDate | No | Processing date in ISO format. Defaults to entryDate. | |
| entryDate | No | Entry date in ISO format. Defaults to today. | |
| lodgement | No | Lodgement amount; must equal total when lodging to bank. | |
| supplierId | No | Supplier id for ledger payments. | |
| accountCode | No | Analysis account code matching analysisCategoryId, for example CP01. | |
| companyName | Yes | Company context name, for example YOUR-COMPANY-NAME. | |
| description | No | Analysis line description. | |
| confirmWrite | No | Must be true only after a plain-English draft has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm). Never set true on the first call or because the user initially asked to create something. | |
| bankAccountId | No | Bank account id for lodgements. | |
| bookTranTypeId | No | Cash Payment book transaction type id. | |
| bankAccountCode | No | Bank account code for lodgements. | |
| analysisCategoryId | No | Cash Payments analysis category id (categoryTypeId 1391170). | |
| confirmCounterpartyExplicit | No | Must be true only after the user explicitly named or confirmed the customer, supplier, or other counterparty in the current conversation. Never set true because a customer or supplier appeared in an earlier draft, was inferred from context, or was filled in without the user's explicit choice in this conversation. |