teamzac/texas-comptroller-tools

从德克萨斯州审计长网站获取数据的工具

2.0.0 2017-09-09 03:56 UTC

This package is auto-updated.

Last update: 2024-09-16 08:44:59 UTC


README

请参阅 teamzac/texas-comptroller

许可证

您可以使用此包(它是 MIT 许可)以您认为合适的方式。

安装

您可以通过 composer 安装此包

composer require teamzac/texas-comptroller-tools

本地销售税报告

目前在审计长网站上可用的支持下载两种不同本地销售税报告的类:分配付款详情报告和历史分配付款报告。这两个类都提供了方便的方法,用于下载不同实体类型(城市、县、交通管理局和特别区)的报告。

付款详情报告

创建一个新的报告对象

$report = new TeamZac\TexasComptroller\SalesTax\AllocationReports\PaymentDetail;

使用适当的搜索字符串请求特定实体类型的报告。审计长提供了四种不同的实体类型

$data = $report->forCity('Austin')->get();

$data = $report->forCounty('Parker')->get();

$data = $report->forTransitAuthority('Dallas MTA')->get();

$data = $report->forSpecialDistrict('Bexar Co ESD 3')->get();

返回值将是一个关联数组,键为分配期的日期。每个值将是不同付款组件及其相应金额的关联数组

[
    'YYYY-MM-01' => [
        'total-collections' => 12345.67,
        'prior-period-collections' => 12345.67,
        'current-period-collections' => 12345.67,
        ...
        'net-payment' => 12345.67
    ],
    ...
]

此报告提供最近24个月的数据。

历史付款报告

创建一个新的报告对象

$report = new TeamZac\TexasComptroller\SalesTax\AllocationReports\HistoricalPayments;

使用适当的搜索字符串请求特定实体类型的报告。审计长提供了四种不同的实体类型

$data = $report->forCity('Austin')->get();

$data = $report->forCounty('Parker')->get();

$data = $report->forTransitAuthority('Dallas MTA')->get();

$data = $report->forSpecialDistrict('Bexar Co ESD 3')->get();

返回值将是一个关联数组,键为分配期的日期。每个值将是不同付款组件及其相应金额的关联数组

[
    'YYYY-MM-01' => [
        'net-payment' => 12345.67
    ],
    ...
]

虽然数据嵌套得有点过多,但这是为了保持与付款详情报告的结果的一致性。

比较摘要报告

创建一个新的报告对象

$report = new TeamZac\TexasComptroller\SalesTax\AllocationReports\ComparisonSummary;

使用适当的搜索字符串请求特定实体类型的报告。审计长提供了四种不同的实体类型

$data = $report->forCities()->get();

$data = $report->forCounties()->get();

$data = $report->forTransitAuthorities()->get();

$data = $report->forSpecialDistricts()->get();

返回值将是一个关联数组,包括分配期和实体数组。每个实体将包括名称、当前金额、本年度金额以及每年变化的金额。

[
    'period' => 'YYYY-MM-01',
    'entities' => [
        [
            'entity' => 'Abbott',
            'amount' => 12345.67,
            'amount_delta' => 12345.67,
            'ytd' => 12345.67,
            'ytd_delta' => 12345.67
        ],
        ...
    ]
]

异常

您应使用流畅的报告生成器方法创建请求。如果您未能这样做,您可能会收到一个 InvalidRequest 异常,您可以捕获该异常。

测试

$ composer test

安全

如果您发现任何安全问题,请通过电子邮件 open@teamzac.com 而不是使用问题跟踪器。

关于 TeamZac

TeamZac 是 eight20 咨询的 Web 应用程序开发部门,专注于为地方政府提供服务。您可以在我们的网站上了解更多关于我们的信息 在这里

许可证

MIT 许可证(MIT)。有关更多信息,请参阅 许可证文件