# 查询收款单数据

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/esssReceivableHistory/v1/queryEsssReceivableHistory/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体:

{
    "page_number": 1,
    "id":"7992869671049732483",
	"status":"1",
	"cm_id":"6563654583404943994",
	"cm_code":" DD000201700290",
	"create_date":"2021-04-02",
	"modify_date":"2021-04-02"
}

请求信息

参数 类型 必填 说明
page_number INT 页码默认1,每页默认1000条
status CHAR(1) 记录状态:0 已删除 1 正常
cm_id VARCHAR(32) 外勤365客户唯一ID
cm_code VARCHAR(32) 客户编码,有效字符详见附录:有效字符说明 (opens new window)
create_date VARCHAR(32) 创建日期,格式:“yyyy-MM-dd”
modify_date VARCHAR(32) 修改日期,格式:“yyyy-MM-dd”
after_create_date VARCHAR(32) 创建时间之后,格式:“yyyy-MM-dd HH:mm:ss”
after_modify_date VARCHAR(32) 修改时间之后,格式:“yyyy-MM-dd HH:mm:ss”
start_create_date VARCHAR(32) 创建时间开始,格式:“yyyy-MM-dd”
end_create_date VARCHAR(32) 创建时间结束,格式:“yyyy-MM-dd”
start_modify_date VARCHAR(32) 修改时间开始,格式:“yyyy-MM-dd”
end_modify_date VARCHAR(32) 修改时间结束,格式:“yyyy-MM-dd”
id VARCHAR 外勤365中id
start_confirm_time VARCHAR(32) 审批通过开始时间,格式:“yyyy-MM-dd HH:mm:ss”
end_confirm_time VARCHAR(32) 审批通过结束时间,格式:“yyyy-MM-dd HH:mm:ss”

返回结果:

{
	"msg_id":"X000001",
	"return_code":"0",
	"return_msg":"", 
	"response_data": [
			{
                      "confirm_time_str": "",
                      "date": "2021-04-02",
                      "orderno": "",
                      "write_off_amount": 133.33,
                      "is_enable": "1",
                      "submiter_name": "wzx",
                      "emp_name": "wzx",
                      "remark": null,
                      "no_write_off_amount": "0.00",
                      "cm_code": "CUS01990",
                      "receive_type": "",
                      "cm_type": "",
                      "account_name": "现金",
                      "confirm_emp_name": "",
                      "small_amount": "0",
                      "details": [
                           {
                                "order_no": "",
                                "date": "2021-04-02",
                                "amount": 133.33,
                                "create_time": "2021-04-02 10:31",
                                "write_off_amount": 133.33,
                                "bill_no": "XSD202104020003",
                                "remark": "",
                                "creator_name": "wzx",
                                "detail_id": 5593944427794729000,
                                "type": "销售单"
                           }
                      ],
                      "id": "8031811764826166702",
                      "creator_code": "wzx",
                      "amount": "133.33",
                      "emp_code": "wzx",
                      "create_time": "2021-04-02 10:31:39",
                      "modify_time": "2021-01-14 14:49:26.304331",
                      "receive_no": "SK202104020001",
                      "account_form_name": "现金",
                      "cm_name": "1003",
                      "account_code": "cash",
                      "creator_name": "wzx",
                      "status": "1"
                 }
	    ]
}

响应信息

参数 类型 必填 说明
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码:0成功 1失败
return_msg VARCHAR(100) 响应说明
response_data VARCHAR(32) 响应数据体[{......}]
receive_no INT8 单据编号
cm_name VARCHAR(32) 客户名称
cm_type VARCHAR(32) 客户类型
account_name VARCHAR(32) 结算账户
receive_type varchar(10) 收款类型
account_form_name VARCHAR(32) 收款方式
amount numeric(10,2) 收款金额
small_amount numeric(10,2) 优惠金额
write_off_amount numeric(10,2) 已核销金额
no_write_off_amount numeric(10,2) 未核销金额
orderno INT8 关联订单号
date VARCHAR(32) 收款日期,yyyy-mm-dd格式
emp_name VARCHAR(32) 经办人
create_time VARCHAR(32) 提交时间,yyyy-mm-dd hh24:mi格式
modify_time VARCHAR(32) 提交时间,yyyy-mm-dd hh24:mi:ss.us格式
submiter_name VARCHAR(32) 提交人
confirm_emp_name VARCHAR(32) 审批人
confirm_time_str VARCHAR(32) 审批时间,yyyy-mm-dd hh24:mi格式
remark VARCHAR(100) 备注
details[].type VARCHAR(32) 业务类型
details[].bill_no INT8 单据号
details[].order_no INT8 关联订单号
details[].amount numeric(10,2) 单据金额
details[].write_off_amount numeric(10,2) 本单核销
details[].date VARCHAR(32) 单据日期,yyyy-mm-dd格式
details[].remark numeric(10,8) 单据备注
details[].creator_name VARCHAR(32) 提交人
details[].create_time VARCHAR(32) 提交时间,yyyy-mm-dd hh24:mi格式

# 新增收款单数据

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/esssReceivableHistory/v1/addEsssReceive/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:


{
    "cm_code": "0001078555",
    "emp_code": "16",
    "date": "2019-01-25",
    "receive_amount": "100",
    "discount_amount": "10",
    "account":"支付宝"
}

请求信息

参数 类型 必填 说明
cm_code VARCHAR(32) 客户编码
emp_code VARCHAR(32) 经办人编码,经办人编码和经办人名称必须传一个
emp_name VARCHAR(100) 经办人名称,经办人编码和经办人名称必须传一个
date VARCHAR(32) 收款日期,格式必须是yyyy-MM-dd
receive_amount VARCHAR(32) 收款金额
discount_amount VARCHAR(32) 优惠金额
account VARCHAR(32) 收款账号名称
remark VARCHAR(100) 备注

返回结果:

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

响应信息

参数 类型 必填 说明
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码:0成功 1失败
return_msg VARCHAR(100) 响应说明

# 新增预收款收款单数据

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/esssReceivableHistory/v1/addPrepaidFeeEsssReceive/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:


{
    "cm_code": "0001078555",
    "emp_code": "16",
    "date": "2019-01-25",
    "receive_amount": "100",
    "discount_amount": "10",
    "account":"支付宝",
    "receiveType":"3"
}

请求信息

参数 类型 必填 说明
cm_code VARCHAR(32) 客户编码
emp_code VARCHAR(32) 经办人编码,经办人编码和经办人名称必须传一个
emp_name VARCHAR(100) 经办人名称,经办人编码和经办人名称必须传一个
date VARCHAR(32) 收款日期,格式必须是yyyy-MM-dd
receive_amount VARCHAR(32) 收款金额
discount_amount VARCHAR(32) 优惠金额
account VARCHAR(32) 收款账号名称
remark VARCHAR(100) 备注
receiveType VARCHAR(2) 收款类型,3:预收款

返回结果:

{
    "return_code": "0",
    "return_msg": "",
    "msg_id": "X000001",
    "return_data": "{\"id\":\"6586695366524478985\",\"code\":\"GJ201611150001\"}"
}

响应信息

参数 类型 必填 说明
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码:0成功 1失败
return_msg VARCHAR(100) 响应说明

# 审批收款单

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/esssReceivableHistory/v1/approveEsssReceive/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:


{
    "id": "4922412710903888732",
    "upModifyTimeStr": "",
    "verify": "1",
    "confirmReason": "审批理由"
}

请求信息

参数 类型 必填 说明
id INT8 收款单id
upModifyTimeStr VARCHAR(32) 修改时间戳 'yyyy-MM-dd HH:mm:ss.us'
verify VARCHAR(1) 审批 1-审批
confirmReason VARCHAR(200) 审批理由

返回结果:

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

响应信息

参数 类型 必填 说明
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码:0成功 1失败
return_msg VARCHAR(100) 响应说明