API开放平台

TIP

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

# 查询收款单数据V2

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

{
    "page_number": 1,
    "id": "7992869671049732483",
	"status": "1",
	"cm_id": "5108521383450986770",
	"cm_code":" STORE2021081201539",
	"create_date": "2022-04-27",
	"modify_date": "2022-04-27"
}

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

参数说明：

参数	类型	必填	说明
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": "2022-04-27",
          "orderno": "",
          "write_off_amount": 133.33,
          "is_enable": "1",
          "submiter_name": "wzx",
          "emp_name": "wzx",
          "prepare_write_off_amount": "0.00",
          "remark": null,
          "no_write_off_amount": "0.00",
          "cm_code": "CUS01990",
          "receive_type": "",
          "cm_type": "",
          "use_prepare": "0.00",
          "account_name": "现金",
          "confirm_emp_name": "",
          "small_amount": "0",
          "details": [
               {
                    "order_no": "",
                    "date": "2022-04-27",
                    "amount": 133.33,
                    "create_time": "2022-04-27 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",
          "receive_no": "SK202104020001",
          "account_form_name": "现金",
          "add_prepare_amount": "0.00",
          "cm_name": "1003",
          "account_code": "cash",
          "creator_name": "wzx",
          "status": "1",
          "account_details": [
              {
                  "amount": "-1.00",
                  "account_name": "现金",
                  "account_code": "cash",
                  "account_form_name": "现金"
              }
          ],
          "confirm_status": "0"
    }
]

参数说明：

参数	类型	必填	说明
receive_no	VARCHAR(32)	是	单据编号
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)	是	未核销金额
use_prepare	numeric(10,2)	是	使用预收
add_prepare_amount	numeric(10,2)	是	转入预收
prepare_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
submiter_name	VARCHAR(32)	是	提交人
confirm_emp_name	VARCHAR(32)	是	审批人
confirm_time_str	VARCHAR(32)	是	审批时间。格式：yyyy-mm-dd hh24:mi:ss
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
account_details	List	是	收款账户列表
account_details.amount	numeric(10,2)	是	账户收款金额
account_details.account_name	VARCHAR(32)	是	账户名称
account_details.account_code	VARCHAR(32)	是	账户编码
account_details.account_form_name	VARCHAR(32)	是	收款方式
account_details.account_detail_id	INT8	是	账户子表id
confirm_status	VARCHAR(32)	是	审批状态。0：待审批，1：已审批，2：已作废

# 新增收款单数据V2

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

{
    "cm_code": "STORE2021081201539",
    "emp_code": "qq1",
    "emp_name": "qq1",
    "date": "2022-04-27",
    "receive_amount": "5",
    "discount_amount": "0",
    "remark": "备注",
    "details": [
        {
            "account_code": "cash",
            "amount_name": "现金",
            "amount": "5",
            "account_form": "现金"
        }
    ]
}

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

参数说明：

参数	类型	必填	说明
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)	否	优惠金额
remark	VARCHAR(32)	否	备注
details	List	是	收款账户列表
details.account_form	VARCHAR(32)	是	收款方式名称
details.account_code	VARCHAR(32)	否	结算账户编码，结算账户编码和结算账户名称必须传一个
details.account_name	VARCHAR(32)	否	结算账户名称，结算账户号编码和结算账户名称必须传一个
details.amount	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)	是	响应说明

# 新增预收款收款单数据V2

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

{
    "cm_code": "STORE2021081201539",
    "emp_code": "qq1",
    "emp_name": "qq1",
    "date": "2022-04-27",
    "receive_amount": "5",
    "discount_amount": "0",
    "remark": "备注",
    "details": [
        {
            "account_code": "cash",
            "amount_name": "现金",
            "amount": "5",
            "account_form": "现金"
        }
    ]
}

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

参数说明：

参数	类型	必填	说明
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)	否	优惠金额
remark	VARCHAR(32)	否	备注
details	List	是	收款账户列表
details.account_form	VARCHAR(32)	是	收款方式名称
details.account_code	VARCHAR(32)	否	结算账户编码，结算账户编码和结算账户名称必须传一个
details.account_name	VARCHAR(32)	否	结算账户名称，结算账户号编码和结算账户名称必须传一个
details.amount	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/esssNewReceivableHistory/v1/approveEsssReceiveNew/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

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

参数说明：

参数	类型	必填	说明
receive_id	INT8	是	收款单id

响应示例：

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

参数说明：

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

← 收款单数据推送其他入库接口 →