API开放平台

TIP

# 新增应收调整单

请求方式： POST（HTTPS）
请求地址： https://openapi.qince.com/api/dmsReceivableChange/v1/save/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
	"cm_id": "",
	"cm_code": "",
	"cm_source_code": "",
	"supply_id": "",
	"supply_code": "",
	"supply_source_code": "",
	"type_name": "",
	"amount": "100.00",
	"date": "2024-01-01 10:00",
	"emp_id": "",
	"emp_code": "",
	"remark": ""
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
cm_id VARCHAR(32) 是 客户id，客户id、客户编码、客户第三方唯一标识必须传一个，如果同时存在，优先级依次递减
cm_code VARCHAR(100) 是 客户编码，客户id、客户编码、客户第三方唯一标识必须传一个，如果同时存在，优先级依次递减
cm_source_code VARCHAR(100) 是 客户第三方唯一标识，客户id、客户编码、客户第三方唯一标识必须传一个，如果同时存在，优先级依次递减
supply_id VARCHAR(32) 是 客户为直营客户时无需传，非直营客户时必传。收款单位id、收款单位编码、收款单位第三方唯一标识必须传一个，如果同时存在，优先级依次递减
supply_code VARCHAR(100) 是 客户为直营客户时无需传，非直营客户时必传。收款单位id、收款单位编码、收款单位第三方唯一标识必须传一个，如果同时存在，优先级依次递减
supply_source_code VARCHAR(100) 是 客户为直营客户时无需传，非直营客户时必传。收款单位id、收款单位编码、收款单位第三方唯一标识必须传一个，如果同时存在，优先级依次递减
type_name VARCHAR(100) 否 调整类型
amount VARCHAR(100) 是 调整金额
date TIMESTAMP 是 业务日期。格式：yyyy-MM-dd HH:mm
emp_id VARCHAR(32) 是 经办人id，经办人id和经办人编码必须传一个
emp_code VARCHAR(100) 是 经办人编码，经办人id和经办人编码必须传一个
remark VARCHAR(300) 否 备注

响应示例：

{
	"msg_id": "X000001",
	"return_code": 0,
	"return_msg": "",
	"response_data": null
}

参数说明：

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明
response_data String 响应数据

# 删除应收调整单

请求方式： POST（HTTPS）
请求地址： https://openapi.qince.com/api/dmsReceivableChange/v1/delete/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
	"id": "",
	"change_no": ""
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
id VARCHAR(32) 是 应收调整单id，应收调整单id和应收调整单号必须传一个
change_no VARCHAR(100) 是 单据号，应收调整单id和应收调整单号必须传一个

响应示例：

{
	"msg_id": "X000001",
	"return_code": 0,
	"return_msg": ""
}

参数说明：

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明

# 查询应收调整单

请求方式： POST（HTTPS）
请求地址： https://openapi.qince.com/api/dmsReceivableChange/v1/query/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
	"id": "",
	"change_no": "",
	"cm_code": "",
	"date_start_date": "",
	"date_end_date": "",
	"create_start_date": "",
	"create_end_date": "",
	"modify_start_date": "",
	"modify_end_date": "",
	"page": 1,
	"page_size": 1000,
	"status": ""
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
id VARCHAR(32) 否 应收调整单id
change_no VARCHAR(100) 否 应收调整单号
cm_code VARCHAR(100) 否 客户编码
date_start_date VARCHAR(20) 否 业务日期开始。格式：yyyy-MM-dd
date_end_date VARCHAR(20) 否 业务日期结束。格式：yyyy-MM-dd
create_start_date VARCHAR(20) 否 创建时间开始。格式：yyyy-MM-dd
create_end_date VARCHAR(20) 否 创建时间结束。格式：yyyy-MM-dd
modify_start_date VARCHAR(20) 否 修改时间开始。格式：yyyy-MM-dd
modify_end_date VARCHAR(20) 否 修改时间结束。格式：yyyy-MM-dd
page int 否 页码默认1，每页默认1000条
page_size int 否 每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整
status VARCHAR(10) 否 记录状态。0：已删除，1：正常

响应示例：

{
  "return_code": "0",
  "return_msg": null,
  "msg_id": "90b4b267dd3d49aeace879038b1e7291",
  "response_data": "{\"total\":1,\"page\":1,\"rows\":[{\"id\":\"4840239569407666173\",\"change_no\":\"TZ20260511000007\",\"cm_id\":\"5407602024634006708\",\"cm_code\":\"POS00000024\",\"supply_id\":\"7159585396807521122\",\"supply_code\":\"ZMD2025061000000001\",\"change_type_name\":\"账款调整\",\"change_amount\":\"12.14\",\"date\":\"2026-05-11\",\"create_time\":\"2026-05-11 10:51\",\"emp_name\":\"cjj\",\"remark\":\"备注\",\"status\":\"1\"}],\"page_size\":10}"
}

参数说明：

参数 类型 必填 说明
msg_id String 请求消息ID
return_code int 响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明
response_data String 响应数据

response_data 参数说明：

参数 类型 必填 说明
id VARCHAR(32) 否 应收调整单id
change_no VARCHAR(100) 否 应收调整单号
cm_id VARCHAR(32) 否 客户id
cm_code VARCHAR(100) 否 客户编码
cm_source_code VARCHAR(100) 否 客户第三方唯一标识
supply_id VARCHAR(32) 否 收款单位id
supply_code VARCHAR(100) 否 收款单位编码
supply_source_code VARCHAR(100) 否 收款单位第三方唯一标识
change_type_name VARCHAR(100) 否 调整类型
change_amount VARCHAR(100) 否 调整金额
date VARCHAR(20) 否 业务日期
create_time VARCHAR(30) 否 创建时间
modify_time VARCHAR(30) 否 修改时间
emp_name VARCHAR(100) 否 经办人姓名
remark VARCHAR(300) 否 备注
status VARCHAR(10) 否 记录状态。0：已删除，1：正常

← 兑货券相关接口 →