乌克兰个体工商户（FOP）信息查询数据 API
将乌克兰个体工商户登记数据接入跨境尽调与风控筛查流程
覆盖注册记录号、姓名、经营状态、注册历史、统一登记号、农户标记与税籍登记，支持精确查询、姓名检索、状态核验和批量核查。
把 GB 级原文登记文件转化为可审计的合规数据资产
为什么需要这个数据服务
乌克兰个体工商户（FOP）是乌境内数量最大的经营主体类型。登记数据以 GB 级原文文件发布，编码、字段与状态描述不统一，直接用于跨境尽调和风控筛查时，需要大量解析、翻译与清洗工作。
GB 级原文文件难以使用
原始登记数据为超大规模平面文件，字段编码与空值处理不统一，姓名与状态均为原文，每次接入都需要重新解析和翻译。
经营状态无法自动核验
存续、注销中、已注销、已撤销与破产程序等状态描述以原文文本存在，缺乏统一枚举，人工核对成本高、易出错。
注册历史与税籍分散
首次注册日期、登记更新、统一登记号、税籍登记类型与起止日期分散在多层字段中，难以直接用于结构化比对。
缺乏批量核查能力
对客户名单、供应商或合作方批量做背景筛查时，无法以单条查询方式完成，需要支持批量核查的标准化接口。
从原文登记数据到结构化查询接口
GooFuture 将乌克兰个体工商户登记公开数据经过六步处理，转化为可直接调用的 API。
客户无需自行处理原文解码和字段映射，可直接通过 API 查询标准化后的个体工商户登记信息。
API 产品能力
面向不同核查场景，提供四个核心接口。所有接口返回标准化 JSON，状态字段统一为五类枚举，支持注册记录号、姓名、状态等多维度查询。
FOP 注册档案详情查询
通过注册记录号精确查询个体工商户全量登记信息，包括姓名、经营状态、注册历史、统一登记号、农户标记及税籍登记。
curl "https://api.goofuture.com/v1/ua/fop/652610" \
-H "Authorization: Bearer {api_key}"{
"record_no": "652610",
"name": "比洛乌斯·瓦西里·瓦西里耶维奇",
"name_original": "BILOUS VASYL VASYLIOVYCH",
"status": "已注册（存续）",
"status_code": "ACTIVE",
"farmer": true,
"registration": {
"first_reg_date": "2004-09-16",
"unified_no": "20070000000000075"
},
"tax": [
{
"type": "纳税人登记册",
"start_date": "2007-12-17",
"end_date": null
}
]
}按姓名检索个体工商户
通过姓名进行模糊搜索，支持中文姓名与原文姓名双向检索，返回匹配个体工商户的注册记录号、状态与注册日期。
curl "https://api.goofuture.com/v1/ua/fop/search?name=%E6%AF%94%E6%B4%9B%E4%B9%8C%E6%96%AF&page=1&page_size=20" \
-H "Authorization: Bearer {api_key}"{
"query": "比洛乌斯",
"total": 1,
"page": 1,
"page_size": 20,
"results": [
{
"record_no": "652610",
"name": "比洛乌斯·瓦西里·瓦西里耶维奇",
"status": "已注册（存续）",
"farmer": true,
"first_reg_date": "2004-09-16"
}
]
}经营状态核验
核验个体工商户当前经营状态，返回存续、注销中、已注销、已撤销或已启动破产程序等枚举状态，并附带注销原因。
curl "https://api.goofuture.com/v1/ua/fop/status?record=653792" \
-H "Authorization: Bearer {api_key}"{
"record_no": "653792",
"name": "斯特里卡尔·阿纳托利·伊万诺维奇",
"name_original": "STRYKAL ANATOLII IVANOVYCH",
"status": "已注销",
"status_code": "TERMINATED",
"terminated": {
"date": "2004-11-04",
"record_no": "20090060002000059",
"reason": "依据个体工商户本人决定终止经营活动",
"reason_original": "Державна реєстрація припинення підприємницької діяльності фізичної особи - підприємця за її рішенням"
}
}批量个体工商户核查
传入注册记录号列表，批量返回各主体的经营状态与登记摘要，适用于客户名单批量筛查与供应商准入审查。
curl -X POST "https://api.goofuture.com/v1/ua/fop/batch" \
-H "Authorization: Bearer {api_key}" \
-H "Content-Type: application/json" \
-d '{"records": ["652610", "653792", "671400"]}'{
"total": 3,
"found": 3,
"results": [
{
"record_no": "652610",
"name": "比洛乌斯·瓦西里·瓦西里耶维奇",
"status": "已注册（存续）",
"farmer": true
},
{
"record_no": "653792",
"name": "斯特里卡尔·阿纳托利·伊万诺维奇",
"status": "已注销",
"terminated_reason": "依据个体工商户本人决定终止经营活动"
},
{
"record_no": "671400",
"name": "伦季奇·瓦季姆·阿列克谢耶维奇",
"status": "已注销",
"estate_manager": "伦季奇·瓦季姆·阿列克谢耶维奇",
"terminated_reason": "依据法院判决终止经营活动（与破产无关）"
}
]
}真实业务场景
不同角色和不同阶段的企业，如何使用乌克兰个体工商户（FOP）信息查询数据 API。
跨境贸易尽调
对乌出口或进口前，核查合作方个体工商户是否存续、是否进入破产程序，建立完整的交易对手背景档案。
风控合规筛查
金融机构与支付机构对乌客户名单批量筛查，自动标记注销中、已注销与破产主体，降低合作风险。
催收与法务
确定债务人经营状态、注销日期与注销原因，识别遗产管理人，为债权主张与诉讼执行提供登记依据。
外贸平台集成
物流、电商与 B2B 平台将个体工商户状态核验嵌入商户入驻流程，实现主体存续性自动校验。
乌克兰个体工商户登记数据覆盖
数据覆盖乌克兰登记在册的个体工商户（FOP）主体，含存续、注销中、已注销、已撤销及破产程序五类经营状态。
数据质量与差异化能力
GooFuture 将原文个体工商户登记数据清洗为可直接查询的结构化数据，降低数据接入和维护成本。
状态枚举化
将原文状态描述统一映射为存续、注销中、已注销、已撤销、已启动破产程序五类枚举，同时保留原文对照，便于审计复核。
姓名汉化对照
提供个体工商户姓名的中文音译与拉丁转写对照，同时保留原文，便于中文团队直接使用和复核。
注册历史结构化
拆分首次注册、登记更新与统一登记号等历史字段，统一日期格式，支持按登记时间范围筛选。
终止原因汉化
将注销原因分类汉化（本人决定、简化程序、法院判决、认定失踪等），供风控规则直接引用。
状态变更追踪
跟踪个体工商户经营状态与登记变更，通过 Webhook 推送，避免已核验主体数据过期。
三步接入
从咨询到生产查询，最快可在数小时内完成。
联系顾问
说明跨境尽调或风控筛查场景中的查询需求，确认需要覆盖的数据范围（记录号、姓名、状态、批量规模等）。
确认方案
双方确认接口范围、调用量、并发要求和更新频率。如需要 Webhook 或 CSV 批量交付，在此阶段约定。
开始查询
获取 API Key 和接口文档，通过标准 REST 查询。集成过程中提供技术支持，确保查询结果可直接用于业务系统。
持续维护
按季度同步登记数据，经营状态变更通过 Webhook 推送。顾问持续跟进数据质量和接口稳定性。
# 查询 FOP 注册档案
curl "https://api.goofuture.com/v1/ua/fop/652610" \
-H "Authorization: Bearer {api_key}"
# 核验经营状态
curl "https://api.goofuture.com/v1/ua/fop/status?record=653792" \
-H "Authorization: Bearer {api_key}"
# 批量核查个体工商户
curl -X POST "https://api.goofuture.com/v1/ua/fop/batch" \
-H "Authorization: Bearer {api_key}" \
-H "Content-Type: application/json" \
-d '{"records": ["652610", "653792", "671400"]}'选择适合你的方案
从单条核验到批量尽调，从低频调用到高并发集成，提供四种方案。
常见问题
关于数据范围、更新频率、接口能力和计费方式的常见问题。
数据覆盖哪些个体工商户？
覆盖乌克兰个体工商户（FOP）登记册中的百万级记录，包含存续、注销中、已注销、已撤销以及已启动破产程序的主体。每条记录包含注册记录号、姓名、经营状态、注册历史、统一登记号、农户标记与税籍登记信息。
为什么不直接查询乌克兰企业登记公开数据？
原始数据以 GB 级平面文件发布，编码、字段命名与空值处理不统一，姓名与状态均为原文，且没有提供按注册记录号或姓名检索的查询接口。GooFuture 完成解码、清洗、汉化与结构化，使其可直接通过 API 接入尽调与核查流程。
支持哪些查询条件？
支持注册记录号精确查询、姓名（中文或原文）检索、经营状态核验，以及批量核查。状态字段统一为存续、注销中、已注销、已撤销、已启动破产程序五类枚举。
多久更新一次？
登记数据按季度同步更新。经营状态变更（如新注销、进入破产程序）推送至 Webhook 订阅端。具体更新频率可在方案确认时约定。
能否集成到现有 ERP 或 SaaS 平台？
可以。通过 REST API 返回标准化 JSON，字段固定、枚举值统一。支持 Webhook 推送更新，并可根据需要以 CSV 或 Excel 格式批量交付。
数据是否包含税务信息？
基础接口包含税籍登记类型（如纳税人登记册）及起止日期。详细的税务申报数据不在本服务范围内，可在方案确认时沟通扩展需求。
如何计费？
按套餐月请求量计费。基础版适合低频单条核验，标准版支持姓名检索与状态核验，专业版和企业版支持更高并发、批量核查、Webhook 和定制集成。请联系顾问获取具体方案。
数据范围是否覆盖乌克兰以外？
当前数据仅覆盖乌克兰登记在册的个体工商户（FOP）。其他国家和地区的主体登记数据不在本服务范围内。
将乌克兰个体工商户登记数据接入尽调与风控流程
从经营状态到注册历史，从统一登记号到税籍登记，构建完整的乌克兰主体合规数据底座。
