pohoda_list_addresses
Retrieve and filter address records from POHODA accounting software by ID, company name, IČO, last changes date, or code. Returns matching addresses in JSON format.
Instructions
List addresses from POHODA addressbook. Supports filtering by id, company name, IČO, last changes date, or code. Returns JSON array of matching address records.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Filter by address ID | |
| companyName | No | Filter by company name | |
| ico | No | Filter by IČO (company ID number) | |
| lastChanges | No | Filter by last changes date (DD.MM.YYYY or YYYY-MM-DD) | |
| code | No | Filter by address code |
Implementation Reference
- src/tools/addresses.ts:21-44 (handler)Handler function for the 'pohoda_list_addresses' tool. It builds an XML request using provided filters, sends it via the Pohoda client, parses the response, and returns the result.
async (params) => { try { const filterParams: ListFilterParams = { id: params.id, companyName: params.companyName, ico: params.ico, lastChanges: params.lastChanges, code: params.code, }; const xml = buildExportRequest( { ico: client.ico }, "lst:listAddressBookRequest", NS.lAdb, "lst:requestAddressBook", (req) => applyFilter(req, filterParams) ); const response = await client.sendXml(xml); const parsed = parseResponse(response); const data = extractListData(parsed); return jsonResult("Addresses", data, Array.isArray(data) ? data.length : 0); } catch (e) { return err((e as Error).message); } } - src/tools/addresses.ts:11-20 (registration)Registration of the 'pohoda_list_addresses' tool with its schema definition within the 'registerAddressTools' function.
server.tool( "pohoda_list_addresses", "List addresses from POHODA addressbook. Supports filtering by id, company name, IČO, last changes date, or code. Returns JSON array of matching address records.", { id: z.number().optional().describe("Filter by address ID"), companyName: z.string().optional().describe("Filter by company name"), ico: z.string().optional().describe("Filter by IČO (company ID number)"), lastChanges: z.string().optional().describe("Filter by last changes date (DD.MM.YYYY or YYYY-MM-DD)"), code: z.string().optional().describe("Filter by address code"), },