@yoctotta/kaman-gateway-client-tally

Kaman Data Gateway client for Tally ERP - syncs Tally accounting data to the Kaman platform.

Built on @yoctotta/kaman-gateway-client.

Installation

npm install -g @yoctotta/kaman-gateway-client-tally

CLI Usage

# With npx (no install needed)
npx @yoctotta/kaman-gateway-client-tally \
  --gateway-url https://gateway.kaman.io \
  --key YOUR_PAIRING_KEY \
  --tally-host localhost \
  --tally-port 9000

# Or if installed globally
kaman-gateway-tally \
  --gateway-url https://gateway.kaman.io \
  --key YOUR_PAIRING_KEY \
  --tally-host localhost \
  --tally-port 9000

| Flag | Default | Description | |------|---------|-------------| | --gateway-url | required | Kaman Data Gateway server URL | | --key | required | Pairing key from Kaman Marketplace | | --tally-host | localhost | Tally HTTP server host | | --tally-port | 9000 | Tally HTTP server port | | --no-reconnect | — | Disable automatic reconnection |

Programmatic Usage

import { GatewayClient } from '@yoctotta/kaman-gateway-client';
import { TallyDataProvider } from '@yoctotta/kaman-gateway-client-tally';

const provider = new TallyDataProvider('localhost', 9000);
const client = new GatewayClient(provider, {
  gatewayUrl: 'https://gateway.kaman.io',
  gatewayKey: 'your-key',
});

await client.connect();

Supported Resources

The client exposes these Tally collections as resources:

| Type | Description | |------|-------------| | ledgers | Chart of accounts / ledger entries | | groups | Account groups | | vouchers | Transaction vouchers (invoices, payments, receipts, etc.) | | stock_items | Inventory / stock items | | stock_groups | Stock item groups | | cost_centres | Cost centres | | voucher_types | Voucher type definitions | | units | Units of measurement | | godowns | Warehouse / godown locations | | currencies | Currency definitions |

Resources use the URI format tally://{company}/{type}.

Tools

Three tools are exposed for direct invocation by Kaman agents:

• tally_raw_query - Send raw TDL XML to Tally
• tally_list_companies - List open companies
• tally_fetch_collection - Fetch a specific collection by company and type

Prerequisites

• Tally ERP running with HTTP server enabled (default port 9000)
• Node.js >= 18

License

MIT