Payables by accounting date (month-end close)

# Instructions — Payables by accounting date (month-end close)

## ⚠️ Critical prerequisite

The `accountingDate` field is an **optional feature disabled by default** in Spendesk.
If it is disabled, `accountingDate` is `null` on all payables and a filter on this field silently returns 0 results.

**Before using this filter, check**: call `get_payables` without a date filter on 3 records and inspect the `accountingDate` field. If it is `null`, the feature is not enabled — use `payableDate` instead.

## Step 1 — Identify the company

Call `list_companies` to get the `companyId`.

## Step 2 — Check whether accountingDate is enabled

Call `get_payables` with `pageSize=3` (no date filter).
Inspect `accountingDate` in the results:
- If populated → the feature is active, continue
- If `null` → **use `payableDate` instead** and inform the user

## Step 3a — If accountingDate is enabled

Call `get_payables` with:
```
filters: { field: "accountingDate", operator: "between", value: { from: "<YYYY-MM-01T00:00:00.000Z>", to: "<YYYY-MM-lastDayT23:59:59.999Z>" } }
```

## Step 3b — If accountingDate is null (standard case)

Call `get_payables` with:
```
filters: { field: "payableDate", operator: "between", value: { from: "...", to: "..." } }
```

And inform the user: "The accounting date (accountingDate) is not enabled on this account. Filtering was done on the document date (payableDate)."

## Step 4 — Pagination

If `hasNextPage=true`, iterate with the `cursor` until exhausted.

## Step 5 — Results

Display: number of payables, total in functional currency (sum `functionalAmount.amount / 10^precision`), breakdown by `bookkeepingStatus`.

## Example prompts

- "Show me the June 2026 invoices for the accounting close"
- "Which payables have an accounting date in July 2026?"