# 预算费控

# 付费陈列核销单新增接口

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

{
    "plan_code": "CX202103293722",
    "creator": "test",
    "business_date": "2021-04-21",
    "verify_data": [
        {
            "activity_code": "SQ202104010001",
            "activity_detail_id": 7547546183825121319,
            "amount": "100.00",
            "verify_remark": "备注1",
            "pay_mode": "现金",
            "rebate_account": ""
        },
        {
            "activity_code": "SQ202104090002",
            "activity_detail_id": 6916424039566956578,
            "amount": "200.00",
            "verify_remark": "备注2",
            "pay_mode": "货补返利",
            "rebate_account": "一号账户"
        }
    ]
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
plan_code varchar(100) 需要核销的活动方案编码
creator varchar(100) 此核销单的创建人
business_date date 如果企业启用费用核算参数的时候此字段需要传值,如果未开启则不用传值
activity_code varchar(100) 需要核销的申请单编号
activity_detail_id int 需要核销的付费明细行ID,如果传了申请单编号,会校验申请单号下是否存在此付费明细行ID
amount int 核销单的提交核销金额
verify_remark varchar(4000) 核销备注
pay_mode varchar(100) 需要传系统中存在的支付方式名称
rebate_account varchar(100) 如果支付方式为“货补返利”的时候,此字段必传。否则此字段传空

响应示例:

{
    "msg_id": "X0001",
    "return_code": 0,
    "return_msg": "付费陈列核销单新增成功!"
}

参数说明:

参数 类型 说明
msg_id string 请求消息ID
return_code int 响应编码。0:成功,1:失败
return_msg string 响应说明

# 万能促销活动核销单新增接口

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

{
    "plan_code": "CX2022012701",
    "account": "DM",
    "rows": [
        {
            "apply_code": "SQ20220127180401",
            "row_id": "456456456",
            "amount": "100.00",
            "remark": "",
            "pay_mode": "现金",
            "rebate_account": "费用池",
            "gifts": [
                {
                    "pd_name": "白酒",
                    "pd_code": "CP000001",
                    "num": 1
                }
            ],
            "ext_fields": [
               {
                   "field_name": "文本",
                   "field_value": "自定义备注"
               }
            ]
        }
    ]
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
plan_code VARCHAR(100) 方案编号
account VARCHAR(100) 创建人账号
rows List 列表
rows.apply_code VARCHAR(100) 活动申请单号
rows.row_id BIGINT 活动申请明细行ID
rows.amount NUMERIC(20, 2) 本次核销金额
rows.remark VARCHAR 核销备注
rows.pay_mode VARCHAR 支付方式
rows.rebate_account VARCHAR 费用池账户。如果支付方式配置的返利方式为费用池的时候,此字段必传。否则此字段传空
rows.gifts List 实际赠送品项,如果支付方式配置的返利方式为赠品池的时候,需要传输商品明细
rows.gifts.pd_name VARCHAR 商品名称
rows.gifts.pd_code VARCHAR 商品编码
rows.gifts.num VARCHAR 核销数量
rows.ext_fields List 扩展字段
rows.ext_fields.field_name VARCHAR 扩展字段名称
rows.ext_fields.field_value VARCHAR 扩展字段名称的值

响应示例:

{
    "msg_id": "X0001",
    "return_code": 0,
    "return_msg": "万能促销活动核销单新增成功!"
}

参数说明:

参数 类型 说明
msg_id string 请求消息ID
return_code int 响应编码。0:成功,1:失败
return_msg string 响应说明

# 固定金额申请核销单新增接口

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

{
  "activity_code": "SQ202111120002",
  "code":"AHX0089798",
  "creator": "test",
  "create_date": "2021-11-12",
  "business_date": "2021-11-12",
  "verify_data": [
    {
      "activity_detail_id": 4967594324087205762,
      "amount": "600",
      "verify_remark": "备注1",
      "pay_mode_name": "现金",
      "rebate_account": ""
    },
    {
      "activity_detail_id": 7520594854182052191,
      "amount": "800",
      "verify_remark": "备注1",
      "pay_mode_name": "现金",
      "rebate_account": ""
    }
  ]
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
code varchar(100) 如果不传系统自动生成
activity_code varchar(100) 需要核销的申请单号
creator varchar(100) 此核销单的创建人
create_date varchar(100) 单据创建日期,如果不传,则为接口传输日期
business_date date 如果企业启用费用核算参数的时候此字段需要传值,如果未开启则不用传值
verify_data List 明细行
verify_data.activity_detail_id int 需要核销的付费明细行ID,如果传了申请单编号,会校验申请单号下是否存在此付费明细行ID
verify_data.amount int 核销单的提交核销金额
verify_data.verify_remark varchar(4000) 核销备注
verify_data.pay_mode_name varchar(100) 需要传系统中存在的支付方式名称
verify_data.rebate_account varchar(100) 如果支付方式配置的需要关联费用池,此字段必传。否则此字段传空

响应示例:

{
    "msg_id": "X0001",
    "return_code": 0,
    "return_msg": "固定金额核销单新增成功!"
}

参数说明:

参数 类型 说明
msg_id string 请求消息ID
return_code int 响应编码。0:成功,1:失败
return_msg string 响应说明

# 进场费核销单新增接口

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

{
  "plan_code": "JCF202201116907",
  "creator": "test",
  "verify_data": [
    {
      "activity_code": "SQ202112120001",
      "activity_detail_id": 4967594324087205762,
      "verify_amount": "600",
      "verify_remark": "备注1",
      "pay_mode": "现金",
      "rebate_account": ""
    },
    {
      "activity_detail_id": 7520594854182052191,
      "verify_amount": "800",
      "verify_remark": "备注1",
      "pay_mode_": "现金",
      "rebate_account": ""
    }
  ]
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
plan_code varchar(100) 需要核销的活动方案编码
creator varchar(100) 此核销单的创建人
verify_data List 明细行
verify_data.activity_code varchar(100) 需要核销的申请单编号
verify_data.activity_detail_id int 需要核销的付费明细行ID,如果传了申请单编号,会校验申请单号下是否存在此付费明细行ID
verify_data.verify_amount int 核销单的提交核销金额
verify_data.verify_remark varchar(4000) 核销备注
verify_data.pay_mode varchar(100) 需要传系统中存在的支付方式名称
verify_data.rebate_account varchar(100) 如果支付方式配置的需要关联费用池,此字段必传。否则此字段传空

响应示例:

{
    "msg_id": "X0001",
    "return_code": 0,
    "return_msg": "新增成功!"
}

参数说明:

参数 类型 说明
msg_id string 请求消息ID
return_code int 响应编码。0:成功,1:失败
return_msg string 响应说明

# 核销单新增接口(直接创建核销)

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

{
    "form_name": "直接创建核销单",
    "account": "zhangsan",
    "create_time": "2022-03-01 20:05:35",
    "bussiness_date": "2022-03-01",
    "dept_name": "销售一部",
    "budget_rows": [
        {
            "subject_code": "KM202203010001",
            "subject_name": "科目",
            "period": "2022-02",
            "dim_data": {
                "维度": "维度值"
            },
            "customer_code": "KH202203010001",
            "customer_name": "客户",
            "dealer_code": "JXS202203010001",
            "dealer_name": "经销商",
            "pd_code": "PD202203010001",
            "pd_name": "商品",
            "amount": "100.00",
            "remark": "备注",
            "pay_mode_name": "转费用池",
            "rebate_account_name": "返利账户",
            "ext_fields": [
                {
                    "name": "理由",
                    "value": "二月份核销"
                }
            ]
        }
    ]
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
form_name VARCHAR 核销单名称。直接创建核销利用的核销单
account VARCHAR 创建人账号。此核销单的创建人
create_time VARCHAR 单据创建日期。格式:yyyy-MM-dd HH:mm:ss。如果不传,则为接口传输日期
bussiness_date VARCHAR 过账日期。格式:yyyy-MM-dd。如果企业启用费用核算参数的时候此字段需要传值,如果未开启则不用传值
dept_name VARCHAR 此核销单所属部门
budget_rows List 列表
budget_rows.subject_code VARCHAR 需要核销的预算科目编号
budget_rows.subject_name VARCHAR 需要核销的预算科目名称
budget_rows.period VARCHAR 预算扣减的期间
budget_rows.dim_data VARCHAR 预算维度信息,格式为:{"预算维度名称":"维值名称"},多个维度用逗号隔开
budget_rows.customer_code VARCHAR 客户编码
budget_rows.customer_name VARCHAR 客户名称
budget_rows.dealer_code VARCHAR 费用代垫经销商编码
budget_rows.dealer_name VARCHAR 费用代垫经销商名称
budget_rows.pd_code VARCHAR 商品编码
budget_rows.pd_name VARCHAR 商品名称
budget_rows.amount VARCHAR 核销单的提交核销金额
budget_rows.remark VARCHAR 核销备注
budget_rows.pay_mode_name VARCHAR 支付方式,需要传系统中存在的支付方式名称
budget_rows.rebate_account_name VARCHAR 费用池账户,如果支付方式配置的需要关联费用池,此字段必传。否则此字段传空。
budget_rows.ext_fields.name VARCHAR 行自定义字段的名称,自定义字段需要先在外勤365系统中维护
budget_rows.ext_fields.value VARCHAR 自定义字段value值,如果对应多个选项值,以“,”分隔拼接

响应示例:

{
    "msg_id": "X0001",
    "return_code": 0,
    "return_msg": "新增成功!"
}

参数说明:

参数 类型 说明
msg_id string 请求消息ID
return_code int 响应编码。0:成功,1:失败
return_msg string 响应说明

# 付费陈列核销单查询

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

{
    "createStartDate": "2017-01-10 00:00:00",
    "createEndDate": "2017-01-20 00:00:00",
    "modifyStartDate": "2017-01-20 00:00:00",
    "modifyEndDate": "2017-01-20 00:00:00",
    "verifyCode": "HX202105140003",
    "verifyStatus": "1",
    "recentAuditFrom": "2021-08-13 00:00:00",
    "recentAuditTo": "2021-08-13 23:59:59",
    "page":"1",
    "pageSize":"100"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
createStartDate VARCHAR(32) 创建开始时间。格式:yyyy-MM-dd HH:mm:ss
createEndDate VARCHAR(32) 创建结束时间。格式:yyyy-MM-dd HH:mm:ss
modifyStartDate VARCHAR(32) 修改开始时间。格式:yyyy-MM-dd HH:mm:ss
modifyEndDate VARCHAR(32) 修改结束时间。格式:yyyy-MM-dd HH:mm:ss
verifyCode VARCHAR(10) 核销单号
verifyStatus VARCHAR(10) 审批状态
recentAuditFrom VARCHAR(32) 最近审批开始时间。格式:yyyy-MM-dd HH:mm:ss
recentAuditTo VARCHAR(32) 最近审批结束时间。格式:yyyy-MM-dd HH:mm:ss
page VARCHAR(10) 数据页码,默认1
pageSize VARCHAR(10) 页长,默认1000

响应示例:

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
    {
        "planId": "5323166537693260610",
        "planCode": "CX20210511224",
        "applyFormName": "付费陈列0506",
        "verifyCode": "HX202105130005",
        "createTime": "2021-05-13 13:58:38",
        "creatorId": 0,
        "creatorName": "lm",
        "creatorDeptCode":"yanptpm",
        "creatorDeptName":"闫沛的TPM企业",
        "verifyAmount": "2.00",
        "verifyStatus": "1",
        "auditId": "7108046175560648076",
        "auditName": "lm",
        "auditTime": "2021-05-13 14:57:50",
        "reverseStatus": "",
        "reversorId": 0,
        "reversorName": "",
        "reverseTime": "",
        "assignFormId": "5294142376237267736",
        "formDataId": 8907080812679072997,
        "businessDate": null,
        "verificationApplyDetails": [{
            "activityCode": "SQ202105110002",
            "customerCode": "CUS000007",
            "customerName": "番茄",
            "uperDealerCode":"csjxs001",
            "uperDealerName": "测试经销商001",
            "businesscAcountCode": "HS202105130003",
            "activityPeriod": "2021-05-01~2021-05-10",
            "initAmount": 2.00,
            "auditAmount": 2.00,
            "subjectCode": "A0001",
            "subjectName": "预算科目001",
            "period": "2021-05",
            "dimsData": {
              "部门": "zf02"
            },
            "verifyRemark": "有过账日期的核销",
            "payModeName": "现金",
            "rebateAccountName": "",
            "budgetAmount": 3.00,
            "dim_dept_name": "zf02",
            "activityCmId": 5261441935139966722
        }],
        "verifyApplyId": 5836080081584349325
    }
]

参数说明:

参数 类型 说明
planId VARCHAR(32) 方案id
planCode VARCHAR(32) 方案编码
applyFormName VARCHAR(32) 核销单模板名称
verifyCode VARCHAR(32) 核销单号
createTime VARCHAR(32) 创建时间。格式:yyyy-MM-dd HH:mm:ss
creatorId VARCHAR(100) 创建人账号
creatorName VARCHAR(32) 创建人姓名
creatorDeptCode VARCHAR(32) 创建人部门编码
creatorDeptName VARCHAR(32) 创建人部门名称
verifyAmount VARCHAR(32) 核销金额
verifyStatus VARCHAR(32) 审批状态。0:处理中,1:已审批,2:被打回
auditId VARCHAR(32) 最近审批人账号
auditName VARCHAR(32) 最近审批人名称
auditTime VARCHAR(32) 最近审批时间。格式:yyyy-MM-dd HH:mm:ss
reverseStatus VARCHAR(32) 红冲状态。0:正常,1:被红冲,2:红冲
reversorId VARCHAR(32) 红冲人账号
reversorName VARCHAR(32) 红冲人姓名
reverseTime VARCHAR(32) 红冲时间
assignFormId VARCHAR(32) 核销单叠加表单id
formDataId VARCHAR(32) 核销单叠加表单数据id
businessDate VARCHAR(32) 过账日期。格式:yyyy-MM-dd HH:mm:ss
verificationApplyDetails 明细行
verificationApplyDetails.activityCode VARCHAR(32) 活动编码
verificationApplyDetails.customerCode VARCHAR(32) 客户编码
verificationApplyDetails.customerName VARCHAR(32) 客户名称
verificationApplyDetails.uperDealerCode VARCHAR(32) 费用代垫经销商编码
verificationApplyDetails.uperDealerName VARCHAR(32) 费用代垫经销商名称
verificationApplyDetails.businessAcountCode VARCHAR(32) 核算记录编号
verificationApplyDetails.activityPeriod VARCHAR(32) 活动周期
verificationApplyDetails.id VARCHAR(32) 核销的申请付费项目明细行ID
verificationApplyDetails.initAmount VARCHAR(32) 本次核销金额
verificationApplyDetails.auditAmount VARCHAR(32) 批复核销金额
verificationApplyDetails.budgetAmount VARCHAR(32) 预算申请金额
verificationApplyDetails.subjectCode VARCHAR(32) 预算科目编码
verificationApplyDetails.subjectName VARCHAR(32) 预算科目名称
verificationApplyDetails.period VARCHAR(32) 预算期间
verificationApplyDetails.dimsData text 预算维度。格式为:{"预算维度名称":维值名称}
verificationApplyDetails.verifyRemark text 核销备注
verificationApplyDetails.payModeName VARCHAR(32) 支付方式
verificationApplyDetails.rebateAccountName VARCHAR(32) 返利账户
verificationApplyDetails.activityCmId VARCHAR(32) 活动门店id
verificationApplyDetails.inputName VARCHAR(32) 投入项名称

# 核销单查询接口(进场费)

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

{
    "createFrom": "2021-11-15 00:00:00",
    "createTo": "2021-11-15 23:59:59",
    "modifyFrom": "2021-11-16 00:00:00",
    "modifyTo": "2021-11-16 23:59:59",
    "recentAuditFrom": "2021-11-16 00:00:00",
    "recentAuditTo": "2021-11-16 23:59:59",
    "verifyCode": "HX202111150012",
    "verifyStatus": "1",
    "page":"1",
    "rows":"100"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
createFrom VARCHAR(10) 创建开始时间。格式:yyyy-MM-dd HH:mm:ss
createTo VARCHAR(10) 创建结束时间。格式:yyyy-MM-dd HH:mm:ss
modifyFrom VARCHAR(10) 修改开始时间。格式:yyyy-MM-dd HH:mm:ss
modifyTo VARCHAR(10) 修改结束时间。格式:yyyy-MM-dd HH:mm:ss
verifyCode VARCHAR(10) 核销单号
verifyStatus VARCHAR(10) 审批状态,0-处理中 1-已通过 2-已打回 3-审批中
recentAuditFrom VARCHAR(32) 最近审批开始时间。格式:yyyy-MM-dd HH:mm:ss
recentAuditTo VARCHAR(32) 最近审批结束时间。格式:yyyy-MM-dd HH:mm:ss
page VARCHAR(10) 数据页码
rows VARCHAR(10) 页长,默认1000

响应示例:

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
    {
        "assign_form": "4863414592974601888",
        "audit_time": "2021-11-16 09:17:58",
        "auditor_id": "8175157116914580540",
        "auditor_name": "xwj20",
        "cm_list": [
            {
                "activity_code": "SQ202110280016",
                "audit_amount": "1.00",
                "customer_code": "CUS000324",
                "customer_name": "新增99",
                "dealer_code": null,
                "dealer_name": null,
                "dim_data": "{\"家畜\":\"鸡\",\"维度1\":\"维值1\"}",
                "entrance_period": "2021-10-15~2021-11-15",
                "execute_period": "2021-10-01~2021-11-30",
                "pay_mode_name": "转费用池",
                "period": "2021-10",
                "rebate_account_name": "账户1",
                "store_num": "10",
                "subject_code": "预算测试694_3",
                "subject_name": "预算测试694_3",
                "verify_amount": "1.00",
                "verify_remark": "大幅度"
            }
        ],
        "create_time": "2021-11-15 15:24:58",
        "creator_id": "8175157116914580540",
        "creator_name": "xwj20",
        "form_data_id": "8866296749272151230",
        "form_name": "进场费--1dada",
        "plan_code": "JCF202110282763",
        "plan_id": "5828029683618730733",
        "reverse_status": "1",
        "reverse_time": "2021-11-16 11:10:35",
        "reverse_user_id": "8175157116914580540",
        "reverse_user_name": "xwj20",
        "verify_amount": "1.00",
        "verify_code": "HX202111150012",
        "verify_status": "1"
    }
]

参数说明:

参数 类型 说明
plan_id VARCHAR(32) 方案ID
plan_code VARCHAR(32) 方案编号
form_name VARCHAR(32) 核销单模板名称
verify_code VARCHAR(32) 核销单号
create_time VARCHAR(32) 核销单创建时间。格式:yyyy-MM-dd HH:mm:ss
creator_id VARCHAR(32) 核销单创建人
creator_name VARCHAR(32) 核销单创建人姓名
verify_amount VARCHAR(32) 核销单的核销金额
verify_status VARCHAR(32) 核销单的审批状态,0:处理中,1:已审批,2:被打回,3:审批中
auditor_id VARCHAR(32) 最近审批人
auditor_name VARCHAR(32) 最近审批人员工姓名
audit_time VARCHAR(32) 最近审批时间。格式:yyyy-MM-dd HH:mm:ss
reverse_status VARCHAR(32) 红冲状态。0:正常,1:被红冲,2:红冲
reverse_user_id VARCHAR(32) 红冲人账号
reverse_user_name VARCHAR(32) 红冲人姓名
reverse_time VARCHAR(32) 红冲时间
assign_form VARCHAR(32) 核销单叠加表单模板ID
form_data_id VARCHAR(32) 核销单叠加表单数据ID
cm_list List
cm_list.activity_code VARCHAR(32) 本次核销的申请单编号
cm_list.customer_code VARCHAR(32) 客户编码
cm_list.customer_name VARCHAR(32) 客户名称
cm_list.dealer_code VARCHAR(32) 费用代垫经销商编码
cm_list.dealer_name VARCHAR(32) 费用代垫经销商名称
cm_list.execute_period VARCHAR(32) 执行周期, 客户申请的活动周期
cm_list.entrance_period VARCHAR(32) 申请进场时间
cm_list.store_num VARCHAR(32) 申请进场门店数
cm_list.verify_amount VARCHAR(32) 本次核销提报金额
cm_list.audit_amount VARCHAR(32) 核销单最近一次审批节点审批通过的金额
cm_list.subject_code VARCHAR(32) 预算科目编码
cm_list.subject_name VARCHAR(32) 预算科目名称
cm_list.period VARCHAR(32) 预算扣减的期间
cm_list.dim_data TEXT 预算维度信息,格式为:{"预算维度名称":维值名称}
cm_list.verify_remark TEXT 核销行备注信息
cm_list.pay_mode_name VARCHAR(32) 核销行的支付方式
cm_list.rebate_account_name VARCHAR(32) 核销行的费用池账户,支付方式为“转费用池”的时候,此字段有值

# 核销单查询接口(市场活动方案)

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

{
    "createStartDate": "2021-10-10 00:00:00",
    "createEndDate": "2021-12-20 00:00:00",
    "modifyStartDate": "2020-01-20 00:00:00",
    "modifyEndDate": "2021-01-20 00:00:00",
    "verifyCode": "HX202105140003",
    "verifyStatus": "1",
    "auditStartDate": "2021-08-13 16:06:20",
    "auditEndDate": "2021-12-13 16:06:20",
    "page":"1",
    "pageSize":"100"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
createStartDate VARCHAR(32) 创建开始时间。格式:yyyy-MM-dd HH:mm:ss
createEndDate VARCHAR(32) 创建结束时间。格式:yyyy-MM-dd HH:mm:ss
modifyStartDate VARCHAR(32) 修改开始时间。格式:yyyy-MM-dd HH:mm:ss
modifyEndDate VARCHAR(32) 修改结束时间。格式:yyyy-MM-dd HH:mm:ss
verifyCode VARCHAR(10) 核销单号
verifyStatus VARCHAR(10) 0:处理中,1:已审批,2:被打回
auditStartDate VARCHAR(32) 最近审批开始时间。格式:yyyy-MM-dd HH:mm:ss
auditEndDate VARCHAR(32) 最近审批结束时间。格式:yyyy-MM-dd HH:mm:ss
page VARCHAR(10) 页码,不填默认第一页
pageSize VARCHAR(10) 页长,不填默认1000

响应示例:

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
    {
        "planId": "5323166537693260610",
        "planCode": "CX20210511224",
        "applyFormName": "市场活动0506",
        "verifyCode": "HX202105130005",
        "createTime": "2021-05-13 13:58:38",
        "creatorId": 0,
        "creatorName": "lm",
        "verifyAmount":"10.00",
        "verifyStatus": "1",
        "auditId": "7108046175560648076",
        "auditName": "lm",
        "auditTime": "2021-05-13 14:57:50",
        "reverseStatus": "",
        "reverserId": 0,
        "reverserName": "",
        "reverseTime": "",
        "payMode": 1,
        "rebateAccount": "",
        "assignFormId": "5294142376237267736",
        "formDataId": 8907080812679072997,
        "verificationCmDetails": [{
            "activityCode": "SQ202105110002",
            "customerCode": "CUS000007",
            "customerName": "番茄",
            "customerType": "番茄",
            "managerName": "admin",
            "activityCircle": "2021-05-01~2021-05-10",
            "verifyRemark": "核销备注"
        }],        
        "verificationBudgetDetails": [{
            "activityCode": "SQ202105110002",
            "subjectCode": "KM000007",
            "subjectName": "预算科目",
            "period": "番茄",
            "dimsData": {
              "部门": "zf02"
            },
            "initAmount": "10.00",
            "auditAmount": "10.00"
        }]
    }
]

参数说明:

参数 类型 说明
planId VARCHAR(32) 方案id
planCode VARCHAR(32) 方案编码
applyFormName VARCHAR(32) 核销单模板名称
verifyCode VARCHAR(32) 核销单号
createTime VARCHAR(32) 核销单创建时间。格式:yyyy-MM-dd HH:mm:ss
creatorId VARCHAR(100) 核销单创建人的员工账号
creatorName VARCHAR(32) 核销单创建人姓名
verifyAmount VARCHAR(32) 核销单的核销金额,取最近一个审批节点填写的金额(预算扣减金额合计)
verifyStatus VARCHAR(32) 核销单的审批状态,0:处理中,1:已审批,2:被打回
auditId VARCHAR(32) 最近审批人的员工账号
auditName VARCHAR(32) 最近审批人员工姓名
auditTime VARCHAR(32) 最近审批时间。格式:yyyy-MM-dd HH:mm:ss
reverseStatus VARCHAR(32) 核销单红冲状态,0:正常,1:被红冲,2:红冲
reverserId VARCHAR(32) 核销单红冲人ID,只有状态为“被红冲”的,才会有值
reverserName VARCHAR(32) 核销单红冲人姓名,只有状态为“被红冲”的,才会有值
reverseTime VARCHAR(32) 核销单红冲时间,只有状态为“被红冲”的,才有值
payMode VARCHAR(32) 支付方式
rebateAccount VARCHAR(32) 费用池账户,支付方式为“转费用池”的时候,此字段有值
assignFormId VARCHAR(32) 核销单叠加表单模板ID
formDataId VARCHAR(32) 核销单叠加表单数据ID
verificationCmDetails 核销客户明细行
verificationCmDetails.activityCode VARCHAR(32) 本次核销的申请单编号,可一次对多个申请单进行核销
verificationCmDetails.customerCode VARCHAR(32) 客户编码
verificationCmDetails.customerName VARCHAR(32) 客户名称
verificationCmDetails.customerType VARCHAR(32) 客户类型
verificationCmDetails.managerName VARCHAR(32) 业务员
verificationCmDetails.activityCircle VARCHAR(32) 客户申请的执行周期
verificationCmDetails.verifyRemark VARCHAR(200) 核销备注
verificationBudgetDetails 预算扣减明细行
verificationBudgetDetails.activityCode VARCHAR(32) 本次核销的申请单编号,可一次对多个申请单进行核销
verificationBudgetDetails.subjectCode VARCHAR(32) 预算科目编码
verificationBudgetDetails.subjectName VARCHAR(32) 预算科目名称
verificationBudgetDetails.period VARCHAR(32) 预算扣减的期间
verificationBudgetDetails.dimsData VARCHAR(32) 预算维度信息,格式为:{"预算维度名称":维值名称},多个维度用逗号隔开
verificationBudgetDetails.initAmount VARCHAR(32) 本次本行预算扣减金额
verificationBudgetDetails.auditAmount VARCHAR(32) 核销单该预算行最近一次审批节点审批通过的金额

# 核销单查询接口(品鉴会)

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiaoRecord/v1/queryTastingRecords/{ 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",
      "verify_code": "HX2112101550",
      "verify_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
verify_code VARCHAR(32) 核销单号
verify_status VARCHAR(10) 0:待审批,1:已审批,2:被打回, 3:处理中
recent_audit_from VARCHAR(32) 最近审批开始时间。格式:yyyy-MM-dd HH:mm:ss
recent_audit_to VARCHAR(32) 最近审批结束时间。格式:yyyy-MM-dd HH:mm:ss
page VARCHAR(10) 数据页码
rows VARCHAR(10) 页长,默认1000

响应示例:

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
    {
        "activity_time": "AM",
        "record_status": "-1",
        "executor_name": "刀妹",
        "actual_participation_num": null,
        "by_pds": [
            {
                "period": "2022-02",
                "pay_mode_name": "现金",
                "rebate_account_name": null,
                "item_name": "海报",
                "dim_data": {
                    "预算组织": "江苏区",
                    "产品分类": "消耗品",
                    "成本中心": "华东区"
                },
                "verify_amount": "5.60",
                "audit_amount": "5.60",
                "subject_name": "子科目一",
                "pds": [
                    {
                        "pd_num": "1.00",
                        "pd_name": "蓝药水",
                        "pd_code": "pd_002",
                        "pd_unit": "把"
                    }
                ],
                "budget_amount": "-130.00"
            }
        ],
        "plan_code": "CX202202224988",
        "form_data_id": null,
        "audit_time": null,
        "audit_id": null,
        "reverse_user_name": null,
        "assign_form": null,
        "reverse_user_time": null,
        "predict_tables": "1",
        "verify_status": "0",
        "customer_code": "CUS000009",
        "predict_participation_num": "2",
        "by_cash": [
            {
                "period": "2022-02",
                "pay_mode_name": "现金",
                "rebate_account_name": null,
                "item_name": "海报",
                "dim_data": {
                    "预算组织": "江苏区",
                    "产品分类": "消耗品",
                    "成本中心": "华北区"
                },
                "verify_amount": "10.00",
                "audit_amount": "10.00",
                "subject_name": "子科目一",
                "budget_amount": "0.00"
            }
        ],
        "reverse_user_id": null,
        "create_time": "2022-02-22 10:57:46",
        "activity_date": "2022-02-22",
        "actual_tables": null,
        "activity_code": "SQ202202220001",
        "plan_name": "699-品鉴会",
        "audit_name": null,
        "pd_details": [
            {
                "actual_num": null,
                "predict_num": "5",
                "pd_name": "蓝药水",
                "pd_code": "pd_002",
                "pd_unit": "把"
            }
        ],
        "reverse_status": "0",
        "creator_id": "4883362607570892159",
        "creator_name": "刀妹",
        "customer_name": "EZ",
        "plan_id": "8149574848177672943"
    }
]

参数说明:

参数 类型 说明
plan_id VARCHAR(32) 活动方案ID
plan_code VARCHAR(32) 活动方案编码
verify_code VARCHAR(32) 核销单号
create_time VARCHAR(32) 核销单创建时间。格式:yyyy-MM-dd HH:mm:ss
creator_id VARCHAR(32) 核销单创建人的员工账号
creator_name VARCHAR(32) 核销单创建人姓名
verify_status VARCHAR(10) 核销单的审批状态,0:处理中,1:已审批,2:被打回, 3:处理中
audit_id VARCHAR(32) 最近审批人的员工账号
audit_name VARCHAR(32) 最近审批人员工姓名
audit_time VARCHAR(32) 最近审批时间。格式:yyyy-MM-dd HH:mm:ss
reverse_status VARCHAR(10) 核销单红冲状态,0:正常,1:被红冲,2:红冲
reverse_user_id VARCHAR(32) 核销单红冲人ID,只有状态为“被红冲”的,才会有值
reverse_user_name VARCHAR(32) 核销单红冲人姓名,只有状态为“被红冲”的,才会有值
reverse_time VARCHAR(32) 核销单红冲时间,只有状态为“被红冲”的,才有值
activity_code VARCHAR(32) 申请单号
customer_code VARCHAR(32) 客户编码
customer_name VARCHAR(32) 客户名称
activity_date VARCHAR(32) 活动日期。格式:yyyy-MM-dd
activity_time VARCHAR(32) 活动时间,
executor_name VARCHAR(32) 执行人名称
predict_cm_num VARCHAR(32) 预计参与人数
actual_cm_num VARCHAR(32) 实际参与人数
predict_tables VARCHAR(32) 预计桌数
actual_tables VARCHAR(32) 实际桌数
record_status VARCHAR(32) 上报状态, -1: 未上报;0:待评价;1:合格;2:不合格;
assign_form VARCHAR(32) 核销单叠加表单ID
form_data_id VARCHAR(32) 核销单叠加表单数据ID
pd_details List
pd_details.pd_code VARCHAR(32) 品鉴商品编码
pd_details.pd_name VARCHAR(32) 品鉴商品名称
pd_details.pd_unit VARCHAR(32) 单位
pd_details.predict_num VARCHAR(32) 预计使用数量
pd_details.actual_num VARCHAR(32) 实际使用数量
by_pds List
by_pds.item_name VARCHAR(32) 付费项目
by_pds.verify_amount VARCHAR(32) 核销申请金额
by_pds.audit_amount VARCHAR(32) 批复核销金额
by_pds.pds.pd_code VARCHAR(32) 商品编码
by_pds.pds.pd_name VARCHAR(32) 商品名称
by_pds.pds.pd_unit VARCHAR(32) 单位
by_pds.pds.verify_num VARCHAR(32) 本次核销数量
by_pds.pay_mode_name VARCHAR(32) 支付方式
by_pds.rebate_account_name VARCHAR(32) 费用池账户
by_pds.subject_name VARCHAR(32) 预算科目名称
by_pds.period VARCHAR(32) 预算期间
by_pds.dim_data VARCHAR(32) 预算维度jason
by_pds.budget_amount VARCHAR(32) 可用预算
by_cash List
by_cash.item_name VARCHAR(32) 付费项目
by_cash.verify_amount VARCHAR(32) 核销申请金额
by_cash.audit_amount VARCHAR(32) 批复核销金额
by_cash.pay_mode_name VARCHAR(32) 支付方式
by_cash.rebate_account_name VARCHAR(32) 费用池账户
by_cash.subject_name VARCHAR(32) 预算科目名称
by_cash.period VARCHAR(32) 预算期间
by_cash.dim_data VARCHAR(32) 预算维度jason
by_cash.budget_amount VARCHAR(32) 可用预算

# 核销单查询接口(万能促销活动)

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiao/verify/v1/queryVerificationRegular/{ 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",
      "verify_code": "HX2112101550",
      "activity_code": "SQ202105110002",
      "verify_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
verify_code varchar 核销单号
activity_code varchar 活动申请单号
verify_status varchar 0:处理中,1:已审批,2:被打回
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": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
    {
        "plan_id": "5323166537693260610",
        "plan_code": "CX20210511224",
        "verify_form_name": "核销0506",
        "verify_code": "HX202105130005",
        "create_time": "2021-05-13 13:58:38",
        "creator_id": "85458",
        "creator_name": "lm",
        "verify_amount":"10.00",
        "verify_status": "1",
        "audit_id": "7108046175560648076",
        "audit_name": "lm",
        "audit_time": "2021-05-13 14:57:50",
        "reverse_status": "",
        "reverser_id": "",
        "reverser_name": "",
        "reverse_time": "",
        "assignFormId": "5294142376237267736",
        "formDataId": "8907080812679072997",
        "ext_data": {
            "自定义头": "文本1"
        },
        "details": [{
            "activity_code": "SQ202105110002",
            "customer_code": "CUS000007",
            "customer_name": "客户1",
            "updealer_code": "CUS000006",
            "updealer_name": "经销商1",
            "execute_date": "2021-05-01~2021-05-10",
            "init_amount": "10.00",
            "audit_amount": "20.00",
            "subject_code": "KM00001",
            "subject_name": "科目1",
            "period": "2021-05-01",
            "dims_data": {
              "部门": "zf02"
            },
            "verify_remark": "科目1",
            "pay_mode_name": "现金",
            "rebate_name": "返利帐户",
            "ext_data": {
              "自定义文本": "11"
            }
        }]
    }
]

参数说明:

参数 类型 说明
plan_id VARCHAR(32) 活动方案ID
plan_code VARCHAR(32) 活动方案编码
verify_form_name VARCHAR(32) 核销单模板名称
verify_code VARCHAR(32) 核销单号
create_time VARCHAR(32) 核销单创建时间。格式:yyyy-MM-dd HH:mm:ss
creator_id VARCHAR(100) 核销单创建人的员工账号
creator_name VARCHAR(32) 核销单创建人姓名
verify_amount VARCHAR(32) 核销单的核销金额,取最近一个审批节点填写的金额(预算扣减金额合计)
verify_status VARCHAR(32) 核销单的审批状态,0:处理中,1:已审批,2:被打回
audit_id VARCHAR(32) 最近审批人的员工账号
audit_name VARCHAR(32) 最近审批人员工姓名
audit_time VARCHAR(32) 最近审批时间。格式:yyyy-MM-dd HH:mm:ss
reverse_status VARCHAR(32) 核销单红冲状态,0:正常,1:被红冲,2:红冲
reverser_id VARCHAR(32) 核销单红冲人ID,只有状态为“被红冲”的,才会有值
reverser_name VARCHAR(32) 核销单红冲人姓名,只有状态为“被红冲”的,才会有值
reverse_time VARCHAR(32) 核销单红冲时间,只有状态为“被红冲”的,才有值
ext_data VARCHAR(32) 扩展字段
assign_form VARCHAR(32) 核销单叠加表单模板ID
form_data_id VARCHAR(32) 核销单叠加表单数据ID
details 核销明细行
details.activity_code VARCHAR(32) 本次核销的申请单编号,可一次对多个申请单进行核销
details.customer_code VARCHAR(32) 客户编码
details.customer_name VARCHAR(32) 客户名称
details.updealer_code VARCHAR(32) 费用代垫经销商编码
details.updealer_name VARCHAR(32) 费用代垫经销商名称
details.execute_date VARCHAR(32) 客户申请的活动周期
details.init_amount VARCHAR(32) 本次核销提报金额
details.audit_amount VARCHAR(32) 核销单最近一次审批节点审批通过的金额
details.subject_code VARCHAR(32) 预算科目编码
details.subject_name VARCHAR(32) 预算科目名称
details.period VARCHAR(32) 预算扣减的期间
details.dims_data VARCHAR(32) 预算维度信息,格式为:{"预算维度名称":维值名称},多个维度用逗号隔开
details.verify_remark VARCHAR(32) 核销行备注信息
details.pay_mode_name VARCHAR(32) 核销行的支付方式
details.rebate_name VARCHAR(32) 核销行的费用池账户,支付方式配置关联“转费用池”的时候,此字段有值
details.ext_data VARCHAR(32) 扩展字段

# 直接创建核销单查询

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

{
    "createStartDate": "2017-01-10",
    "createEndDate": "2017-01-20",
    "modifyStartDate": "2017-01-20",
    "modifyEndDate": "2017-01-20",
    "verifyCode": "2017-01-20",
    "page":"1",
    "pageSize":"100"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
createStartDate VARCHAR(10) 创建开始时间。格式:yyyy-MM-dd HH:mm:ss
createEndDate VARCHAR(10) 创建结束时间。格式:yyyy-MM-dd HH:mm:ss
modifyStartDate VARCHAR(10) 修改开始时间。格式:yyyy-MM-dd HH:mm:ss
modifyEndDate VARCHAR(10) 修改结束时间。格式:yyyy-MM-dd HH:mm:ss
verifyStatus VARCHAR(10) 审批状态,0-处理中 1-已通过 2-已打回 3-审批中
recentAuditFrom VARCHAR(32) 最近审批开始时间。格式:yyyy-MM-dd HH:mm:ss
recentAuditTo VARCHAR(32) 最近审批结束时间。格式:yyyy-MM-dd HH:mm:ss
verifyCode VARCHAR(10) 核销单号
page VARCHAR(10) 数据页码
pageSize VARCHAR(10) 页长,默认1000

响应示例:

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
    {
        "applyFormName": "直接创建核销001",
        "assignFormId": "5294142376237267736",
        "auditId": 0,
        "auditName": "",
        "auditTime": null,
        "budgetId": "8400976472405167763",
        "businessDate": "2021-05-14 00:00:00",
        "createTime": "2021-05-14 17:17:22",
        "creatorId": 0,
        "creatorName": "",
        "formDataId": 6965528341675340984,
        "reverseStatus": "",
        "reverseTime": null,
        "reversorId": 0,
        "reversorName": "",
        "verificationApplyDetails": [{
            "rebateAccountName": null,
            "period": "2021-05",
            "dealerName": "橘子",
            "dealerCode": "CUS000001",
            "businessAccountCode": null,
            "customerCode": "CUS002622",
            "dimsData": {
                "部门": "zf02"
            },
            "customerName": "黄瓜",
            "productName": "香蕉布拉乐",
            "auditAmount": null,
            "productCode": "4456",
            "dim_dept_name": "zf02",
            "payModeName": "现金",
            "field_249514": "文本框1",
            "initAmount": 1.00,
            "subjectCode": "A0001",
            "field_564853": "选项1",
            "exts": [{
                "ext_key": "文本框",
                "ext_value": "文本框1"
            }, {
                "ext_key": "单选框",
                "ext_value": "选项1"
            }],
            "subjectName": "预算科目001"
        }],
        "verifyAmount": "1.00",
        "verifyApplyId": 5363775306512380374,
        "verifyCode": "HX202105140003",
        "verifyStatus": "0"
    }
]

参数说明:

参数 类型 说明
applyFormName VARCHAR(32) 核销单模板名称
assignFormId VARCHAR(32) 核销单叠加表单id
auditId VARCHAR(32) 最近审批人账号
auditName VARCHAR(32) 最近审批人名称
auditTime VARCHAR(32) 最近审批时间。格式:yyyy-MM-dd HH:mm:ss
businessDate VARCHAR(32) 过账日期。格式:yyyy-MM-dd HH:mm:ss
createTime VARCHAR(32) 创建时间。格式:yyyy-MM-dd HH:mm:ss
creatorId VARCHAR(100) 创建人账号
creatorName VARCHAR(32) 创建人姓名
formDataId VARCHAR(32) 核销单叠加表单数据id
reverseStatus VARCHAR(32) 红冲状态。0:正常,1:被红冲,2:红冲
reverseTime VARCHAR(32) 红冲时间
reversorId VARCHAR(32) 红冲人账号
reversorName VARCHAR(32) 红冲人姓名
verifyAmount VARCHAR(32) 核销金额
verifyCode VARCHAR(32) 核销单号
verifyStatus VARCHAR(32) 审批状态。0:处理中,1:已审批,2:被打回
verificationApplyDetails 明细行
verificationApplyDetails.rebateAccountName VARCHAR(32) 返利账户
verificationApplyDetails.period VARCHAR(32) 预算期间
verificationApplyDetails.dealerName VARCHAR(32) 费用代垫经销商名称
verificationApplyDetails.dealerCode VARCHAR(32) 费用代垫经销商编码
verificationApplyDetails.businessAccountCode VARCHAR(32) 核算记录编号
verificationApplyDetails.customerCode VARCHAR(32) 客户编码
verificationApplyDetails.dimsData text 预算维度。格式为:{"预算维度名称":维值名称}
verificationApplyDetails.customerName VARCHAR(32) 客户名称
verificationApplyDetails.productName VARCHAR(32) 商品名称
verificationApplyDetails.auditAmount VARCHAR(32) 批复核销金额
verificationApplyDetails.productCode VARCHAR(32) 商品编码
verificationApplyDetails.payModeName VARCHAR(32) 支付方式
verificationApplyDetails.initAmount VARCHAR(32) 本次核销金额
verificationApplyDetails.subjectCode VARCHAR(32) 预算科目编码
verificationApplyDetails.exts 自定义字段
verificationApplyDetails.exts.ext_key VARCHAR(32) 自定义字段key
verificationApplyDetails.exts.ext_value VARCHAR(32) 自定义字段value
verificationApplyDetails.subjectName VARCHAR(32) 预算科目名称

# 进货折扣核销单查询

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

{
    "create_date_start": "2017-01-10",
    "create_date_end": "2017-01-20",
    "update_date_start": "2017-01-20",
    "update_date_end": "2017-01-20",
    "verify_code": "",
    "page":"1",
    "rows":"100"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
create_date_start VARCHAR() 创建开始时间。格式:yyyy-MM-dd HH:mm:ss
create_date_end VARCHAR() 创建结束时间。格式:yyyy-MM-dd HH:mm:ss
update_date_start VARCHAR() 修改开始时间。格式:yyyy-MM-dd HH:mm:ss
update_date_end VARCHAR() 修改结束时间。格式:yyyy-MM-dd HH:mm:ss
verify_code varchar 核销单号
page VARCHAR(10) 数据页码,默认1
rows VARCHAR(10) 页长,默认1000

响应示例:

{
	"reverse_user_id": null,
	"code": "HX202105170001",
	"create_time": "2021-05-17 19:41:55",
	"reverse_time": null,
	"form_data_id": 7287055005598618790,
	"business_date": "2021-05-17",
	"verify_amount": 0.00,
	"audit_time": null,
	"audit_name": null,
	"audit_id": null,
	"reverse_user_name": null,
	"model_name": "客户进货折扣核销申请单",
	"assign_form": 5294142376237267736,
	"reverse_status": "0",
	"creator_id": 5133482379484696411,
	"verify_status": "处理中",
	"details": [{
		"subject_code": "1225",
		"period": "2021-05",
		"rebate_account_id": null,
		"budget_dim_info": "[{\"dim_dept_name\":\"zf02\",\"dim_dept\":\"10\"}]",
		"range_end_date": "2021-05-15",
		"init_amount": 7.00,
		"verify_cost_code": null,
		"range_start_date": "2021-05-10",
		"pay_mode_name": "现金",
		"pay_mode_id": "1",
		"verification_id": 7467288607926123276,
		"audit_amount": null,
		"subject_name": "预算test",
		"verify_remark": "",
		"pd_name": "娃娃哈",
		"id": 6325017386372783408,
		"customer_name": "梨子",
		"customer_code": "CUS000005",
		"pd_code": "wwh",
		"apply_amount": 12110000.00
	}, {
		"subject_code": "1225",
		"period": "2021-05",
		"rebate_account_id": null,
		"budget_dim_info": "[{\"dim_dept_name\":\"zf02\",\"dim_dept\":\"10\"}]",
		"range_end_date": "2021-05-15",
		"init_amount": 1.00,
		"verify_cost_code": null,
		"range_start_date": "2021-05-10",
		"pay_mode_name": "现金",
		"pay_mode_id": "1",
		"verification_id": 7467288607926123276,
		"audit_amount": null,
		"subject_name": "预算test",
		"verify_remark": "",
		"pd_name": "欧冠",
		"id": 8731564052992177830,
		"customer_name": "香菇",
		"customer_code": "CUS000009",
		"pd_code": "og",
		"apply_amount": 1.00
	}],
	"id": "7467288607926123276",
	"create_name": "陈假假"
}

参数说明:

参数 类型 说明
model_name varchar 核销单模板名称
code varchar 核销单号
id varchar 核销的申请单号
create_time varchar 核销单创建时间
creator_id int 核销单创建人的员工账号
create_name varchar 核销单创建人姓名
verify_amount varchar 核销单的核销金额,取最近一个审批节点填写的金额
verify_status varchar 核销单的审批状态。0:处理中,1:已审批,2:被打回
audit_id varchar 最近一次审批人的员工账号
audit_name varchar 最近一次审批人的员工姓名
audit_time varchar 最近审批时间。格式:yyyy-MM-dd HH:mm:ss
reverse_status varchar 核销单红冲状态。0:正常,1:被红冲,2:红冲
reverse_user_id varchar 核销单红冲人账号,只有状态为“被红冲”的,才会有值
reverse_user_name varchar 核销单红冲人姓名,只有状态为“被红冲”的,才会有值
reverse_time varchar 核销单红冲时间,只有状态为“被红冲”的,才有值。格式:yyyy-MM-dd HH:mm:ss
assign_form int 核销单叠加表单模板ID
form_data_id int 核销单叠加表单数据ID
business_date varchar 核销单的过账日期,开启费用核算对接ERP系统生成凭证的企业,此字段有值。格式:YYY-MM-DD
details.id int 核销的申请明细行ID
details.customer_code varchar 客户编码
details.customer_name varchar 客户名称
details.verify_cost_code varchar 此核销行的核算记录编号,只有开启费用核算的企业,此字段有值
details.range_start_date varchar 活动周期开始时间。格式:yyyy-MM-dd
details.range_end_date varchar 活动周期结束时间。格式:yyyy-MM-dd
details.pd_code varchar 参与活动的折让商品编码
details.pd_name varchar 参与活动的折让商品名称
details.subject_code varchar 预算科目编码
details.subject_name varchar 预算科目名称
details.period varchar 预算扣减的期间
details.budget_dim_info varchar 预算维度jason。预算维度信息,格式为:{"预算维度名称":维值名称},多个维度用逗号隔开
details.apply_amount varchar 申请单的预算申请金额
details.init_amount varchar 本次核销提报金额
details.audit_amount varchar 核销单审批通过的金额
details.verify_remark varchar 核销行备注信息
details.pay_mode_name varchar 核销行的支付方式
details.rebate_account_id varchar 核销行的返利账户,支付方式为“货补返利”的时候,此字段有值

# 核销单查询接口(固定金额申请)

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

{
  "create_start": "2020-08-01 00:00:00",
  "create_end": "2020-08-20 23:59:59",
  "modify_start": "2020-08-01 00:00:00",
  "modify_end": "2020-08-20 23:59:59",
  "verification_code": "HX202105070001",
  "activity_code": "SQ202105080001",
  "page": "1",
  "rows": "100"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
create_start string(100) 记录生成开始时间。格式:YYYY-MM-DD hh:mi:ss
create_end string(100) 记录生成结束时间。格式:YYYY-MM-DD hh:mi:ss
modify_start string(100) 修改开始时间。格式:YYYY-MM-DD hh:mi:ss
modify_end string(4000) 修改结束时间。格式:YYYY-MM-DD hh:mi:ss
verification_code string(100) 核销单号
activity_code varchar 活动申请单号
verify_status string(10) 审批状态 0-处理中 1-已通过 2-已打回 3-审批中
recent_audit_from string(32) 最近审批开始时间。格式:yyyy-MM-dd HH:mm:ss
recent_audit_to string(32) 最近审批结束时间。格式:yyyy-MM-dd HH:mm:ss
page string(100) 当前页
rows string(100) 每页条数

响应示例:

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
    {
        "auditId": "6715524305277767083",
        "auditName": "gm",
        "auditTime": "2021-05-11 18:44",
        "businessDate": "",
        "cmList": 
        [
            {
              "applyAmount": "100.00",
              "auditAmount": "100.00",
              "budgetDimInfo": "[{\"dim_dept_name\":\"zf02\",\"dim_dept\":\"10\"}]",
              "customerCode": "CUS000007",
              "customerName": "番茄",
              "id": "6123872662289242394",
              "payModeName": "现金",
              "period": "2021",
              "rangeEndDate": "2021-05-07",
              "rangeStartDate": "2021-05-07",
              "rebateAccountName": "",
              "subjectCode": "001",
              "subjectName": "预算警告",
              "verifyAmount": "100.00",
              "verifyCostCode": "",
              "verifyRemark": ""
            }
      ],
        "createTime": "2021-05-11 18:43",
        "creatorId": "6715524305277767083",
        "creatorName": "gm",
        "id": 5021882277991952210,
        "reserveUserId": "",
        "reverseName": "",
        "reverseStatus": "0",
        "reverseTime": "",
        "skuList": 
        [
          {
            "applyAmount": "80.00",
            "auditAmount": "30.00",
            "budgetDimInfo": "[{\"dim_dept_name\":\"zf02\",\"dim_dept\":\"10\"}]",
            "customerCode": "CUS000008",
            "customerName": "胡萝卜",
            "id": "8245472906361650691",
            "payModeName": "现金",
            "period": "2021",
            "rangeEndDate": "2021-05-11",
            "rangeStartDate": "2021-05-11",
            "rebateAccountName": "",
            "skuName": "麦德龙",
            "subjectCode": "001",
            "subjectName": "预算警告",
            "verifyAmount": "30.00",
            "verifyCostCode": "",
            "verifyRemark": ""
          }
        ],
        "verificationCode": "HX202105110006",
        "activityCode": "SQ202105080001",
        "verificationFormName": "05-08 直接申请",
        "verifyAmount": "100.00",
        "verifyFormDataId": "8532858878323479560",
        "verifyFormId": "5294142376237267736",
        "verifyStatus": "1"
    }
]

参数说明:

参数 类型 说明
verificationFormName string 核销单模板名称
verificationCode string 核销单号
activityCode string 核销的申请单号
createTime date 核销单创建时间
creatorId int 核销单创建人的员工账号
creatorName string 核销单创建人姓名
verifyAmount int 核销单的核销金额,取最近一个审批节点填写的金额
verifyStatus string 核销单的审批状态,0:处理中,1:已审批,2:被打回
auditId string 最近一次审批人的员工账号
auditName string 最近一次审批人的员工姓名
auditTime date 最近审批时间。格式:yyyy-MM-dd HH:mm:ss
reverseStatus string 核销单红冲状态。0:正常,1:被红冲,2:红冲
reserveUserId string 核销单红冲人账号,只有状 态为“被红冲”的,才会有值
reverseName string 核销单红冲人姓名,只有状态为“被红冲”的,才会有值
reverseTime date 核销单红冲时间,只有状态为“被红冲”的,才有值。格式:yyyy-MM-dd HH:mm:ss
verifyFormId int 核销单叠加表单模板ID
verifyFormDataId int 核销单叠加表单数据ID
businessDate date 核销单的过账日期,开启费用核算对接ERP系统生成凭证的企业,此字段有值。格式:YYY-MM-DD
skuList List 列表
skuList.ID string 核销的申请明细行ID
skuList.skuName string 连锁品牌名称
skuList.customerCode string 客户编码
skuList.customerName string 客户名称
skuList.dealerCode string 费用代垫经销商编码
skuList.dealerName string 费用代垫经销商名称
skuList.verifyCostCode string 此核销行的核算记录编号
skuList.rangeStartDate string 客户申请时填的活动周期
skuList.rangeEndDate string 客户申请时填的活动周期
skuList.subjectCode string 预算科目编码
skuList.subjectName string 预算科目名称
skuList.period date 预算扣减的期间
skuList.budgetDimInfo string 预算维度信息,格式为:{"预算维度名称":维值名称},多个维度用逗号隔开
skuList.applyAmount int 申请单的预算申请金额
skuList.verifyAmount int 本次核销提报金额
skuList.auditAmount int 核销单最近一次审批节点审批通过的金额
skuList.verifyRemark string 核销行备注信息
skuList.payModeName string 核销行的支付方式
skuList.rebateAccountName string 核销行的返利账户,支付方式为“货补返利”的时候,此字段有值
cmList List 列表
cmList.id string 核销的申请明细行ID
cmList.customerCode string 客户编码
cmList.customerName string 客户名称
cmList.dealerCode string 费用代垫经销商编码
cmList.dealerName string 费用代垫经销商名称
cmList.verifyCostCode string 此核销行的核算记录编号,只有开启费用核算的企业,此字段有值
cmList.rangeStartDate string 客户申请时填的活动周期
cmList.rangeEndDate string 客户申请时填的活动周期
cmList.subjectCode string 预算科目编码
cmList.subjectName string 预算科目名称
cmList.period string 预算扣减的期间
cmList.budgetDimInfo string 预算维度信息,格式为:{"预算维度名称":维值名称},多个维度用逗号隔开
cmList.applyAmount int 申请单的预算申请金额
cmList.verifyAmount int 本次核销提报金额
cmList.auditAmount int 核销单最近一次审批节点审批通过的金额
cmList.verifyRemark string 核销行备注信息
cmList.payModeName string 核销行的支付方式
cmList.rebateAccountName string 核销行的返利账户,支付方

# 差旅费核销单查询

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiao/verify/v1/queryVerificationTravel/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
参数说明:

参数 类型 必填 说明
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
verify_code varchar 核销单号
verify_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

请求示例:

{
    "create_from": "2017-01-10 00:00:00",
    "create_to": "2017-01-20 23:59:59",
    "modify_from": "2017-01-20 00:00:00",
    "modify_to": "2017-01-20 23:59:59",
    "verify_code": "HX2112101550",
    "verify_status": "1",
    "recent_audit_from": "2021-11-29 00:00:00",
    "recent_audit_to": "2021-11-29 23:59:59",
    "page":"1",
    "rows":"100"
}

响应示例:

[
    {
        "travel_id": "8785225515971759823",
        "reverse_user_id": "8230823847295124348",
        "create_time": "2021-11-29 18:56:21",
        "reverse_time": "2021-11-30 15:16:38",
        "verify_code": "HX202111290003",
        "form_data_id": "5219272373361056370",
        "verify_amount": "80.00",
        "audit_time": "2021-11-29 19:07:28",
        "creator_dept_code": "cynic",
        "audit_name": "gaomeng",
        "audit_id": "8230823847295124348",
        "reverse_user_name": "gaomeng",
        "model_name": "697-差旅费-112301",
        "assign_form": "8962949206300408214",
        "reverse_status": "1",
        "creator_id": "8230823847295124348",
        "creator_dept_name": "西栗",
        "creator_name": "gaomeng",
        "verify_status": "1",
        "details": [
            {
                "subject_code": "YS21090802",
                "period": "2021-12",
                "audit_amount": "80.00",
                "init_amount": "80.00",
                "subject_name": "地支",
                "pay_mode_name": "现金",
                "verify_remark": "121",
                "dims_data": {
                    "五曜": "金"
                },
                "id": "5925703782113030167"
            }
        ]
    }
]

参数说明:

参数 类型 说明
travel_id INT8 出差申请ID
model_name varchar 核销单模板名称
verify_code varchar 核销单号
create_time varchar 创建时间。格式:yyyy-MM-dd HH:mm:ss
creator_id INT8 核销单创建人的员工账号
creator_name varchar 核销单创建人姓名
creator_dept_code varchar 创建人部门编码
creator_dept_name varchar 创建人部门名称
verify_amount NUMERIC(15, 2) 核销单的核销金额
verify_status varchar 核销单的审批状态,0:处理中,1:已审批,2:被打回,3:审批中
audit_id INT8 最近一次审批人的员工账号
audit_name varchar 最近一次审批人的员工姓名
audit_time varchar 最近审批时间。格式:yyyy-MM-dd HH:mm:ss
reverse_status varchar 红冲状态
reverse_user_id INT8 红冲人账号
reverse_user_name varchar 红冲人姓名
reverse_time varchar 核销单红冲时间,只有状态为“被红冲”的,才有值。格式:yyyy-MM-dd HH:mm:ss
assign_form INT8 核销单叠加表单模板ID
form_data_id INT8 核销单叠加表单数据ID
details List 列表
details.id INT8 核销的申请明细行ID
details.init_amount NUMERIC(15, 2) 本次核销提报金额
details.audit_amount NUMERIC(15, 2) 核销单审批通过的金额
details.subject_code varchar 预算科目编码
details.subject_name varchar 预算科目名称
details.period varchar 预算扣减的期间
details.dims_data varchar 预算维度信息,格式为:{"预算维度名称":维值名称},多个维度用逗号隔开
details.verify_remark varchar 核销行备注信息
details.pay_mode_name varchar 核销行的支付方式

# 核销单红冲接口(固定类费用)

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiaoVerify/v1/reverseFixAmount/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
参数说明:

参数 类型 必填 说明
verificationCode varchar 核销单号
creator VARCHAR(32) 此核销单的红冲人
reverseTime VARCHAR(32) 单据红冲红冲时间,默认为当前时间。格式:yyyy-MM-dd HH:mm:ss
businessDate VARCHAR(32) 红冲过账日期,企业启用费用核算参数的时必须传值。格式:yyyy-MM-dd

请求示例:

{
    "verificationCode": "HX2112101550",
    "creator": "zhanghao",
    "reverseTime": "2017-01-20 23:59:59",
    "businessDate": "2017-01-20"
}

响应示例:

{
    "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/cuxiaoVerify/v1/reverseRegular/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
参数说明:

参数 类型 必填 说明
verify_code varchar 需要进行红冲的核销单号
creator VARCHAR(32) 此核销单的红冲人
reverse_time VARCHAR(32) 如果不传,则为接口传输日期

请求示例:

{
    "verify_code": "HX2112101550",
    "creator": "zhanghao",
    "reverse_time": "2022-01-29 10:35:47"
}

响应示例:

{
    "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/cuxiaoVerify/v1/reverseEntrance/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
参数说明:

参数 类型 必填 说明
verify_code varchar 核销单号
creator VARCHAR(32) 此核销单的红冲人
reverse_time VARCHAR(32) 单据红冲红冲时间,默认为当前时间。格式:yyyy-MM-dd HH:mm:ss

请求示例:

{
    "verify_code": "HX2112101550",
    "creator": "zhanghao",
    "reverse_time": "2022-01-05 10:35:47"
}

响应示例:

{
    "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/cuxiaoVerify/v1/reverseDisplay/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
参数说明:

参数 类型 必填 说明
verify_code varchar 核销单号
creator VARCHAR(32) 此核销单的红冲人
reverse_time VARCHAR(32) 单据红冲红冲时间,默认为当前时间。格式:yyyy-MM-dd HH:mm:ss
business_date VARCHAR(32) 红冲过账日期,企业启用费用核算参数的时必须传值。格式:yyyy-MM-dd

请求示例:

{
    "verify_code": "HX2112101550",
    "creator": "zhanghao",
    "reverse_time": "2017-01-20 23:59:59",
    "business_date": "2017-01-20"
}

响应示例:

{
    "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/cuxiaoVerify/v1/reverseDirect/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
参数说明:

参数 类型 必填 说明
verify_code varchar 需要进行红冲的核销单号
creator VARCHAR(32) 此核销单的红冲人
reverse_time VARCHAR(32) 如果不传,则为接口传输日期

请求示例:

{
    "verify_code": "HX2112101550",
    "creator": "zhanghao",
    "reverse_time": "2017-01-20 23:59:59"
}

响应示例:

{
    "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/cuxiaoVerify/v1/auditVerifyApply/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
参数说明:

参数 类型 必填 说明
verify_code varchar 核销单编码
auditor VARCHAR(32) 最后审批人的名称
audit_time VARCHAR(32) 如果不传,则为接口传输日期
verify_status varchar 1:已通过;2:已打回

请求示例:

{
    "verify_code": "HX2112101550",
    "auditor": "zhanghao",
    "audit_time": "2022-01-20 23:59:59",
    "verify_status": "1"
}

响应示例:

{
    "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/cuxiaoVerify/v1/queryEndRecords/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
参数说明:

参数 类型 必填 说明
start_time varchar(32) 终止开始时间。格式:yyyy-MM-dd HH:mm:ss
end_time VARCHAR(32) 终止结束时间。格式:yyyy-MM-dd HH:mm:ss
scene_name VARCHAR(32) 系统中场景的名称(非别名)
page VARCHAR(10) 页码,不填默认第一页
rows VARCHAR(10) 页长,不填默认1000

请求示例:

{
    "scene_name": "进场费",
    "start_time": "2017-01-20 00:00:00",
    "end_time": "2017-01-21 00:00:00",
    "page": "1",
    "rows": "1000"
}

响应示例:

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
    {
        "end_code": "ZZ2022021701",
        "end_time": "2022-02-17 17:09",
        "end_amount": "1000.00",
        "end_close_amount": "",
        "end_reason": "终止原因",
        "row_id": "1711032546",
        "customer_name": "客户名称",
        "budget_amount": "2000.00",
        "close_amount": "",
        "verify_amount": "1000.00"
    }
]

参数说明:

参数 类型 说明
end_code VARCHAR(32) 终止单号
end_time VARCHAR(32) 终止时间。格式:yyyy-MM-dd HH:mm
end_amount NUMERIC(15, 2) 终止申请金额
end_close_amount NUMERIC(15, 2) 终止结案金额
end_reason VARCHAR(100) 终止核销原因
row_id VARCHAR(100) 申请行id
customer_name VARCHAR(100) 客户名称
budget_amount NUMERIC(15, 2) 申请金额
close_amount NUMERIC(15, 2) 结案金额
verify_amount NUMERIC(15, 2) 核销金额