litex.regon - 波兰 REGON 数据库的前端

REGON 数据库的简单 Pythonic 包装器（可在 https://wyszukiwarkaregon.stat.gov.pl/appBIR/index.aspx访问 Web 前端）。要访问其 SOAP API，需要一个由 REGON 管理员颁发的 USER_KEY，可在 Regon_Bir@stat.gov.pl 获得。

下面的使用示例：

>>> from litex.regon import REGONAPI

REGONAPI 接受一个参数：服务 URL（由 REGON 管理员提供）。

>>> api = REGONAPI(SERVICE_URL)

首先，需要登录（使用提供的用户密钥）

>>> api.login(USER_KEY)

登录后，就可以开始查询数据库了。搜索方法接受以下参数：

• regon- 单个 REGON 号码（9 位或 14 位长）
• krs- 单个 10 位 KRS 号码
• nip- 单个 NIP（10 位字符串）
• regons- REGON 的集合（它们的长度必须为 14 或 9 位）
• krss- KRS 集合
• nips- NIP 集合

查询中只使用了一个参数。如果通过了多个，则考虑上面列表中的第一个。

另外，detailed可以传递一个参数：detailed=True使搜索方法获取默认的详细报告。

>>> entities = api.search(nip='9999999999')

entities是一个包含搜索结果的 LXML 对象化对象列表（最多 100 个）。如果使用 调用搜索detailed=True，则完整报告可用作detailed属性。

如果知道业务实体的 REGON 和详细的报告名称，则可以直接获取完整的报告：

>>> detailed_report = api.full_report('99999999', 'PublDaneRaportFizycznaOsoba')

可以通过以下方式获取包含给定条件的 REGON 列表的摘要报告：

>>> summary_report = api.summary_report(
        '2020-01-01', 
        'BIR11NowePodmiotyPrawneOrazDzialalnosciOsFizycznych'
    )

报告名称可以在 REGON 管理员提供的文档中找到。

变化

1.0.6

• 搜索方法中更有意义的错误消息（感谢@m-ganko）
• 总结报告（也感谢@m-ganko）

1.0.5

• 重新设计了 REGON 清理逻辑（在搜索功能中，获取详细报告时）
• 搜索方法现在使用 DaneSzukajPodmioty（API 版本 1.1）调用而不是 DaneSzukaj（感谢 @kicaj 的拉取请求）

1.0.4

• 从鼻子迁移到 py.test
• 用于 Python 2 和 3 测试的 tox 配置
• 改进了对详细报告的处理（感谢@miloszsobiczewski 记录问题）

1.0.3

• Python 3.6 兼容性（感谢 Mariusz Witek）

1.0.2

• 移除验证码——当前 API 中不再需要

1.0.1

• 详细的报告获取逻辑重做

1.0.0

• 初始发行