创建公司
支持在单个接口中进行公司信息添加,包括公司基本信息、注册地址信息、工作地址信息等
Tip: 非必填参数,不传时默认为空
请求
| 项目 | 值 |
|---|---|
| HTTP URL | https://open.feishu.cn/open-apis/corehr/v1/companies |
| HTTP Method | POST |
| 接口频率限制 | 1000 次/分钟、50 次/秒 |
| 支持的应用类型 | custom |
| 权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 | corehr:corehr 更新核心人事信息 |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | tenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token |
| Content-Type | string | 是 | 固定值:"application/json; charset=utf-8" |
查询参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
client_token | string | 否 | 操作的唯一标识,用于幂等的进行更新操作,根据client_token是否一致来判断是否为同一请求。此值为空表示将发起一次新的请求,此值非空表示幂等的进行更新操作。 示例值:"22ff85f7-5938-4579-9b57-d52cfeb05d52" |
请求体
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
hiberarchy_common | hiberarchy_common | 是 | 公司基本信息,该结构维护了公司的名称、编码、启用状态、上级公司等基础信息。 |
└ parent_id | string | 否 | 上级公司ID,在创建场景下, 该字段必填,枚举值及详细信息可通过【批量查询公司】接口查询获得 示例值:"4719168654814483759" |
└ name | i18n\[\] | 是 | 公司名称 - 名称不能包含「/」「;」「;」「\」「'」字符。 - xx中英文名称会有全局唯一校验 |
└ lang | string | 是 | 名称信息的语言,支持中文和英文。中文用zh-CN;英文用en-US。 示例值:"zh-CN" |
└ value | string | 是 | 名称信息的内容,支持中文和英文 示例值:"xx有限科技公司" |
└ active | boolean | 是 | 是否启用该公司 示例值:true |
└ effective_time | string | 否 | 版本生效日期 - 填写格式:YYYY-MM-DD 00:00:00(系统会自动将时分秒改为00:00:00) - 系统默认为填写日期当天的 00:00:00 生效 - 该接口只支持到最小单位为日 - 日期范围要求:1900-01-01 00:00:00~9999-12-31 23:59:59 示例值:"2020-05-01 00:00:00" |
└ code | string | 否 | 公司编码 (不能与其他记录的编码重复) - 开启自动编码时,如果不传值会自动生成编码,否则以传入值为准 - 未开启自动编码时,不传值不会自动生成编码 示例值:"12456" |
└ description | i18n\[\] | 否 | 描述 |
└ lang | string | 是 | 名称信息的语言,支持中文和英文。中文用zh-CN;英文用en-US。 示例值:"zh-CN" |
└ value | string | 是 | 名称信息的内容,支持中文和英文 示例值:"xx有限科技公司" |
└ custom_fields | object_field_data\[\] | 否 | 自定义字段(该功能暂不支持) |
└ field_name | string | 是 | 自定义字段 API Name,即自定义字段的唯一标识 示例值:"name" |
└ value | string | 是 | 字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05") 示例值:""Sandy"" |
type | enum | 否 | 公司性质,通过获取字段详情查询获取。请求参数:object_api_name=company;custom_api_name=type。 |
└ enum_name | string | 是 | 枚举值 示例值:"private_owned" |
industry_list | enum\[\] | 否 | 所在行业,通过获取字段详情查询获取。请求参数:object_api_name=company;custom_api_name=industry。 |
└ enum_name | string | 是 | 枚举值 示例值:"professional_technique_service" |
legal_representative | i18n\[\] | 否 | 法定代表人 - 仅注册地址中的 国家 / 地区为中国大陆时,法人字段填入才有效。 - 若注册地址中的 国家 / 地区 不为中国大陆时,则填入法人字段无效。 - 不是分公司时,法人字段填入才有效。 - 是分公司时,填入法人字段无效。 |
└ lang | string | 是 | 名称信息的语言,支持中文和英文。中文用zh-CN;英文用en-US。 示例值:"zh-CN" |
└ value | string | 是 | 名称信息的内容,支持中文和英文 示例值:"张三" |
post_code | string | 否 | 邮编(该字段已废弃,可忽略) 示例值:"100000" |
tax_payer_id | string | 否 | 纳税人识别号 示例值:"1234567890" |
confidential | boolean | 否 | 是否保密,该功能暂不支持,可以忽略 示例值:true |
sub_type_list | enum\[\] | 否 | 公司主体类型,通过获取字段详情查询获取。请求参数:object_api_name=company;custom_api_name=subtype。 |
└ enum_name | string | 是 | 枚举值 示例值:"company" |
branch_company | boolean | 否 | 是否为分公司 - 是分公司时,主要负责人生效。 - 不是分公司时,法定代表人生效。 示例值:true |
primary_manager | i18n\[\] | 否 | 主要负责人 - 是分公司时,该字段填入才有效。 - 不是分公司时,填入该字段无效。 |
└ lang | string | 是 | 名称信息的语言,支持中文和英文。中文用zh-CN;英文用en-US。 示例值:"zh-CN" |
└ value | string | 是 | 名称信息的内容,支持中文和英文 示例值:"张三" |
custom_fields | object_field_data\[\] | 否 | 自定义字段(暂时不支持该功能) |
└ field_name | string | 是 | 字段名 示例值:"name" |
└ value | string | 是 | 字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05") 示例值:""Sandy"" |
currency | currency | 否 | 默认币种 |
└ currency_name | i18n\[\] | 否 | 货币名称 |
└ lang | string | 是 | 语言,支持中文和英文。中文用zh-CN;英文用en-US。 示例值:"zh-CN" |
└ value | string | 是 | 内容,支持中文和英文 示例值:"张三" |
└ numeric_code | int | 否 | 对应币种的指代代码,通过查询货币信息v2查询获取。 示例值:156 |
└ currency_alpha_3_code | string | 否 | 法定货币对应代码,如CNY、USD等,通过查询货币信息v2查询获取。 示例值:"CNY" |
phone | phone_number_and_area_code | 否 | 电话 |
└ area_code | enum | 是 | 区号对应的数字,可通过 获取字段详情查询获取。请求参数:object_api_name=phone;custom_api_name=international_area_code 示例值:123123 |
└ enum_name | string | 是 | 区号对应名称 示例值:"86_china" |
└ phone_number | string | 是 | 号码 示例值:"18812341234" |
fax | phone_number_and_area_code | 否 | 传真 |
└ area_code | enum | 是 | 区号对应的数字,可通过 获取字段详情查询获取。请求参数:object_api_name=phone;custom_api_name=international_area_code。 示例值:123123 |
└ enum_name | string | 是 | 区号对应的名称 示例值:"86_china" |
└ phone_number | string | 是 | 号码 示例值:"18812341234" |
registered_office_address_info | address | 否 | 注册地址详细信息,该字段在OpenAPI为非必填字段,在页面管理端为必填字段。如果此处不填写该字段,可通过页面管理端补齐该字段。 |
└ country_region_id | string | 是 | 国家 / 地区id。各国家/地区填写字段可参考地址填写规则查询。 国家/地区id可通过查询国家/地区信息查询获取。 示例值:"6862995757234914824" |
└ region_id | string | 否 | 主要行政区id。 可通过 查询省份/主要行政区信息查询获取。 示例值:"6863326815667095047" |
└ city_id | string | 否 | 城市id,可通过 查询城市信息查询获取。 示例值:"6863333254578046471" |
└ distinct_id | string | 否 | 区/县id,可通过 查询区/县信息查询获取。 示例值:"6863333516579440141" |
└ address_line1 | string | 否 | 地址行 1 示例值:"丹佛测试地址-纽埃时区" |
└ address_line2 | string | 否 | 地址行 2 示例值:"PoewH" |
└ address_line3 | string | 否 | 地址行 3 示例值:"PoewH" |
└ address_line4 | string | 否 | 地址行 4 示例值:"jmwJc" |
└ address_line5 | string | 否 | 地址行 5 示例值:"jmwJc" |
└ address_line6 | string | 否 | 地址行 6 示例值:"jmwJc" |
└ address_line7 | string | 否 | 地址行 7 示例值:"jmwJc" |
└ address_line8 | string | 否 | 地址行 8 示例值:"rafSu" |
└ address_line9 | string | 否 | 地址行 9 示例值:"McPRG" |
└ local_address_line1 | string | 否 | 地址行 1(非拉丁语系的本地文字) 示例值:"丹佛测试地址-纽埃时区" |
└ local_address_line2 | string | 否 | 地址行 2(非拉丁语系的本地文字) 示例值:"PoewH" |
└ local_address_line3 | string | 否 | 地址行 3(非拉丁语系的本地文字) 示例值:"PoewH" |
└ local_address_line4 | string | 否 | 地址行 4(非拉丁语系的本地文字) 示例值:"jmwJc" |
└ local_address_line5 | string | 否 | 地址行 5(非拉丁语系的本地文字) 示例值:"jmwJc" |
└ local_address_line6 | string | 否 | 地址行 6(非拉丁语系的本地文字) 示例值:"jmwJc" |
└ local_address_line7 | string | 否 | 地址行 7(非拉丁语系的本地文字) 示例值:"jmwJc" |
└ local_address_line8 | string | 否 | 地址行 8(非拉丁语系的本地文字) 示例值:"rafSu" |
└ local_address_line9 | string | 否 | 地址行 9(非拉丁语系的本地文字) 示例值:"McPRG" |
└ postal_code | string | 否 | 邮政编码 示例值:"611530" |
office_address_info | address | 否 | 办公地址详细信息,该字段在OpenAPI为非必填字段,在页面管理端为必填字段。若此处不填写该字段,可通过页面管理端补齐该字段。 |
└ country_region_id | string | 是 | 国家 / 地区id。 各国家/地区填写字段可参考地址填写规则查询。 国家/地区id可通过查询国家/地区信息查询获取。 示例值:"6862995757234914824" |
└ region_id | string | 否 | 主要行政区id。可通过查询省份/主要行政区信息查询获取。 示例值:"6863326815667095047" |
└ city_id | string | 否 | 城市id,可通过查询城市信息查询获取。 示例值:"6863333254578046471" |
└ distinct_id | string | 否 | 区/县id,可通过查询区/县信息查询获取。 示例值:"6863333516579440141" |
└ address_line1 | string | 否 | 地址行 1 示例值:"丹佛测试地址-纽埃时区" |
└ address_line2 | string | 否 | 地址行 2 示例值:"PoewH" |
└ address_line3 | string | 否 | 地址行 3 示例值:"PoewH" |
└ address_line4 | string | 否 | 地址行 4 示例值:"jmwJc" |
└ address_line5 | string | 否 | 地址行 5 示例值:"jmwJc" |
└ address_line6 | string | 否 | 地址行 6 示例值:"jmwJc" |
└ address_line7 | string | 否 | 地址行 7 示例值:"jmwJc" |
└ address_line8 | string | 否 | 地址行 8 示例值:"rafSu" |
└ address_line9 | string | 否 | 地址行 9 示例值:"McPRG" |
└ local_address_line1 | string | 否 | 地址行 1(非拉丁语系的本地文字) 示例值:"丹佛测试地址-纽埃时区" |
└ local_address_line2 | string | 否 | 地址行 2(非拉丁语系的本地文字) 示例值:"PoewH" |
└ local_address_line3 | string | 否 | 地址行 3(非拉丁语系的本地文字) 示例值:"PoewH" |
└ local_address_line4 | string | 否 | 地址行 4(非拉丁语系的本地文字) 示例值:"jmwJc" |
└ local_address_line5 | string | 否 | 地址行 5(非拉丁语系的本地文字) 示例值:"jmwJc" |
└ local_address_line6 | string | 否 | 地址行 6(非拉丁语系的本地文字) 示例值:"jmwJc" |
└ local_address_line7 | string | 否 | 地址行 7(非拉丁语系的本地文字) 示例值:"jmwJc" |
└ local_address_line8 | string | 否 | 地址行 8(非拉丁语系的本地文字) 示例值:"rafSu" |
└ local_address_line9 | string | 否 | 地址行 9(非拉丁语系的本地文字) 示例值:"McPRG" |
└ postal_code | string | 否 | 邮政编码 示例值:"611530" |
请求体示例
json
{
"hiberarchy_common": {
"parent_id": "4719168654814483759",
"name": [
{
"lang": "zh-CN",
"value": "xx有限科技公司"
}
],
"active": true,
"effective_time": "2020-05-01 00:00:00",
"code": "12456",
"description": [
{
"lang": "zh-CN",
"value": "xx有限科技公司"
}
],
"custom_fields": [
{
"field_name": "name",
"value": "\"Sandy\""
}
]
},
"type": {
"enum_name": "private_owned"
},
"industry_list": [
{
"enum_name": "professional_technique_service"
}
],
"legal_representative": [
{
"lang": "zh-CN",
"value": "张三"
}
],
"post_code": "100000",
"tax_payer_id": "1234567890",
"confidential": true,
"sub_type_list": [
{
"enum_name": "company"
}
],
"branch_company": true,
"primary_manager": [
{
"lang": "zh-CN",
"value": "张三"
}
],
"custom_fields": [
{
"field_name": "name",
"value": "\"Sandy\""
}
],
"currency": {
"currency_name": [
{
"lang": "zh-CN",
"value": "张三"
}
],
"numeric_code": 156,
"currency_alpha_3_code": "CNY"
},
"phone": {
"area_code": {
"enum_name": "86_china"
},
"phone_number": "18812341234"
},
"fax": {
"area_code": {
"enum_name": "86_china"
},
"phone_number": "18812341234"
},
"registered_office_address_info": {
"country_region_id": "6862995757234914824",
"region_id": "6863326815667095047",
"city_id": "6863333254578046471",
"distinct_id": "6863333516579440141",
"address_line1": "丹佛测试地址-纽埃时区",
"address_line2": "PoewH",
"address_line3": "PoewH",
"address_line4": "jmwJc",
"address_line5": "jmwJc",
"address_line6": "jmwJc",
"address_line7": "jmwJc",
"address_line8": "rafSu",
"address_line9": "McPRG",
"local_address_line1": "丹佛测试地址-纽埃时区",
"local_address_line2": "PoewH",
"local_address_line3": "PoewH",
"local_address_line4": "jmwJc",
"local_address_line5": "jmwJc",
"local_address_line6": "jmwJc",
"local_address_line7": "jmwJc",
"local_address_line8": "rafSu",
"local_address_line9": "McPRG",
"postal_code": "611530"
},
"office_address_info": {
"country_region_id": "6862995757234914824",
"region_id": "6863326815667095047",
"city_id": "6863333254578046471",
"distinct_id": "6863333516579440141",
"address_line1": "丹佛测试地址-纽埃时区",
"address_line2": "PoewH",
"address_line3": "PoewH",
"address_line4": "jmwJc",
"address_line5": "jmwJc",
"address_line6": "jmwJc",
"address_line7": "jmwJc",
"address_line8": "rafSu",
"address_line9": "McPRG",
"local_address_line1": "丹佛测试地址-纽埃时区",
"local_address_line2": "PoewH",
"local_address_line3": "PoewH",
"local_address_line4": "jmwJc",
"local_address_line5": "jmwJc",
"local_address_line6": "jmwJc",
"local_address_line7": "jmwJc",
"local_address_line8": "rafSu",
"local_address_line9": "McPRG",
"postal_code": "611530"
}
}响应
响应体
| 名称 | 类型 | 描述 |
|---|---|---|
code | int | 错误码,非 0 表示失败 |
msg | string | 错误描述 |
data | \- | - |
└ company | company | 创建成功的公司信息 |
└ id | string | 公司 ID |
└ hiberarchy_common | hiberarchy_common | 公司基本信息,该结构维护了公司的名称、编码、启用状态、上级公司等基础信息。 |
└ parent_id | string | 上级公司 ID |
└ name | i18n\[\] | 公司名称 |
└ lang | string | 名称信息的语言,支持中文和英文。中文用zh-CN;英文用en-US。 |
└ value | string | 名称信息的内容,支持中文和英文。 |
└ type | enum | 组织类型,枚举值可通过文档【飞书人事枚举常量】组织类型(organization_type)枚举定义部分获得。该字段为通用字段,若为公司维度则为必填。 - 该字段返回常量:company |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 名称信息的语言,支持中文和英文。中文用zh-CN;英文用en-US。 |
└ value | string | 名称信息的内容,支持中文和英文 |
└ active | boolean | 是否启用,启用为true,停用为false |
└ effective_time | string | 版本生效日期 - 填写格式:YYYY-MM-DD 00:00:00(系统会自动将时分秒改为00:00:00) - 系统默认为填写日期当天的 00:00:00 生效 - 该接口只支持到最小单位为日 - 日期范围要求:1900-01-01 00:00:00~9999-12-31 23:59:59 |
└ expiration_time | string | 版本失效日期 - 填写格式:YYYY-MM-DD 00:00:00(系统会自动将时分秒改为00:00:00) - 本次编辑的记录版本失效的时间, 如果用户在本次操作的生效日期之后修改了对象信息,则系统会将下一次操作的日期作为当前记录的失效时间。 - 系统默认为填写日期当天的 00:00:00 失效 - 日期范围要求:1900-01-01 00:00:00~9999-12-31 23:59:59 |
└ code | string | 公司编码 |
└ description | i18n\[\] | 描述 |
└ lang | string | 名称信息的语言,支持中文和英文。中文用zh-CN;英文用en-US。 |
└ value | string | 名称信息的内容,支持中文和英文 |
└ tree_order | string | 树形排序(暂不支持该功能) |
└ list_order | string | 列表排序(暂不支持该功能) |
└ custom_fields | object_field_data\[\] | 自定义字段(暂不支持该功能) |
└ field_name | string | 字段名 |
└ value | string | 字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05") |
└ type | enum | 公司性质,通过获取字段详情查询获取。请求参数:object_api_name=company;custom_api_name=type。 |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 名称信息的语言,支持中文和英文。中文用zh-CN;英文用en-US。 |
└ value | string | 名称信息的内容,支持中文和英文 |
└ industry_list | enum\[\] | 所在行业,通过获取字段详情查询获取。请求参数:object_api_name=company;custom_api_name=industry。 |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 名称信息的语言,支持中文和英文。中文用zh-CN;英文用en-US。 |
└ value | string | 名称信息的内容,支持中文和英文 |
└ legal_representative | i18n\[\] | 法定代表人。 - 仅注册地址中的 国家 / 地区为中国大陆时,法人字段填入才有效。 - 若注册地址中的 国家 / 地区 不为中国大陆时,则填入法人字段无效。 - 不是分公司时,法人字段填入才有效。 - 是分公司时,填入法人字段无效。 |
└ lang | string | 名称信息的语言,支持中文和英文。中文用zh-CN;英文用en-US。 |
└ value | string | 名称信息的内容,支持中文和英文 |
└ post_code | string | 邮编(该字段已废弃,可忽略) |
└ tax_payer_id | string | 纳税人识别号 |
└ confidential | boolean | 是否保密(该字段暂不支持,可忽略) |
└ sub_type_list | enum\[\] | 公司主体类型,通过获取字段详情查询获取。请求参数:object_api_name=company;custom_api_name=subtype。 |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 名称信息的语言,支持中文和英文。中文用zh-CN;英文用en-US。 |
└ value | string | 名称信息的内容,支持中文和英文 |
└ branch_company | boolean | 是否为分公司 - 是分公司时,主要负责人生效。 - 不是分公司时,法定代表人生效。 |
└ primary_manager | i18n\[\] | 主要负责人 - 是分公司时,该字段填入才有效。 - 不是分公司时,填入该字段无效。 |
└ lang | string | 名称信息的语言,支持中文和英文。中文用zh-CN;英文用en-US。 |
└ value | string | 名称信息的内容,支持中文和英文 |
└ custom_fields | object_field_data\[\] | 自定义字段(该功能暂不支持) |
└ field_name | string | 字段名 |
└ value | string | 字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05") |
└ currency | currency | 默认币种 |
└ id | string | 货币id |
└ country_region_id | string | 货币所属国家/地区id,详细信息可通过【查询国家/地区信息】接口查询获得 |
└ currency_name | i18n\[\] | 货币名称 |
└ lang | string | 货币语言,支持中文和英文。中文用zh-CN;英文用en-US。 |
└ value | string | 货币内容,支持中文和英文 |
└ numeric_code | int | 对应币种的指代代码,通过查询货币信息v2查询获取。 |
└ currency_alpha_3_code | string | 法定货币对应代码,如CNY 、USD等,通过查询货币信息v2查询获取。 |
└ phone | phone_number_and_area_code | 电话 |
└ area_code | enum | 区号对应的数字,可通过 获取字段详情查询获取。请求参数:object_api_name=phone;custom_api_name=international_area_code |
└ enum_name | string | 区号对应的名称 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 语言,支持中文和英文。中文用zh-CN;英文用en-US。 |
└ value | string | 内容,支持中文和英文 |
└ phone_number | string | 号码 |
└ fax | phone_number_and_area_code | 传真 |
└ area_code | enum | 区号 |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 语言,支持中文和英文。中文用zh-CN;英文用en-US。 |
└ value | string | 内容,支持中文和英文 |
└ phone_number | string | 号码 |
└ registered_office_address | i18n\[\] | 完整注册地址(该字段暂不返回,可忽略) - 调用【查询单个公司】【批量查询公司】等接口可以返回完整注册地址 |
└ lang | string | 语言,支持中文和英文。中文用zh-CN;英文用en-US。 |
└ value | string | 内容,支持中文和英文 |
└ office_address | i18n\[\] | 完整办公地址(该字段暂不返回,可忽略) - 调用【查询单个公司】【批量查询公司】等接口可以返回完整办公地址 |
└ lang | string | 语言,支持中文和英文。中文用zh-CN;英文用en-US。 |
└ value | string | 内容,支持中文和英文 |
└ registered_office_address_info | address | 注册地址详细信息。 |
└ country_region_id | string | 国家 / 地区id。各国家/地区填写字段可参考地址填写规则查询。 国家/地区id可通过查询国家/地区信息查询获取。 |
└ region_id | string | 主要行政区id。可通过查询省份/主要行政区信息查询获取。 |
└ city_id | string | 城市id。可通过查询城市信息查询获取。 |
└ distinct_id | string | 区/县id,可通过查询区/县信息查询获取。 |
└ address_line1 | string | 地址行 1 |
└ address_line2 | string | 地址行 2 |
└ address_line3 | string | 地址行 3 |
└ address_line4 | string | 地址行 4 |
└ address_line5 | string | 地址行 5 |
└ address_line6 | string | 地址行 6 |
└ address_line7 | string | 地址行 7 |
└ address_line8 | string | 地址行 8 |
└ address_line9 | string | 地址行 9 |
└ local_address_line1 | string | 地址行 1(非拉丁语系的本地文字) |
└ local_address_line2 | string | 地址行 2(非拉丁语系的本地文字) |
└ local_address_line3 | string | 地址行 3(非拉丁语系的本地文字) |
└ local_address_line4 | string | 地址行 4(非拉丁语系的本地文字) |
└ local_address_line5 | string | 地址行 5(非拉丁语系的本地文字) |
└ local_address_line6 | string | 地址行 6(非拉丁语系的本地文字) |
└ local_address_line7 | string | 地址行 7(非拉丁语系的本地文字) |
└ local_address_line8 | string | 地址行 8(非拉丁语系的本地文字) |
└ local_address_line9 | string | 地址行 9(非拉丁语系的本地文字) |
└ postal_code | string | 邮政编码 |
└ office_address_info | address | 办公地址详细信息。 |
└ country_region_id | string | 国家 / 地区id。各国家/地区填写字段可参考地址填写规则查询。 国家/地区id可通过查询国家/地区信息查询获取。 |
└ region_id | string | 主要行政区id,可通过查询省份/主要行政区信息查询获取。 |
└ city_id | string | 城市id,可通过查询城市信息查询获取。 |
└ distinct_id | string | 区/县id,可通过查询区/县信息查询获取。 |
└ address_line1 | string | 地址行 1 |
└ address_line2 | string | 地址行 2 |
└ address_line3 | string | 地址行 3 |
└ address_line4 | string | 地址行 4 |
└ address_line5 | string | 地址行 5 |
└ address_line6 | string | 地址行 6 |
└ address_line7 | string | 地址行 7 |
└ address_line8 | string | 地址行 8 |
└ address_line9 | string | 地址行 9 |
└ local_address_line1 | string | 地址行 1(非拉丁语系的本地文字) |
└ local_address_line2 | string | 地址行 2(非拉丁语系的本地文字) |
└ local_address_line3 | string | 地址行 3(非拉丁语系的本地文字) |
└ local_address_line4 | string | 地址行 4(非拉丁语系的本地文字) |
└ local_address_line5 | string | 地址行 5(非拉丁语系的本地文字) |
└ local_address_line6 | string | 地址行 6(非拉丁语系的本地文字) |
└ local_address_line7 | string | 地址行 7(非拉丁语系的本地文字) |
└ local_address_line8 | string | 地址行 8(非拉丁语系的本地文字) |
└ local_address_line9 | string | 地址行 9(非拉丁语系的本地文字) |
└ postal_code | string | 邮政编码 |
响应体示例
json
{
"code": 0,
"msg": "success",
"data": {
"company": {
"id": "4692472714243080020",
"hiberarchy_common": {
"parent_id": "4719168654814483759",
"name": [
{
"lang": "zh-CN",
"value": "张三"
}
],
"type": {
"enum_name": "type_1",
"display": [
{
"lang": "zh-CN",
"value": "张三"
}
]
},
"active": true,
"effective_time": "2020-05-01 00:00:00",
"expiration_time": "2020-05-02 00:00:00",
"code": "12456",
"description": [
{
"lang": "zh-CN",
"value": "张三"
}
],
"tree_order": "001000",
"list_order": "001000-001000",
"custom_fields": [
{
"field_name": "name",
"value": "\"Sandy\""
}
]
},
"type": {
"enum_name": "type_1",
"display": [
{
"lang": "zh-CN",
"value": "张三"
}
]
},
"industry_list": [
{
"enum_name": "type_1",
"display": [
{
"lang": "zh-CN",
"value": "张三"
}
]
}
],
"legal_representative": [
{
"lang": "zh-CN",
"value": "张三"
}
],
"post_code": "100000",
"tax_payer_id": "123456840",
"confidential": true,
"sub_type_list": [
{
"enum_name": "type_1",
"display": [
{
"lang": "zh-CN",
"value": "张三"
}
]
}
],
"branch_company": true,
"primary_manager": [
{
"lang": "zh-CN",
"value": "张三"
}
],
"custom_fields": [
{
"field_name": "name",
"value": "\"Sandy\""
}
],
"currency": {
"id": "1",
"country_region_id": "12",
"currency_name": [
{
"lang": "zh-CN",
"value": "张三"
}
],
"numeric_code": 12,
"currency_alpha_3_code": "CNY"
},
"phone": {
"area_code": {
"enum_name": "86_china",
"display": [
{
"lang": "zh-CN",
"value": "张三"
}
]
},
"phone_number": "18812341234"
},
"fax": {
"area_code": {
"enum_name": "86_china",
"display": [
{
"lang": "zh-CN",
"value": "张三"
}
]
},
"phone_number": "18812341234"
},
"registered_office_address": [
{
"lang": "zh-CN",
"value": "张三"
}
],
"office_address": [
{
"lang": "zh-CN",
"value": "张三"
}
],
"registered_office_address_info": {
"country_region_id": "6862995757234914824",
"region_id": "6863326815667095047",
"city_id": "6863333254578046471",
"distinct_id": "6863333516579440141",
"address_line1": "丹佛测试地址-纽埃时区",
"address_line2": "PoewH",
"address_line3": "PoewH",
"address_line4": "jmwJc",
"address_line5": "jmwJc",
"address_line6": "jmwJc",
"address_line7": "jmwJc",
"address_line8": "rafSu",
"address_line9": "McPRG",
"local_address_line1": "丹佛测试地址-纽埃时区",
"local_address_line2": "PoewH",
"local_address_line3": "PoewH",
"local_address_line4": "jmwJc",
"local_address_line5": "jmwJc",
"local_address_line6": "jmwJc",
"local_address_line7": "jmwJc",
"local_address_line8": "rafSu",
"local_address_line9": "McPRG",
"postal_code": "611530"
},
"office_address_info": {
"country_region_id": "6862995757234914824",
"region_id": "6863326815667095047",
"city_id": "6863333254578046471",
"distinct_id": "6863333516579440141",
"address_line1": "丹佛测试地址-纽埃时区",
"address_line2": "PoewH",
"address_line3": "PoewH",
"address_line4": "jmwJc",
"address_line5": "jmwJc",
"address_line6": "jmwJc",
"address_line7": "jmwJc",
"address_line8": "rafSu",
"address_line9": "McPRG",
"local_address_line1": "丹佛测试地址-纽埃时区",
"local_address_line2": "PoewH",
"local_address_line3": "PoewH",
"local_address_line4": "jmwJc",
"local_address_line5": "jmwJc",
"local_address_line6": "jmwJc",
"local_address_line7": "jmwJc",
"local_address_line8": "rafSu",
"local_address_line9": "McPRG",
"postal_code": "611530"
}
}
}
}