# 更新公司 更新公司信息，包括基本信息、注册地址、办公地址等 **注意事项**：- 非必填字段，不传时即不做变更 - 如果传入生效时间当天不存在版本则会自动生成一个版本。 - 如果传入生效时间当天存在版本则会修改该版本。 ## 请求 基本 |   ---|--- HTTP URL | https://open.feishu.cn/open-apis/corehr/v1/companies/:company_id HTTP Method | PATCH 接口频率限制 | [100 次/分钟](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN) 支持的应用类型 | Custom App 权限要求
**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 更新核心人事信息(corehr:corehr) ### 请求头 名称 | 类型 | 必填 | 描述 ---|---|---|--- Authorization | string | 是 | `tenant_access_token`
或
`user_access_token`
**值格式**："Bearer `access_token`"
**示例值**："Bearer u-7f1bcd13fc57d46bac21793a18e560"
[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use) Content-Type | string | 是 | **固定值**："application/json; charset=utf-8" ### 路径参数 名称 | 类型 | 描述 ---|---|--- company_id | string | 需要更新的公司 ID。ID获取方式：
- 调用[【创建公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/create)[【批量查询公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)等接口可以返回部门ID
**示例值**："6863333352603125255" ### 查询参数 名称 | 类型 | 必填 | 描述 ---|---|---|--- client_token | string | 否 | 根据client_token是否一致来判断是否为同一请求
**示例值**：fe599b60-450f-46ff-b2ef-9f6675625b97 ### 请求体 名称 | 类型 | 必填 | 描述 ---|---|---|--- hiberarchy_common | hiberarchy_common | 否 | 组织实体公共字段，包括名称、描述、上级、启停用状态、生效日期、编码等基础信息 parent_id | string | 否 | 上级组织
**示例值**："4719168654814483759" name | i18n\[\] | 否 | 公司名称
- 名称不能包含「/」「；」「;」「\」「'」字符。
- 公司中英文名称会有全局唯一校验 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有限科技公司" type | enum | 否 | 公司性质，通过[获取字段详情](https://open.larkoffice.com/document/server-docs/corehr-v1/basic-infomation/custom_field/get_by_param)查询获取。请求参数：object_api_name=company；custom_api_name=type。 enum_name | string | 是 | 枚举值
**示例值**："private_owned" industry_list | enum\[\] | 否 | 所在行业，通过[获取字段详情](https://open.larkoffice.com/document/server-docs/corehr-v1/basic-infomation/custom_field/get_by_param)查询获取。请求参数：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 | 否 | 纳税人识别号
**示例值**："123456840" confidential | boolean | 否 | 是否保密，该功能暂不支持，可以忽略
**示例值**：true sub_type_list | enum\[\] | 否 | 公司主体类型，通过[获取字段详情](https://open.larkoffice.com/document/server-docs/corehr-v1/basic-infomation/custom_field/get_by_param)查询获取。请求参数：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 | 是 | 内容，支持中文和英文。
**示例值**："张三" currency | currency | 否 | 默认币种 currency_name | i18n\[\] | 否 | 货币名称 lang | string | 是 | 语言，支持中文和英文。中文用zh-CN；英文用en-US。
**示例值**："zh-CN" value | string | 是 | 内容，支持中文和英文
**示例值**："xx科技有限公司" numeric_code | int | 否 | 对应币种的指代代码，通过系统内部查找，通过[查询货币信息v2](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-currency/search)查询获取。
**示例值**：12 currency_alpha_3_code | string | 否 | 法定货币对应代码，如CNY 、USD等.通过[查询货币信息v2](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-currency/search)查询获取。
**示例值**："CNY" phone | phone_number_and_area_code | 否 | 电话 area_code | enum | 是 | 区号对应的数字，可通过
[获取字段详情](https://open.larkoffice.com/document/server-docs/corehr-v1/basic-infomation/custom_field/get_by_param)查询获取。请求参数：object_api_name=phone；custom_api_name=international_area_code。
**示例值**：123123 enum_name | string | 是 | 区号对应名称
**示例值**："86_china" phone_number | string | 是 | 号码
**示例值**："213213" fax | phone_number_and_area_code | 否 | 传真 area_code | enum | 是 | 区号对应的数字，可通过
[获取字段详情](https://open.larkoffice.com/document/server-docs/corehr-v1/basic-infomation/custom_field/get_by_param)查询获取。请求参数：object_api_name=phone；custom_api_name=international_area_code。
**示例值**：123123 enum_name | string | 是 | 区号对应的名称
**示例值**："86_china" phone_number | string | 是 | 号码
**示例值**："213213" registered_office_address_info | address | 否 | 注册地址详细信息。公共字段，若请求对象为公司，则该字段必填。 country_region_id | string | 是 | 国家 / 地区 ID。各国家/地区填写字段可参考[地址填写规则](https://bytedance.larkoffice.com/wiki/GoL4wAKAXis3OWku72YcEjTxnKe?sheet=0sMjoP)查询。可通过
[查询国家/地区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)查询获取。
**示例值**："6862995757234914824" region_id | string | 否 | 主要行政区ID.可通过
[查询省份/主要行政区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)查询获取。
**示例值**："6863326815667095047" city_id | string | 否 | 城市ID.可通过
[查询城市信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-city/search)查询获取。
**示例值**："6863333254578046471" distinct_id | string | 否 | 区/县ID.可通过
[查询区/县信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-district/search)查询获取。
**示例值**："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 | 否 | 办公地址详细信息。公共字段，若请求对象为公司，则该字段必填。 country_region_id | string | 是 | 国家 / 地区 ID。各国家/地区填写字段可参考[地址填写规则](https://bytedance.larkoffice.com/wiki/GoL4wAKAXis3OWku72YcEjTxnKe?sheet=0sMjoP)查询.可通过
[查询国家/地区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)查询获取。
**示例值**："6862995757234914824" region_id | string | 否 | 主要行政区ID.可通过
[查询省份/主要行政区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)查询获取。
**示例值**："6863326815667095047" city_id | string | 否 | 城市ID.可通过
[查询城市信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-city/search)查询获取。
**示例值**："6863333254578046471" distinct_id | string | 否 | 区/县ID.可通过
[查询区/县信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-district/search)查询获取。
**示例值**："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有限科技公司" } ] }, "type": { "enum_name": "private_owned" }, "industry_list": [ { "enum_name": "professional_technique_service" } ], "legal_representative": [ { "lang": "zh-CN", "value": "张三" } ], "post_code": "100000", "tax_payer_id": "123456840", "confidential": true, "sub_type_list": [ { "enum_name": "company" } ], "branch_company": true, "primary_manager": [ { "lang": "zh-CN", "value": "张三" } ], "currency": { "currency_name": [ { "lang": "zh-CN", "value": "xx科技有限公司" } ], "numeric_code": 12, "currency_alpha_3_code": "CNY" }, "phone": { "area_code": { "enum_name": "86_china" }, "phone_number": "213213" }, "fax": { "area_code": { "enum_name": "86_china" }, "phone_number": "213213" }, "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 | 上级组织 name | i18n\[\] | 名称 lang | string | 语言，支持中文和英文。中文用zh-CN；英文用en-US。 value | string | 内容，支持中文和英文。 type | enum | 组织类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)组织类型（organization_type）枚举定义部分获得 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（最小单位到日）
- 日期范围:1900-01-01 00:00:00～9999-12-31 23:59:59 expiration_time | string | 版本失效日期
- 返回格式：YYYY-MM-DD 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 | 公司性质，通过[获取字段详情](https://open.larkoffice.com/document/server-docs/corehr-v1/basic-infomation/custom_field/get_by_param)查询获取。请求参数：object_api_name=company；custom_api_name=type。 enum_name | string | 枚举值 display | i18n\[\] | 枚举多语展示 lang | string | 语言，支持中文和英文。中文用zh-CN；英文用en-US。 value | string | 内容，支持中文和英文 industry_list | enum\[\] | 所在行业，通过[获取字段详情](https://open.larkoffice.com/document/server-docs/corehr-v1/basic-infomation/custom_field/get_by_param)查询获取。请求参数：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\[\] | 公司主体类型，通过[获取字段详情](https://open.larkoffice.com/document/server-docs/corehr-v1/basic-infomation/custom_field/get_by_param)查询获取。请求参数：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，详细信息可通过[【查询国家/地区信息】](https://open.feishu.cn/document/server-docs/corehr-v1/basic-infomation/location_data/list)接口查询获得 currency_name | i18n\[\] | 货币名称 lang | string | 货币语言，支持中文和英文。中文用zh-CN；英文用en-US。 value | string | 货币内容，支持中文和英文 numeric_code | int | 对应币种的指代代码，通过系统内部查找，通过[查询货币信息v2](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-currency/search) currency_alpha_3_code | string | 法定货币对应代码，如CNY 、USD等.通过[查询货币信息v2](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-currency/search) phone | phone_number_and_area_code | 电话 area_code | enum | 区号对应的数字，可通过
[获取字段详情](https://open.larkoffice.com/document/server-docs/corehr-v1/basic-infomation/custom_field/get_by_param)查询获取。请求参数：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 | - 电话区号
通过[获取字段详情](https://open.larkoffice.com/document/server-docs/corehr-v1/basic-infomation/custom_field/get_by_param)查询获取。请求参数：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 | 号码 registered_office_address | i18n\[\] | 完整注册地址（该字段暂不返回，可忽略）
- 调用[【查询单个公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/get)[【批量查询公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)等接口可以返回完整注册地址 lang | string | 语言，支持中文和英文。中文用zh-CN；英文用en-US。 value | string | 内容，支持中文和英文 office_address | i18n\[\] | 完整办公地址（该字段暂不返回，可忽略）
- 调用[【查询单个公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/get)[【批量查询公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)等接口可以返回完整办公地址 lang | string | 语言，支持中文和英文。中文用zh-CN；英文用en-US。 value | string | 内容，支持中文和英文 registered_office_address_info | address | 注册地址详细信息。公共字段，若请求对象为公司，则该字段必填。 country_region_id | string | 国家 / 地区 ID。各国家/地区填写字段可参考[地址填写规则](https://bytedance.larkoffice.com/wiki/GoL4wAKAXis3OWku72YcEjTxnKe?sheet=0sMjoP)查询.可通过
[查询国家/地区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)查询获取。 region_id | string | 主要行政区ID.可通过
[查询省份/主要行政区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)查询获取。 city_id | string | 城市ID.可通过
[查询城市信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-city/search)查询获取。 distinct_id | string | 区/县ID，可通过
[查询区/县信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-district/search)查询获取。 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 | 国家 / 地区。各国家/地区填写字段可参考[地址填写规则](https://bytedance.larkoffice.com/wiki/GoL4wAKAXis3OWku72YcEjTxnKe?sheet=0sMjoP)查询。 region_id | string | 主要行政区 city_id | string | 城市Id.可通过
[查询城市信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-city/search)查询获取。 distinct_id | string | 区/县ID，可通过
[查询区/县信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-district/search)查询获取。 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": "xx有限科技公司" } ], "type": { "enum_name": "phone_type", "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": "phone_type", "display": [ { "lang": "zh-CN", "value": "张三" } ] }, "industry_list": [ { "enum_name": "phone_type", "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": "phone_type", "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": "phone_type", "display": [ { "lang": "zh-CN", "value": "张三" } ] }, "phone_number": "213213" }, "fax": { "area_code": { "enum_name": "phone_type", "display": [ { "lang": "zh-CN", "value": "张三" } ] }, "phone_number": "213213" }, "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" } } } } ``` ### 错误码 HTTP状态码 | 错误码 | 描述 | 排查建议 ---|---|---|--- 400 | 1160004 | client_token repeat. | 请检查 client_token 是否重复 500 | 1160101 | marshal error | 检查消息体格式是否符合要求 500 | 1160102 | unmarshal error | 请求参数解析失败，请确认请求参数中json数据是否符合参数规范。如果无法解决可以联系飞书人事 [技术支持](https://applink.feishu.cn/TLJpeNdW) 500 | 1160103 | request ID repeat | 请检查请求 ID 是否重复