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",
"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": "",
"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"
}]
}]
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
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.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.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.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.budgetList | List | 按方案冻结预算时的预算信息集合 |
details.gift_data | List | 如果支付方式配置的返利方式为赠品池的时候,实际赠送品项集合 |
参数说明:
{
"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) | 预算科目名称 |
参数说明:
{
"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": "处理中",
"applyCode": "7467288607926123276",
"create_name": "陈假假",
"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"
}],
"verifyApplyId": 5836080081584349325
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
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 |
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) | 预算科目名称 |
参数说明:
{
"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 |