API开放平台

TIP

# 费用预付接口

# 万能促销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）
请求地址： 第三方服务接口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

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

接口说明：支持线上费用预付款单行自定义字段的更新，传哪个字段就更新哪个字段。传的字段必须是系统中存在的自定义字段，其中，附件、图片不支持。支持的字段类型：客户、商品、人员、下拉框、单选框、多选框、文本框、多行文本框、数值框、日期、定位。 请求方式： 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) 预付款关闭金额

← mbo设置查询接口 →