接口文档：获取合同公司列表

scope: contract_company:list

body参数

名称	类型	是否必填	描述
corpId	String	是	企业ID
ids	Array of String	否	合同公司ID列表（不传则查询全部）
status	String	否	状态筛选（NORMAL-正常，STOP-停用，不传则查询全部）
page	Integer	否	当前页码（默认1）
pageSize	Integer	否	每页大小（默认30）

返回参数

名称	类型	描述
success	Boolean	接口是否响应成功
errorCode	String	错误码（成功时为null）
errorMsg	String	错误提示原因（成功时为null）
data	Object	返回结果（分页数据）

data 数据结构

名称	类型	描述
list	Array of Object	合同公司列表
total	Integer	总记录数
page	Integer	当前页码
pageSize	Integer	每页大小

list 数组元素结构

名称	类型	描述
id	String	合同公司ID
contractCompanyName	String	合同公司名称
uniformSocialCreditCode	String	统一社会信用代码
shortName	String	简称
dateOfEstablishment	String	成立日期
businessScope	String	经营范围
legalRepresentative	String	法定代表人
address	String	地址
registeredCapital	Number	注册资本
type	String	类型
bankName	String	银行名称
bankAccount	String	银行账户
description	String	合同公司描述
status	String	状态

枚举值说明

status 合同公司状态

value	label
NORMAL	正常
STOP	停用

返回示例

{
    "data": {
        "list": [
            {
                "id": "68ae9b19e4b0a1034892b353",
                "contractCompanyName": "百事可乐公司",
                "uniformSocialCreditCode": "910000881917600043",
                "shortName": null,
                "dateOfEstablishment": null,
                "businessScope": null,
                "legalRepresentative": null,
                "address": null,
                "registeredCapital": null,
                "type": null,
                "bankName": null,
                "bankAccount": null,
                "description": null,
                "status": "NORMAL"
            }
        ],
        "total": 1,
        "totalSizeForSelect": 0,
        "page": 1,
        "pageSize": 10,
        "notDataPermission": null
    },
    "success": true,
    "errorCode": null,
    "errorMsg": null
}

注意事项

权限要求：调用方需拥有 contract_company:list 权限

ID筛选：ids 参数可传入合同公司ID列表进行精确查询，不传则返回全部

状态筛选：status 不传时返回所有状态的合同公司

可选字段：除 id、contractCompanyName、status 外，其余字段可能为 null（取决于企业是否填写）

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "data": {
        "list": [
            {
                "id": "",                               //合同公司 id
                "contractCompanyName": "",              //合同公司名称
                "uniformSocialCreditCode": "",          //统一社会信用代码
                "shortName": "",                        //简称
                "dateOfEstablishment": "",              //成立日期
                "businessScope": "",                    //经营范围
                "legalRepresentative": "",              //法定代表人
                "address": "",                          //地址
                "registeredCapital": "",                //注册资本
                "type": "",                             //类型
                "bankName": "",                         //银行名称
                "bankAccount": "",                      //银行账户
                "description": "",                      //合同公司描述
                "status": ""                            //字段状态
            }
        ],
        "total": 50,                                    //总条数 
        "page": 1,                                      //当前页数
         "pageSize": 30,                                //每页大小
        "notDataPermission": null 
    },
    "success": true,
    "errorCode": null,
    "errorMsg": null
}

合同公司列表

接口文档：获取合同公司列表#

body参数#

返回参数#

data 数据结构#

list 数组元素结构#

枚举值说明#

status 合同公司状态#

返回示例#

注意事项#

请求参数