Method

reconcile.setInfo

Set or remove an account's last reconcile date, interval, postponed reconciliation or sub-account flag.

Sets or removes an account's reconcile information: the last reconcile date, the interval between statements ({months, days}), a postponed reconciliation ({date, balance}) and whether sub-accounts are included. A field you leave out is kept; null removes it. Use it to correct the dates after importing a book, or to drop a postponed reconciliation you no longer want.

Examples

Example: with a copy of the reports/reconcile example book open as book.gnucash.

JSON-RPC

Request:

{"jsonrpc":"2.0","id":1,"method":"reconcile.setInfo","params":{"account":"Root:Asset:Bank","lastInterval":{"months":1,"days":0}}}

Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "lastInterval": {
      "months": 1,
      "days": 0
    },
    "lastDate": null,
    "…": "…"
  }
}

Command line

red-ale exec --book book.gnucash reconcile.setInfo '{"account":"Root:Asset:Bank","lastInterval":{"months":1,"days":0}}'

It prints:

{
  "lastInterval": {
    "months": 1,
    "days": 0
  },
  "lastDate": null,
  "…": "…"
}

MCP tool call

Tool call:

{"name":"reconcile.setInfo","arguments":{"account":"Root:Asset:Bank","lastInterval":{"months":1,"days":0}}}

Result:

{
  "structuredContent": {
    "lastInterval": {
      "months": 1,
      "days": 0
    },
    "lastDate": null,
    "…": "…"
  }
}

Effect: write, on the Book.

Params

Params of reconcile.setInfo. An absent field is left alone; null removes it.

  • account (AccountRef, required): The account.
  • lastDate (Timestamp or null): The last reconcile date.
  • lastInterval (IntervalWire or null): The interval between reconciliations.
  • postpone (PostponeWire or null): A postponed reconciliation; null clears it.
  • includeSubaccounts (boolean or null): Whether reconciliations include sub-accounts.

Result

An account's reconcile information.

  • account (Guid, required): The account.
  • lastDate (Timestamp or null): When it was last reconciled.
  • lastInterval (IntervalWire or null): The interval between its last two reconciliations.
  • postponeDate (Timestamp or null): A postponed reconciliation's statement date.
  • postponeBalance (Amount or null): A postponed reconciliation's ending balance, raw sign.
  • includeSubaccounts (boolean, required): Reconciliations include sub-accounts.