# 预算费控

# 核销单查询接口(付费陈列)

请求方式: 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",
        "verifyApplyId": "12312312",
        "verifyCode": "HX202105130005",
        "createTime": "2021-05-13 13:58:38",
        "creatorId": 0,
        "creatorName": "lm",
        "creatorSourceCode": "",
        "creatorDeptCode":"yanptpm",
        "creatorDeptName":"闫沛的TPM企业",
        "verifyAmount": "2.00",
        "verifyStatus": "1",
        "auditId": "7108046175560648076",
        "auditName": "lm",
        "auditSourceCode": "",
        "auditTime": "2021-05-13 14:57:50",
        "reverseStatus": "",
        "reversorId": 0,
        "reversorName": "",
        "reversorSourceCode": "",
        "reverseTime": "",
        "assignFormId": "5294142376237267736",
        "formDataId": 8907080812679072997,
        "businessDate": null,
        "verificationApplyDetails": [{
            "activityCode": "SQ202105110002",
            "customerCode": "CUS000007",
            "customerName": "番茄",
            "customerSourceCode": "",
            "uperDealerCode":"csjxs001",
            "uperDealerName": "测试经销商001",
            "uperDealerSourceCode": "",
            "businesscAcountCode": "HS202105130003",
            "activityPeriod": "2021-05-01~2021-05-10",
            "initAmount": 2.00,
            "auditAmount": 2.00,
            "subjectCode": "A0001",
            "subjectName": "预算科目001",
            "period": "2021-05",
            "dimsData": [{
              "dim_2203010003": "WX220505131802",
                "五行": "烈火燎原"
             }],
            "verifyRemark": "有过账日期的核销",
            "payModeName": "现金",
            "rebateAccountName": "",
            "budgetAmount": 3.00,
            "dim_dept_name": "zf02",
            "activityCmId": 5261441935139966722
        }]
    }
]

参数说明:

参数 类型 说明
planId VARCHAR(32) 方案id
planCode VARCHAR(32) 方案编码
applyFormName VARCHAR(32) 核销单模板名称
verifyApplyId VARCHAR(32) 核销单id
verifyCode VARCHAR(32) 核销单号
createTime VARCHAR(32) 创建时间。格式:yyyy-MM-dd HH:mm:ss
creatorId VARCHAR(100) 创建人账号
creatorName VARCHAR(32) 创建人姓名
creatorSourceCode VARCHAR(32) 创建人外部id
creatorDeptCode VARCHAR(32) 创建人部门编码
creatorDeptName VARCHAR(32) 创建人部门名称
verifyAmount VARCHAR(32) 核销金额
verifyStatus VARCHAR(32) 审批状态。0:处理中,1:已审批,2:被打回
auditId VARCHAR(32) 最近审批人账号
auditName VARCHAR(32) 最近审批人名称
auditSourceCode VARCHAR(32) 最近审批人外部id
auditTime VARCHAR(32) 最近审批时间。格式:yyyy-MM-dd HH:mm:ss
reverseStatus VARCHAR(32) 红冲状态。0:正常,1:被红冲,2:红冲
reversorId VARCHAR(32) 红冲人账号
reversorName VARCHAR(32) 红冲人姓名
reversorSourceCode VARCHAR(32) 红冲人外部id
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.customerSourceCode VARCHAR(32) 客户外部id
verificationApplyDetails.uperDealerCode VARCHAR(32) 费用代垫经销商编码
verificationApplyDetails.uperDealerName VARCHAR(32) 费用代垫经销商名称
verificationApplyDetails.uperDealerSourceCode VARCHAR(32) 费用代垫经销商外部id
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 List 预算维度。格式为:{"预算维度名称":维值名称,""预算维度编码":维值编码}
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",
        "auditor_source_code": "",
        "cm_list": [
            {
                "activity_code": "SQ202110280016",
                "audit_amount": "1.00",
                "customer_code": "CUS000324",
                "customer_name": "新增99",
                "customer_source_code": "",
                "dealer_code": null,
                "dealer_name": null,
                "dealer_source_code": "",
                "dim_data": "[{\"dim_2203010003\":\"WX220505131802\",\"五行\":\"烈火燎原\"}]",
                "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",
        "creator_source_code": "",
        "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",
        "reverse_user_source_code": "",
        "verify_amount": "1.00",
        "verify_code": "HX202111150012",
        "id": "231421421",
        "verify_status": "1"
    }
]

参数说明:

参数 类型 说明
plan_id VARCHAR(32) 方案ID
plan_code VARCHAR(32) 方案编号
form_name VARCHAR(32) 核销单模板名称
verify_code VARCHAR(32) 核销单号
id VARCHAR(32) 核销单id
create_time VARCHAR(32) 核销单创建时间。格式:yyyy-MM-dd HH:mm:ss
creator_id VARCHAR(32) 核销单创建人
creator_name VARCHAR(32) 核销单创建人姓名
creator_source_code VARCHAR(32) 核销单创建人外部id
verify_amount VARCHAR(32) 核销单的核销金额
verify_status VARCHAR(32) 核销单的审批状态,0:待审批,1:已审批,2:被打回,3:审批中, 4:已作废
auditor_id VARCHAR(32) 最近审批人
auditor_name VARCHAR(32) 最近审批人员工姓名
auditor_source_code VARCHAR(32) 最近审批人员工外部id
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_user_source_code VARCHAR(32) 红冲人外部id
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.customer_source_code VARCHAR(32) 客户外部id
cm_list.dealer_code VARCHAR(32) 费用代垫经销商编码
cm_list.dealer_name VARCHAR(32) 费用代垫经销商名称
cm_list.dealer_source_code VARCHAR(32) 费用代垫经销商外部id
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 List 预算维度信息,格式为:{"预算维度名称":维值名称,""预算维度编码":维值编码}
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",
        "verifyApplyId": "21312412",
        "createTime": "2021-05-13 13:58:38",
        "creatorId": 0,
        "creatorName": "lm",
        "creatorSourceCode": "",
        "verifyAmount":"10.00",
        "verifyStatus": "1",
        "auditId": "7108046175560648076",
        "auditName": "lm",
        "auditSourceCode": "",
        "auditTime": "2021-05-13 14:57:50",
        "reverseStatus": "",
        "reverserId": 0,
        "reverserName": "",
        "reverserSourceCode": "",
        "reverseTime": "",
        "payMode": 1,
        "rebateAccount": "",
        "assignFormId": "5294142376237267736",
        "formDataId": 8907080812679072997,
        "verificationCmDetails": [{
            "activityCode": "SQ202105110002",
            "customerCode": "CUS000007",
            "customerName": "番茄",
            "customerSourceCode": "",
            "customerType": "番茄",
            "managerName": "admin",
            "activityCircle": "2021-05-01~2021-05-10",
            "verifyRemark": "核销备注"
        }],        
        "verificationBudgetDetails": [{
            "activityCode": "SQ202105110002",
            "activityCmId": "2312421",
            "subjectCode": "KM000007",
            "subjectName": "预算科目",
            "period": "番茄",
            "dimsData": [{
              "dim_2203010003": "WX220505131802",
              "五行": "烈火燎原"
             }],
            "initAmount": "10.00",
            "auditAmount": "10.00"
        }]
    }
]

参数说明:

参数 类型 说明
planId VARCHAR(32) 方案id
planCode VARCHAR(32) 方案编码
applyFormName VARCHAR(32) 核销单模板名称
verifyCode VARCHAR(32) 核销单号
verifyApplyId VARCHAR(32) 核销单id
createTime VARCHAR(32) 核销单创建时间。格式:yyyy-MM-dd HH:mm:ss
creatorId VARCHAR(100) 核销单创建人的员工账号
creatorName VARCHAR(32) 核销单创建人姓名
creatorSourceCode VARCHAR(32) 核销单创建人外部id
verifyAmount VARCHAR(32) 核销单的核销金额,取最近一个审批节点填写的金额(预算扣减金额合计)
verifyStatus VARCHAR(32) 核销单的审批状态,0:处理中,1:已审批,2:被打回
auditId VARCHAR(32) 最近审批人的员工账号
auditName VARCHAR(32) 最近审批人员工姓名
auditSourceCode VARCHAR(32) 最近审批人员工外部id
auditTime VARCHAR(32) 最近审批时间。格式:yyyy-MM-dd HH:mm:ss
reverseStatus VARCHAR(32) 核销单红冲状态,0:正常,1:被红冲,2:红冲
reverserId VARCHAR(32) 核销单红冲人ID,只有状态为“被红冲”的,才会有值
reverserName VARCHAR(32) 核销单红冲人姓名,只有状态为“被红冲”的,才会有值
reverserSourceCode VARCHAR(32) 核销单红冲人外部id
reverseTime VARCHAR(32) 核销单红冲时间,只有状态为“被红冲”的,才有值
payMode VARCHAR(32) 支付方式
rebateAccount VARCHAR(32) 费用池账户,支付方式为“转费用池”的时候,此字段有值
assignFormId VARCHAR(32) 核销单叠加表单模板ID
formDataId VARCHAR(32) 核销单叠加表单数据ID
verificationCmDetails 核销客户明细行
verificationCmDetails.activityCode VARCHAR(32) 本次核销的申请单编号,可一次对多个申请单进行核销
verificationCmDetails.activityCmId VARCHAR(32) 申请行明细ID
verificationCmDetails.customerCode VARCHAR(32) 客户编码
verificationCmDetails.customerName VARCHAR(32) 客户名称
verificationCmDetails.customerSourceCode VARCHAR(32) 客户外部id
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 List 预算维度信息,格式为:{"预算维度名称":维值名称,""预算维度编码":维值编码},多个维度用逗号隔开
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:审批中, 4:已作废
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": "刀妹",
        "executor_source_code": "",
        "actual_participation_num": null,
        "by_pds": [
            {
                "period": "2022-02",
                "pay_mode_name": "现金",
                "rebate_account_name": null,
                "item_name": "海报",
                "dim_data": [{
                 "dim_post": "GW2022011302",
                  "岗位": "测试"
                }],
                "verify_amount": "5.60",
                "audit_amount": "5.60",
                "subject_name": "子科目一",
                "pds": [
                    {
                        "pd_num": "1.00",
                        "pd_name": "蓝药水",
                        "pd_source_code": "",
                        "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,
        "reverse_user_source_code": "",
        "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": [{
                  "dim_post": "GW2022011302",
                  "岗位": "测试"
                }],
                "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,
        "audit_source_code": "",
        "pd_details": [
            {
                "actual_num": null,
                "predict_num": "5",
                "pd_name": "蓝药水",
                "pd_source_code": "",
                "pd_code": "pd_002",
                "pd_unit": "把"
            }
        ],
        "reverse_status": "0",
        "creator_id": "4883362607570892159",
        "creator_name": "刀妹",
        "creator_source_code": "",
        "customer_name": "EZ",
        "customer_source_code": "",
        "plan_id": "8149574848177672943"
    }
]

参数说明:

参数 类型 说明
plan_id VARCHAR(32) 活动方案ID
plan_code VARCHAR(32) 活动方案编码
verify_code VARCHAR(32) 核销单号
verify_id VARCHAR(32) 核销单id
create_time VARCHAR(32) 核销单创建时间。格式:yyyy-MM-dd HH:mm:ss
creator_id VARCHAR(32) 核销单创建人的员工账号
creator_name VARCHAR(32) 核销单创建人姓名
creator_source_code VARCHAR(32) 核销单创建人外部id
verify_status VARCHAR(10) 核销单的审批状态。0:待审批,1:已审批,2:被打回, 3:审批中, 4:已作废
audit_id VARCHAR(32) 最近审批人的员工账号
audit_name VARCHAR(32) 最近审批人员工姓名
audit_source_code VARCHAR(32) 最近审批人员工外部id
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_user_source_code VARCHAR(32) 核销单红冲人外部id
reverse_time VARCHAR(32) 核销单红冲时间,只有状态为“被红冲”的,才有值
activity_code VARCHAR(32) 申请单号
customer_code VARCHAR(32) 客户编码
customer_name VARCHAR(32) 客户名称
customer_source_code VARCHAR(32) 客户外部id
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_source_code VARCHAR(32) 品鉴商品外部id
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_source_code VARCHAR(32) 商品外部id
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 List 预算维度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 List 预算维度jason
by_cash.budget_amount VARCHAR(32) 可用预算

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

请求方式: 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:审批中,4:已作废
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示例:

[
    {
        "project_id": "8789448295479284095",
        "project_code": "XM2022046174",
        "project_name": "702-DM-项目-0421",
        "plan_id": "5323166537693260610",
        "plan_code": "CX20210511224",
        "verify_form_name": "核销0506",
        "verify_code": "HX202105130005",
        "verify_id": "231321",
        "verify_batch_code": "HXB202105130005",
        "create_time": "2021-05-13 13:58:38",
        "creator_id": "85458",
        "creator_account": "85458",
        "creator_name": "lm",
        "creator_source_code": "SOURCES11",
        "verify_amount":"10.00",
        "verify_status": "1",
        "audit_id": "7108046175560648076",
        "audit_account": "85458",
        "audit_name": "lm",
        "audit_source_code": "SOURCES22",
        "audit_time": "2021-05-13 14:57:50",
        "reverse_status": "",
        "reverser_id": "",
        "reverser_account": "",
        "reverser_name": "",
        "reverser_source_code": "",
        "reverse_time": "",
        "assignFormId": "5294142376237267736",
        "formDataId": "8907080812679072997",
        "ext_data": {
            "自定义头": "文本1"
        },
        "details": [{
            "id": "12321123",
            "activity_code": "SQ202105110002",
            "project_code": "BN202204290004",
            "activity_cm_id": "7896080812679071886",
            "customer_id": "8596380812679041259",
            "customer_code": "CUS000007",
            "customer_name": "客户1",
            "customer_source_code": "Scm1123",
            "updealer_id": "2586380812679078542",
            "updealer_code": "CUS000006",
            "updealer_name": "经销商1",
            "updealer_source_code": "UP0098",
            "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": "返利帐户",
            "capital_account_name": "资金池帐户",
            "cost_amount": "100.00",
            "sale_amount": "120.00",
            "sell_amount": "",
            "invoice_amount": "120",
            "sell_num": "",
            "sell_teu_num": "",
            "actual_dealer_id": "",
            "actual_dealer_code": "",
            "actual_dealer_name": "",
            "actual_dealer_source_code": "",
            "actual_cm_id": "",
            "actual_cm_code": "",
            "actual_cm": "",
            "actual_cm_source_code": "",
            "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"
            },
            "budgetList":[{
              "subject_code": "regular",
              "subject_name": "万能促销活动",
              "period":"2022-09",
              "dims_data": {
                "部门": "zf02"
              }
            }
          ],
          "gift_data":[{
            "pd_id": "8599699725241479981",
            "pd_name": "蓝苓口服液",
            "pd_code": "12035",
            "pd_source_code": "PD9009",
            "pd_price": "38.00",
            "unit_name": "盒",
            "init_num": "2.00",
            "init_amount": "76.00"
          }],
          "invoice_id": "",
          "invoice_code": "",
          "invoice_no": "",
          "invoice_source_code": "",
          "invoice_this_time_amount": "",
          "record_count": "0",
          "check_record": "0",
          "check_record_qualified": "0",
          "report_ai_outlier": "0",
          "report_record_qualified": "0",
          "report_comment_count": "0",
          "report_qualified_cm_count": "0",
          "report_cm_count": "0"
        }],
      "next_user_id" : "" ,
      "next_user_code" : "" ,
      "next_user_name" : "" ,
      "next_user_source_code" : "" 
    }
]

参数说明:

参数 类型 说明
project_id VARCHAR(32) 项目id
project_code VARCHAR(32) 项目编码
project_name VARCHAR(100) 项目名称
plan_id VARCHAR(32) 活动方案ID
plan_code VARCHAR(32) 活动方案编码
verify_form_name VARCHAR(32) 核销单模板名称
verify_code VARCHAR(32) 核销单号
verify_id VARCHAR(32) 核销单id
verify_batch_code VARCHAR(32) 核销批次号
create_time VARCHAR(32) 核销单创建时间。格式:yyyy-MM-dd HH:mm:ss
creator_id VARCHAR(100) 核销单创建人的员工id
creator_account VARCHAR(100) 核销单创建人的员工账号
creator_name VARCHAR(32) 核销单创建人姓名
creator_source_code VARCHAR(32) 核销单创建人外部id
verify_amount VARCHAR(32) 核销单的核销金额,取最近一个审批节点填写的金额(预算扣减金额合计)
verify_status VARCHAR(32) 核销单的审批状态,0:待审批,1:已审批,2:被打回,3:审批中,4:已作废
audit_id VARCHAR(32) 最近审批人的员工id
audit_account VARCHAR(32) 最近审批人的员工账号
audit_name VARCHAR(32) 最近审批人员工姓名
audit_source_code VARCHAR(32) 最近审批人员工外部id
audit_time VARCHAR(32) 最近审批时间。格式:yyyy-MM-dd HH:mm:ss
next_user_id VARCHAR(32) 当前审批人id
next_user_code VARCHAR(32) 当前审批人的员工账号
next_user_name VARCHAR(32) 当前审批人员工姓名
next_user_source_code VARCHAR(32) 当前审批人人对应外部数据id
reverse_status VARCHAR(32) 核销单红冲状态,0:正常,1:被红冲,2:红冲
reverser_id VARCHAR(32) 核销单红冲人ID,只有状态为“被红冲”的,才会有值
reverser_account VARCHAR(32) 核销单红冲账号,只有状态为“被红冲”的,才会有值
reverser_name VARCHAR(32) 核销单红冲人姓名,只有状态为“被红冲”的,才会有值
reverser_source_code VARCHAR(32) 核销单红冲人外部id,只有状态为“被红冲”的,才会有值
reverse_time VARCHAR(32) 核销单红冲时间,只有状态为“被红冲”的,才有值
ext_data VARCHAR(32) 扩展字段
assign_form VARCHAR(32) 核销单叠加表单模板ID
form_data_id VARCHAR(32) 核销单叠加表单数据ID
details 核销明细行
details.id VARCHAR(32) 核销行ID
details.activity_code VARCHAR(32) 本次核销的申请单编号,可一次对多个申请单进行核销
details.project_code VARCHAR(32) 申请批次号
details.activity_cm_id VARCHAR(32) 申请行ID
details.customer_id VARCHAR(32) 客户ID
details.customer_code VARCHAR(32) 客户编码
details.customer_name VARCHAR(32) 客户名称
details.customer_source_code VARCHAR(32) 客户外部ID
details.updealer_id VARCHAR(32) 费用代垫经销商ID
details.updealer_code VARCHAR(32) 费用代垫经销商编码
details.updealer_name VARCHAR(32) 费用代垫经销商名称
details.updealer_source_code VARCHAR(32) 费用代垫经销外部ID
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.capital_account_name VARCHAR(32) 核销行的资金池账户,支付方式配置关联“转资金池”的时候,此字段有值
details.invoice_amount 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_id VARCHAR(32) 实际代垫经销商ID
details.actual_dealer_code VARCHAR(32) 实际代垫经销商编码
details.actual_dealer_name VARCHAR(32) 实际代垫经销商
details.actual_dealer_source_code VARCHAR(32) 实际代垫经销商外部ID
details.actual_cm_id VARCHAR(32) 实际核销客户ID
details.actual_cm_code VARCHAR(32) 实际核销客户编码
details.actual_cm VARCHAR(32) 实际核销客户
details.actual_cm_source_code VARCHAR(32) 实际核销客户外部ID
details.account_unit_name VARCHAR(32) 结算单位
details.unit_discount VARCHAR(32) 实际单位折让
details.actual_close_amount VARCHAR(32) 实际结案金额
details.ext_data VARCHAR(32) 扩展字段
details.budgetList List 按方案冻结预算时的预算信息集合
details.gift_data List 如果支付方式配置的返利方式为赠品池的时候,实际赠送品项集合
details.gift_data.pd_id VARCHAR(32) 商品id
details.gift_data.pd_name VARCHAR(32) 商品名称
details.gift_data.pd_code VARCHAR(32) 商品编码
details.gift_data.pd_source_code VARCHAR(32) 商品编码对应外部数据id
details.gift_data.unit_name VARCHAR(32) 单位
details.gift_data.pd_price VARCHAR(32) 价格
details.gift_data.init_num VARCHAR(32) 核销数量
details.gift_data.init_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) 扩展字段
details.invoice_id VARCHAR(32) 发票id
details.invoice_code VARCHAR(32) 发票代码
details.invoice_no VARCHAR(32) 发票号码
details.invoice_source_code VARCHAR(32) 发票外部id
details.invoice_this_time_amount VARCHAR(32) 本次关联金额
details.record_count VARCHAR(32) 上报记录
details.check_record VARCHAR(32) 检核记录
details.check_record_qualified VARCHAR(32) 检核记录合格数
details.report_ai_outlier VARCHAR(32) AI识别异常数
details.report_record_qualified VARCHAR(32) 上报记录合格数
details.report_comment_count VARCHAR(32) 上报记录已评价数
details.report_qualified_cm_count VARCHAR(32) 上报合格客户数
details.report_cm_count 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": "",
        "auditSourceCode": "",
        "auditTime": null,
        "budgetId": "8400976472405167763",
        "businessDate": "2021-05-14 00:00:00",
        "createTime": "2021-05-14 17:17:22",
        "creatorId": 0,
        "creatorName": "",
        "creatorSourceCode": "",
        "formDataId": 6965528341675340984,
        "reverseStatus": "",
        "reverseTime": null,
        "reversorId": 0,
        "reversorName": "",
        "reversorSourceCode": "",
        "verifyHeadFields": [{
            "ext_key": "文本框",
            "ext_value": "文本框1"
        }],
        "verificationApplyDetails": [{
            "rebateAccountName": null,
            "capitalAccountName": null,
            "period": "2021-05",
            "dealerName": "橘子",
            "dealerCode": "CUS000001",
            "dealerSourceCode": "",
            "businessAccountCode": null,
            "customerCode": "CUS002622",
            "customerSourceCode": "",
            "dimsData": [{
              "dim_dept": "BM21111601",
              "费用承担部门": "诺克萨斯"
            }, {
             "dim_customer": "CUS000004",
              "经销商": "伊泽瑞尔"
            }],
            "customerName": "黄瓜",
            "productName": "香蕉布拉乐",
            "productSourceCode": "",
            "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) 最近审批人名称
reversorSourceCode VARCHAR(32) 最近审批人外部id
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) 创建人姓名
creatorSourceCode VARCHAR(32) 创建人外部id
formDataId VARCHAR(32) 核销单叠加表单数据id
reverseStatus VARCHAR(32) 红冲状态。0:正常,1:被红冲,2:红冲
reverseTime VARCHAR(32) 红冲时间
reversorId VARCHAR(32) 红冲人账号
reversorName VARCHAR(32) 红冲人姓名
reversorSourceCode VARCHAR(32) 红冲人外部id
verifyAmount VARCHAR(32) 核销金额
verifyApplyId VARCHAR(32) 核销单id
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.capitalAccountName VARCHAR(32) 资金池账户
verificationApplyDetails.period VARCHAR(32) 预算期间
verificationApplyDetails.dealerName VARCHAR(32) 费用代垫经销商名称
verificationApplyDetails.dealerCode VARCHAR(32) 费用代垫经销商编码
verificationApplyDetails.dealerSourceCode VARCHAR(32) 费用代垫经销商外部id
verificationApplyDetails.businessAccountCode VARCHAR(32) 核算记录编号
verificationApplyDetails.customerCode VARCHAR(32) 客户编码
verificationApplyDetails.dimsData List 预算维度。格式为:{"预算维度名称":维值名称,""预算维度编码":维值编码},多个维度用逗号隔开
verificationApplyDetails.customerName VARCHAR(32) 客户名称
verificationApplyDetails.customerSourceCode VARCHAR(32) 客户外部id
verificationApplyDetails.productName VARCHAR(32) 商品名称
verificationApplyDetails.productSourceCode VARCHAR(32) 商品外部id
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 09:12:00",
    "create_date_end": "2017-01-20 09:12:00",
    "update_date_start": "2017-01-20 09:12:00",
    "update_date_end": "2017-01-20 09:12:00",
    "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,
	"reverse_user_source_code": "",
	"code": "HX202105170001",
    "id": "24142241",
    "apply_id": "24142241",
	"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_source_code": "",
	"audit_id": null,
	"reverse_user_name": null,
	"model_name": "客户进货折扣核销申请单",
	"assign_form": 5294142376237267736,
	"reverse_status": "0",
	"creator_id": 5133482379484696411,
	"verify_status": "处理中",
	"details": [{
		"subject_code": "1225",
        "dept_name": "客户部",
        "dept_source_code": "",
        "dealer_code": "经销商编码",
        "dealer_name": "经销商名称",
        "dealer_source_code": "",
		"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": "娃娃哈",
		"pd_source_code": "",
		"id": 6325017386372783408,
		"customer_name": "梨子",
		"customer_code": "CUS000005",
		"customer_source_code": "",
		"pd_code": "wwh",
		"apply_amount": 12110000.00
	}, {
		"subject_code": "1225",
        "dept_name": "客户部",
        "dept_source_code": "",
        "dealer_code": "经销商编码",
        "dealer_name": "经销商名称",
        "dealer_source_code": "",
		"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": "欧冠",
		"pd_source_code": "",
		"id": 8731564052992177830,
		"customer_name": "香菇",
		"customer_code": "CUS000009",
		"customer_source_code": "",
		"pd_code": "og",
		"apply_amount": 1.00
	}],
	"create_name": "陈假假",
	"create_source_code": ""
}

参数说明:

参数 类型 说明
model_name varchar 核销单模板名称
code varchar 核销单号
id varchar 核销单id
apply_id varchar 申请单id
create_time varchar 核销单创建时间
creator_id int 核销单创建人的员工账号
create_name varchar 核销单创建人姓名
create_source_code varchar 核销单创建人外部id
verify_amount varchar 核销单的核销金额,取最近一个审批节点填写的金额
verify_status varchar 核销单的审批状态。0:待审批,1:已审批,2:被打回,3:审批中, 4:已作废
audit_id varchar 最近一次审批人的员工账号
audit_name varchar 最近一次审批人的员工姓名
audit_source_code varchar 最近一次审批人的员工外部id
audit_time varchar 最近审批时间。格式:yyyy-MM-dd HH:mm:ss
reverse_status varchar 核销单红冲状态。0:正常,1:被红冲,2:红冲
reverse_user_id varchar 核销单红冲人账号,只有状态为“被红冲”的,才会有值
reverse_user_name varchar 核销单红冲人姓名,只有状态为“被红冲”的,才会有值
reverse_user_source_code varchar 核销单红冲人外部id
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.customer_source_code varchar 客户外部id
details.dept_name varchar 客户所属部门
details.dept_source_code varchar 客户所属部门外部id
details.dealer_code varchar 费用代垫经销商编码
details.dealer_name varchar 费用代垫经销商
details.dealer_source_code varchar 费用代垫经销商外部id
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.pd_source_code varchar 参与活动的折让商品外部id
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-审批中 4-已作废
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",
        "auditSourceCode": "",
        "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": "番茄",
              "customerSourceCode": "",
              "dealerCode": "dwa",
              "dealerName": "dwa",
              "dealerSourceCode": "",
              "pdCode": "dwa",
              "pdName": "dwa",
              "pdSourceCode": "",
              "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",
        "createSourceCode": "",
        "id": 5021882277991952210,
        "reserveUserId": "",
        "reverseName": "",
        "reverseUserSourceCode": "",
        "reverseStatus": "0",
        "reverseTime": "",
        "skuList": 
        [
          {
            "applyAmount": "80.00",
            "auditAmount": "30.00",
            "budgetDimInfo": "[{\"dim_dept_name\":\"zf02\",\"dim_dept\":\"10\"}]",
            "customerCode": "CUS000008",
            "customerName": "胡萝卜",
            "customerSourceCode": "",
            "id": "8245472906361650691",
            "payModeName": "现金",
            "period": "2021",
            "rangeEndDate": "2021-05-11",
            "rangeStartDate": "2021-05-11",
            "rebateAccountName": "",
            "skuName": "麦德龙",
            "subjectCode": "001",
            "subjectName": "预算警告",
            "dealerCode": "dwa",
            "dealerName": "dwa",
            "dealerSourceCode": "",
            "pdCode": "dwa",
            "pdName": "dwa",
            "pdSourceCode": "",
            "verifyAmount": "30.00",
            "verifyCostCode": "",
            "verifyRemark": ""
          }
        ],
        "verificationCode": "HX202105110006",
        "activityCode": "SQ202105080001",
        "activityId": "202105080001",
        "verificationFormName": "05-08 直接申请",
        "verifyAmount": "100.00",
        "verifyFormDataId": "8532858878323479560",
        "verifyFormId": "5294142376237267736",
        "verifyStatus": "1"
    }
]

参数说明:

参数 类型 说明
verificationFormName string 核销单模板名称
verificationCode string 核销单号
id int 核销单id
activityCode string 核销的申请单号
activityId string 核销的申请单id
createTime date 核销单创建时间
creatorId int 核销单创建人的员工账号
creatorName string 核销单创建人姓名
createSourceCode string 核销单创建人外部id
verifyAmount int 核销单的核销金额,取最近一个审批节点填写的金额
verifyStatus string 核销单的审批状态,0:处理中,1:已审批,2:被打回
auditId string 最近一次审批人的员工账号
auditName string 最近一次审批人的员工姓名
auditSourceCode string 最近一次审批人的员工外部id
auditTime date 最近审批时间。格式:yyyy-MM-dd HH:mm:ss
reverseStatus string 核销单红冲状态。0:正常,1:被红冲,2:红冲
reserveUserId string 核销单红冲人账号,只有状 态为“被红冲”的,才会有值
reverseName string 核销单红冲人姓名,只有状态为“被红冲”的,才会有值
reverseUserSourceCode string 核销单红冲人外部id
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.customerSourceCode string 客户外部id
skuList.dealerCode string 费用代垫经销商编码
skuList.dealerName string 费用代垫经销商名称
skuList.dealerSourceCode string 费用代垫经销商外部id
skuList.pdCode string 商品编码
skuList.pdName string 商品名称
skuList.pdSourceCode string 商品外部id
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.customerSourceCode string 客户外部id
cmList.dealerCode string 费用代垫经销商编码
cmList.dealerName string 费用代垫经销商名称
cmList.dealerSourceCode string 费用代垫经销商外部id
cmList.pdCode string 商品编码
cmList.pdName string 商品名称
cmList.pdSourceCode string 商品外部id
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:审批中, 4:已作废
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",
        "verify_id": "12312312",
        "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",
                "invoice_amount": "123",
                "dim_data": [{
                  "dim_post": "GW2022011302",
                  "岗位": "测试"
                }],
                "id": "5925703782113030167"
            }
        ]
    }
]

参数说明:

参数 类型 说明
travel_id INT8 出差申请ID
model_name varchar 核销单模板名称
verify_code varchar 核销单号
verify_id varchar 核销单id
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:审批中, 4:已作废
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 List 预算维度信息,格式为:{"预算维度名称":维值名称},多个维度用逗号隔开
details.verify_remark varchar 核销行备注信息
details.pay_mode_name varchar 核销行的支付方式
details.invoice_amount varchar 核销行的发票金额

# 核销单查询接口(差旅费-新接口)

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cuxiao/verify/v1/queryVerificationTravelNew/{ 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:审批中, 4:已作废
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",
        "verify_id": "12312312",
        "form_data_id": "5219272373361056370",
        "verify_amount": "80.00",
        "audit_time": "2021-11-29 19:07:28",
        "creator_dept_code": "cynic",
        "audit_name": "gaomeng",
        "audit_source_code": "",
        "audit_id": "8230823847295124348",
        "reverse_user_name": "gaomeng",
        "reverse_user_source_code": "",
        "model_name": "697-差旅费-112301",
        "assign_form": "8962949206300408214",
        "reverse_status": "1",
        "creator_id": "8230823847295124348",
        "creator_dept_name": "西栗",
        "creator_dept_source_code": "",
        "creator_name": "gaomeng",
        "creator_source_code": "",
        "verify_status": "1",
        "travel_details": [
            {
                "travel_id": "12421412",
                "details": [
                {
                  "subject_code": "YS21090802",
                  "period": "2021-12",
                  "audit_amount": "80.00",
                  "init_amount": "80.00",
                  "subject_name": "地支",
                  "pay_mode_name": "现金",
                  "verify_remark": "121",
                  "invoice_amount": "123",
                  "dim_data": [{
                    "dim_post": "GW2022011302",
                    "岗位": "测试"
                  }],
                  "id": "5925703782113030167"
                }
              ]
            }
        ]
    }
]

参数说明:

参数 类型 说明
travel_id INT8 出差申请ID
model_name varchar 核销单模板名称
verify_code varchar 核销单号
verify_id varchar 核销单id
create_time varchar 创建时间。格式:yyyy-MM-dd HH:mm:ss
creator_id INT8 核销单创建人的员工账号
creator_name varchar 核销单创建人姓名
creator_source_code varchar 核销单创建人外部id
creator_dept_code varchar 创建人部门编码
creator_dept_name varchar 创建人部门名称
creator_dept_source_code varchar 创建人部门外部id
verify_amount NUMERIC(15, 2) 核销单的核销金额
verify_status varchar 核销单的审批状态,0:待审批,1:已审批,2:被打回,3:审批中,4:已作废
audit_id INT8 最近一次审批人的员工账号
audit_name varchar 最近一次审批人的员工姓名
audit_source_code varchar 最近一次审批人的员工外部id
audit_time varchar 最近审批时间。格式:yyyy-MM-dd HH:mm:ss
reverse_status varchar 红冲状态
reverse_user_id INT8 红冲人账号
reverse_user_name varchar 红冲人姓名
reverse_user_source_code varchar 红冲人外部id
reverse_time varchar 核销单红冲时间,只有状态为“被红冲”的,才有值。格式:yyyy-MM-dd HH:mm:ss
assign_form INT8 核销单叠加表单模板ID
form_data_id INT8 核销单叠加表单数据ID
travel_details List 出差申请行列表
travel_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 List 预算维度信息,格式为:{"预算维度名称":维值名称},多个维度用逗号隔开
details.verify_remark varchar 核销行备注信息
details.pay_mode_name varchar 核销行的支付方式
details.invoice_amount varchar 核销行的发票金额

# 关闭申请记录查询接口

接口说明:暂时只支持进货折扣、进场费、固定金额、市场活动方案、万能促销活动、品鉴会场景

请求方式: 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",
        "activity_code": "SQ0000001",
        "customer_name": "客户名称",
        "customer_source_code": "",
        "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
activity_code VARCHAR(100) 申请单号
customer_name VARCHAR(100) 客户名称
customer_source_code VARCHAR(100) 客户外部id
budget_amount NUMERIC(15, 2) 申请金额
close_amount NUMERIC(15, 2) 结案金额
verify_amount NUMERIC(15, 2) 核销金额

# 核销单查询接口(万能促销活动(AP/CP)核销头)

请求方式: 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-审批中 4-已作废
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_code": null,
	"audit_id": null,
    "audit_source_code": null,
	"reverse_user_name": null,
    "reverse_user_code": null,
    "reverse_source_code": null,
	"model_name": "客户进货折扣核销申请单",
	"assign_form": 5294142376237267736,
	"reverse_status": "0",
	"creator_id": 5133482379484696411,
    "create_source_code": "e1231",
    "create_code":"cynic",
	"verify_status": "处理中",
	"applyCode": "7467288607926123276",
	"create_name": "陈假假",
    "apply_id": "5133482379484696411",
    "verify_id": "5133482379484696411",
    "verify_name": "核销单名称",
    "verify_charge_person_id": "5133482379484696411",
    "verify_charge_person_name": "陈假假",
    "verify_charge_person_code": "12321",
    "verify_charge_person_source_code": "12321",
    "dept_code": "IONY",
    "dept_name": "艾欧尼亚",
    "dept_id": "3123",
    "dept_source_code": "1213d",
    "actual_sales_num": "1",
    "actual_sales_amount": "10",
    "ext_data": {
      "ext_20230323001": "测试"
    }
}

参数说明:

参数 类型 说明
model_name varchar 核销单模板名称
code varchar 核销单号
verify_id int 核销单id
verify_name varchar 核销单名称
applyCode varchar 活动申请单号
apply_id int 申请单id
create_time varchar 核销单创建时间
creator_id int 核销单创建人的员工id
create_code varchar 核销单创建人的员工账号
create_source_code varchar 核销单创建人的外部id
create_name varchar 核销单创建人姓名
verify_amount varchar 核销单的核销金额,取最近一个审批节点填写的金额
verify_status varchar 核销单的审批状态。0:待审批,1:已审批,2:被打回,3-审批中,4-已作废
audit_id varchar 最近一次审批人的员工账号id
audit_code varchar 最近一次审批人的员工账号
audit_name varchar 最近一次审批人的员工姓名
audit_time varchar 最近审批时间。格式:yyyy-MM-dd HH:mm:ss
audit_source_code varchar 核销单审批人的外部id
reverse_status varchar 核销单红冲状态。0:正常,1:被红冲,2:红冲
reverse_user_id varchar 核销单红冲人账号id,只有状态为“被红冲”的,才会有值
reverse_user_code varchar 核销单红冲人账号,只有状态为“被红冲”的,才会有值
reverse_user_name varchar 核销单红冲人姓名,只有状态为“被红冲”的,才会有值
reverse_source_code varchar 核销单红冲人外部id,只有状态为“被红冲”的,才会有值
reverse_time varchar 核销单红冲时间,只有状态为“被红冲”的,才有值。格式:yyyy-MM-dd HH:mm:ss
assign_form int 核销单叠加表单模板ID
form_data_id int 核销单叠加表单数据ID
verify_charge_person_id int 核销负责人账号id
verify_charge_person_name varchar 核销负责人姓名
verify_charge_person_code varchar 核销负责人账号
verify_charge_person_source_code varchar 核销负责人外部id
dept_code varchar 所属部门编码
dept_name varchar 所属部门
dept_id varchar 所属id
dept_source_code varchar 所属外部id
actual_sales_num varchar 实际销量
actual_sales_amount varchar 实际销额
ext_data object 核销头自定义字段(<字段名称,字段值>)

# 核销查询接口(万能促销活动(AP/CP)核销行)

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

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

参数说明:

参数 类型 必填 说明
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,
            "capitalAccountName": null,
            "period": "2021-05",
            "dealerId": "41421412412",
            "dealerName": "橘子",
            "dealerCode": "CUS000001",
            "dealerSourceId": "123123",
            "customerCode": "CUS002622",
            "customerId": "12312312",
            "customerSourceId": "123123412",
            "dimsData": {
                "部门": "zf02"
            },
            "customerName": "黄瓜",
            "applyId": "20230323202851515",
            "cmRelId": "20230323202851515",
            "auditAmount": null,
            "payModeName": "现金",
            "initAmount": 1.00,
            "subjectCode": "A0001",
            "applyAmount": 1.00,
            "exts": [{
                "ext_key": "文本框",
                "ext_value": "文本框1"
            }, {
                "ext_key": "单选框",
                "ext_value": "选项1"
            }],
            "subjectName": "预算科目001",
            "verifyRemark": "测试备注",
            "gifts": [
              {
                "prodId": "231312",
                "prodName": "红药水",
                "prodCode": "SP202109150005",
                "prodSourceCode": "SP202109150005",
                "unitName": "瓶",
                "prodPrice": "50",
                "verifyNum": "2",
                "verifyAmount": "100",
                "verifyRemark": "测试行备注"
              }
            ],
            "advanceChargeDetail": [
              {
                "code": "YFK2023061600000001",
                "detail_id": "123",
                "init_amount": "1",
                "advance_amount": "1"
              }
            ]
    }
]

参数说明:

参数 类型 说明
code VARCHAR(32) 核销单号
rebateAccountName VARCHAR(32) 费用池账户
capitalAccountName VARCHAR(32) 资金池账户
period VARCHAR(32) 预算期间
dealerId VARCHAR(32) 实际费用代垫经销商id
dealerName VARCHAR(32) 实际费用代垫经销商
dealerSourceId VARCHAR(32) 实际费用代垫经销商第三方id
dealerCode VARCHAR(32) 实际费用代垫经销商编码
customerCode VARCHAR(32) 实际客户编码
dimsData text 预算维度。格式为:{"预算维度名称":维值名称}
customerName VARCHAR(32) 实际客户
customerId VARCHAR(32) 实际客户id
customerSourceId VARCHAR(32) 实际客户第三方id
auditAmount VARCHAR(32) 批复核销金额
payModeName VARCHAR(32) 支付方式
initAmount VARCHAR(32) 本次核销金额
subjectCode VARCHAR(32) 预算科目编码
applyAmount VARCHAR(32) 预算申请金额
exts List 自定义字段
exts.ext_key VARCHAR(32) 自定义字段key
exts.ext_value VARCHAR(32) 自定义字段value
subjectName VARCHAR(32) 预算科目名称
applyId VARCHAR(32) 申请行id
cmRelId VARCHAR(32) 核销行id
gifts List 实际赠送品项
gifts.prodId VARCHAR(100) 商品id
gifts.prodName VARCHAR(100) 商品名称
gifts.prodCode VARCHAR(100) 商品编码
gifts.prodSourceCode VARCHAR(100) 商品第三方id
gifts.unitName VARCHAR(100) 单位
gifts.prodPrice VARCHAR(100) 价格
gifts.verifyNum VARCHAR(100) 核销数量
gifts.verifyAmount VARCHAR(100) 核销金额
gifts.verifyRemark VARCHAR(100) 核销备注
advanceChargeDetail List 预付款列表
advanceChargeDetail.code VARCHAR(100) 预付款单号
advanceChargeDetail.detail_id VARCHAR(100) 预付款行ID
advanceChargeDetail.init_amount VARCHAR(100) 核销预付款金额
advanceChargeDetail.advance_amount VARCHAR(100) 预付款金额

# 发票池查询接口

接口说明:查询发票池中发票信息。

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

{
  "id":"",
  "source_code":"",
  "invoice_no":"",
  "invoice_code":"",
  "start_time":"",
  "end_time":"",
  "page": 1,
  "rows": 1000
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
id VARCHAR(100) 发票id
source_code VARCHAR(100) 发票外部系统id
invoice_no VARCHAR(100) 发票号码
invoice_code VARCHAR(100) 发票代码
start_time VARCHAR(100) 发票上传开始时间,格式:yyyy-MM-dd HH:mm:ss
end_time VARCHAR(100) 发票上传结束时间,格式:yyyy-MM-dd HH:mm:ss
page NUMERIC 数据页码,不填默认第一页
rows NUMERIC 页长,默认1000

响应示例:

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

数据DATA示例:

[
  {
    "tax_amount": "10.00",
    "remark": "openapi测试发票备注001",
    "seller_taxpayer": "EZ经销商客户",
    "seller_address_tel": "水电费",
    "purchaser_tax_no": "989768671276131893",
    "invoice_name": "openapi新增发票001",
    "invoice_date": "2023-06-15 00:00:00",
    "payee": "yz",
    "creator_source_code": "",
    "purchaser_address_tel": "东街19号 670003",
    "review": "yz",
    "machine_number": "661905769875",
    "seller_tax_type": "1",
    "checksum": "9527",
    "invoice_type": "20220111165401",
    "details": [
      {
        "tax_amount": "10.00",
        "unit": "箱",
        "amount": "20.00",
        "sequ": "1.00",
        "total_amount": "30.00",
        "num": "1",
        "taxable_name": "服务名称",
        "unit_price": "20.00000000",
        "specifications": "40873",
        "tax_rate": "50.00"
      }
    ],
    "id": "7291581295336937385",
    "seller_bank_account": "1322700987666",
    "creator_code": "yz",
    "verification_bills": [
      {
        "bills_code": "HX202204270005",
        "bills_id": "8370996358726586935",
        "sub_bills_id": "5769319148235938664",
        "verify_associated_amount": "5.00"
      }
    ],
    "amount": "20.00",
    "create_time": "2023-06-15 00:00:00",
    "invoice_no": "NO-20230615001",
    "purchaser_bank_account": "2023032214410001",
    "drawer": "yz",
    "check_status": "0",
    "invoice_code": "CODE-20230615001",
    "total_amount": "30.00",
    "seller_tax_no": "",
    "creator_id": "7806203820472342773",
    "used_amount": "",
    "creator_name": "yangzhi",
    "left_amount": "30.00",
    "source_code": "",
    "purchaser_taxpayer": "大大商贸"
  }
]

参数说明:

参数 类型 说明
id VARCHAR(100) 发票id
source_code VARCHAR(100) 发票外部系统id
invoice_name VARCHAR(100) 发票名称
invoice_type VARCHAR(100) 发票类型({"id":20220111165401,"name":"增值税专用发票"},{"id":20220111165402,"name":"增值税普通发票"},{"id":20220111165403,"name":"增值税电子普通发票"},{"id":20220111165404,"name":"增值税电子专用发票"},{"id":202305091095405,"name":"电子发票(增值税普通发票)"},{"id":202305091095406,"name":"电子发票(增值税专用发票)"})
invoice_date VARCHAR(100) 开票日期
invoice_no VARCHAR(100) 发票号码
invoice_code VARCHAR(100) 发票代码
drawer VARCHAR(100) 开票人
payee VARCHAR(100) 收款人
review VARCHAR(100) 复核人
checksum VARCHAR(100) 校验码
machine_number VARCHAR(100) 机器编号
remark text 备注
total_amount VARCHAR(100) 价税合计金额
amount VARCHAR(100) 不含税金额合计
tax_amount VARCHAR(100) 税额合计
used_amount VARCHAR(100) 已关联金额
verification_bills List 关联核销单据列表
verification_bills.bills_code VARCHAR(100) 核销单号
verification_bills.bills_id VARCHAR(100) 核销单id
verification_bills.sub_bills_id VARCHAR(100) 核销单明细id
verification_bills.verify_associated_amount VARCHAR(100) 关联金额
left_amount VARCHAR(100) 发票余额
type VARCHAR(100) 发票主体类型(1:本企业;2:第三方)
purchaser_taxpayer VARCHAR(100) 购买方
purchaser_tax_no VARCHAR(100) 购买方纳税人识别号
purchaser_address_tel VARCHAR(100) 购买方地址/电话
purchaser_bank_account VARCHAR(100) 购买方开户行/账号
seller_tax_type VARCHAR(100) 销售方类型(1:客户;0:第三方)
seller_taxpayer VARCHAR(100) 销售方
seller_tax_no VARCHAR(100) 销售方纳税人识别号
seller_address_tel VARCHAR(100) 销售方地址/电话
seller_bank_account VARCHAR(100) 销售方开户行/账号
check_status VARCHAR(1) 验真状态(0:未验真;1:已验真;2:验真失败)
creator_id VARCHAR(100) 发票上传人id
creator_code VARCHAR(100) 发票上传人账号
creator_name VARCHAR(100) 发票上传人名称
creator_source_code VARCHAR(100) 发票上传人外部id
create_time VARCHAR(100) 发票上传时间
details List 发票行
details.sequ VARCHAR(100) 行号
details.taxable_name VARCHAR(100) 货物或应税劳务、服务名称
details.specifications VARCHAR(100) 规格型号
details.unit VARCHAR(100) 单位
details.num VARCHAR(100) 数量
details.unit_price VARCHAR(100) 单价
details.amount VARCHAR(100) 金额
details.tax_rate VARCHAR(100) 税率
details.tax_amount VARCHAR(100) 税额
details.total_amount VARCHAR(100) 含税金额