jairforo/php-vat-checker

基于欧盟委员会网络服务的PHP增值税检查器

3.0.0 2021-01-12 16:32 UTC

This package is auto-updated.

Last update: 2024-09-13 00:52:29 UTC


README

Latest Version Build Status StyleCI Total Downloads

一个PHP包,通过增值税号和国家代码的组合帮助您检查欧盟公司的信息。此包是消费欧盟委员会提供的SOAP API网络服务的接口。(http://ec.europa.eu/taxation_customs/vies/checkVatTestService.wsdl

安装

您可以通过composer安装此包

composer require jairforo/php-vat-checker

用法

检查增值税信息。

此检查仅验证增值税信息是否有效。

use JairForo\VATChecker\Exceptions\VATCheckerException;
use JairForo\VATChecker\VATChecker;

try {
    /** @var bool $isValid */
    $isValid = (new VATChecker())->isValid($countryCode, $vatNumber);
} catch (VATCheckerException $exception) {
    // Something went wrong during the request.
}

获取增值税信息。

  • 如果信息无效,将抛出InvalidVATException异常。
  • 如果在请求过程中出现错误,将抛出VATCheckerException异常。
use JairForo\VATChecker\Exceptions\InvalidVATException;
use JairForo\VATChecker\Exceptions\VATCheckerException;
use JairForo\VATChecker\Objects\VATResponse;
use JairForo\VATChecker\VATChecker;

try {
    /** @var VATResponse $vatResponse */
    $vatResponse = (new VATChecker())->check($countryCode, $vatNumber);
    
    print_r($vatResponse);
} catch (VATCheckerException $exception) {
    if ($exception instanceof InvalidVATException) {
        // The VAT information was invalid.
        return;
    }
    
    // Something else went wrong during the request.
}

成功时,上述输出如下

{
  "country_code": "NL",
  "vat_number": "611989431B01",
  "requested_at": {
    "date": "2020-02-02 00:00:00.000000",
    "timezone_type": 1,
    "timezone": "+00:00"
  },
  "company_name": "UNICORN B.V.",
  "address": "UNICORN STREET 007",
  "zipcode": "1108DH",
  "city": "AMSTERDAM",
  "original_address": "UNICORN STREET 007 1108DH AMSTERDAM"
}

测试

composer test

贡献

请参阅CONTRIBUTING以获取详细信息。

许可证

BSD 2-clause "简化"许可证(bsd-2-clause)。请参阅许可证文件以获取更多信息。