# 收款单(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