firebed/vat-registry

商业登记信息搜索

安装: 32

依赖: 0

建议者: 0

安全: 0

星标: 3

关注者: 1

分支: 1

开放问题: 0

类型:package

v1.0.4 2024-06-05 11:48 UTC

This package is auto-updated.

Last update: 2024-09-05 12:24:58 UTC


README

通过使用本服务,法律实体、法律主体和从事商业活动的自然人可以搜索基本信息,以确定其他法律实体或法律主体或从事商业活动的纳税人/自然人的税务或职业身份。

系统提供两种基本企业信息搜索方式

  • 通过基本企业信息搜索服务
  • 通过增值税信息交换系统(VIES)

安装

composer require firebed/vat-registry

通过基本企业信息搜索服务

该服务允许搜索所有希腊税号(AΦΜ)。搜索需要usernamepassword

注册过程

有关更多详情和注册,请访问AADE官方网站

注册后,您将获得使用该服务所需的usernamepassword

use Firebed\VatRegistry\TaxisNet;
use Firebed\VatRegistry\VatException;

$username = 'your-username';
$password = 'your-password';

$taxis = new TaxisNet($username, $password);

try {
    $entity = $taxis->handle('094014201');
    
    print_r($entity);
} catch (VatException $exception) {
    echo "Σφάλμα: " . $exception->getMessage();
}

上述调用的结果

Firebed\VatRegistry\VatEntity {
  +vatNumber: "094014201"
  +taxAuthorityId: "1159"
  +taxAuthorityName: "ΦΑΕ ΑΘΗΝΩΝ"
  +flagDescription: "ΜΗ ΦΠ"
  +valid: true
  +validityDescription: "ΕΝΕΡΓΟΣ ΑΦΜ"
  +firmFlagDescription: "ΕΠΙΤΗΔΕΥΜΑΤΙΑΣ"
  +legalName: "ΤΡΑΠΕΖΑ ΕΘΝΙΚΗ ΤΗΣ ΕΛΛΑΔΟΣ ΑΝΩΝΥΜΗ ΕΤΑΙΡΕΙΑ"
  +commerceTitle: ""
  +legalStatusDescription: "ΑΕ"
  +street: "ΑΙΟΛΟΥ"
  +streetNumber: "86"
  +postcode: "10559"
  +city: "ΑΘΗΝΑ"
  +registrationDate: "1900-01-01"
  +stopDate: ""
  +normalVat: true
  +firms: array:2 [
    0 => array:4 [
      "code" => "64191204"
      "description" => "ΥΠΗΡΕΣΙΕΣ ΤΡΑΠΕΖΩΝ"
      "kind" => "1"
      "kindDescription" => "ΚΥΡΙΑ"
    ]
    1 => array:4 [
      "code" => "66221001"
      "description" => "ΥΠΗΡΕΣΙΕΣ ΑΣΦΑΛΙΣΤΙΚΟΥ ΠΡΑΚΤΟΡΑ ΚΑΙ ΑΣΦΑΛΙΣΤΙΚΟΥ ΣΥΜΒΟΥΛΟΥ"
      "kind" => "2"
      "kindDescription" => "ΔΕΥΤΕΡΕΥΟΥΣΑ"
    ]
  ]
}

如果税号(AΦΜ)无效,则返回值null。如果发生其他问题,则VatException将包含相关错误消息。

通过增值税信息交换系统(VIES)

通过使用VIES服务,您可以验证欧盟任何成员国颁发的税号(AΦΜ)的有效性。它提供的信息比AADE服务更有限。

该服务免费,无需注册任何机构。它接受两个参数

  • 国家代码(例如,EL代表希腊)
  • 要验证的税号(AΦΜ)。
use Firebed\VatRegistry\VIES;
use Firebed\VatRegistry\VatException;

$taxis = new VIES();

try {
    $entity = $taxis->handle('EL', '094014201');
    
    print_r($entity);
} catch (VatException $exception) {
    echo "Σφάλμα: " . $exception->getMessage();
}

上述调用的结果

Firebed\VatRegistry\VatEntity {
  +vatNumber: "094014201"
  +taxAuthorityId: null
  +taxAuthorityName: null
  +flagDescription: null
  +valid: true
  +validityDescription: null
  +firmflagDescription: null
  +legalName: "ΤΡΑΠΕΖΑ ΕΘΝΙΚΗ ΤΗΣ ΕΛΛΑΔΟΣ ΑΝΩΝΥΜΗ ΕΤΑΙΡΕΙΑ"
  +commerceTitle: null
  +legalStatusDescription: null
  +street: "ΑΙΟΛΟΥ"
  +streetNumber: "86"
  +postcode: "10559"
  +city: "ΑΘΗΝΑ"
  +registrationDate: null
  +stopDate: null
  +normalVat: null
  +firms: []
}

如果税号(AΦΜ)无效,则服务返回null

辅助方法

个人/公司验证

$entity->isNaturalPerson();
$entity->isCompany();

活动维护验证

// Επιστρέφει true αν η επιχείρηση είναι ενεργή
// Επιστρέφει false αν η επιχείρηση έχει διακοπεί
$entity->isActive();