菜单

通用批量操作

基本信息

用途说明：通用的批量操作，适用于只传id的操作，比如删除、审核、反审核
请求方式：POST
请求地址：http://api.kingdee.com/jdy/sys/common_batch_operate

headers参数

所有的接口必须携带header参数

参数名称	参数示例	是否必填	参数说明
Content-Type	application/json	true	固定传：application/json
groupName	ns-v7g6	true	分组名称，获取授权信息时返回的groupName
accountId	16xxxxxxxxxxxx	true	账套ID，获取授权信息时返回的accountId
X-GW-Router-Addr	https://tf.jdy.com	true	IDC域名，获取授权信息时返回的domain

params参数

参数名称	参数类型	是否必填	参数说明
access_token	string	true	金蝶云通行证token

body参数

参数名称	必选	类型	说明
ids	true	Array[String]	id的集合
numbers	true	Array[String]	编码的集合（*ids与numbesr二选一）
entity_number	true	String	单据或基础资料类型，参照《常用的基础资料或业务单据编码》
operate_type	true	String	操作类型，删除delete、审核audit、反审核unaudit、订单关闭close_donothing

请求示例

curl -X POST 
  'http://api.kingdee.com/jdy/sys/common_batch_operate?access_token=XXX' 
  -H 'Content-type: application/json;charset=utf-8' 
  -d '{
	ids:[804079444439336960,804086904000613376,804086658281507840],
	entity_number:sal_bill_outbound,
	operate_type:delete
}'

响应参数

参数名称	参数类型	参数说明
errorCode	string	返回码，调用成功时为success
message	string	返回信息，调用失败时会返回具体信息
data	obj	业务数据

data

参数名称	参数类型	参数说明
successPkIds	List<string>	保存成功时返回的id数组

响应示例

示例1

{
    success: true,
    data: {
        successPkIds: [804079444439336960],
        success: false,
        errorInfo: [
            {
                msg: 内码为804086904000613376资料不存在,
                id: 804086904000613376
            },
            {
                msg: XSCK-20200115-00003: 删除失败，单据已审核,
                id: 804086658281507840
            }
        ],
        message: 数据校验发现错误！,
        errorLevel: Error
    },
    errorCode: success
}

示例2

{
    success: false,
    message: 请输入操作类型,
    errorCode: fail
}

最近修改: 2025-08-12