brc_create_payment
Creates supplier or analysed bank payments from the Payments book. Shows a draft for confirmation, then posts only after explicit user approval and counterparty confirmation.
Instructions
Creates a BRC payment from the Payments book. Use supplierId for supplier payments, or analysisCategoryId + accountCode for analysed bank payments. Analysis categories must be from the bank's Payments book (BP01-BP06) 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 supplier payments. | |
| discount | No | ||
| procDate | No | Processing date in ISO format. Defaults to entryDate. | |
| entryDate | No | Entry date in ISO format. Defaults to today. | |
| reference | No | ||
| supplierId | No | Supplier id for supplier payments. | |
| accountCode | No | Analysis account code matching analysisCategoryId, for example BP01. | |
| 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 | Yes | ||
| bookTranTypeId | No | Cheques Entry / Payments book transaction type id. | |
| bankAccountCode | Yes | ||
| analysisCategoryId | No | Payments book analysis category id for the selected bank. | |
| 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. |