danvaly / anaf_search
API ANAF 用于验证符合税法第316条注册的纳税人。与 Laravel 10+ 兼容
1.0.0
2023-08-18 00:36 UTC
Requires
- php: ^8.1.0
- ext-curl: *
- ext-json: *
- ext-mbstring: *
- laravel/framework: ^10.0
Requires (Dev)
- phpunit/phpunit: ^10.0
This package is not auto-updated.
Last update: 2024-09-28 04:44:08 UTC
README
PHP 库,用于免费验证符合税法第316条注册的纳税人
可获取的数据
- 公司名称/地址
- 营业执照号码
- 电话号码
- 增值税纳税人/非纳税人
- 增值税收款纳税人
- 增值税分割纳税人(至2020年2月1日)(关于增值税分期支付的条例23/2017自2020年2月1日起被废除)
- 增值税分割IBAN
- 增值税登记日期
- 公司状态(活跃/不活跃)
- 注销日期
安装
composer require danvaly/anaf_search
使用示例
- 初始化库
$anaf = new \Danvaly\AnafSearch\Anaf();
要验证单个CUI,请使用以下方法
$cif = "123456"; $dataVerificare = "YYYY-MM-DD"; $anaf->addCif($cif, $dataVerificare);
如下所示
$cif = "123456"; $dataVerificare = "2019-05-20"; $anaf->addCif($cif, $dataVerificare); $company = $anaf->first(); // Metode disponibile echo $company->getName(); echo $company->getCIF(); echo $company->getRegCom(); echo $company->getPhone(); echo $company->getFullAddress(); echo $company->getAddress()->getCity(); echo $company->getAddress()->getCounty(); echo $company->getAddress()->getStreet(); echo $company->getAddress()->getStreetNumber(); echo $company->getAddress()->getPostalCode(); echo $company->getAddress()->getOthers(); echo $company->getTVA()->hasTVA(); echo $company->getTVA()->getTVAEnrollDate(); echo $company->getTVA()->getTVAEndDate(); echo $company->getTVA()->hasTVACollection(); echo $company->getTVA()->getTVACollectionEnrollDate(); echo $company->getTVA()->getTVACollectionEndDate(); echo $company->getTVA()->hasTVASplit(); echo $company->getTVA()->getTVASplitEnrollDate(); echo $company->getTVA()->getTVASplitEndDate(); echo $company->getTVA()->getTVASplitIBAN(); echo $company->getReactivationDate(); echo $company->getInactivationDate(); echo $company->getDeletionDate(); echo $company->isActive(); sau echo $company->name; echo $company->cif; echo $company->reg_com; echo $company->phone; echo $company->full_address; echo $company->city; echo $company->county; echo $company->street; echo $company->street_number; echo $company->postal_code; echo $company->others; echo $company->has_tva; echo $company->tva_enroll_date; echo $company->tva_end_date; echo $company->has_tva_collection; echo $company->tva_collection_enroll_date; echo $company->tva_collection_end_date; echo $company->has_tva_split; echo $company->tva_split_enroll_date; echo $company->tva_split_end_date; echo $company->tva_split_iban; echo $company->reactivation_date; echo $company->inactivation_date; echo $company->deletion_date; echo $company->is_active; sau $anaf->toArray(); // Returneaza un array cu toate datele $anaf->toJson(); // Returneaza un string JSON cu toate datele
要同时验证多个CUI,请参考以下示例
$anaf->addCif("123456", "2019-05-20"); $anaf->addCif("RO654321"); // Daca data nu este setata, valoarea default va fi data de azi $raspuns = $anaf->get(); // SAU $cifs = [ "123456", "RO6543221" ]; $anaf->addCif($cifs, "2019-05-20"); $raspuns = $anaf->get();
限制
你可以请求最多500个CUI的响应,请求频率为每秒1个请求。
要求
- PHP >= 8.2
- Laravel >= 10.0
- Ext-Curl
- Ext-Json
- Ext-Mbstring
异常
- Danvaly\AnafSearch\Exceptions\LimitExceeded - 你已超过500个CUI/请求的限制;
- Danvaly\AnafSearch\Exceptions\ResponseFailed - 从ANAF收到的响应不是JSON格式,异常返回响应体以便手动检查;
- Danvaly\AnafSearch\Exceptions\RequestFailed - 从ANAF收到的响应状态不是成功状态,请在异常中手动检查收到的响应。
从2到3的升级
版本2与版本3不兼容,如果您有旧的实现,则需要重构以实现兼容性。