burtds/laravel-vatnumber-checker

为Laravel提供的一个简单的增值税号码检查包。

v1.0.2 2024-03-14 08:00 UTC

This package is auto-updated.

Last update: 2024-09-17 11:52:54 UTC


README

Latest Version on Packagist GitHub Workflow Status Total Downloads

关于laravel-vatnumber-checker

一个小型包,允许您轻松检索与增值税号码相关联的信息。验证有效性、公司名称和公司地址仅需一个API调用。

如何使用laravel-vatnumber-checker

安装

您可以通过composer安装此包

composer require burtds/laravel-vatnumber-checker

之后,您就可以获取所需的信息了。

用法

此包使用由欧洲委员会提供的API,名为"VIES"。

我们将在文件顶部导入此包的外观。

use Burtds\VatChecker\Facades\VatChecker

完成这些操作后,您将能够使用提供的函数。在此示例中,我们使用Vulpo BV的增值税号码。

$validVatNumber = '0749617582' // Vulpo BV's VAT number

// returns a raw response of the European Commission's API
VatChecker::getRawVatInstance('BE', $validVatNumber); 

// returns the validity of a VAT number
VatChecker::isVatValid('BE', $validVatNumber); 

// returns the company name related to the VAT number
VatChecker::getCompanyName('BE', $validVatNumber); 

// returns the company address related to the VAT number
VatChecker::getCompanyAddress('BE', $validVatNumber); 

所有方法均支持单个参数。

$validVatNumber = 'BE0749617582' // Vulpo BV's VAT number

// returns a raw response of the European Commission's API
VatChecker::getRawVatInstance($validVatNumber); 

// returns the validity of a VAT number
VatChecker::isVatValid($validVatNumber); 

...

验证规则

此包还提供了一个简单的验证规则。

use Burtds\VatChecker\Rules\VatNumber;

$validatedData = $request->validate([
    'vat_number' => ['required', new VatNumber],
]);

如果提供的增值税号码有效,此示例将通过验证。如果不正确,它将返回一个整洁的错误消息。

测试与代码格式化

对于测试,您可以运行

composer test

对于使用Laravel Pint格式化代码,您可以运行

composer format

安全漏洞

如果您在此包中发现安全漏洞,请通过bert@bert.gent发送电子邮件给我。我会尽快回复您。

鸣谢

许可

此包是开源软件,根据MIT许可证授权。