teamzac / texas-comptroller-tools
从德克萨斯州审计长网站获取数据的工具
Requires
- php: >=5.6.4
- emanueleminotto/simple-html-dom: ^1.5
- guzzlehttp/guzzle: ~5.3|~6.0
- illuminate/support: 5.4.*
- nesbot/carbon: ~1.20
Requires (Dev)
- mockery/mockery: 0.9.*
- phpunit/phpunit: ~4.0
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)。有关更多信息,请参阅 许可证文件。