tallyprime-sdk 0.2.0

Rust SDK for TallyPrime XML/HTTP integration with typed APIs for masters, vouchers, and financial reports.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

use super::{gst_parser, report_parser, TallyClient};
use crate::errors::Result;
use crate::models::{
    BalanceSheetEntry, GstComputationReport, Gstr1Report, ProfitAndLossEntry, TrialBalanceEntry,
};
use crate::xml_builder::XmlBuilder;

impl TallyClient {
    /// Export the Trial Balance report for an optional date range.
    ///
    /// Dates use `YYYYMMDD`. When `explode_flag` is `true`, Tally expands nested
    /// groups in the XML response.
    pub fn get_trial_balance(
        &self,
        from_date: Option<&str>,
        to_date: Option<&str>,
        explode_flag: bool,
    ) -> Result<Vec<TrialBalanceEntry>> {
        let resp = self.export_builtin_report("Trial Balance", from_date, to_date, explode_flag)?;
        Ok(report_parser::parse_trial_balance_from_xml(&resp))
    }

    /// Export the Balance Sheet report for an optional date range.
    pub fn get_balance_sheet(
        &self,
        from_date: Option<&str>,
        to_date: Option<&str>,
        explode_flag: bool,
    ) -> Result<Vec<BalanceSheetEntry>> {
        let resp = self.export_builtin_report("Balance Sheet", from_date, to_date, explode_flag)?;
        Ok(report_parser::parse_balance_sheet_from_xml(&resp))
    }

    /// Export the Profit and Loss report for an optional date range.
    pub fn get_profit_and_loss(
        &self,
        from_date: Option<&str>,
        to_date: Option<&str>,
        explode_flag: bool,
    ) -> Result<Vec<ProfitAndLossEntry>> {
        let resp =
            self.export_builtin_report("Profit and Loss", from_date, to_date, explode_flag)?;
        Ok(report_parser::parse_profit_and_loss_from_xml(&resp))
    }

    /// Export Tally's builtin **GST Computation** report for a period.
    pub fn get_gst_computation(
        &self,
        from_date: Option<&str>,
        to_date: Option<&str>,
    ) -> Result<GstComputationReport> {
        let resp = self.export_builtin_report("GST Computation", from_date, to_date, false)?;
        Ok(gst_parser::parse_gst_computation_from_xml(&resp))
    }

    /// Build a GSTR-1 style return summary for `[from_date, to_date]`.
    ///
    /// TallyPrime does not currently expose a builtin HTTP report named `GSTR-1`
    /// (export returns "Could not find Report"). This method therefore derives
    /// B2B / B2CL / B2CS / CDNR / HSN / document sections from vouchers in the
    /// range via [`Self::get_vouchers_in_range`].
    pub fn get_gstr1(&self, from_date: &str, to_date: &str) -> Result<Gstr1Report> {
        let vouchers = self.get_vouchers_in_range(from_date, to_date)?;
        Ok(gst_parser::build_gstr1_from_vouchers(
            from_date, to_date, &vouchers,
        ))
    }

    fn export_builtin_report(
        &self,
        report_name: &str,
        from_date: Option<&str>,
        to_date: Option<&str>,
        explode_flag: bool,
    ) -> Result<String> {
        let current_company = self.current_company_name()?;
        let xml = XmlBuilder::create_builtin_report_request(
            report_name,
            from_date,
            to_date,
            current_company.as_deref(),
            explode_flag,
        )?;
        self.post_xml(&xml)
    }
}