TIP
# 核销数据同步
# 付费陈列核销单
接口说明:推送付费陈列的核销单。当付费陈列核销单新建提交、修改提交、审批通过、打回、红冲时都会推送,所以对同一个核销单(核销单ID相同),该接口可能会调用多次。红冲的时候,由于会再生成一个新单,所以会有两条数据,会推送两次。
注:接口参数与付费陈列核销单查询返回元素一致,若文档未更新请参考查询接口返回数据
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_display |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"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) | 投入项名称 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 付费陈列核销单删除
接口说明:推送付费陈列删除的核销单。当付费陈列核销单删除时会调用此接口。
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_delete_display |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"verify_code": "HX202105130005"
}
参数说明:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| verify_code | VARCHAR(32) | 是 | 核销单号 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 市场活动核销单
接口说明:推送市场活动的核销单。当市场活动核销单新建提交、修改提交、审批通过、打回、红冲时都会推送,所以对同一个核销单(核销单ID相同),该接口可能会调用多次。红冲的时候,由于会再生成一个新单,所以会有两条数据,会推送两次。
注:接口参数与核销单查询接口(市场活动方案)返回元素一致,若文档未更新请参考查询接口返回数据
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_market |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"planId": "5323166537693260610",
"planCode": "CX20210511224",
"applyFormName": "市场活动0506",
"verifyApplyId": "12312312",
"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": [{
"dim_2203010003": "WX220505131802",
"五行": "烈火燎原"
}],
"initAmount": "10.00",
"auditAmount": "10.00"
}]
}
参数说明:
| 参数 | 类型 | 说明 |
|---|---|---|
| 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) | 核销单创建人姓名 |
| 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 | List | 预算维度信息,格式为:{"预算维度名称":维值名称},多个维度用逗号隔开 |
| verificationBudgetDetails.initAmount | VARCHAR(32) | 本次本行预算扣减金额 |
| verificationBudgetDetails.auditAmount | VARCHAR(32) | 核销单该预算行最近一次审批节点审批通过的金额 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 市场活动核销单删除
接口说明:推送市场活动删除的核销单。当市场活动核销单删除时会调用此接口。
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_delete_market |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"verify_code": "HX202105130005"
}
参数说明:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| verify_code | VARCHAR(32) | 是 | 核销单号 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 进场费核销单
接口说明:推送进场费的核销单。当进场费核销单新建提交、修改提交、审批通过、打回、红冲时都会推送,所以对同一个核销单(核销单ID相同),该接口可能会调用多次。红冲的时候,由于会再生成一个新单,所以会有两条数据,会推送两次。
注:接口参数与核销单查询接口(进场费)返回元素一致,若文档未更新请参考查询接口返回数据
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_entrance |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"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": "[{\"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",
"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",
"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) | 核销单创建人姓名 |
| 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 | List | 预算维度信息,格式为:{"预算维度名称":维值名称,""预算维度编码":维值编码} |
| cm_list.verify_remark | TEXT | 核销行备注信息 |
| cm_list.pay_mode_name | VARCHAR(32) | 核销行的支付方式 |
| cm_list.rebate_account_name | VARCHAR(32) | 核销行的费用池账户,支付方式为“转费用池”的时候,此字段有值 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 进场费核销单删除
接口说明:推送进场费删除的核销单。当进场费核销单删除时会调用此接口。
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_delete_entrance |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"verify_code": "HX202111150012"
}
参数说明:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| verify_code | VARCHAR(32) | 是 | 核销单号 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 万能促销活动(TP)核销单
接口说明:推送万能促销活动的核销单。当万能促销活动核销单新建提交、修改提交、审批通过、打回、红冲时都会推送,所以对同一个核销单(核销单ID相同),该接口可能会调用多次。红冲的时候,由于会再生成一个新单,所以会有两条数据,会推送两次。
注:接口参数与核销单查询接口(万能促销(TP))返回元素一致,若文档未更新请参考查询接口返回数据
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_regular |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"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_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": "",
"next_user_id" : "" ,
"next_user_code" : "" ,
"next_user_name" : "" ,
"next_user_source_code" : "",
"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",
"row_no": "1",
"settlement_period": "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_code": "",
"actual_dealer_name": "",
"actual_cm_code": "",
"actual_cm": "",
"execution_count": "1",
"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_name": "蓝苓口服液",
"pd_code": "12035",
"pd_price": "38.00",
"unit_name": "盒",
"init_num": "2.00",
"init_amount": "76.00"
}],
"special_tax_amount": "",
"tax_include_amount": ""
}]
}
参数说明:
| 参数 | 类型 | 说明 |
|---|---|---|
| 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) | 核销单创建人的员工账号 |
| creator_name | VARCHAR(32) | 核销单创建人姓名 |
| verify_amount | VARCHAR(32) | 核销单的核销金额,取最近一个审批节点填写的金额(预算扣减金额合计) |
| verify_status | VARCHAR(32) | 核销单的审批状态,0:处理中,1:已审批,2:被打回 |
| audit_id | VARCHAR(32) | 最近审批人的员工账号 |
| audit_name | VARCHAR(32) | 最近审批人员工姓名 |
| audit_time | VARCHAR(32) | 最近审批时间。格式:yyyy-MM-dd HH:mm:ss |
| reverse_status | VARCHAR(32) | 核销单红冲状态,0:正常,1:被红冲,2:红冲 |
| reverser_id | VARCHAR(32) | 核销单红冲人ID,只有状态为“被红冲”的,才会有值 |
| reverser_name | VARCHAR(32) | 核销单红冲人姓名,只有状态为“被红冲”的,才会有值 |
| reverse_time | VARCHAR(32) | 核销单红冲时间,只有状态为“被红冲”的,才有值 |
| next_user_id | VARCHAR(32) | 当前审批人id |
| next_user_code | VARCHAR(32) | 当前审批人的员工账号 |
| next_user_name | VARCHAR(32) | 当前审批人员工姓名 |
| next_user_source_code | VARCHAR(32) | 当前审批人人对应外部数据id |
| 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.budget_freeze_node | VARCHAR(32) | 预算冻结节点 0 方案冻结预算 1 申请冻结预算 |
| 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.row_no | VARCHAR(32) | 行号 |
| details.settlement_period | 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_code | VARCHAR(32) | 实际代垫经销商编码 |
| details.actual_dealer_name | VARCHAR(32) | 实际代垫经销商 |
| details.actual_cm_code | VARCHAR(32) | 实际核销客户编码 |
| details.actual_cm | VARCHAR(32) | 实际核销客户 |
| details.execution_count | 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) | 扩展字段 |
| details.special_tax_amount | VARCHAR(32) | 关联专票税额 |
| details.tax_include_amount | VARCHAR(32) | 关联含税金额 |
| details.budgetList | List | 按方案冻结预算时的预算信息集合 |
| details.gift_data | List | 如果支付方式配置的返利方式为赠品池的时候,实际赠送品项集合 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 宴席核销单
接口说明:推送宴席的核销单。当宴席核销单新建提交、修改提交、审批通过、打回、红冲时都会推送,所以对同一个核销单(核销单ID相同),该接口可能会调用多次。红冲的时候,由于会再生成一个新单,所以会有两条数据,会推送两次。
注:接口参数与核销单查询接口(宴席)返回元素一致,若文档未更新请参考查询接口返回数据
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_regular |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"plan_id": "5323166537693260610",
"plan_code": "CX20210511224",
"verify_form_name": "核销0506",
"activity_code": "SQ202105130005",
"activity_id": "5323166537693260610",
"verify_id": "231321",
"verify_code": "HX202105130005",
"create_time": "2021-05-13 13:58:38",
"creator_account": "85458",
"creator_name": "lm",
"creator_source_code": "SOURCES11",
"verify_status": "1",
"audit_account": "85458",
"audit_name": "lm",
"audit_source_code": "SOURCES22",
"audit_time": "2021-05-13 14:57:50",
"reverse_status": "",
"reverser_account": "",
"reverser_name": "",
"reverser_source_code": "",
"reverse_time": "",
"verify_name": "xxx",
"rebate_flag": "是",
"verify_amount": "10.00",
"ext_data": {
"自定义头": "文本1"
},
"ext_col": {
"自定义文本": "ext_1"
},
"gift_list": [
{
"gift_type": "12321123",
"pd_code": "SQ202105110002",
"unit": "BN202204290004",
"init_num": "7896080812679071886",
"remark": "8596380812679041259"
}
]
}
参数说明:
| 参数 | 类型 | 说明 |
|---|---|---|
| plan_id | VARCHAR(32) | 活动方案ID |
| plan_code | VARCHAR(32) | 活动方案编码 |
| verify_form_name | VARCHAR(32) | 核销单模板名称 |
| activity_code | VARCHAR(32) | 申请单号 |
| activity_id | VARCHAR(32) | 申请单id |
| verify_id | VARCHAR(32) | 核销单id |
| verify_code | VARCHAR(32) | 核销单号 |
| create_time | VARCHAR(32) | 核销单创建时间。格式:yyyy-MM-dd HH:mm:ss |
| creator_account | VARCHAR(100) | 核销单创建人的员工账号 |
| creator_name | VARCHAR(32) | 核销单创建人姓名 |
| creator_source_code | VARCHAR(32) | 核销单创建人外部id |
| verify_status | VARCHAR(32) | 核销单的审批状态,0:待审批,1:已审批,2:被打回,3:审批中,4:已作废,5:已撤回 |
| audit_account | 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(32) | 核销单红冲状态,0:正常,1:被红冲,2:红冲 |
| reverser_account | VARCHAR(32) | 核销单红冲账号,只有状态为“被红冲”的,才会有值 |
| reverser_name | VARCHAR(32) | 核销单红冲人姓名,只有状态为“被红冲”的,才会有值 |
| reverser_source_code | VARCHAR(32) | 核销单红冲人外部id,只有状态为“被红冲”的,才会有值 |
| reverse_time | VARCHAR(32) | 核销单红冲时间,只有状态为“被红冲”的,才有值 |
| verify_name | VARCHAR(32) | 核销单名称 |
| rebate_flag | VARCHAR(32) | 是否同步赠品池 |
| verify_amount | VARCHAR(32) | 核销单的核销金额,取最近一个审批节点填写的金额(预算扣减金额合计) |
| ext_data | VARCHAR(32) | 扩展字段 |
| gift_list | 实际赠送商品 | |
| gift_list.gift_type | VARCHAR(32) | 赠送对象 |
| gift_list.pd_code | VARCHAR(100) | 商品编码 |
| details.unit | VARCHAR(32) | 单位 |
| gift_list.init_num | VARCHAR(32) | 数量 |
| gift_list.remark | VARCHAR(32) | 备注 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 万能促销活动(TP)关闭/开启申请行
接口说明:推送万能促销活动申请行的关闭/开启记录
注:接口参数与关闭申请记录查询接口(万能促销活动(TP))返回元素一致,若文档未更新请参考查询接口返回数据
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_regular |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"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) | 核销金额 |
| end_status | VARCHAR(32) | 关闭状态 1:关闭申请;0:开启申请 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 万能促销活动(TP)核销单删除
接口说明:推送万能促销活动删除的核销单。当万能促销活动核销单删除时会调用此接口。
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_delete_regular |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"verify_code": "HX202211240001"
}
参数说明:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| verify_code | VARCHAR(32) | 是 | 核销单号 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 固定金额核销单
接口说明:推送“固定类费用”的核销单。当“固定类费用”核销单新建提交、修改提交、审批通过、打回、红冲时都会推送,所以对同一个核销单(核销单ID相同),该接口可能会调用多次。红冲的时候,由于会再生成一个新单,所以会有两条数据,会推送两次。
注:接口参数与核销单查询接口(固定金额申请)返回元素一致,若文档未更新请参考查询接口返回数据
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_fixamount |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"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": "番茄",
"dealerCode": "dwa",
"dealerName": "dwa",
"pdCode": "dwa",
"pdName": "dwa",
"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": "预算警告",
"dealerCode": "dwa",
"dealerName": "dwa",
"pdCode": "dwa",
"pdName": "dwa",
"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 | 核销单创建人姓名 |
| 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.pdCode | string | 商品编码 |
| skuList.pdName | 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.pdCode | string | 商品编码 |
| cmList.pdName | 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 | 核销行的返利账户,支付方 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 固定金额核销单删除
接口说明:推送“固定类费用”删除的核销单。当“固定类费用”核销单删除时会调用此接口。
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_delete_fixamount |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"verify_code": "HX202105110006"
}
参数说明:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| verify_code | VARCHAR(32) | 是 | 核销单号 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 进货折扣核销单
接口说明:推送“进货折扣(后返)”的核销单。当“进货折扣(后返)”核销单新建提交、修改提交、审批通过、打回、红冲时都会推送,所以对同一个核销单(核销单ID相同),该接口可能会调用多次。红冲的时候,由于会再生成一个新单,所以会有两条数据,会推送两次。
注:接口参数与进货折扣核销单查询返回元素一致,若文档未更新请参考查询接口返回数据
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_discount |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"reverse_user_id": null,
"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_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": "客户部",
"dealer_code": "经销商编码",
"dealer_name": "经销商名称",
"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 | 核销单id |
| apply_id | varchar | 申请单id |
| create_time | varchar | 核销单创建时间 |
| creator_id | int | 核销单创建人的员工账号 |
| create_name | varchar | 核销单创建人姓名 |
| verify_amount | varchar | 核销单的核销金额,取最近一个审批节点填写的金额 |
| verify_status | varchar | 核销单的审批状态。0:处理中,1:已审批,2:被打回 |
| audit_id | varchar | 最近一次审批人的员工账号 |
| audit_name | varchar | 最近一次审批人的员工姓名 |
| audit_time | varchar | 最近审批时间。格式:yyyy-MM-dd HH:mm:ss |
| reverse_status | varchar | 核销单红冲状态。0:正常,1:被红冲,2:红冲 |
| reverse_user_id | varchar | 核销单红冲人账号,只有状态为“被红冲”的,才会有值 |
| reverse_user_name | varchar | 核销单红冲人姓名,只有状态为“被红冲”的,才会有值 |
| reverse_time | varchar | 核销单红冲时间,只有状态为“被红冲”的,才有值。格式:yyyy-MM-dd HH:mm:ss |
| assign_form | int | 核销单叠加表单模板ID |
| form_data_id | int | 核销单叠加表单数据ID |
| business_date | varchar | 核销单的过账日期,开启费用核算对接ERP系统生成凭证的企业,此字段有值。格式:YYY-MM-DD |
| details.id | int | 核销的申请明细行ID |
| details.customer_code | varchar | 客户编码 |
| details.customer_name | varchar | 客户名称 |
| details.dept_name | varchar | 客户所属部门 |
| details.dealer_code | varchar | 费用代垫经销商编码 |
| details.dealer_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 | 核销行的返利账户,支付方式为“货补返利”的时候,此字段有值 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 进货折扣核销单删除
接口说明:推送“进货折扣(后返)”删除的核销单。当“进货折扣(后返)”核销单删除时会调用此接口。
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_delete_discount |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"verify_code": "HX202105170001"
}
参数说明:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| verify_code | VARCHAR(32) | 是 | 核销单号 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 直接创建核销单
接口说明:推送“其他(直接创建核销)”的核销单。当“其他(直接创建核销)”单核销单新建提交、修改提交、审批通过、打回、红冲时都会推送,所以对同一个核销单(核销单ID相同),该接口可能会调用多次。红冲的时候,由于会再生成一个新单,所以会有两条数据,会推送两次。
注:接口参数与直接创建核销单查询返回元素一致,若文档未更新请参考查询接口返回数据
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_direct |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"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,
"capitalAccountName": null,
"cuxiao_supplier_id": "111",
"cuxiao_supplier_name": "啊啊啊",
"cuxiao_supplier_code": "aaa",
"cuxiao_supplier_source_code": "222",
"period": "2021-05",
"dealerName": "橘子",
"dealerCode": "CUS000001",
"businessAccountCode": null,
"customerCode": "CUS002622",
"dimsData": [{
"dim_dept": "BM21111601",
"费用承担部门": "诺克萨斯"
}, {
"dim_customer": "CUS000004",
"经销商": "伊泽瑞尔"
}],
"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",
"verifyName": "111",
"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) | 核销金额 |
| verifyApplyId | VARCHAR(32) | 核销单id |
| verifyCode | VARCHAR(32) | 核销单号 |
| verifyName | 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.businessAccountCode | VARCHAR(32) | 核算记录编号 |
| verificationApplyDetails.customerCode | VARCHAR(32) | 客户编码 |
| verificationApplyDetails.dimsData | List | 预算维度。格式为:{"预算维度名称":维值名称,""预算维度编码":维值编码},多个维度用逗号隔开 |
| 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.cuxiao_supplier_id | VARCHAR(32) | 供应商id |
| verificationApplyDetails.cuxiao_supplier_name | VARCHAR(32) | 供应商名称 |
| verificationApplyDetails.cuxiao_supplier_code | VARCHAR(32) | 供应商编码 |
| verificationApplyDetails.cuxiao_supplier_source_code | VARCHAR(32) | 供应商外部id |
| verificationApplyDetails.exts | 自定义字段 | |
| verificationApplyDetails.exts.ext_key | VARCHAR(32) | 自定义字段key |
| verificationApplyDetails.exts.ext_value | VARCHAR(32) | 自定义字段value |
| verificationApplyDetails.subjectName | VARCHAR(32) | 预算科目名称 |
| verificationApplyDetails.invoice_amount | VARCHAR(32) | 发票金额 |
| verificationApplyDetails.special_tax_amount | VARCHAR(32) | 关联专票税额 |
| verificationApplyDetails.tax_include_amount | VARCHAR(32) | 关联含税金额 |
| verificationApplyDetails.invoices | List | 发票明细 |
| verificationApplyDetails.invoices.invoice_id | VARCHAR(32) | 发票行id |
| verificationApplyDetails.invoices.invoice_no | VARCHAR(32) | 发票号码 |
| verificationApplyDetails.invoices.invoice_code | VARCHAR(32) | 发票代码 |
| verificationApplyDetails.invoices.invoice_this_time_amount | VARCHAR(32) | 本次关联金额 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 直接创建核销单删除
接口说明:推送“其他(直接创建核销)”删除的核销单。当“其他(直接创建核销)”核销单删除时会调用此接口。
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_delete_direct |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"verify_code": "HX202105140003"
}
参数说明:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| verify_code | VARCHAR(32) | 是 | 核销单号 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 差旅费核销单
接口说明:推送“差旅费”的核销单。当“差旅费”单核销单新建提交、修改提交、审批通过、打回、红冲时都会推送,所以对同一个核销单(核销单ID相同),该接口可能会调用多次。红冲的时候,由于会再生成一个新单,所以会有两条数据,会推送两次。
注:接口参数与差旅费核销单查询返回元素一致,若文档未更新请参考查询接口返回数据
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_travel |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
[
{
"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",
"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_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 |
| 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 | 核销行的发票金额 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 差旅费核销单删除
接口说明:推送“差旅费”删除的核销单。当“差旅费”核销单删除时会调用此接口。
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_delete_travel |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"verify_code": "HX202111290003"
}
参数说明:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| verify_code | VARCHAR(32) | 是 | 核销单号 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 品鉴会核销单
接口说明:推送“品鉴会”的核销单。当“品鉴会”单核销单新建提交、修改提交、审批通过、打回、红冲时都会推送,所以对同一个核销单(核销单ID相同),该接口可能会调用多次。红冲的时候,由于会再生成一个新单,所以会有两条数据,会推送两次。
注:接口参数与核销单查询接口(品鉴会)返回元素一致,若文档未更新请参考查询接口返回数据
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_tasting |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"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": [{
"dim_post": "GW2022011302",
"岗位": "测试"
}],
"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": [{
"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,
"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) | 核销单号 |
| verify_id | VARCHAR(32) | 核销单id |
| 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 | 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) | 可用预算 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 品鉴会核销单删除
接口说明:推送“品鉴会”删除的核销单。当“品鉴会”核销单删除时会调用此接口。
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_delete_tasting |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"verify_code": "HX202211240001"
}
参数说明:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| verify_code | VARCHAR(32) | 是 | 核销单号 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 万能促销活动(AP/CP)核销单
接口说明:推送推送“其他(按申请核销)”的核销单。当其他(按申请核销)核销单新建提交万能、修改提交、审批通过、打回、红冲时都会推送,所以对同一个核销单(核销单ID相同),该接口可能会调用多次。红冲的时候,由于会再生成一个新单,所以会有两条数据,会推送两次。
注:接口参数与其他(按申请核销)核销单查询返回元素一致,若文档未更新请参考查询接口返回数据
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_other |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"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": "处理中",
"apply_code": "",
"apply_id": "7467288607926123276",
"create_name": "陈假假",
"verify_name": "核销单名称",
"create_source_code": "EMP001",
"audit_source_code": "EMP002",
"reverse_source_code": "",
"verify_charge_person_source_code": "EMP001",
"dept_source_code": "DEPT001",
"verificationApplyDetails": [{
"rebateAccountName": null,
"capitalAccountName": 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"
}],
"cmRelId": "",
"customerSourceId":"",
"dealerSourceId": "",
"gifts": [
{
"prodId": "231312",
"prodName": "红药水",
"prodCode": "SP202109150005",
"prodSourceCode": "SP202109150005",
"unitName": "瓶",
"prodPrice": "50",
"verifyNum": "2",
"verifyAmount": "100",
"verifyRemark": "测试行备注"
}
]
}
参数说明:
| 参数 | 类型 | 说明 |
|---|---|---|
| model_name | varchar | 核销单模板名称 |
| code | varchar | 核销单号 |
| apply_code | varchar | 活动申请单号 |
| apply_id | varchar | 活动申请单id |
| 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 |
| verify_name | varchar | 核销单名称 |
| verify_charge_person_source_code | varchar | 核销负责人外部ID |
| dept_source_code | varchar | 所属部门外部ID |
| create_source_code | varchar | 创建人外部ID |
| audit_source_code | varchar | 最近审批人外部ID |
| reverse_source_code | varchar | 红冲人外部ID |
| verificationApplyDetails | 明细行 | |
| verificationApplyDetails.rebateAccountName | VARCHAR(32) | 费用池账户 |
| verificationApplyDetails.capitalAccountName | VARCHAR(32) | 资金池账户 |
| verificationApplyDetails.period | VARCHAR(32) | 预算期间 |
| verificationApplyDetails.dealerName | VARCHAR(32) | 费用代垫经销商名称 |
| verificationApplyDetails.dealerCode | VARCHAR(32) | 费用代垫经销商编码 |
| verificationApplyDetails.customerCode | VARCHAR(32) | 客户编码 |
| verificationApplyDetails.dimsData | text | 预算维度。格式为:{"预算维度名称":维值名称} |
| verificationApplyDetails.customerName | VARCHAR(32) | 客户名称 |
| verificationApplyDetails.auditAmount | VARCHAR(32) | 批复核销金额 |
| verificationApplyDetails.payModeName | VARCHAR(32) | 支付方式 |
| verificationApplyDetails.initAmount | VARCHAR(32) | 本次核销金额 |
| verificationApplyDetails.subjectCode | VARCHAR(32) | 预算科目编码 |
| verificationApplyDetails.applyAmount | VARCHAR(32) | 预算申请金额 |
| verificationApplyDetails.exts | 自定义字段 | |
| verificationApplyDetails.exts.ext_key | VARCHAR(32) | 自定义字段key |
| verificationApplyDetails.exts.ext_value | VARCHAR(32) | 自定义字段value |
| verificationApplyDetails.subjectName | VARCHAR(32) | 预算科目名称 |
| verificationApplyDetails.customerSourceId | VARCHAR(32) | 实际客户外部id |
| verificationApplyDetails.dealerSourceId | VARCHAR(32) | 实际费用经销商外部id |
| verificationApplyDetails.cmRelId | VARCHAR(32) | 核销行id |
| verificationApplyDetails.applyId | VARCHAR(32) | 申请行id |
| verificationApplyDetails.gifts | List | 实际赠送品项 |
| verificationApplyDetails.gifts.prodId | VARCHAR(100) | 商品id |
| verificationApplyDetails.gifts.prodName | VARCHAR(100) | 商品名称 |
| verificationApplyDetails.gifts.prodCode | VARCHAR(100) | 商品编码 |
| verificationApplyDetails.gifts.prodSourceCode | VARCHAR(100) | 商品编码外部id |
| verificationApplyDetails.gifts.unitName | VARCHAR(100) | 单位 |
| verificationApplyDetails.gifts.prodPrice | VARCHAR(100) | 价格 |
| verificationApplyDetails.gifts.verifyNum | VARCHAR(100) | 核销数量 |
| verificationApplyDetails.gifts.verifyAmount | VARCHAR(100) | 核销金额 |
| verificationApplyDetails.gifts.verifyRemark | VARCHAR(100) | 核销备注 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 万能促销活动(AP/CP)核销单删除
接口说明:推送“(按申请核销)”删除的核销单。当“进货折扣(后返)”核销单删除时会调用此接口。
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_delete_other |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"verify_code": "HX202105170001"
}
参数说明:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| verify_code | VARCHAR(32) | 是 | 核销单号 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 线上费用核销单
接口说明:推送“线上费用”的核销单。当其他(按申请核销)核销单新建提交万能、修改提交、审批通过、打回、红冲时都会推送,所以对同一个核销单(核销单ID相同),该接口可能会调用多次。红冲的时候,由于会再生成一个新单,所以会有两条数据,会推送两次。
注:接口参数与线上费用核销单查询返回元素一致,若文档未更新请参考查询接口返回数据
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_onlineCost |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"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": "核销单名称",
"supplier_code": "sadwq12",
"supplier_name": "111222",
"ext_data": {
"ext_20230323001": "测试"
},
"ext_col": {
"自定义文本": "ext_1"
},
"verificationApplyDetails": [{
"code": "HX202409140038",
"verifyRemark": "12",
"applyAmount": 1000.44,
"applyId": "9150202182580329598",
"actualSaleAmount": 121.00,
"auditAmount": null,
"initAmount": 100.00,
"exts": [{
"ext_col": "ext_2409140162",
"ext_key": "文本框",
"ext_value": null
}, {
"ext_col": "ext_2409140163",
"ext_key": "单选",
"ext_value": "[{\"name\":\"选项3\",\"id\":\"选项3\"}]"
}, {
"ext_col": "ext_2409140164",
"ext_key": "多选框",
"ext_value": "[{\"name\":\"选项1\",\"id\":\"选项1\"},{\"name\":\"选项3\",\"id\":\"选项3\"}]"
}, {
"ext_col": "ext_2409140165",
"ext_key": "下拉框",
"ext_value": null
}, {
"ext_col": "ext_2409140166",
"ext_key": "人员选择",
"ext_value": "闫沛",
"ext_source_code": null
}, {
"ext_col": "ext_2409140167",
"ext_key": "商品单选",
"ext_value": "雪花啤酒勇闯天涯8度",
"ext_source_code": null
}],
"subjectName": "科目名称001",
"period": "2024-09",
"dimsData": {
"dim_terminal": "zd001",
"dim_post": "gw001",
"dim_online_platform": "zdyptbm001",
"线上平台": "自定义平台名称001",
"dim_2408050001": "zdy001",
"dim_customer": "jxs001",
"终端": "终端001",
"自定义": "自定义001",
"dim_product": "1000001",
"dim_dept": "7240tpm",
"商品": "雪花啤酒勇闯天涯8度",
"部门": "7240tpm",
"经销商": "经销商001",
"岗位": "岗位001"
},
"advanceChargeDetail": [
{
"code": "YFK2023061600000001",
"detail_id": "123",
"init_amount": "1",
"advance_amount": "1"
}
],
"cmRelId": "6888353181729287530",
"payModeName": "现金",
"subjectCode": "kmbm001",
"expectSaleRatio": 2112.00
}]
}
参数说明:
| 参数 | 类型 | 说明 |
|---|---|---|
| model_name | varchar | 核销单模板名称 |
| code | varchar | 核销单号 |
| verify_id | int | 核销单id |
| verify_name | varchar | 核销单名称 |
| apply_code | varchar | 活动申请单号 |
| apply_id | int | 申请单id |
| create_time | varchar | 核销单创建时间 |
| creator_id | int | 核销单创建人的员工id |
| create_code | varchar | 核销单创建人的员工账号 |
| create_source_code | varchar | 核销单创建人的外部id |
| create_name | varchar | 核销单创建人姓名 |
| supplier_code | varchar | 供应商编码 |
| supplier_name | varchar | 供应商名称 |
| verify_amount | varchar | 核销单的核销金额,取最近一个审批节点填写的金额 |
| verify_status | varchar | 核销单的审批状态。0:待审批,1:已审批,2:被打回,3-审批中,4-已作废,5-已撤回 |
| 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 |
| ext_data | object | 核销头自定义字段(<字段名称,字段值>) |
| ext_col | object | 核销头自定义字段(<字段名称,字段code>) |
| verificationApplyDetails | 明细行 | |
| verificationApplyDetails.code | VARCHAR(32) | 核销单号 |
| verificationApplyDetails.period | VARCHAR(32) | 预算期间 |
| verificationApplyDetails.dimsData | text | 预算维度。格式为:{"预算维度名称":维值名称} |
| verificationApplyDetails.auditAmount | VARCHAR(32) | 批复核销金额 |
| verificationApplyDetails.payModeName | VARCHAR(32) | 支付方式 |
| verificationApplyDetails.initAmount | VARCHAR(32) | 本次核销金额 |
| verificationApplyDetails.subjectCode | VARCHAR(32) | 预算科目编码 |
| verificationApplyDetails.applyAmount | VARCHAR(32) | 预算申请金额 |
| verificationApplyDetails.exts | List | 自定义字段 |
| verificationApplyDetails.exts.ext_key | VARCHAR(32) | 自定义字段key |
| verificationApplyDetails.exts.ext_value | VARCHAR(32) | 自定义字段value |
| verificationApplyDetails.exts.ext_col | VARCHAR(32) | 自定义字段code |
| verificationApplyDetails.subjectName | VARCHAR(32) | 预算科目名称 |
| verificationApplyDetails.applyId | VARCHAR(32) | 申请行id |
| verificationApplyDetails.cmRelId | VARCHAR(32) | 核销行id |
| verificationApplyDetails.verifyRemark | VARCHAR(100) | 核销备注 |
| verificationApplyDetails.actualSaleAmount | VARCHAR(100) | 实际销额 |
| verificationApplyDetails.expectSaleRatio | VARCHAR(100) | 实际费效比 |
| verificationApplyDetails.advanceChargeDetail | List | 预付款列表 |
| verificationApplyDetails.advanceChargeDetail.code | VARCHAR(100) | 预付款单号 |
| verificationApplyDetails.advanceChargeDetail.detail_id | VARCHAR(100) | 预付款行ID |
| verificationApplyDetails.advanceChargeDetail.init_amount | VARCHAR(100) | 核销预付款金额 |
| verificationApplyDetails.advanceChargeDetail.advance_amount | VARCHAR(100) | 预付款金额 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |
# 线上费用核销单删除
接口说明:推送“线上费用”删除的核销单。当“线上费用”核销单删除时会调用此接口。
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求参数:
| 参数名称 | 参数值 |
|---|---|
| msgId | 消息ID |
| dataId | 数据ID |
| dataVersion | 接口数据版本,如:001 |
| dataFormat | 数据格式:json |
| dataSource | 数据来源。biz:业务功能产生,api:开放接口产生 |
| timestamp | 请求时间戳,如:1503276678552 |
| status | 数据同步状态。0:数据首次同步,2:数据失败同步 |
| statusTime | 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss |
| tenantId | 企业ID,各注册企业在勤策中对应的唯一ID |
| digest | 数据签名,md5(data|pushsecret|timestamp) |
| dataType | cuxiao_verify_delete_onlineCost |
| data | <<请求数据体>> ,说明:格式为JSON格式数据 |
请求示例:
{
"verify_code": "HX202105170001"
}
参数说明:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| verify_code | VARCHAR(32) | 是 | 核销单号 |
参数说明:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应消息内容 |
| msg_id | 消息ID |