vmdoh / php-taxcloud

此包已被废弃,不再维护。没有建议的替代包。

税云PHP库

v0.1.1 2013-12-10 10:20 UTC

This package is not auto-updated.

Last update: 2018-06-10 09:48:57 UTC


README

Latest Stable Version Total Downloads Build Status Coverage Status

到目前为止,实现订单所需的大部分功能都已实现。唯一剩下的待全面测试和实现的功能是免税。

提供了一个烟雾测试,该测试使用存储在环境变量中的凭据连接到税云API。它旨在进行快速测试以确保库的核心功能正常工作,但它不是彻底的测试。请不要使用实际网站的凭据运行烟雾测试。它将创建交易。

烟雾测试还提供了一套优秀的示例,说明如何使用此库。

关于

PHP库,可帮助您的PHP网络应用程序与税云进行通信。

兼容性

php-taxcloud已与PHP 5.3及更高版本进行了测试。

贡献

如果您想帮助php-taxcloud,您的努力将受到赞赏!

但是,您的代码应至少在一定程度上遵循PSR-2指南,并且API更改应附带测试。

入门

此库要求您拥有税云和美国邮政局的API凭据。

要获取税云API密钥,您需要首先在税云注册一个账户,验证您的网站,然后获取您特定网站的API IDAPI KEY

要获取美国邮政局Web Tools的用户ID,您需要填写此表单。您将收到一封包含用户名和密码的电子邮件。您只需要用户名。

如果您已经在某些地方实施了地址验证,则美国邮政局Web Tools用户ID是可选的。重要的是您有准确的地域+4代码,以便进行税务目的。

示例

烟雾测试是一个很好的资源,它以基本直接的方式提供了一个工作示例。如果您需要查看特定功能的工作方式,单元测试是一个更好的资源。单元测试使用存根来模拟API,这些存根可以显示您可以期望的数据类型。

测试

php-taxcloud包括详尽的单元测试,这些测试不需要与API建立实时连接。如果您正在为php-taxcloud做出贡献,请包括您贡献的单元测试。

Travis-ci为此存储库运行单元测试。但是,您可以使用PHPUnit在本地运行它们。

还包括一个连接到API的smoketest,仅用于快速检查基本功能是否未损坏。要使用smoketest,您需要设置以下环境变量

  • TaxCloud_apiLoginID
  • TaxCloud_apiKey
  • TaxCloud_uspsUserID

请勿使用实时站点的凭据运行smoketest。这将创建交易