SuperAPI AI 工具集

abn-entity-lookup

办公与效率

查看项目

更新于 10-15 19:49

技能介绍

用途:查询澳大利亚商业登记处(ABR),校验 ABN、获取实体名称、判断实体类型、检查 GST 注册状态以及 ABN 是否处于有效或已注销状态,常用于承包商判定分析、工资税合规和实体类型确定。

主要能力:支持按 ABN 查询(主接口 ABRSearchByABN),另有按 ACN 查询(ABRSearchByASIC)、按名称模糊查询(ABRSearchByName)及带州/邮编过滤的高级名称查询(ABRSearchByNameAdvanced)。可提取实体名称、实体类型代码、ABN 状态、GST 注册与状态、州、邮编、ACN 等字段,并映射到税率、更正期和工资税分组等税务含义。

使用方式:接口端点为 https://abr.business.gov.au/abrxmlsearch/AbrXmlSearch.asmx/ABRSearchByABN,参数包括 searchString(必填,11 位 ABN)、includeHistoricalDetails(可选,Y/N,默认 N)、authenticationGuid(必填,来自环境变量 ABR_GUID)。调用前建议在客户端做格式校验:必须为 11 位数字,首位减 1 后按权重 [10,1,3,5,7,9,11,13,15,17,19] 相乘求和,结果需能被 89 整除。

适用场景:付款前校验承包商 ABN、为新 Xero 组织连接填充实体信息、交叉核对 Xero 联系人 ABN 的数据质量、判断输入税额抵免资格等。

限制与注意事项:ABR 数据为公开信息,无需同意即可查询,但缓存含个体经营者姓名的响应涉及隐私,建议最多缓存 24 小时并限制访问;ABN 状态与 GST 状态需分别检查;ABR 未公布速率限制,建议不超过每秒 1 次请求;ABN 未找到时应优雅处理,实体可能刚注册或已注销。