TIP

付费陈列核销单新增接口
万能促销活动核销单新增接口
固定金额申请核销单新增接口
进场费核销单新增接口
核销单新增接口（直接创建核销）
付费陈列核销单查询
核销单查询接口（进场费）
核销单查询接口（市场活动方案）
核销单查询接口（品鉴会）
核销单查询接口（万能促销活动）
直接创建核销单查询
进货折扣核销单查询
核销单查询接口(固定金额申请)
差旅费核销单查询
核销单红冲接口（固定类费用）
核销单红冲接口（万能促销活动）
核销单红冲接口（进场费）
核销单红冲接口（付费陈列）
核销单红冲接口（直接创建核销）
订单费用明细新增
核销单状态回写接口
万能核销单外部审批接口
终止核销记录查询接口
按申请核销头查询接口
按申请核销行查询接口

# 预算费控

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

请求方式： 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} 在线调试
请求示例：

{
    "code": "HX2022090800001",
    "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
                }
            ],
            "actual_pd_range":"3",
            "actual_pd_brand":"3653607485061434567,3653607485061434568",
            "actual_pd_type":"8599699725241479981,6406679509246323530",
            "actual_pd_ids":"",
            "ext_fields": [
               {
                   "field_name": "文本",
                   "field_value": "自定义备注"
               }
            ]
        }
    ]
}

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
code	VARCHAR(32)	否	核销单号，不传时系统默认生成
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.actual_pd_range	VARCHAR	否	实际活动商品范围。如果该预设字段启用的时候，此字段必传。否则不用传（1、和申请的活动商品一致；2、和方案的活动商品一致；3、指定商品类型或品牌；4、指定具体商品）
rows.actual_pd_brand	VARCHAR	否	实际活动品牌。多个id用逗号隔开
rows.actual_pd_type	VARCHAR	否	实际活动商品类型。多个id用逗号隔开
rows.actual_pd_ids	VARCHAR	否	实际活动商品。多个id用逗号隔开
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": "销售一部",
    "verify_head_fields": [
        {
            "name": "理由",
            "value": "二月份核销"
        }
    ],
    "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。如果企业启用费用核算参数的时候此字段需要传值，如果未开启则不用传值
verify_head_fields[].name	VARCHAR	否	自定义字段的名称，自定义字段需要先在外勤365系统中维护
verify_head_fields[].value	VARCHAR	否	自定义字段value值，如果对应多个选项值，以“,”分隔拼接
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：被打回，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": "{ 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",
            "activity_cm_id": "7896080812679071886",
            "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": "返利帐户",
            "cost_amount": "100.00",
            "sale_amount": "120.00",
            "sell_amount": "",
            "sell_num": "",
            "sell_teu_num": "",
            "actual_dealer_code": "",
            "actual_dealer_name": "",
            "actual_cm_code": "",
            "actual_cm": "",
            "account_unit_name": "",
            "unit_discount": "",
            "actual_close_amount": "",
            "actual_pd_range" : "3" ,
            "actual_pd_range_name" : "指定商品类型或品牌" ,
            "actual_pd_ids" : "4745474794331158742" ,
            "actual_pd_ids_code" : "pd_0001" ,
            "actual_pd_ids_name" : "无尽之刃" ,
            "actual_pd_brand" : "3653607485061434567,3653607485061434568" ,
            "actual_pd_brand_name" : "品牌001,品牌002" ,
            "actual_pd_type" : "8599699725241479981,6406679509246323530" ,
            "actual_pd_type_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：被打回，3：审批中
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.activity_cm_id	VARCHAR(32)	申请行ID
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.cost_amount	VARCHAR(32)	销售金额
details.sale_amount	VARCHAR(32)	费用金额
details.sell_amount	VARCHAR(32)	实际销额
details.sell_num	VARCHAR(32)	实际销量
details.sell_teu_num	VARCHAR(32)	实际销量（标箱）
details.actual_dealer_code	VARCHAR(32)	实际代垫经销商编码
details.actual_dealer_name	VARCHAR(32)	实际代垫经销商
details.actual_cm_code	VARCHAR(32)	实际核销客户编码
details.actual_cm	VARCHAR(32)	实际核销客户
details.account_unit_name	VARCHAR(32)	结算单位
details.unit_discount	VARCHAR(32)	实际单位折让
details.actual_close_amount	VARCHAR(32)	实际结案金额
details.actual_pd_range	VARCHAR(2)	实际活动商品范围（1、和申请的活动商品一致；2、和方案的活动商品一致；3、指定商品类型或品牌；4、指定具体商品）
details.actual_pd_range_name	VARCHAR(32)	实际活动商品范围名称
details.actual_pd_ids	VARCHAR(1000)	实际活动商品id
details.actual_pd_ids_code	VARCHAR(1000)	实际活动商品编码
details.actual_pd_ids_name	VARCHAR(1000)	实际活动商品名称
details.actual_pd_brand	VARCHAR(1000)	实际活动品牌id
details.actual_pd_brand_name	VARCHAR(1000)	实际活动品牌名称
details.actual_pd_type	VARCHAR(1000)	实际活动商品类型id
details.actual_pd_type_name	VARCHAR(1000)	实际活动商品类型名称
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": "",
        "verifyHeadFields": [{
            "ext_key": "文本框",
            "ext_value": "文本框1"
        }],
        "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：被打回
verifyHeadFields		自定义字段
verifyHeadFields.ext_key	VARCHAR(32)	自定义字段key
verifyHeadFields.ext_value	VARCHAR(32)	自定义字段value
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：被打回，3：审批中
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

请求示例：

响应示例：

{
    "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)	否	如果不传，则为接口传输日期

请求示例：

响应示例：

{
    "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

请求示例：

响应示例：

{
    "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

请求示例：

响应示例：

{
    "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)	否	如果不传，则为接口传输日期

请求示例：

响应示例：

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

{
    "plan_code": "CX202209196669",
    "customer_code": "CUS000012",
    "delivery_code": "DL000002",
    "order_code": "OD47999565667",
    "supplier_code": "CUS000020",
    "order_policy_code": "OPC0005900",
    "transfer_way": "2",
    "sale_amount": "100.21",
    "cost_amount": "80.56",
    "create_time": "2022-09-20 13:20:24",
    "pd_list": [
        {
            "name": "红药水",
            "is_gift": "1",
            "num":"2.2",
            "unit": "",
            "origin_amount":"60",
            "discounted_amount": "50",
            "cost_amount": "40"         
        }
    ],
    "creator_code": "xx"
}

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
plan_code	VARCHAR(100)	是	营销活动的活动方案编码
customer_code	VARCHAR(100)	是	客户编码
delivery_code	VARCHAR(100)	是	发货单号
order_code	VARCHAR(100)	否	关联订单编号
supplier_code	VARCHAR(100)	否	供应商
order_policy_code	VARCHAR(100)	否	促销策略编号
creator_code	VARCHAR(100)	是	操作人账号
transfer_way	VARCHAR(32)	是	传输方式
sale_amount	VARCHAR(100)	否	销售金额；传输方式为按总额时，必传；传输方式为按明细时，无需传入，系统根据明细自动汇总
cost_amount	VARCHAR(100)	否	费用金额；传输方式为按总额时，必传；传输方式为按明细时，无需传入，系统根据明细自动汇总
create_time	VARCHAR(100)	否	创建时间，如果不传，为系统当前的传输时间
pd_list	List	否	明细列表
pd_list.name	VARCHAR(100)	是	商品名称
pd_list.is_gift	VARCHAR(100)	是	是否赠品
pd_list.num	VARCHAR(100)	否	数量
pd_list.unit	VARCHAR(100)	否	单位
pd_list.origin_amount	VARCHAR(100)	否	优惠前金额
pd_list.discounted_amount	VARCHAR(1000)	是	优惠后金额
pd_list.cost_amount	VARCHAR(32)	是	费用金额

响应示例：

{
    "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:已打回

请求示例：

响应示例：

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

参数	类型	必填	说明
verify_id	varchar	否	核销单id，核销单ID和核销单号必须传一个，且核销单的审批状态为审批中
verify_code	varchar	否	核销单号，核销单ID和核销单号必须传一个，且核销单的审批状态为审批中
auditor_id	varchar	否	审批人账号id，审批人id和编码必须传一个，且在系统中存在未被停用
auditor_code	varchar	否	审批人账号编码，审批人id和编码必须传一个，且在系统中存在未被停用
verify_status	varchar	是	1:已通过；2:已打回
opinion	varchar	否	审批意见

请求示例：

响应示例：

{
    "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

请求示例：

响应示例：

{
    "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)	核销金额

# 按申请核销头查询接口

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

{
  "create_date_start": "2020-08-01 00:00:00",
  "create_date_end": "2020-08-20 23:59:59",
  "update_date_start": "2020-08-01 00:00:00",
  "update_date_end": "2020-08-20 23:59:59",
  "verify_code": "HX202105070001",
  "apply_id": "SQ202105080001",
  "audit_begin_time": "2021-11-29 00:00:00",
  "audit_end_time": "2021-11-29 23:59:59",
  "verify_status": "0",
  "page": "1",
  "rows": "100"
}

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
create_date_start	string(100)	否	记录生成开始时间。格式：YYYY-MM-DD hh:mi:ss
create_date_end	string(100)	否	记录生成结束时间。格式：YYYY-MM-DD hh:mi:ss
update_date_start	string(100)	否	修改开始时间。格式：YYYY-MM-DD hh:mi:ss
update_date_end	string(4000)	否	修改结束时间。格式：YYYY-MM-DD hh:mi:ss
verify_code	string(100)	否	核销单号
apply_id	varchar	否	活动申请单号
verify_status	string(10)	否	审批状态 0-待审批 1-已通过 2-已打回 3-审批中
audit_begin_time	string(32)	否	最近审批开始时间。格式：yyyy-MM-dd HH:mm:ss
audit_end_time	string(32)	否	最近审批结束时间。格式：yyyy-MM-dd HH:mm:ss
page	string(100)	否	当前页
rows	string(100)	否	每页条数

响应示例：

{
	"reverse_user_id": null,
	"code": "HX202105170001",
	"create_time": "2021-05-17 19:41:55",
	"reverse_time": null,
	"form_data_id": 7287055005598618790,
	"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": "处理中",
	"applyCode": "7467288607926123276",
	"create_name": "陈假假"
}

参数说明：

参数	类型	说明
model_name	varchar	核销单模板名称
code	varchar	核销单号
applyCode	varchar	活动申请单号
create_time	varchar	核销单创建时间
creator_id	int	核销单创建人的员工账号
create_name	varchar	核销单创建人姓名
verify_amount	varchar	核销单的核销金额，取最近一个审批节点填写的金额
verify_status	varchar	核销单的审批状态。0：待审批，1：已审批，2：被打回，3-审批中
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

# 按申请核销行查询接口

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

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
verify_code	VARCHAR(10)	否	核销单号
page	VARCHAR(10)	否	数据页码
rows	VARCHAR(10)	否	页长，默认1000

响应示例：

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

数据DATA示例:

[
    {   
            "code": "HX202209220005",
            "rebateAccountName": null,
            "period": "2021-05",
            "dealerName": "橘子",
            "dealerCode": "CUS000001",
            "customerCode": "CUS002622",
            "dimsData": {
                "部门": "zf02"
            },
            "customerName": "黄瓜",
            "auditAmount": null,
            "payModeName": "现金",
            "initAmount": 1.00,
            "subjectCode": "A0001",
            "applyAmount": 1.00,
            "exts": [{
                "ext_key": "文本框",
                "ext_value": "文本框1"
            }, {
                "ext_key": "单选框",
                "ext_value": "选项1"
            }],
            "subjectName": "预算科目001"
    }
]

参数说明：

参数	类型	说明
code	VARCHAR(32)	核销单号
rebateAccountName	VARCHAR(32)	费用池账户
period	VARCHAR(32)	预算期间
dealerName	VARCHAR(32)	费用代垫经销商名称
dealerCode	VARCHAR(32)	费用代垫经销商编码
customerCode	VARCHAR(32)	客户编码
dimsData	text	预算维度。格式为：{"预算维度名称":维值名称}
customerName	VARCHAR(32)	客户名称
auditAmount	VARCHAR(32)	批复核销金额
payModeName	VARCHAR(32)	支付方式
initAmount	VARCHAR(32)	本次核销金额
subjectCode	VARCHAR(32)	预算科目编码
applyAmount	VARCHAR(32)	预算申请金额
exts		自定义字段
exts.ext_key	VARCHAR(32)	自定义字段key
exts.ext_value	VARCHAR(32)	自定义字段value
subjectName	VARCHAR(32)	预算科目名称

← 费用核算接口费用预算接口 →