vmdoh / php-taxcloud
税云PHP库
Requires
- php: >=5.3.0
- ext-soap: *
This package is not auto-updated.
Last update: 2018-06-10 09:48:57 UTC
README
到目前为止,实现订单所需的大部分功能都已实现。唯一剩下的待全面测试和实现的功能是免税。
提供了一个烟雾测试,该测试使用存储在环境变量中的凭据连接到税云API。它旨在进行快速测试以确保库的核心功能正常工作,但它不是彻底的测试。请不要使用实际网站的凭据运行烟雾测试。它将创建交易。
烟雾测试还提供了一套优秀的示例,说明如何使用此库。
关于
PHP库,可帮助您的PHP网络应用程序与税云进行通信。
兼容性
php-taxcloud已与PHP 5.3及更高版本进行了测试。
贡献
如果您想帮助php-taxcloud,您的努力将受到赞赏!
但是,您的代码应至少在一定程度上遵循PSR-2指南,并且API更改应附带测试。
入门
此库要求您拥有税云和美国邮政局的API凭据。
要获取税云API密钥,您需要首先在税云注册一个账户,验证您的网站,然后获取您特定网站的API ID和API 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。这将创建交易