firebed / vat-registry
商业登记信息搜索
v1.0.4
2024-06-05 11:48 UTC
Requires
- php: ^8.0
- ext-mbstring: *
- ext-soap: *
Requires (Dev)
- phpunit/phpunit: ^10.0
README
通过使用本服务,法律实体、法律主体和从事商业活动的自然人可以搜索基本信息,以确定其他法律实体或法律主体或从事商业活动的纳税人/自然人的税务或职业身份。
系统提供两种基本企业信息搜索方式
- 通过基本企业信息搜索服务
- 通过增值税信息交换系统(VIES)
安装
composer require firebed/vat-registry
通过基本企业信息搜索服务
该服务允许搜索所有希腊税号(AΦΜ)。搜索需要username
和password
。
注册过程
有关更多详情和注册,请访问AADE官方网站。
注册后,您将获得使用该服务所需的username
和password
。
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();