> ## Documentation Index
> Fetch the complete documentation index at: https://agents.nanonets.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Tally List Stock Items

> Lists stock item masters in Tally with their exact names, stock groups, base units and closing balances.

Lists stock item masters in a Tally company, optionally filtered to names containing a substring. Display name **"Tally List Stock Items"**. Off by default.

Its purpose is to resolve an **exact** stock item name and unit symbol before a purchase order is issued. Tally matches item names exactly and rejects an entire order voucher when one line names an item that does not exist, and the unit symbol is the one purchase-order input that cannot be inferred.

## Authentication and enablement

Requires a workspace Tally integration pointing at the TallyPrime HTTP-XML gateway. `base_url`, `company`, and the optional reverse-proxy basic-auth credentials are injected from the integration record. Enable the tool and bind the integration.

The Tally company must be **"Maintain Accounts with Inventory"** — an accounts-only company has no stock item masters.

## Inputs

* `name_contains` (optional): case-insensitive substring to filter item names (e.g. `steel`). Omit to list every stock item.

## Output

`{name_contains, total_items, items[], retrieved_at}`.

Each entry in `items[]` carries:

* `name` — the exact name to pass to `tally_create_purchase_order`.
* `parent_group` — the item's stock group.
* `base_unit` — the unit symbol (`Nos`, `Kgs`) to pass as a purchase-order line's `unit`.
* `closing_balance` — Tally's own quantity string (e.g. `42 Nos`), with its numeric part in `closing_qty`.
* `closing_value` — closing stock value.

## Limits and side effects

* Read-only against Tally. Creates and changes nothing.
* The collection is always exported unfiltered and the name filter is applied afterwards. A Tally TDL string filter that silently matched nothing would be indistinguishable from "the item does not exist", which is the exact confusion this tool exists to prevent. On a company with a very large item master the export can be slow.
* `base_unit` is the authoritative unit symbol. The unit inside `closing_balance` is not parsed back out.
* An empty result is a successful response, not an error.

## Expected errors

* Missing Tally credentials.
* Gateway unreachable or an HTTP error from the Tally gateway.
* Unparseable response from Tally.