Create Sales Entry
brc_create_sales_entryCreates one BRC sales entry with positive, zero or negative net values and multiple VAT lines. Legacy single-VAT fields remain supported. Zero entries may omit analysis and VAT allocations. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload preview. confirmWrite: true applies the previewed change after explicit confirmation. Passing preflight is not confirmation. Requires confirmCounterpartyExplicit: true; confirmation is scoped to the counterparty selected for the current preview.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"companyName": "<companyName>",
"customerId": "<customerId>",
"acCode": "<acCode>",
"note": "<note>",
"entryDate": "<entryDate>",
"procDate": "<procDate>",
"bookTranTypeId": "<bookTranTypeId>",
"netAmount": "<netAmount>",
"routeToken": "<routeToken>"
},
"name": "brc_create_sales_entry"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | Yes | ||
| total | No | ||
| acCode | Yes | ||
| procDate | Yes | ||
| totalNet | No | ||
| totalVAT | No | ||
| vatLines | No | Separate VAT allocations; net amounts must sum to netAmount. Legacy vatRateId/vatPercentage remain supported. | |
| entryDate | Yes | ||
| netAmount | Yes | Signed net total: positive, zero, or negative credit. No record-type conversion. | |
| vatRateId | No | ||
| customerId | Yes | ||
| routeToken | Yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. | |
| accountCode | No | ||
| companyName | Yes | Company context name, for example YOUR-COMPANY-NAME. | |
| description | No | ||
| confirmWrite | No | Must be true only after a plain-English preview before posting 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. Nothing is written to Big Red Cloud until you confirm. | |
| connectionRef | No | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reusing the same connectionRef after successful tool calls — do not start a new connection because a lookup returned empty or partial data. It is not an API key and does not contain credentials. | |
| vatPercentage | No | ||
| bookTranTypeId | Yes | ||
| detailedResponse | No | Include full payload and BRC response; compact result is default. | |
| analysisCategoryId | No | ||
| 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 preview, was inferred from context, or was filled in without the user's explicit choice in this conversation. |