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

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

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

接口描述#

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

公共请求参数#

参数类型是否必填最大长度描述示例值
_aidString20开放平台系统编号,固定为S107S107
_akeyString20万店掌开放平台分配给第三方的开发者key认证平台开发者后获取
_mtString100接口名称open.shopweb.liveCheck.task.statisticsPageOfTask
_smString100签名算法 md5,sha1md5
_requestModeString100请求方式post,getPOST
_versionString100版本号v1
_timestampString100时间戳yyyyMMddHHmmss格式
_sigString32签名token根据签名算法生成,详情见签名算法规则
_formatString10format类型目前默认仅支持json

业务请求参数#

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

公共响应参数#

参数类型最大长度描述示例值
statJSON-网关状态(具体参数描述如下:)查看
stat.cidString100http请求的标识符
stat.codeString100网关返回码
stat.codenameString100网关返回码名称
stat.systimeStringLong接口调用的当前时间
resultString100接口返回提示信息
dataJSON-接口调用返回的业务信息(一般是json格式数据,具体数据格式会在业务返回参数中定义)查看

业务返回参数#

参数名称类型是否一定返回返回最大长度描述示例值
isError
boolean×100isErrorisError
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巡检人id0
    
userName
int×0用户展示名 test
    
signPicUrl
int×0巡店签到图片 test
    
signOutPicUrl
int×0巡店签退图片 test
    
sourceType
int×01:点检任务,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

公共返回码#

返回码名称返回码返回码描述解决方案
SUCCESS0调用成功
KEY_NOTNULL1_akey和不能为空接口调用时传入_akey参数
KEY_UNLAWFUL2_akey不合法key是非法的,传入正确的key
KEY_HAS_EXPIRED3_akey已过期请续订服务或联系平台管理人员
SIGN_METHOD_NOTNULL4_sm参数不能为空接口调用时传入_sm参数
SIGN_TYPE_NOTEXIST5_sm类型不存在目前仅支持md5,sha1
SIGN_NOTNULL6_sig参数不能为空接口调用时传入_sig参数
SIGN_WRONG7无效的签名,请检查参数和签名格式_sig值根据签名算法生成
METHOD_NOTNULL8_mt参数不能为空接口调用时传入_mt参数
METHOD_NOTEXIST_CODE9_mt对应的方法名不存在或未注册进服务检查_mt方法名和_version版本号对应的方法是否传入错误
REQUESTMODE_NOTNULL10_requestMode参数不能为空接口调用时传入_requestMode参数
APPLICATIONID_NOTNULL11_aid参数不能为空接口调用时传入_aid参数
APPLICATIONID_NOTSAME12_aid与当前key不匹配_aid与_akey必须一一对应
VERSION_NOTNULL13_version版本号不能为空接口调用时传入_version参数
TIMESTAMP_NOTNULL14_timestamp时间戳不能为空接口调用时传入_timestamp参数
TIMESTAMP_FORMAT_ERROR15_timestamp时间戳格式化错误按照yyyyMMddHHmmss格式
TIMESTAMP_OVERTIME16_timestamp已失效_timestamp每次接口调用时重新生成
FORMAT_TYPE_NOTEXIST17_format类型不存在目前仅支持json(默认),xml
API_CALL_REPEAT-100接口重复调用接口平台调用异常
API_SYSTEM_CALL_ERROR-500api调用失败,系统发生异常接口平台调用异常
UNKNOWN_ERROR-999开放平台系统异常重新发起请求

业务返回码#

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