liagkos / vatidinfo
从税务登记处检索希腊商业信息
v1.0.6
2020-04-01 08:19 UTC
README
此类实现了希腊税务登记增值税ID信息服务的最新版本。此服务仅提供作为商业注册的增值税ID信息(不提供个人信息的查询),您需要先从此链接获取一些额外的凭证。
增加了两个功能
- 检查增值税状态(正常或免税),对第39A条款很有用
- 检查过去某个特定日期的状态(最多3年)
安装
使用Composer安装此包
composer require liagkos/vatidinfo
用法
try { $client = new Liagkos\Taxis\Vatidinfo('Username-Token', 'Password-Token'); } catch (Exception $e) { echo $e->getMessage(); // Or whatever for SOAP error (NOT authentication error) die($e->getCode()); // Or whatever for SOAP error (NOT authentication error) } $params = [ 'method' => 'query', 'afmFor' => '123456789', 'afmFrom' => '999999999', 'lookDate' => '2017-12-31', 'type' => 'array', 'separator' => '-' ]; $reply = $client->exec($params);
参数说明
- method
- query: 正常操作,请求增值税ID信息(默认)
- info: 获取一些与服务相关的信息
- afmFor: 如果方法为
query
,则这是您必须传递并获取信息的增值税ID - afmFrom: 使用服务的最终用户的增值税ID。如果省略,则服务将认为用户是构造函数中登录到服务的人(默认)。否则,如果个人或公司已授权用户代表其进行查询(公司本身不允许进行查询),则您必须在这里传递授权人的增值税ID。
- lookDate: 格式为YYYY-MM-DD的参考日期。如果省略,则服务将仅返回最新的信息(默认)。
- separator: 活动以2位数分组,由此分隔符分隔。如果没有传递值,则将使用点(默认),例如11.22.33.44。
- type: 默认回复类型是格式化的
json
。如果您更喜欢关联数组,则将此值设置为array
或任何其他值(它不会被检查)。
回复示例
{ "success":true, "data":{ "found":true, "queryid":"863209758", "errors":false, "caller":{ "user":{ "username":"USERNAME", "fullname":"ΠΑΠ*** ΓΕΩ*** του ΙΩΑ***", "vatid":"123456789" }, "owner":{ "fullname":"ΠΑΠ*** ΓΕΩ*** του ΙΩΑ***", "vatid":"999999999" } }, "data":{ "dateShown":{ "date":"2018-07-11 00:00:00.000000", "timezone_type":3, "timezone":"UTC" }, "name":"ΔΗΜΟΣΙΑ ΕΠΙΧΕΙΡΗΣΗ ΗΛΕΚΤΡΙΣΜΟΥ ΑΝΩΝΥΜΗ ΕΤΑΙΡΙΑ", "title":"Δ.Ε.Η. Α.Ε. - Δ.Ε.Η.", "vatid":"090000045", "doyID":"1159", "doyName":"Φ.Α.Ε. ΑΘΗΝΩΝ", "address":{ "street":"ΧΑΛΚΟΚΟΝΔΥΛΗ", "number":"30", "city":"ΑΘΗΝΑ", "zip":"10432" }, "isWhat":"ΜΗ ΦΠ", "isCompany":true, "companyType":"ΑΕ", "isActive":true, "isActiveTxt":"ΕΝΕΡΓΟΣ ΑΦΜ", "type":"ΕΠΙΤΗΔΕΥΜΑΤΙΑΣ", "regDate":{ "date":"1900-01-01 00:00:00.000000", "timezone_type":3, "timezone":"UTC" }, "stopDate":false, "normalVat":true, "activities":{ "1":{ "descr":"ΚΥΡΙΑ", "items":[ { "code":35141000, "descr":"ΥΠΗΡΕΣΙΕΣ ΕΜΠΟΡΙΟΥ (ΠΩΛΗΣΗΣ) ΗΛΕΚΤΡΙΚΟΥ ΡΕΥΜΑΤΟΣ", "formatted":"35.14.10.00" } ] }, "2":{ "descr":"ΔΕΥΤΕΡΕΥΟΥΣΑ", "items":[ { "code":5200000, "descr":"ΕΞΟΡΥΞΗ ΛΙΓΝΙΤΗ", "formatted":"05.20.00.00" }, { "code":35111000, "descr":"ΠΑΡΑΓΩΓΗ ΗΛΕΚΤΡΙΚΟΥ ΡΕΥΜΑΤΟΣ", "formatted":"35.11.10.00" }, { "code":35111001, "descr":"ΠΑΡΑΓΩΓΗ ΗΛΕΚΤΡΙΚΗΣ ΕΝΕΡΓΕΙΑΣ ΑΠΟ ΑΕΡΟΣΤΡΟΒΙΛΙΚΕΣ ΜΟΝΑΔΕΣ ΠΕΤΡΕΛΑΙΟΥ", "formatted":"35.11.10.01" }, { "code":35111002, "descr":"ΠΑΡΑΓΩΓΗ ΗΛΕΚΤΡΙΚΗΣ ΕΝΕΡΓΕΙΑΣ ΑΠΟ ΛΙΓΝΙΤΙΚΕΣ ΜΟΝΑΔΕΣ", "formatted":"35.11.10.02" }, { "code":35111005, "descr":"ΠΑΡΑΓΩΓΗ ΗΛΕΚΤΡΙΚΗΣ ΕΝΕΡΓΕΙΑΣ ΑΠΟ ΜΟΝΑΔΕΣ ΦΥΣΙΚΟΥ ΑΕΡΙΟΥ", "formatted":"35.11.10.05" }, { "code":35111007, "descr":"ΠΑΡΑΓΩΓΗ ΗΛΕΚΤΡΙΚΗΣ ΕΝΕΡΓΕΙΑΣ ΑΠΟ ΣΤΑΘΜΟΥΣ ΕΣΩΤΕΡΙΚΗΣ ΚΑΥΣΗΣ", "formatted":"35.11.10.07" }, { "code":35111008, "descr":"ΠΑΡΑΓΩΓΗ ΗΛΕΚΤΡΙΚΗΣ ΕΝΕΡΓΕΙΑΣ ΑΠΟ ΥΔΡΟΗΛΕΚΤΡΙΚΟΥΣ ΣΤΑΘΜΟΥΣ", "formatted":"35.11.10.08" }, { "code":35121000, "descr":"ΥΠΗΡΕΣΙΕΣ ΜΕΤΑΔΟΣΗΣ ΗΛΕΚΤΡΙΚΟΥ ΡΕΥΜΑΤΟΣ", "formatted":"35.12.10.00" }, { "code":35131000, "descr":"ΥΠΗΡΕΣΙΕΣ ΔΙΑΝΟΜΗΣ ΗΛΕΚΤΡΙΚΟΥ ΡΕΥΜΑΤΟΣ", "formatted":"35.13.10.00" }, { "code":77401901, "descr":"ΥΠΗΡΕΣΙΕΣ ΜΕΤΑΒΙΒΑΣΗΣ Η ΠΑΡΑΧΩΡΗΡΗΣ ΧΡΗΣΗΣ ΑΥΛΩΝ ΑΓΑΘΩΝ (ΔΙΚΑΙΩΜΑΤΩΝ ΠΝΕΥΜΑΤΙΚΗΣ ΙΔΙΟΚΤΗΣΙΑΣ, ΔΙΚΑΙΩΜΑΤΩΝ ΕΚΠΟΜΠΗΣ ΑΕΡΙΩΝ ΘΕΡΜΟΚΗΠΙΟΥ, ΔΙΠΛΩΜΑΤΩΝ ΕΥΡΕΣΙΤΕΧΝΙΑΣ, ΑΔΕΙΩΝ ΕΚΜΕΤΑΛΛΕΥΣΗΣ ΒΙΟΜΗΧΑΝΙΚΩΝ ΚΑΙ ΕΜΠΟΡΙΚΩΝ ΣΗΜΑΤΩΝ ΚΑΙ ΠΑΡΟΜΟΙΩΝ ΔΙΚΑΙΩΜΑΤΩΝ", "formatted":"77.40.19.01" } ] } } } } }
大多数字段都是自解释的,但请记住
success
为true表示SOAP请求已成功完成,无论增值税ID是否找到或凭证是否正确found
为true表示我们实际上为此增值税ID获得了信息errors
为false如果没有错误,或者如果存在服务错误,则是一个包含键code
和msg
的数组dateShown
、regDate
和stopDate
是DateTime
对象regDate
将为false,如果增值税ID属于旧(非活动)业务(回复为null)stopDate
将为false,如果增值税ID尚未停止其业务或属于没有停止日期的旧业务activities
将为false,如果没有可用数据(旧已停止的业务)activities
按类型排序,然后按代码排序
就这么多!
我希望您像我一样觉得它很有用。如果您有任何建议或问题,请随时联系我!