常见问题

积分是你使用我们 API 的货币。每次请求根据端点和所选选项消耗一定数量的积分。

你可以通过三种方式获得积分：

• 注册奖励: 新用户注册即可获得 150 免费积分
• 每月订阅积分: 每个套餐都包含每月积分额度
• 充值: 按需购买额外积分

费用取决于端点和所选数据。详细信息请见：

• 我们的 API 文档列出了所有端点及其价格
• 使用首页上的积分计算器估算你的费用

这取决于你是否有订阅：

• 有订阅时: 订阅期间，充值积分和注册奖励不会过期
• 无订阅时: 积分自入账起 30 天内有效
• 订阅积分: 有效期至当前计费周期结束

当你的余额不足时：

• API 请求将返回“Insufficient credits”错误（HTTP 402）
• 购买更多积分，或等待下一次每月订阅积分发放
• 你的账户和 API 访问保持不变，只需补充积分

你可以在仪表板中查看用量；余额不足时会显示提示。

所有套餐均包含：

• 永不过期的积分: 订阅期间，你购买的积分不会过期
• 每月积分额度: 每月获得新积分
• API 访问: 所有端点；部分数据点和筛选条件需 Pro 或 Max

各套餐的额外权益：

• Plus: 适合小型项目和测试
• Pro: 所有积分购买享 5% 奖励，优先支持
• Max: 购买积分享 15% 奖励，最大每月额度，优先支持

• 在每个计费周期开始时，你将获得套餐所含积分；按年付费时每月发放
• 每月积分优先于购买的积分使用
• 未使用的每月积分在周期结束时过期
• 只要订阅有效即可获得每月积分；取消后，持续到已付费期间结束

可以，你可以完全掌控你的订阅：

• 升级: 随时切换到更高套餐：立即生效，开始新的计费周期，并立即按新价格收费
• 降级: 随时切换到较低套餐：立即生效，开始新的计费周期，并立即按新价格收费
• 取消: 随时取消，无最短期限；你的套餐将持续到已付费期间结束
• 恢复: 在已取消的订阅到期前，可在仪表板的“管理”中恢复

重要提示：更换套餐时，剩余的订阅积分会转入新套餐。从按年付费切换为按月付费，需在年度订阅结束后进行。

你可以在仪表板中取消订阅并管理付款信息；在首页的价格区域更换套餐。

当你取消订阅时：

• 每月积分: 在已付费期间结束前仍可使用
• 充值积分: 在已付费期间结束前不会过期；之后恢复其原始到期日期
• API 访问: 只要你还有积分即可继续使用；但人物档案需要有效订阅

你可以在仪表板中或首页价格区域的“Top-up Credits”下购买积分。在仪表板中：

1. 打开你的仪表板
2. 滚动到“购买积分”
3. 使用滑块或快捷数值选择数量
4. 查看奖励和积分总数
5. 通过 Stripe 完成安全结账

购买后积分立即可用。

可以，需有订阅。没有订阅时，充值积分自购买之日起 30 天内有效。只要你有订阅（Plus、Pro 或 Max），它们就不会过期，之前购买的积分也是如此，前提是订阅开始时仍然有效。订阅结束后，恢复其原始到期日期。

一次购买越多，获得的奖励积分越多：

奖励会自动应用，并与你套餐的奖励叠加。

有，每次充值至少 2,000 积分。这样可以确保：

• 每积分的交易成本更低
• 为你提供更优惠的价格
• 减少支付处理工作量

每次购买最多可选择 500,000 积分。

数量奖励和套餐奖励相加计算：

两种奖励均基于基础积分计算。

我们的定价很简单：

• 积分: 每积分 0.01 €（奖励前）
• 订阅: 固定的月度或年度价格，含积分
• 无隐藏费用: 所见即所付

所有价格以欧元计，另加法定增值税。

不包含，所有价格均为净价。适用的增值税取决于你所在的国家和增值税号，将在结账时计算并显示。

我们接受以下支付方式：

• 信用卡（Visa、Mastercard、American Express）
• 借记卡
• PayPal
• 签订 Enterprise 合同后可通过银行转账凭发票付款（[email protected]）

所有在线支付均通过 Stripe 安全处理，符合 PCI 标准。

可以，每笔付款都会自动生成发票：

• 付款后立即可用
• 有订阅时，可随时在仪表板的“查看发票”中获取
• 包含所有必要的税务信息
• 每次付款后通过电子邮件发送

我们的发票符合欧盟税务法规，包含你会计所需的全部信息。

你在结账时通过 Stripe 使用信用卡、借记卡或 PayPal 支付套餐和充值费用，并获得相应发票。签订 Enterprise 合同后，可通过银行转账凭发票付款；请发送邮件至 [email protected]。

永不过期的积分是每个订阅的权益：

• 适用于购买的积分和注册奖励
• 订阅开始时积分必须仍然有效
• 只要订阅有效，就不会过期
• 订阅结束后，恢复自购买之日起 30 天的有效期

积分按以下顺序消耗：

1. 订阅积分 （如果你有订阅）
2. 购买的积分和注册奖励 （最早的优先）

这样可以确保：

• 每月积分在过期前被使用
• 购买的积分保留更久
• 你的积分得到最佳利用

扣除自动进行：

• 积分在响应返回后扣除，且仅针对已交付的数据
• 每次扣除均附带详细记录
• 你的余额即时更新
• 失败的请求不消耗积分，但公司档案的 AI 模式除外：即使出错也会计费

数据库锁定机制确保即使在高负载下每次扣除也准确无误。

AI 模式是公司档案（/api/v1/fetch-organization）的一个选项：

• 更好的匹配：常能找到精确名称搜索遗漏的公司
• 网络数据：联系方式、关键词、产品和服务，以及完整的 WZ 分类
• 额外消耗 20 积分，即使请求失败也计费
• 在 /api/v1/fetch-organization 中可选；在 /api/v1/fetch-person 中始终启用（已含在 15 积分的基础价格中）

我们的服务器位于德国和欧盟。

符合，handelsregister.ai 符合 GDPR。数据来自公开登记册，我们的服务器位于德国和欧盟。

数据处理协议（DPA）可应要求签订。请发送邮件至 [email protected]。

详细内容请见我们的隐私政策。

你可以随时在我们的状态页 handelsregister.ai/status 查看 API 的当前状态。

合同约定的可用性保证（SLA）仅限 Enterprise 合同。

德国商业登记册没有官方 API。handelsregister.ai 是 Fusionbase GmbH 推出的独立 API，以结构化 JSON 提供来自商业登记册、Bundesanzeiger 和破产公告的官方企业数据——可按需实时获取，面向软件和 AI 智能体。

数据来自官方登记册和公开来源，主要包括：

• 德国商业登记册: 法律形式、注册地和管理层等登记数据，以及公告、股东名单和文件
• Unternehmensregister 与 Bundesanzeiger: 已公布的年度财务报表，含资产负债表和损益表
• 破产法院: 破产公告
• 媒体与网络: 新闻、公司网站及其他公开网页

API 包含超过500万家企业和组织。

所有在德国商业登记册或官方登记门户的其他登记册中登记的企业和组织：

• 商业登记册 B 部（HRB）: 资合公司，如 GmbH、UG (haftungsbeschränkt)、AG、SE 和 KGaA
• 商业登记册 A 部（HRA）: 登记商人（e.K.）及人合公司，如 OHG、KG 和 GmbH & Co. KG
• 合作社登记册（GnR）: 登记合作社（eG）
• 合伙登记册（PR）: 自由职业者合伙企业（PartG、PartG mbB）
• 社团登记册（VR）: 登记社团（e.V.）
• 民事合伙登记册（GsR）: 登记民事合伙（eGbR）

借助 AI 模式，你还可以通过公开网页找到未登记的企业，例如个体经营者和自由职业者。

视企业而定，可提供以下数据类别：

并非每家企业都具备所有数据类别；可用性取决于企业规模、法律形式和信息披露义务。

财务数据（资产负债表、损益表、KPI）适用于有义务公布年度财务报表的企业，主要包括：

• 所有 GmbH、UG、AG 和 KGaA
• 某些没有自然人承担无限责任的人合公司（如 GmbH & Co. KG）

详细程度各不相同：较大的企业通常公布更全面的财务报告，较小的企业往往只提交简式资产负债表。个体经营者以及由自然人承担无限责任的人合公司通常没有财务数据。

许多集团会公布两套报表：公司自身的年度财务报表和合并财务报表。在 API、Playground 和公司信息补充（Firmen-Enrichment）中，你可以选择提供哪种报表类型以及多少个财务年度；在公司档案页面上，如果同一年度两者都有，点击一下即可在单体数据和集团数据之间切换。

股东数据主要适用于：

• GmbH 和 UG: 股东名单提交至商业登记册，包含姓名、出资额和持股比例
• AG: 通常不登记个人股东；只有大股东可能通过公开披露得知

可用性取决于是否已向登记册提交最新的股东名单。

我们结合自动化系统和 AI 辅助提取来处理数据：

• 自动读取官方登记文件和公告
• AI 对信息进行结构化、补充和分析
• 整合多个来源的数据并保持最新

这取决于数据来源：

• 商业登记册: 基本数据、人员和登记公告，我们会持续根据登记册保持更新。使用实时模式时，API 会在请求时直接从商业登记册实时获取公司档案。
• 年度财务报表: 新公布的报表我们每天收录。公司最多有十二个月的时间公布，因此最新的报表往往是前年的。
• 破产公告: 法院通常在裁定当天或不久之后公布。
• 文件: 登记摘录、股东名单和公司章程，API 始终直接从商业登记册实时获取。

可以。使用实时模式（参数 realtime_mode）时，API 会在请求时直接从商业登记册实时获取公司档案，包括当前管理层。仅在实时获取成功时额外消耗 10 积分，耗时会多几秒。不使用实时模式时，档案来自我们的数据库。

实时调取不包含前任总经理及其他历史信息。

登记摘录、股东名单和公司章程等文件，API 始终从商业登记册实时调取。如果同一文件在过去 24 小时内已被调取过，我们将从缓存中提供。

可以，需签订 Enterprise 合同：你将获得整个数据库的导出，我们会通过单独的许可协议约定使用权。请发送邮件至 [email protected] 说明你的计划；我们将在一个工作日内回复。

如需单个列表，可使用“搜索与导出”中的导出功能：每次导出最多 5,000 家公司。