# 查询收款单数据

请求方式: 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

响应示例:

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据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"
    }
]

参数说明:

参数 类型 必填 说明
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 List
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 } 在线调试
请求示例:

{
    "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 } 在线调试
请求示例:

{
    "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 } 在线调试
请求示例:

{
    "id": "4922412710903888732",
    "upModifyTimeStr": "",
    "verify": "1",
    "confirmReason": "审批理由"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
id INT8 收款单id
upModifyTimeStr VARCHAR(32) 修改时间戳。格式:yyyy-MM-dd HH:mm:ss.us
verify VARCHAR(1) 审批标识,只能传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) 响应说明