TIP
# 预算费控
# 付费陈列核销单新增接口
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/cuxiao/verify/v1/saveVerify/{openid}/{timestamp}/{digest}/{msg_id}
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
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 | 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}
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 |
请求示例:
响应示例:
[
{
"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 | 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 | 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) | 预算科目名称 |