ANAF API
用于根据税法第316条免费验证注册纳税人的PHP库
可获取的数据:
- 公司名称/地址
- 商业注册号
- 电话号码
- 是否缴纳增值税
- 是否采用收款时缴纳增值税
- 是否采用增值税分账制度(截至2020年2月1日)(关于增值税分账支付的第23/2017号紧急法令自2020年2月1日起废止)
- 增值税分账IBAN
- 增值税登记日期
- 公司状态(活跃/非活跃)
- 注销日期
:heart: 如果对你有帮助,请给个星星 :star:
安装
composer require itrack/anaf
使用示例
- 初始化库
$anaf = new \Itrack\Anaf\Client();
要验证单个CUI,请使用以下方法
$cif = "123456";
$dataVerificare = "YYYY-MM-DD";
$anaf->addCif($cif, $dataVerificare);
根据以下示例:
$cif = "123456";
$dataVerificare = "2019-05-20";
$anaf->addCif($cif, $dataVerificare);
$company = $anaf->first();
// 可用方法
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();
要同时验证多个CUI,请按照以下示例操作:
$anaf->addCif("123456", "2019-05-20");
$anaf->addCif("RO654321"); // 如果未设置日期,默认值将为今天
$raspuns = $anaf->get();
// 或者
$cifs = [
"123456",
"RO6543221"
];
$anaf->addCif($cifs, "2019-05-20");
$raspuns = $anaf->get();
限制
你最多可以同时请求500个CUI的响应,请求速率为1次/秒。
要求
- PHP >= 7.1 | >= 8
- Ext-Curl
- Ext-Json
- Ext-Mbstring
异常:
- Itrack\Anaf\Exceptions\LimitExceeded - 你已超过每个请求500个CUI的限制;
- Itrack\Anaf\Exceptions\ResponseFailed - 从ANAF收到的响应不是JSON格式,异常会返回响应体以供手动检查;
- Itrack\Anaf\Exceptions\RequestFailed - 从ANAF收到的响应状态不成功,请手动检查异常中收到的响应。
从版本2升级到版本3
版本2与版本3不兼容,如果你有旧的实现,需要重新编写以兼容新版本。