该接口用于在企业KYB流程中添加上级母公司(Parent Company)信息。通过提交母公司的注册信息、地址信息等,完成企业股权结构的上层信息收集。接口支持新增和修改两种操作:当请求中包含uuid字段时表示修改已有母公司信息,不包含uuid时表示新增母公司信息。每个企业最多允许添加5个上级母公司。
字段名 类型 必填 说明 uid string 是 用户ID,用于标识当前操作的企业用户 uuid string 否 母公司唯一标识ID,修改时必填,新增时不填
字段名 类型 必填 说明 entity_type array 是 企业实体类型,如:["Holding Company"](控股公司) entity_legal_identification_number string 是 企业法定注册号/识别码 entity_legal_name string 是 企业法定全称 trade_name string 否 企业商号/经营用名称 parent_company string 是 是否有母公司,默认“No”代表无母公司。切换“Yes”可正常添加母公司。 country_of_formation string 是 企业注册国家/地区
字段名 类型 必填 说明 date_of_formation string 是 企业成立日期,格式:YYYY-MM-DD
字段名 类型 必填 说明 registered_country string 是 注册地址国家 registered_city string 是 注册地址城市 registered_state string 是 注册地址州/省 registered_zipcode string 是 注册地址邮政编码 registered_address1 string 是 注册地址第一行 registered_address2 string 否 注册地址第二行
字段名 类型 必填 说明 business_country string 是 实际经营地址国家 business_city string 是 实际经营地址城市 business_state string 是 实际经营地址州/省 business_zipcode string 是 实际经营地址邮政编码 business_address1 string 是 实际经营地址第一行 business_address2 string 否 实际经营地址第二行
JSON
{
"uid": "1234567",
"entity_type": ["Holding Company"],
"entity_legal_identification_number": "HOLD987654321",
"entity_legal_name": "Acme Holdings Inc",
"trade_name": "Acme Holdings",
"date_of_formation": "2015-03-10",
"registered_country": "US",
"registered_city": "Wilmington",
"registered_state": "DE",
"registered_zipcode": "19801",
"registered_address1": "789 Corporate Boulevard, Downtown District",
"registered_address2": "Suite 1500",
"business_country": "US",
"business_city": "Wilmington",
"business_state": "DE",
"business_zipcode": "19801",
"business_address1": "789 Corporate Boulevard, Business Park",
"business_address2": "Floor 15",
"parent_company": "Yes",
"country_of_formation": "US"
}
JSON
{
"uid": "1234567",
"uuid": "143DlNdQ85xkRamOKmBMj9ZnqeX2L7Yy",
"entity_type": ["Holding Company"],
"entity_legal_identification_number": "HOLD987654321",
"entity_legal_name": "Acme Holdings Inc",
"trade_name": "Acme Holdings",
"date_of_formation": "2015-03-10",
"registered_country": "US",
"registered_city": "Wilmington",
"registered_state": "DE",
"registered_zipcode": "19801",
"registered_address1": "789 Corporate Boulevard, Downtown District",
"registered_address2": "Suite 1500",
"business_country": "US",
"business_city": "Wilmington",
"business_state": "DE",
"business_zipcode": "19801",
"business_address1": "789 Corporate Boulevard, Business Park",
"business_address2": "Floor 15",
"parent_company": "Yes",
"country_of_formation": "US"
}
操作类型 判断条件 说明 新增 请求中不包含uuid字段 系统生成新的唯一标识ID 修改 请求中包含uuid字段 更新指定UUID的母公司信息
限制项 说明 最大数量 每个企业最多添加5个上级母公司 计数方式 所有已保存的母公司记录(包括通过审核的)计入总数 超出处理 尝试添加第6个时会返回错误
字段 说明 entity_type 企业类型数组,如:Holding Company(控股公司)、Investment Company(投资公司)等 entity_legal_identification_number 企业注册号,用于唯一标识该企业 trade_name 经营用名称,可能与法定名称不同 parent_company 固定为"Yes",表示这是一个母公司记录