rechtlogisch/steuer-id

验证德国税务识别号(Steuerliche Identifikationsnummer)

v1.1.0 2024-07-09 19:04 UTC

This package is auto-updated.

Last update: 2024-09-09 19:34:21 UTC


README

Recht logisch Steuer-ID banner image

Latest Version on Packagist Tests Total Downloads

steuer-id

验证德国税务识别号(Steuerliche Identifikationsnummer)

基于官方ELSTER文档(第2章;截至2024-06-17)。

提示:此包仅验证提供的输入的语法和校验位。它不确认已验证的税务识别号是否分配给个人。如果您对您的税务识别号不确定,请联系德国税务局

安装

您可以通过composer安装此包

composer require rechtlogisch/steuer-id

用法

isSteuerIdValid('02476291358'); // => true

use Rechtlogisch\SteuerId\SteuerId;

(new SteuerId('02476291358'))
    ->validate() // ValidationResult::class
    ->isValid(); // => true

测试税务识别号

默认启用对测试税务识别号(以0开头)的支持。测试税务识别号在生产环境中通常是无效的。建议使用以下环境变量禁用它们

STEUERID_PRODUCTION=true

或PHP中

putenv('STEUERID_PRODUCTION=true');

验证错误

您可以获取一个错误列表,解释为什么提供的输入无效。validate()方法返回一个包含getErrors()方法的DTO。

提示:getErrors()的键持有异常类的字符串化引用。您可以通过与::class常量进行比较来检查特定错误。例如:Rechtlogisch\UstId\Exceptions\InvalidUstIdLength::class

validateSteuerId('x2476291358')->getErrors();
// [
//   'Rechtlogisch\SteuerId\Exceptions\SteuerIdCanContainOnlyDigits'
//    => ['Only digits are allowed.']
// ]

use Rechtlogisch\SteuerId\SteuerId;

(new SteuerId('x2476291358'))
    ->validate() // ValidationResult::class
    ->getErrors();
// [
//   'Rechtlogisch\SteuerId\Exceptions\SteuerIdCanContainOnlyDigits'
//    => ['Only digits are allowed.']
// ]

测试

composer test

变更日志

请参阅CHANGELOG以获取有关最近更改的更多信息。

贡献

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

安全漏洞

如果您发现任何与安全相关的问题,请通过电子邮件open-source@rechtlogisch.de联系,而不是使用问题跟踪器。

致谢

许可

MIT许可(MIT)。有关更多信息,请参阅许可文件