# 收款单(receive)相关数据同步
勤策平台收款单数据发生变化时向第三方系统推送数据接口
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
参数名称 | 参数值 |
---|---|
msgId | 消息ID |
dataId | 数据ID |
dataVersion | 接口数据版本,如:001 |
dataFormat | 数据格式:json |
dataSource | 数据来源:biz 业务功能产生 api 开放接口产生 |
timestamp | 请求时间戳,如:1503276678552 |
status | 数据同步状态,0-数据首次同步 2-数据失败同步 |
statusTime | 上次同步失败时间,格式:yyyy-MM-dd HH:mm:ss |
tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
digest | 数据签名,md5(data|pushsecret|timestamp) |
dataType | receive |
data | <<请求数据体>> , 说明:格式为JSON格式数据 |
请求数据体:
{
"receive_no": "SK202101090003",
"cm_code": "zsmd",
"cm_name":"张三门店",
"cm_source_code":"",
"emp_code": "zhangsan",
"emp_name": "张三",
"emp_source_code": "",
"date": "2018-04-23",
"receive_amount": "200",
"small_amount": "10",
"pay_type": "微信",
"account_name": "9251",
"remark": "备注1",
"order_no": "SD202101090005",
"comfirm_status": "1",
"exts": [
{
"ext_key": "单行文本框1",
"ext_value": "12"
},
{
"ext_key": "日期自定义",
"ext_value": "2016-11-28 20:58"
},
{
"ext_key": "紧急程度",
"ext_value": ""
},
{
"ext_key": "可靠程度",
"ext_value": ""
},
{
"ext_key": "多选1",
"ext_value": ""
},
{
"ext_key": "图片1",
"ext_value": ""
},
{
"ext_key": "数值2",
"ext_value": ""
},
{
"ext_key": "文本框2",
"ext_value": ""
},
{
"ext_key": "自定义时间",
"ext_value": ""
},
{
"ext_key": "自定义时间2",
"ext_value": ""
}
]
}
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
id | INT8 | 是 | 收款单id |
receive_no | VARCHAR(32) | 是 | 收款单号 |
cm_code | VARCHAR(32) | 是 | 客户编码 |
cm_name | VARCHAR(32) | 是 | 客户名称 |
cm_source_code | VARCHAR(32) | 是 | 客户sourcecode |
emp_code | VARCHAR(32) | 是 | 经办人编码 |
emp_name | varchar(32) | 是 | 经办人名称 |
emp_source_code | varchar(32) | 是 | 经办人sourcecode |
date | VARCHAR(32) | 是 | 收款日期,yyyy-mm-dd格式 |
receive_amount | VARCHAR(32) | 是 | 收款金额 |
small_amount | VARCHAR(32) | 是 | 优惠金额 |
pay_type | VARCHAR(32) | 是 | 付款方式 0、现金 1、微信 2、支付宝 3、其他 |
account_name | VARCHAR(32) | 是 | 结算账户 |
remark | VARCHAR(4000) | 是 | 备注 |
order_no | VARCHAR(32) | 是 | 订单编号 |
order_pay_status | VARCHAR(32) | 是 | 支付状态(0:线上未支付;1:线上已支付;3:线下支付) |
comfirm_status | VARCHAR(32) | 是 | 审核状态;0:审核,1:已审核 |
details | List | ||
details.type | VARCHAR(2) | 是 | 核销记录类型;1、期初余额,2、销售发货单,3、客户退货,4、车销单 |
details.bill_id | INT8 | 是 | 单据id;type是1的时候对应期初应收款id,2的时候对应发货主表id,3的时候对应退货主表id,4的时候对应的是车销单主表id,5的时候对应的是订货单主表id |
details.bill_no | VARCHAR(32) | 是 | 单据编号 |
details.bill_detail_id | INT8 | 是 | 单据明细行id |
details.amount | VARCHAR(32) | 是 | 金额 |
details.sequ | VARCHAR(32) | 是 | 排序号 |
exts | List | 收款单信息扩展字段列表 | |
exts.ext_key | varchar(4000) | 是 | 收款单信息扩展字段需先在我方系统中创建 |
exts.ext_value | varchar(4000) | 是 | 扩展字段value值对应多个选项值,以","分隔拼接 |
is_enable | varchar(2) | 是 | 是否作废,0、已作废,1、未作废 |
is_outside | varchar(2) | 是 | 是否是外部erp同步单据,1:是;0:否 |
bill_check_status | varchar(2) | 是 | 确认字段,交款交账用,0、待确认 1、已确认 (交款交账用) |
account_form_str | varchar(4000) | 是 | 当时的收款方式,冗余,多个‘、’连接,保存时前端传值 |
account_str | varchar(4000) | 是 | 当时的结算账户,冗余,多个‘、’连接,保存时前端传值 |
refund_status | varchar(2) | 是 | 退款状态,0、可退款 1、退款中 2、退款成功 |
pay_status | varchar(2) | 是 | 支付状态,0、待支付 1、支付成功 |
print_count | numeric(20) | 是 | 打印次数 |
confirm_reason | varchar(4000) | 是 | 审批意见 |
响应示例:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
参数说明:
参数 | 说明 |
---|---|
return_code | 响应编码 |
return_msg | 响应消息内容 |
msg_id | 消息ID |