README

注册为增值税纳税人的实体列表，包括未注册的、已删除并恢复到增值税登记册的。

下一步将是处理一个平面文件，其中将提供关于NIP-银行账户对的详细信息。该部尚未提供此类文件的存储位置。

更多信息请访问https://www.gov.pl/web/kas/wykaz-podatnikow-vat

用法

搜索方法

该部对单个IP每天的问题数量设限为10个。

nip方法

通过税务识别号搜索单个实体

<?php

use SJRoyd\MF\VATPayers\Params\NIP;
use SJRoyd\MF\VATPayers\Search;
    
try {
    $s = new Search();
    $r = $s->nip(new NIP('0000000000'));
    // $r is a EntityItem instance  
} catch (Exception $e){
    // $e is a Exception instance
}

nips方法

通过税务识别号搜索多个实体

<?php

use SJRoyd\MF\VATPayers\Params\NIP;
use SJRoyd\MF\VATPayers\Search;

try {
    $s = new Search();
    $r = $s->nips(new NIP(['0000000000', '1111111111'])); // max 30 numbers
    // $r is a EntityList instance  
} catch (Exception $e){
    // $e is a Exception instance
}

regon方法

通过REGON号搜索单个实体

<?php

use SJRoyd\MF\VATPayers\Params\REGON;
use SJRoyd\MF\VATPayers\Search;

try {
    $s = new Search();
    $r = $s->regon(new REGON('000000000')); // 9 or 14 digits REGON
    // $r is a EntityItem instance  
} catch (Exception $e){
    // $e is a Exception instance
}

regons方法

通过REGON号搜索多个实体

<?php

use SJRoyd\MF\VATPayers\Params\REGON;
use SJRoyd\MF\VATPayers\Search;

try {
    $s = new Search();
    $r = $s->regons(new REGON(['000000000', '11111111111111'])); // 9 or 14 digits REGONs, max 30 numbers
    // $r is a EntityList instance  
} catch (Exception $e){
    // $e is a Exception instance
}

bankAccount方法

通过银行账户号搜索实体

<?php

use SJRoyd\MF\VATPayers\Params\NRB;
use SJRoyd\MF\VATPayers\Search;

try {
    $s = new Search();
    $r = $s->bankAccount(new NRB('00 0000 0000 0000 0000 0000 0000')); // 26 digits polish bank account number
    // $r is a EntityList instance  
} catch (Exception $e){
    // $e is a Exception instance
}

bankAccounts方法

通过银行账户号搜索多个实体

<?php

use SJRoyd\MF\VATPayers\Params\NRB;
use SJRoyd\MF\VATPayers\Search;

try {
    $s = new Search();
    $r = $s->bankAccounts(new NRB(['00 0000 0000 0000 0000 0000 0000', '12345678901234567890123456'])); // max 30 numbers
    // $r is a EntityList instance  
} catch (Exception $e){
    // $e is a Exception instance
}

检查方法

该部对IP的每天问题数量设限为1个。

nip方法

通过NIP和银行账户号检查单个实体

<?php

use SJRoyd\MF\VATPayers\Params\NIP;
use SJRoyd\MF\VATPayers\Params\NRB;
use SJRoyd\MF\VATPayers\Check;

try {
    $c = new Check();
    $r = $c->nip(new NIP('0000000000'), new NRB('00 0000 0000 0000 0000 0000 0000'));
    // $r is a EntityCheck instance  
} catch (Exception $e){
    // $e is a Exception instance
}

regon方法

通过REGON和银行账户号检查单个实体

<?php

use SJRoyd\MF\VATPayers\Params\REGON;
use SJRoyd\MF\VATPayers\Params\NRB;
use SJRoyd\MF\VATPayers\Check;
use SJRoyd\MF\VATPayers\Exception;

try {
    $c = new Check();
    $r = $c->regon(new REGON('000000000'), new NRB('00 0000 0000 0000 0000 0000 0000'));
    // $r is a EntityCheck instance 
} catch (Exception $e){
    // $e is a Exception instance
}

响应

实体列表

包含方法

• getSubjects(): array[Entity] - 实例列表
• getRequestId(): string - 请求ID，例如 9mll9-85feng0

实体项

包含方法

• getSubject(): Entity - 实例
• getRequestId(): string - 请求ID，例如 9mll9-85feng0

实体检查

包含方法

• getAccountAssigned(): boolean - 是否将账户分配给活动实体
• getRequestId(): string - 请求ID，例如 9mll9-85feng0

实体

实体

包含方法

• getName(): string - 公司名称（名称）或姓名和姓氏
• getNip(): string - （可选）NIP识别号
• getStatusVat(): string - （可选）增值税纳税人状态；枚举：Czynny、Zwolniony、Niezarejestrowany
• getRegon(): string - （可选）REGON识别号
• getPesel(): string - （可选）PESEL识别号
• getKrs(): string - （可选）如果发放，则KRS号
• getResidenceAddress(): string - （可选）总部地址
• getWorkingAddress(): string - （可选）永久性机构的地址或在没有永久性地址的情况下，居住地址
• getRepresentatives(): array[EntityPerson] - （可选）授权代表实体的成员的姓名和姓氏以及他们的NIP和/或PESEL号
• getAuthorizedClerks(): array[EntityPerson] - （可选）代理人的姓名和姓氏以及他们的NIP和/或PESEL号
• getPartners(): array[EntityPerson] - （可选）合作伙伴的姓名和姓氏或公司（名称）以及他的NIP和/或PESEL号
• getRegistrationLegalDate(): DateTime - （可选）注册为增值税纳税人的日期
• getRegistrationDenialDate(): DateTime - （可选）拒绝注册为增值税纳税人的日期
• getRegistrationDenialBasis(): string - （可选）拒绝注册的法律依据
• getRestorationDate(): DateTime - （可选）恢复为增值税纳税人的日期
• getRestorationBasis(): string - （可选）恢复为增值税纳税人的法律依据
• getRemovalDate(): DateTime - （可选）删除拒绝注册为增值税纳税人的日期
• getRemovalBasis(): string - （可选）恢复为增值税纳税人的法律依据
• getAccountNumbers(): array[string] - (可选) 银行账户列表
• getHasVirtualAccounts(): boolean - (可选) 该实体是否有虚拟账户掩码
• isVatActive(): boolean - 纳税人是否活跃？
• isVatExempt(): boolean - 纳税人是否免税？
• isVatUnregistered(): boolean - 纳税人是否未注册？

实体人员

包含方法

• getCompanyName() - (可选)
• getFirstName() - (可选)
• getLastName() - (可选)
• getNip() - (可选)
• getPesel() - (可选)

异常

异常实例

一个实例扩展PHP Exception并继承所有父类方法。

方法

• getMessage(): string - 错误信息
• getCode(): string - 示例：WL-101