万店掌 开放平台 巡店任务报表-任务详情表

open.shopweb.liveCheck.task.statisticsPageOfTask (巡店任务报表-任务详情表)

巡店任务报表-任务详情表

接口描述 #

环境 接口方法 提交方式 是否需要签名 HTTP请求路由
正式环境 open.shopweb.liveCheck.task.statisticsPageOfTask POST true http://cloudapi.ovopark.com/cloud.api

公共请求参数 #

参数 类型 是否必填 最大长度 描述 示例值
_aid String 20 开放平台系统编号,固定为S107 S107
_akey String 20 万店掌开放平台分配给第三方的开发者key 认证平台开发者后获取
_mt String 100 接口名称 open.shopweb.liveCheck.task.statisticsPageOfTask
_sm String 100 签名算法 md5,sha1 md5
_requestMode String 100 请求方式post,get POST
_version String 100 版本号 v1
_timestamp String 100 时间戳 yyyyMMddHHmmss格式
_sig String 32 签名token 根据签名算法生成,详情见签名算法规则
_format String 10 format类型 目前默认仅支持json

业务请求参数 #

参数 类型 是否必填 最大长度 描述 示例值
pageNumber
string 0 (Integer) 1
pageSize
string 0 (Integer) 10
tabType
string 0 报表类型:0:巡店任务报表-任务汇总表,2:巡店任务报表-任务详情表 0
isRoot
string 0 是否请求下级数据(0:请求下级数据,也就是点组织架构下钻,1:不请求下级数据) 0
startTime
string 0 提交开始时间 2023-07-03 12:00:01
endTime
string 0 提交结束时间 2023-07-03 12:00:01
deptNode
string × 0 范围 test
enterpriseId
string 0 企业id 18888
templateId
string × 0 模板多选,多个逗号隔开 1,2
×
sourceType
string × 0 检查方式:现场巡店:8,14,15,远程巡店:9,13,点检任务:1,门店自检:12,17 8,14
userIds
string × 0 巡检人,多个逗号隔开 测试1,测试1
roleIds
string × 0 角色id,多个逗号隔开 12,11,22
chooseFlag
string 0 1按照组织架构,2按照标签 1
scoreOrder
string × 0 分数排序,0降序,1升序 0
timeOrder
string × 0 时间排序,null或0降序,1升序 0
taskCreateTimeOrder
string × 0 任务创建时间排序,null或0降序,1升序 0

公共响应参数 #

参数 类型 最大长度 描述 示例值
stat JSON - 网关状态(具体参数描述如下:) 查看
stat.cid String 100 http请求的标识符
stat.code String 100 网关返回码
stat.codename String 100 网关返回码名称
stat.systime String Long 接口调用的当前时间
result String 100 接口返回提示信息
data JSON - 接口调用返回的业务信息(一般是json格式数据,具体数据格式会在业务返回参数中定义) 查看

业务返回参数 #

参数名称 类型 是否一定返回 返回最大长度 描述 示例值
isError
boolean × 100 isError isError
data
JSON × 100 返回数据 查看
    
mesageId
int × 0 跳转web的messageId messageId
    
taskHistorySubmitId
int × 0 巡店历史表id 1888
    
evaluationCount
int × 0 检查项总数 100
    
passCount
int × 0 检查项 合格数 10
    
notPassCount
int × 0 不合格数 10
    
totalCount
int × 0 检查项总数 100
    
notWorkCount
int × 0 不适用总数 10
    
problemNum
int × 0 未解决问题数 10
    
totalProblemNum
int × 0 总问题数 10
    
score
int × 0 得分 100
    
totalScore
int × 0 总分 120
    
scorePercentage
int × 0 得分百分比 20
    
liveSeconds
int × 0 有效巡店时长(单位秒) 20
    
timeConsumingMinutes
int × 0 有效巡店时长-单位 分钟,做四舍五入。 2
    
totalDuration
int × 0 任务总时长,单位秒 2
    
totalDurationMinutes
int × 0 巡店总时长,单位分钟,做四舍五入。 2
    
liveMinutes
int × 0 页面停留时长-做了转换 1
    
createTimeDate
int × 0 任务提交时间 2023-07-03 12:00:02
    
createTime
int × 0 任务提交时间(格式:yyyy-MM-dd HH:mm:ss) 2023-07-03 12:00:02
    
finishTimeDate
int × 0 任务完成时间 2023-07-03 12:00:02
    
finishTime
int × 0 任务完成时间(格式:yyyy-MM-dd HH:mm:ss) 2023-07-03 12:00:02
    
deptId
int × 0 门店id 1288
    
shopId
int × 0 店铺ID 888
    
deptName
int × 0 门店名称 test
    
managerShowName
int × 0 店长的显示名称 test
    
isComplete
int × 0 巡店任务状态 0 进行中 1 完成 0
    
userId
int × 0 巡检人id 0
    
userName
int × 0 用户展示名 test
    
signPicUrl
int × 0 巡店签到图片 test
    
signOutPicUrl
int × 0 巡店签退图片 test
    
sourceType
int × 0 1:点检任务,2:摇一摇巡店,4:手动创建问题,7:告警,8:现场巡店,9:远程巡店,10:AI 抓拍比对,11:AI 实时监控,12:门店自检,13:计划巡店中巡店任务的远程巡店,14:计划巡店中巡店任务的现场巡店,15:计划巡店中的巡检计划,17:计划巡店中巡店任务的门店自检 1
    
sourceTypeName
int × 0 类型名称 1
    
taskId
int × 0 巡店任务id 1888
    
taskName
int × 0 巡店任务名称 test
    
pictureCount
int × 0 图片数量 1
    
pictureList
int × 0 图片列表 test
    
organizeName
int × 0 所属区域 1888
    
extraMark
int × 0 额外扣去的分数 10
    
moneyType
int × 0 奖惩类型(0 奖励 1惩罚) 0
    
money
int × 0 奖惩金额 10
    
moneyStr
int × 0 奖惩金额翻译之后的结果:+8 代表 奖励8元 +8
    
templateId
int × 0 模板id 188
    
templateName
string × 0 模板名称 test
    
isInRange
string × 0 是否在范围内签到(null:有开启范围限制,0:不在有效范围内,1:在范围内) null
    
taskCreateTime
string × 0 任务创建时间(格式:yyyy-MM-dd HH:mm:ss)) 2023-07-03 12:00:02
    
taskCreateTimeDate
string × 0 巡店开始时间(任务开始时间) 2023-07-03 12:00:02
    
taskEndTimeDate
string × 0 巡店记录提交时间 2023-07-03 12:00:02
    
approvalTime
string × 0 审核时间 2023-07-03 12:00:02
    
summary
string × 0 巡店总结 test
    
appendixContent
string × 0 附录内容 test
    
uuidStatusInt
int × 0 手机标识(1正常/0异常) 1
    
uuid
string × 0 手机唯一标识码 1333
    
companyIdStr
string × 0 陪同人ID ","分割 test,test
    
companyNameStr
string × 0 陪同人展示名称 ","分割 test,test
    
onSiteUserId
int × 0 现场责任人id 1888
    
onSiteUserName
string × 0 现场责任人展示名 test
    
sketchyScore
int × 0 总得分 100
    
resultEvaluate
int × 0 巡店结果评价 100
    
evaluateContent
string × 0 评价内容 test
    
planTypeName
string × 0 计划类型(巡店任务、巡检计划、临时) test
    
depOrganizeLeaders
string × 0 门店上级组织结构负责人(小周/.../小杨) test
    
deptOrgStructure
string × 0 门店所属组织架构层级 1888
    
approveType
int × 0 审核方式:1:无需审批,4:人工审批、5:自动审批 1
    
approveTypeStr
string × 0 审核方式名称(无需审批、人工审批、自动审批) test
    
approveDuration
int × 0 审核时长,单位秒 20
    
approveDurationStr
string × 0 审核时长:X天X小时X分X秒 test
    
approver
string × 0 审核人。多审核人逗号隔开 test,test
    
roles
string × 0 角色 test
    
isCreateInRange
string × 0 签到是否在范围内 1
    
losePoint
int × 0 失分:总分-得分 110
    
templateEvaluation
string × 0 模板评价:1-优秀 2-合格 3-不合格 1
    
templateEvaluationStr
string × 0 模板评价 test
    
highEvaluationNamesStr
string × 0 优先级高的不合格点检项name集合 test
    
highPriorityUnqualifiedItems
string × 0 优先级高的不合格点检项 test
    
middleEvaluationNamesStr
string × 0 优先级中的不合格点检项name集合 test
    
middlePriorityUnqualifiedItems
string × 0 优先级中的不合格点检项 test
    
lowEvaluationNamesStr
string × 0 优先级低的不合格点检项name集合 test
    
lowPriorityUnqualifiedItems
string × 0 优先级低的不合格点检项 test
    
supervision
string × 0 督导 test
    
regionalManager
string × 0 区域经理 test
    
departureTimes
int × 0 离场次数 2
    
departmentType
int × 0 门店类型 1
    
lightspotSharedNum
int × 0 亮点分享次数 1
    
highPriorityUnqualifiedItemsNames
string × 0 优先级高的不合格点检项名称集合 test
    
middlePriorityUnqualifiedItemsNames
string × 0 优先级中的不合格点检项名称集合 test
    
lowPriorityUnqualifiedItemsNames
string × 0 优先级低的不合格点检项名称集合 test
    
commentScore
int × 0 巡店评分 1.0
    
commentContent
string × 0 巡店评论 测试

公共返回码 #

返回码名称 返回码 返回码描述 解决方案
SUCCESS 0 调用成功
KEY_NOTNULL 1 _akey和不能为空 接口调用时传入_akey参数
KEY_UNLAWFUL 2 _akey不合法 key是非法的,传入正确的key
KEY_HAS_EXPIRED 3 _akey已过期 请续订服务或联系平台管理人员
SIGN_METHOD_NOTNULL 4 _sm参数不能为空 接口调用时传入_sm参数
SIGN_TYPE_NOTEXIST 5 _sm类型不存在 目前仅支持md5,sha1
SIGN_NOTNULL 6 _sig参数不能为空 接口调用时传入_sig参数
SIGN_WRONG 7 无效的签名,请检查参数和签名格式 _sig值根据签名算法生成
METHOD_NOTNULL 8 _mt参数不能为空 接口调用时传入_mt参数
METHOD_NOTEXIST_CODE 9 _mt对应的方法名不存在或未注册进服务 检查_mt方法名和_version版本号对应的方法是否传入错误
REQUESTMODE_NOTNULL 10 _requestMode参数不能为空 接口调用时传入_requestMode参数
APPLICATIONID_NOTNULL 11 _aid参数不能为空 接口调用时传入_aid参数
APPLICATIONID_NOTSAME 12 _aid与当前key不匹配 _aid与_akey必须一一对应
VERSION_NOTNULL 13 _version版本号不能为空 接口调用时传入_version参数
TIMESTAMP_NOTNULL 14 _timestamp时间戳不能为空 接口调用时传入_timestamp参数
TIMESTAMP_FORMAT_ERROR 15 _timestamp时间戳格式化错误 按照yyyyMMddHHmmss格式
TIMESTAMP_OVERTIME 16 _timestamp已失效 _timestamp每次接口调用时重新生成
FORMAT_TYPE_NOTEXIST 17 _format类型不存在 目前仅支持json(默认),xml
API_CALL_REPEAT -100 接口重复调用 接口平台调用异常
API_SYSTEM_CALL_ERROR -500 api调用失败,系统发生异常 接口平台调用异常
UNKNOWN_ERROR -999 开放平台系统异常 重新发起请求

业务返回码 #

返回码名称 返回码 返回码描述
code
code code