/app/kyc/entity/parent

该接口用于在企业KYB流程中添加上级母公司(Parent Company)信息。通过提交母公司的注册信息、地址信息等,完成企业股权结构的上层信息收集。接口支持新增和修改两种操作:当请求中包含uuid字段时表示修改已有母公司信息,不包含uuid时表示新增母公司信息。每个企业最多允许添加5个上级母公司。

请求参数说明

基础参数

字段名类型必填说明
uidstring用户ID,用于标识当前操作的企业用户
uuidstring母公司唯一标识ID,修改时必填,新增时不填

企业类型信息

字段名类型必填说明
entity_typearray企业实体类型,如:["Holding Company"](控股公司)
entity_legal_identification_numberstring企业法定注册号/识别码
entity_legal_namestring企业法定全称
trade_namestring企业商号/经营用名称
parent_companystring是否有母公司,默认“No”代表无母公司。切换“Yes”可正常添加母公司。
country_of_formationstring企业注册国家/地区

成立信息

字段名类型必填说明
date_of_formationstring企业成立日期,格式:YYYY-MM-DD

注册地址信息

字段名类型必填说明
registered_countrystring注册地址国家
registered_citystring注册地址城市
registered_statestring注册地址州/省
registered_zipcodestring注册地址邮政编码
registered_address1string注册地址第一行
registered_address2string注册地址第二行

实际经营地址信息

字段名类型必填说明
business_countrystring实际经营地址国家
business_citystring实际经营地址城市
business_statestring实际经营地址州/省
business_zipcodestring实际经营地址邮政编码
business_address1string实际经营地址第一行
business_address2string实际经营地址第二行

请求示例

新增母公司(无uuid)

{
  "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"
}

修改母公司(包含uuid)

{
  "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"
}

使用说明

1. 新增与修改逻辑

操作类型判断条件说明
新增请求中不包含uuid字段系统生成新的唯一标识ID
修改请求中包含uuid字段更新指定UUID的母公司信息

2. 数量限制说明

限制项说明
最大数量每个企业最多添加5个上级母公司
计数方式所有已保存的母公司记录(包括通过审核的)计入总数
超出处理尝试添加第6个时会返回错误

3. 字段说明

字段说明
entity_type企业类型数组,如:Holding Company(控股公司)、Investment Company(投资公司)等
entity_legal_identification_number企业注册号,用于唯一标识该企业
trade_name经营用名称,可能与法定名称不同
parent_company固定为"Yes",表示这是一个母公司记录

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json