# 费用预付接口

# 万能促销AP/CP预付款申请单新增接口

接口说明:万能促销AP/CP预付款申请单新增接口,适应于万能促销活动(AP/CP)场景。

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiaoPrepayment/v1/addApply/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "code": "YFK000202",
    "name": "YKFXXX",
    "account": "XXX",
    "remark": "备注",
    "details": [
      {
        "activity_code": "",
        "activity_cm_id": "",
        "prepayment_amount":"",
        "ext_fields": [
          {
            "name": "自定义文本",
            "value": "文本"
          }
        ]
      }
    ]
}
说明: 本示例仅供参考,具体以参数说明为准。

请求说明

参数 类型 必填 说明
code varchar(100) 预付款单号,不传时系统默认生成,必须不重复
name varchar(100) 预付款名称
account varchar(100) 经办人,账号存在且未被停用
remark varchar(4000) 预付款备注
details List 明细列表
details.activity_code varchar(32) 申请单号,在系统存在,且申请单审批通过
details.activity_cm_id varchar(100) 活动申请明细行ID,在系统存在,且对应申请单审批通过,且该行未关闭
details.prepayment_amount varchar(100) 预付金额
details.ext_fields varchar(100) 预付款行自定义字段
details.ext_fields.name varchar(100) 预付款行自定义字段名
details.ext_fields.value varchar(100) 预付款行自定义字段值

响应示例:

{
    "msg_id": "X0001",
    "return_code": 0,
    "return_msg": "预付款申请新增成功!"
}

​ ​ ​ ​ ​

# 万能促销AP/CP预付款申请单红冲接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiaoPrepayment/v1/reverseApply/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "code": "YFK202008100001",
    "account":"XXX",
    "reverse_time": "2021-01-01 09:05:09"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
code VARCHAR(100) 需要进行红冲的预付款单号
account VARCHAR(100) 红冲人账号,此预付款单的红冲人
reverse_time VARCHAR(100) 单据红冲时间,如果不传,则为接口传输日期

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}
参数 说明
return_code 响应编码
return_msg 响应信息
msg_id 消息ID

# 万能促销AP/CP预付款申请单查询接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiaoPrepayment/v1/queryList/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
  "create_from": "2021-01-10 00:00:00",
  "create_to": "2021-10-20 23:59:59",
  "modify_from": "2021-01-20 00:00:00",
  "modify_to": "2021-10-20 23:59:59",
  "prepayment_code": "YFK200112101550",
  "activity_code": "SQ202105110002",
  "flow_status": "1",
  "recent_audit_from": "2021-11-29 00:00:00",
  "recent_audit_to": "2021-11-29 23:59:59",
  "page":"1",
  "rows":"100"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
create_from VARCHAR(32) 创建开始时间。格式:yyyy-MM-dd HH:mm:ss
create_to VARCHAR(32) 创建结束时间。格式:yyyy-MM-dd HH:mm:ss
modify_from VARCHAR(32) 修改开始时间。格式:yyyy-MM-dd HH:mm:ss
modify_to VARCHAR(32) 修改结束时间。格式:yyyy-MM-dd HH:mm:ss
prepayment_code varchar 预付款单号
activity_code varchar 活动申请单号
flow_status varchar 审批状态。0:待审批,1:已审批,2:被打回,3:审批中
recent_audit_from varchar 最近审批开始时间。格式:yyyy-MM-dd HH:mm:ss
recent_audit_to varchar 最近审批结束时间。格式:yyyy-MM-dd HH:mm:ss
page VARCHAR(10) 数据页码,不填默认第一页
rows VARCHAR(10) 页长,默认1000

响应示例:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data":"<<DATA>>"
}

数据DATA示例:

[
  {
        "prepayment_code": "YFK2023060600000008",
        "prepayment_name": "71650002",
        "create_time": "2023-06-06 14:44:42",
        "creator_account": "ns",
        "creator_name": "xx",
        "prepayment_amount": "3.00",
        "flow_status": "0",
        "auditor_account": "",
        "auditor_name": "",
        "audit_time": "",
        "reverse_status": "",
        "reverser_account": "",
        "reverser_name": "",
        "reverse_time": "",
        "operator_name": "",
        "remark": "222"
  }
]

参数说明:

参数 类型 说明
prepayment_code VARCHAR(32) 预付款单号
prepayment_name VARCHAR(32) 预付款名称
create_time VARCHAR(100) 创建时间
creator_account VARCHAR(32) 创建人账号
creator_name VARCHAR(32) 创建人姓名
prepayment_amount VARCHAR(32) 预付款金额
flow_status VARCHAR(32) 审批状态。0:待审批,1:已审批,2:被打回,3:审批中
auditor_account VARCHAR(32) 最近审批人账号
auditor_name VARCHAR(32) 最近审批人姓名
audit_time VARCHAR(32) 最近审批时间
reverse_status VARCHAR(100) 红冲状态。1:被红冲,2:红冲
reverser_account VARCHAR(100) 红冲人账号
reverser_name VARCHAR(32) 红冲人姓名
reverse_time VARCHAR(32) 红冲时间
operator_name VARCHAR(32) 经办人
remark VARCHAR(32) 预付款备注

# 万能促销AP/CP预付款申请单明细查询接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiaoPrepayment/v1/queryDetailList/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
  "prepayment_code": "YFK2023060600000008",
  "page":"1",
  "rows":"100"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
prepayment_code VARCHAR(32) 预付款单号
page VARCHAR(10) 数据页码,不填默认第一页
rows VARCHAR(10) 页长,默认1000

响应示例:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data":"<<DATA>>"
}

数据DATA示例:

[
  {
        "id": "7443692480703869490",
        "prepayment_code": "YFK2023061300000010",
        "activity_code": "SQ202303220075",
        "activity_cm_id": "6033516322825915357",
        "activity_cm_amount": "1.01",
        "prepaid_amount": "0.10",
        "prepayment_amount": "0.10",
        "verified_amount": "0",
        "verifying_amount": "0",
        "ext_data": {
            "商品单选": {
              "name": "红药水",
              "code": "SP202109150005",
              "id": "8100596779352169588",
              "source_code": ""
            },
            "文本2": "4",
            "文本框1": "2",
            "单选1": "选项2",
            "客户单选": {
              "name": "hts001的门店002",
              "code": "CUS000033",
              "id": "8314693660311196859",
              "source_code": ""
            }
        }
  }
]

参数说明:

参数 类型 说明
id VARCHAR(32) 预付款行ID
prepayment_code VARCHAR(32) 预付款单号
activity_code VARCHAR(32) 申请单号
activity_cm_id VARCHAR(100) 申请行明细ID
activity_cm_amount VARCHAR(32) 申请金额
prepaid_amount VARCHAR(32) 已预付金额
prepayment_amount VARCHAR(32) 预付款金额
verified_amount VARCHAR(32) 已核销预付金额
verifying_amount VARCHAR(32) 核销中预付金额
ext_data VARCHAR(32) 预付款行自定义字段

# 万能促销AP/CP预付款申请单推送接口

接口说明:推送预付款申请单。当预付款申请单新建提交、修改提交、审批通过、打回、红冲时都会推送,所以对同一个预付款申请单(预付款申请单ID相同),该接口可能会调用多次。红冲的时候,由于会再生成一个新单,所以会有两条数据,会推送两次。

注:接口参数与万能促销AP/CP预付款申请单查询接口返回元素一致,若文档未更新请参考查询接口返回数据

请求方式: 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 cuxiao_verify_display
data <<请求数据体>> ,说明:格式为JSON格式数据

请求示例:

{
      "prepayment_code": "YFK2023060600000008",
      "prepayment_name": "71650002",
      "create_time": "2023-06-06 14:44:42",
      "creator_account": "ns",
      "creator_name": "xx",
      "prepayment_amount": "3.00",
      "flow_status": "0",
      "auditor_account": "",
      "auditor_name": "",
      "audit_time": "",
      "reverse_status": "",
      "reverser_account": "",
      "reverser_name": "",
      "reverse_time": "",
      "operator_name": "",
      "remark": "222",
      "details": [
          {
            "id": "7443692480703869490",
            "prepayment_code": "YFK2023061300000010",
            "activity_code": "SQ202303220075",
            "activity_cm_id": "6033516322825915357",
            "activity_cm_amount": "1.01",
            "prepaid_amount": "0.10",
            "prepayment_amount": "0.10",
            "verified_amount": "0",
            "verifying_amount": "0",
            "ext_data": {
              "商品单选": {
                "name": "红药水",
                "code": "SP202109150005",
                "id": "8100596779352169588",
                "source_code": ""
              },
              "文本2": "4",
              "文本框1": "2",
              "单选1": "选项2",
              "客户单选": {
                "name": "hts001的门店002",
                "code": "CUS000033",
                "id": "8314693660311196859",
                "source_code": ""
              }
            }
          }
      ]
}

参数说明:

参数 类型 说明
prepayment_code VARCHAR(32) 预付款单号
prepayment_name VARCHAR(32) 预付款名称
create_time VARCHAR(100) 创建时间
creator_account VARCHAR(32) 创建人账号
creator_name VARCHAR(32) 创建人姓名
prepayment_amount VARCHAR(32) 预付款金额
flow_status VARCHAR(32) 审批状态。0:待审批,1:已审批,2:被打回,3:审批中
auditor_account VARCHAR(32) 最近审批人账号
auditor_name VARCHAR(32) 最近审批人姓名
audit_time VARCHAR(32) 最近审批时间
reverse_status VARCHAR(100) 红冲状态。1:被红冲,2:红冲
reverser_account VARCHAR(100) 红冲人账号
reverser_name VARCHAR(32) 红冲人姓名
reverse_time VARCHAR(32) 红冲时间
operator_name VARCHAR(32) 经办人
remark VARCHAR(32) 预付款备注
details List 明细行
details.id VARCHAR(32) 预付款行ID
details.prepayment_code VARCHAR(32) 预付款单号
details.activity_code VARCHAR(32) 申请单号
details.activity_cm_id VARCHAR(100) 申请行明细ID
details.activity_cm_amount VARCHAR(32) 申请金额
details.prepaid_amount VARCHAR(32) 已预付金额
details.prepayment_amount VARCHAR(32) 预付款金额
details.verified_amount VARCHAR(32) 已核销预付金额
details.verifying_amount VARCHAR(32) 核销中预付金额
details.ext_data VARCHAR(32) 预付款行自定义字段

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001"
}
参数 说明
return_code 响应编码
return_msg 响应消息内容
msg_id 消息ID

# 万能促销AP/CP预付款申请单删除

接口说明:推送预付款申请单。当预付款申请单删除时会调用此接口。

请求方式: 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 cuxiao_prepayment_delete
data <<请求数据体>> ,说明:格式为JSON格式数据

请求示例:

{
    "prepayment_code": "YFK202105130005"
}

参数说明:

参数 类型 必填 说明
prepayment_code VARCHAR(32) 预付款单号

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001"
}
参数 说明
return_code 响应编码
return_msg 响应消息内容
msg_id 消息ID

# 万能促销AP/CP预付款申请单行自定义字段更新接口

接口说明:支持核销单头行自定义字段的更新,传哪个字段就更新哪个字段。传的字段必须是系统中存在的自定义字段,其中,附件、图片不支持。支持的字段类型:客户、商品、人员、下拉框、单选框、多选框、文本框、多行文本框、数值框、日期、定位。 请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiaoPrepayment/v1/extFiledUpdate/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
参数说明:

参数 类型 必填 说明
prepayment_code varchar 预付款申请单号
prepayment_id varchar 预付款ID
ext_list list 预付款申请单明细列表
ext_key VARCHAR(32) 预付款申请单行数据自定义字段名称
ext_value VARCHAR(32) 预付款申请单行数据自定义字段值(商品/客户/人员传code)
prepayment_cm_id VARCHAR(32) 预付款申请单行id

请求示例:

{
  "prepayment_id": "12312312",
  "prepayment_code":"YFK11213",
      "ext_list":[
        {
          "prepayment_cm_id":"4809137625405004710",
          "ext_key":"人员/商品/客户",
          "ext_value":"qwer(传code)"
    
        }
      ]
}

响应示例:

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

参数说明:

参数 类型 名称 备注
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码。0:成功,1:失败
return_msg VARCHAR(100) 响应说明

# 万能促销AP/CP预付款申请单关闭记录查询接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiaoPrepayment/v1/queryEndRecordList/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
  "start_date": "2021-01-10 00:00:00",
  "end_date": "2021-10-20 23:59:59",
  "prepayment_code": "YFK2131",
  "activity_code": "SQ1213",
  "end_code": "1234",
  "page":"1",
  "rows":"100"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
start_date VARCHAR(32) 关闭开始时间,格式yyyy-MM-dd HH:mm:ss
end_date VARCHAR(32) 关闭结束时间,格式yyyy-MM-dd HH:mm:ss
prepayment_code VARCHAR(32) 预付款单号
activity_code VARCHAR(32) 活动申请单号
end_code varchar 关闭单号
page VARCHAR(10) 数据页码,不填默认第一页
rows VARCHAR(10) 页长,默认1000

响应示例:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data":"<<DATA>>"
}

数据DATA示例:

[
  {
        "end_code": "YFK2023060600000008",
        "create_time": "2023-06-06 14:44:42",
        "creator_code": "asd",
        "creator_name": "ns",
        "end_reason": "xx",
        "activity_code": "SQ123",
        "activity_name": "撒旦",
        "supplier_name": "十分大",
        "supplier_code": "1231",
        "area_name": "阿斯顿",
        "apply_amount": "111",
        "prepayment_amount": "111",
        "verified_amount": "111",
        "end_amount": "111"
  }
]

参数说明:

参数 类型 说明
end_code VARCHAR(32) 关闭单号
create_time VARCHAR(32) 关闭时间
creator_code VARCHAR(100) 关闭人账号
creator_name VARCHAR(32) 关闭人姓名
end_reason VARCHAR(32) 关闭原因
activity_code VARCHAR(32) 申请单号
activity_name VARCHAR(32) 申请单名称
supplier_name VARCHAR(32) 供应商
supplier_code VARCHAR(32) 供应商编码
area_name VARCHAR(32) 活动场地
apply_amount VARCHAR(100) 申请金额
prepayment_amount VARCHAR(100) 预付金额
verified_amount VARCHAR(32) 已核销预付金额
end_amount VARCHAR(32) 预付款关闭金额

# 线上费用预付款申请新增接口

接口说明:线上费用预付款申请新增接口,适应于线上费用场景。

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiaoPrepayment/v1/addOnlineCostApply/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "code": "YFK000202",
    "name": "YKFXXX",
    "account": "XXX",
    "remark": "备注",
    "details": [
      {
        "activity_code": "",
        "activity_cm_id": "",
        "prepayment_amount":"",
        "ext_fields": [
          {
            "name": "自定义文本",
            "value": "文本"
          }
        ]
      }
    ]
}
说明: 本示例仅供参考,具体以参数说明为准。

请求说明

参数 类型 必填 说明
code varchar(100) 预付款单号,不传时系统默认生成,必须不重复
name varchar(100) 预付款名称
account varchar(100) 经办人,账号存在且未被停用
remark varchar(4000) 预付款备注
details List 明细列表
details.activity_code varchar(32) 申请单号,在系统存在,且申请单审批通过
details.activity_cm_id varchar(100) 活动申请明细行ID,在系统存在,且对应申请单审批通过,且该行未关闭
details.prepayment_amount varchar(100) 预付金额
details.ext_fields varchar(100) 预付款行自定义字段
details.ext_fields.name varchar(100) 预付款行自定义字段名
details.ext_fields.value varchar(100) 预付款行自定义字段值

响应示例:

{
    "msg_id": "X0001",
    "return_code": 0,
    "return_msg": "预付款申请新增成功!"
}

# 线上费用预付款申请红冲接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiaoPrepayment/v1/reverseOnlineCostApply/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "code": "YFK202008100001",
    "account":"XXX",
    "reverse_time": "2021-01-01 09:05:09"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
code VARCHAR(100) 需要进行红冲的预付款单号
account VARCHAR(100) 红冲人账号,此预付款单的红冲人
reverse_time VARCHAR(100) 单据红冲时间,如果不传,则为接口传输日期

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data": null
}

# 线上费用预付款申请单查询接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiaoPrepayment/v1/queryOnlineCostList/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
  "create_from": "2021-01-10 00:00:00",
  "create_to": "2021-10-20 23:59:59",
  "modify_from": "2021-01-20 00:00:00",
  "modify_to": "2021-10-20 23:59:59",
  "prepayment_code": "YFK200112101550",
  "activity_code": "SQ202105110002",
  "flow_status": "1",
  "recent_audit_from": "2021-11-29 00:00:00",
  "recent_audit_to": "2021-11-29 23:59:59",
  "page":"1",
  "rows":"100"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
create_from VARCHAR(32) 创建开始时间。格式:yyyy-MM-dd HH:mm:ss
create_to VARCHAR(32) 创建结束时间。格式:yyyy-MM-dd HH:mm:ss
modify_from VARCHAR(32) 修改开始时间。格式:yyyy-MM-dd HH:mm:ss
modify_to VARCHAR(32) 修改结束时间。格式:yyyy-MM-dd HH:mm:ss
prepayment_code varchar 预付款单号
activity_code varchar 活动申请单号
flow_status varchar 审批状态。0:待审批,1:已审批,2:被打回,3:审批中
recent_audit_from varchar 最近审批开始时间。格式:yyyy-MM-dd HH:mm:ss
recent_audit_to varchar 最近审批结束时间。格式:yyyy-MM-dd HH:mm:ss
page VARCHAR(10) 数据页码,不填默认第一页
rows VARCHAR(10) 页长,默认1000

响应示例:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data":"<<DATA>>"
}

数据DATA示例:

[
  {
        "prepayment_code": "YFK2023060600000008",
        "prepayment_name": "71650002",
        "create_time": "2023-06-06 14:44:42",
        "creator_account": "ns",
        "creator_name": "xx",
        "prepayment_amount": "3.00",
        "flow_status": "0",
        "auditor_account": "",
        "auditor_name": "",
        "audit_time": "",
        "reverse_status": "",
        "reverser_account": "",
        "reverser_name": "",
        "reverse_time": "",
        "operator_name": "",
        "remark": "222"
  }
]

参数说明:

参数 类型 说明
prepayment_code VARCHAR(32) 预付款单号
prepayment_name VARCHAR(32) 预付款名称
create_time VARCHAR(100) 创建时间
creator_account VARCHAR(32) 创建人账号
creator_name VARCHAR(32) 创建人姓名
prepayment_amount VARCHAR(32) 预付款金额
flow_status VARCHAR(32) 审批状态。0:待审批,1:已审批,2:被打回,3:审批中
auditor_account VARCHAR(32) 最近审批人账号
auditor_name VARCHAR(32) 最近审批人姓名
audit_time VARCHAR(32) 最近审批时间
reverse_status VARCHAR(100) 红冲状态。1:被红冲,2:红冲
reverser_account VARCHAR(100) 红冲人账号
reverser_name VARCHAR(32) 红冲人姓名
reverse_time VARCHAR(32) 红冲时间
operator_name VARCHAR(32) 经办人
remark VARCHAR(32) 预付款备注
参数 说明
return_code 响应编码
return_msg 响应信息
msg_id 消息ID

# 线上费用预付款申请明细查询接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiaoPrepayment/v1/queryOnlineCostDetailList/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
  "prepayment_code": "YFK2023060600000008",
  "page":"1",
  "rows":"100"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
prepayment_code VARCHAR(32) 预付款单号
page VARCHAR(10) 数据页码,不填默认第一页
rows VARCHAR(10) 页长,默认1000

响应示例:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data":"<<DATA>>"
}

数据DATA示例:

[
  {
        "id": "7443692480703869490",
        "prepayment_code": "YFK2023061300000010",
        "activity_code": "SQ202303220075",
        "activity_cm_id": "6033516322825915357",
        "activity_cm_amount": "1.01",
        "prepaid_amount": "0.10",
        "prepayment_amount": "0.10",
        "verified_amount": "0",
        "verifying_amount": "0",
        "ext_data": {
            "商品单选": {
              "name": "红药水",
              "code": "SP202109150005",
              "id": "8100596779352169588",
              "source_code": ""
            },
            "文本2": "4",
            "文本框1": "2",
            "单选1": "选项2",
            "客户单选": {
              "name": "hts001的门店002",
              "code": "CUS000033",
              "id": "8314693660311196859",
              "source_code": ""
            }
        }
  }
]

参数说明:

参数 类型 说明
id VARCHAR(32) 预付款行ID
prepayment_code VARCHAR(32) 预付款单号
activity_code VARCHAR(32) 申请单号
activity_cm_id VARCHAR(100) 申请行明细ID
activity_cm_amount VARCHAR(32) 申请金额
prepaid_amount VARCHAR(32) 已预付金额
prepayment_amount VARCHAR(32) 预付款金额
verified_amount VARCHAR(32) 已核销预付金额
verifying_amount VARCHAR(32) 核销中预付金额
ext_data VARCHAR(32) 预付款行自定义字段

# 线上费用预付款申请推送接口

接口说明:推送预付款申请单。当预付款申请单新建提交、修改提交、审批通过、打回、红冲时都会推送,所以对同一个预付款申请单(预付款申请单ID相同),该接口可能会调用多次。红冲的时候,由于会再生成一个新单,所以会有两条数据,会推送两次。

注:接口参数与线上费用预付款申请单查询接口返回元素一致,若文档未更新请参考查询接口返回数据

请求方式: 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 cuxiao_verify_display
data <<请求数据体>> ,说明:格式为JSON格式数据

请求示例:

{
      "prepayment_code": "YFK2023060600000008",
      "prepayment_name": "71650002",
      "create_time": "2023-06-06 14:44:42",
      "creator_account": "ns",
      "creator_name": "xx",
      "prepayment_amount": "3.00",
      "flow_status": "0",
      "auditor_account": "",
      "auditor_name": "",
      "audit_time": "",
      "reverse_status": "",
      "reverser_account": "",
      "reverser_name": "",
      "reverse_time": "",
      "operator_name": "",
      "remark": "222",
      "details": [
          {
            "id": "7443692480703869490",
            "prepayment_code": "YFK2023061300000010",
            "activity_code": "SQ202303220075",
            "activity_cm_id": "6033516322825915357",
            "activity_cm_amount": "1.01",
            "prepaid_amount": "0.10",
            "prepayment_amount": "0.10",
            "verified_amount": "0",
            "verifying_amount": "0",
            "ext_data": {
              "商品单选": {
                "name": "红药水",
                "code": "SP202109150005",
                "id": "8100596779352169588",
                "source_code": ""
              },
              "文本2": "4",
              "文本框1": "2",
              "单选1": "选项2",
              "客户单选": {
                "name": "hts001的门店002",
                "code": "CUS000033",
                "id": "8314693660311196859",
                "source_code": ""
              }
            }
          }
      ]
}

参数说明:

参数 类型 说明
prepayment_code VARCHAR(32) 预付款单号
prepayment_name VARCHAR(32) 预付款名称
create_time VARCHAR(100) 创建时间
creator_account VARCHAR(32) 创建人账号
creator_name VARCHAR(32) 创建人姓名
prepayment_amount VARCHAR(32) 预付款金额
flow_status VARCHAR(32) 审批状态。0:待审批,1:已审批,2:被打回,3:审批中
auditor_account VARCHAR(32) 最近审批人账号
auditor_name VARCHAR(32) 最近审批人姓名
audit_time VARCHAR(32) 最近审批时间
reverse_status VARCHAR(100) 红冲状态。1:被红冲,2:红冲
reverser_account VARCHAR(100) 红冲人账号
reverser_name VARCHAR(32) 红冲人姓名
reverse_time VARCHAR(32) 红冲时间
operator_name VARCHAR(32) 经办人
remark VARCHAR(32) 预付款备注
details List 明细行
details.id VARCHAR(32) 预付款行ID
details.prepayment_code VARCHAR(32) 预付款单号
details.activity_code VARCHAR(32) 申请单号
details.activity_cm_id VARCHAR(100) 申请行明细ID
details.activity_cm_amount VARCHAR(32) 申请金额
details.prepaid_amount VARCHAR(32) 已预付金额
details.prepayment_amount VARCHAR(32) 预付款金额
details.verified_amount VARCHAR(32) 已核销预付金额
details.verifying_amount VARCHAR(32) 核销中预付金额
details.ext_data VARCHAR(32) 预付款行自定义字段

参数说明:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001"
}
参数 说明
return_code 响应编码
return_msg 响应消息内容
msg_id 消息ID

# 线上费用预付款申请自定义字段更新接口

接口说明:支持线上费用预付款单行自定义字段的更新,传哪个字段就更新哪个字段。传的字段必须是系统中存在的自定义字段,其中,附件、图片不支持。支持的字段类型:客户、商品、人员、下拉框、单选框、多选框、文本框、多行文本框、数值框、日期、定位。 请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiaoOnLineCostPrepayment/v1/extFiledUpdate/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
参数说明:

参数 类型 必填 说明
prepayment_code varchar 预付款申请单号
prepayment_id varchar 预付款ID
ext_list list 预付款申请单明细列表
ext_key VARCHAR(32) 预付款申请单行数据自定义字段名称
ext_value VARCHAR(32) 预付款申请单行数据自定义字段值(商品/客户/人员传code)
prepayment_cm_id VARCHAR(32) 预付款申请单行id

请求示例:

{
  "prepayment_id": "12312312",
  "prepayment_code":"YFK11213",
      "ext_list":[
        {
          "prepayment_cm_id":"4809137625405004710",
          "ext_key":"人员/商品/客户",
          "ext_value":"qwer(传code)"
    
        }
      ]
}

响应示例:

{
    "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/cuxiaoPrepayment/v1/queryOnlineCostEndRecordList/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
  "start_date": "2021-01-10 00:00:00",
  "end_date": "2021-10-20 23:59:59",
  "prepayment_code": "YFK2131",
  "activity_code": "SQ1213",
  "end_code": "1234",
  "page":"1",
  "rows":"100"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
start_date VARCHAR(32) 关闭开始时间,格式yyyy-MM-dd HH:mm:ss
end_date VARCHAR(32) 关闭结束时间,格式yyyy-MM-dd HH:mm:ss
prepayment_code VARCHAR(32) 预付款单号
activity_code VARCHAR(32) 活动申请单号
end_code varchar 关闭单号
page VARCHAR(10) 数据页码,不填默认第一页
rows VARCHAR(10) 页长,默认1000

响应示例:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001",
    "response_data":"<<DATA>>"
}

数据DATA示例:

[
  {
      "activity_name": "08220001",
      "end_code": "GBYFK2024082900000001",
      "create_time": "2024-08-29 16:28",
      "end_reason": "",
      "activity_code": "SQ202408220019",
      "input_item_name": "带公示计算-淘宝、pdd",
      "exe_cycle": "2024-08-15 ~ 2024-08-31",
      "platform_name": "淘宝",
      "verified_amount": "",
      "creator_name": "闫沛",
      "id": "6056838570053526794",
      "prepayment_amount": 30,
      "end_amount": "30.00",
      "apply_amount": "30.00"
 }
]

参数说明:

参数 类型 说明
end_code VARCHAR(32) 关闭单号
create_time VARCHAR(32) 关闭时间
creator_code VARCHAR(100) 关闭人账号
creator_name VARCHAR(32) 关闭人姓名
end_reason VARCHAR(32) 关闭原因
activity_code VARCHAR(32) 申请单号
activity_name VARCHAR(32) 申请单名称
platform_name VARCHAR(32) 平台
input_item_name VARCHAR(32) 付费项目
apply_amount VARCHAR(100) 申请金额
prepayment_amount VARCHAR(100) 预付金额
verified_amount VARCHAR(32) 已核销预付金额
end_amount VARCHAR(32) 预付款关闭金额