API开放平台

TIP

查询收款单数据
新增收款单数据
新增预收款收款单数据
审批收款单

# 查询收款单数据

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

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
page_number	INT	是	页码默认1，每页默认1000条
status	CHAR(1)	否	记录状态。0：已删除，1：正常
cm_id	VARCHAR(32)	否	勤策客户唯一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	否	勤策中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	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	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	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)	是	响应说明