Skip to main content
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.