siigo_get_trial_balance_by_third
Generate trial balance reports filtered by third parties in Siigo accounting software. Specify date ranges, account codes, and tax difference inclusion to analyze financial data by customer.
Instructions
Get trial balance by third party report
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account_end | No | Ending account code | |
| account_start | No | Starting account code | |
| customer | No | Customer filter | |
| includes_tax_difference | Yes | Include tax differences | |
| month_end | Yes | Ending month (1-13) | |
| month_start | Yes | Starting month (1-13) | |
| year | Yes | Year |
Implementation Reference
- src/index.ts:1131-1134 (handler)MCP tool handler function that delegates to SiigoClient.getTrialBalanceByThird and formats the response as JSON text.private async handleGetTrialBalanceByThird(args: any) { const result = await this.siigoClient.getTrialBalanceByThird(args); return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] }; }
- src/index.ts:753-765 (schema)Input schema defining parameters for the trial balance by third party report.inputSchema: { type: 'object', properties: { account_start: { type: 'string', description: 'Starting account code' }, account_end: { type: 'string', description: 'Ending account code' }, year: { type: 'number', description: 'Year' }, month_start: { type: 'number', description: 'Starting month (1-13)' }, month_end: { type: 'number', description: 'Ending month (1-13)' }, includes_tax_difference: { type: 'boolean', description: 'Include tax differences' }, customer: { type: 'object', description: 'Customer filter' }, }, required: ['year', 'month_start', 'month_end', 'includes_tax_difference'], },
- src/index.ts:750-766 (registration)Registration of the tool in the getTools() method, including name, description, and input schema.{ name: 'siigo_get_trial_balance_by_third', description: 'Get trial balance by third party report', inputSchema: { type: 'object', properties: { account_start: { type: 'string', description: 'Starting account code' }, account_end: { type: 'string', description: 'Ending account code' }, year: { type: 'number', description: 'Year' }, month_start: { type: 'number', description: 'Starting month (1-13)' }, month_end: { type: 'number', description: 'Ending month (1-13)' }, includes_tax_difference: { type: 'boolean', description: 'Include tax differences' }, customer: { type: 'object', description: 'Customer filter' }, }, required: ['year', 'month_start', 'month_end', 'includes_tax_difference'], }, },
- src/index.ts:173-174 (registration)Dispatcher case in the CallToolRequestSchema handler that routes to the tool's handler function.case 'siigo_get_trial_balance_by_third': return await this.handleGetTrialBalanceByThird(args);
- src/siigo-client.ts:266-279 (helper)SiigoClient helper method that performs the actual API request to the Siigo /v1/trial-balance-by-third endpoint.async getTrialBalanceByThird(params: { account_start?: string; account_end?: string; year: number; month_start: number; month_end: number; includes_tax_difference: boolean; customer?: { identification: string; branch_office?: number; }; }): Promise<SiigoApiResponse<any>> { return this.makeRequest<any>('GET', '/v1/trial-balance-by-third', undefined, params); }