owowagency/laravel-vatlayer

Laravel Vatlayer 是一个非常小巧的包,可以帮助您连接 Laravel 应用程序与 Vatlayer API

1.0.0 2020-06-29 08:54 UTC

This package is auto-updated.

Last update: 2024-08-29 05:43:22 UTC


README

Latest Stable Version Total Downloads Build status

Laravel Vatlayer 是一个非常小巧的包,可以帮助您连接您的 Laravel 应用程序与 Vatlayer API

安装

安装非常快速和简单。通过 Composer 安装该包,您就可以使用了。

composer require owowagency/laravel-vatlayer

设置

该包需要从 Vatlayer API 获取一个 API 密钥。您可以在这里请求一个。一旦设置完成,您需要将以下配置添加到您的 services.php 配置文件中

'vatlayer' => [
    'key' => env('VATLAYER_KEY'),
    'encrypted' => env('VATLAYER_ENCRYPTED', false)
],

现在您可以在 .env 文件中设置您的 API 密钥。encrypted 布尔值指示 API 请求是否应通过 https 或 http 进行。这取决于您使用的订阅计划。如果您使用的是免费计划,应将此变量设置为 false,如果您有付费订阅,则绝对应将此变量设置为 true

用法

该包附带一个 Facade 辅助工具,可以快速调用任何方法。目前该包只提供两个可用的方法。

执行验证请求

要检查增值税号是否具有有效的格式、有效值,并接收属于增值税号的公司的名称和地址,应调用 validate($vatNumber) 方法。

$response = \Vatlayer::validate('NL123456789B01');

// The response looks like: 
$response = [
  'valid' => true,
  'format_valid' => true,
  'query' => 'NL123456789B01',
  'country_code' => 'NL',
  'vat_number' => '855020970B01',
  'company_name' => 'OWOW PROJECTS B.V.',
  'company_address' => ' FUUTLAAN 00014 UNIT E 5613AB EINDHOVEN ',
];

检查增值税号

要快速检查增值税号是否有效,请使用 isValidVatNumber($vatNumber) 方法。此方法返回一个布尔值以检查该号码是否具有有效格式并且是已知的欧洲增值税号。

$valid = \Vatlayer::isValidVatNumber('NL123456789B01');