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

open.shopweb.liveCheck.statisticsDetailPageForCustomer (巡店报表详情)

这个接口主要功能是获取用户巡店报表相关信息,主要包括巡店人信息、巡店类型、创建时间、门店信息、问题状态、分数、细则、检查项信息、问题有效期、奖惩金额类型、金额、倒扣分、问题整改图片或整改视频等。sourceTypes: * 1.点检任务 * 2.摇一摇巡店 * 3.图片抓拍 * 4.手动创建问题 * 6.快拍 * 7.告警 * 8.现场巡店 * 9.远程巡店 * 10.AI 抓拍比对 * 11.AI 实时监控 * 12.门店自检 * 13.计划巡店中巡店任务的远程巡店 * 14.计划巡店中巡店任务的现场巡店 * 15.计划巡店中的巡检计划 * 16.小鸟探店 * 17.计划巡店中巡店任务的门店自检

接口描述#

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

公共请求参数#

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

业务请求参数#

参数类型是否必填最大长度描述示例值
pageNumber
int11页码1
pageSize
int11每页显示的条数20
enterpriseId
int11企业id1084
startTime
string100开始时间2021-01-03
endTime
string100结束时间2021-03-23
sourceTypes
string×100检查方式,多个逗号隔开(1:点检任务,2:摇一摇巡店,4:手动创建问题,7:告警,8:现场巡店,9:远程巡店,10:AI 抓拍比对,11:AI 实时监控,12:门店自检,13:计划巡店中巡店任务的远程巡店,14:计划巡店中巡店任务的现场巡店,15:计划巡店中的巡检计划,17:计划巡店中巡店任务的门店自检)1,2,3
templateIds
string×0模板1,3,4
deptNode
string×0组织架构ID(门店以S_开头)S_123
userIds
string×0巡店人ids,多个逗号隔开1,2
problemClassifyIds
string×0点检项ID,多个逗号隔开1,2
openStatus
string×0门店状态0.准备中,1.营业,2.闭店0
commitTimeStart
string×0提交开始时间2022-04-06 10:56:59
commitTimeEnd
string×0提交结束时间2022-04-06 10:56:59
checkStartTimeStart
string×0巡店开始时间2022-04-06 10:56:59
approvalTimeStart
string×0审核开始时间2022-04-06 10:56:59
approvalTimeEnd
string×0审核结束时间2022-04-06 10:56:59

公共响应参数#

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

业务返回参数#

参数名称类型是否一定返回返回最大长度描述示例值
total
int×11数据总数0
data
JSON×0数据查看
    
bh
string×0编号111
    
deptId
string×0门店id123
    
shopId
string×0第三方店铺id测试门店
    
organizeName
string×0组织架构名称 1888
    
deptName
string×0门店名称 测试
    
managerOfDept
string×0门店店长 测试
    
templateName
string×0模板测试
    
parentEvaluationName
string×0检查项分类名称 测试
    
evaluationName
string×0检查项名称测试
    
allDetailRuleString
string×0细则 测试
    
detailedRuleNames
string×0违反细则测试
    
status1
string×0结果100
    
mark
int×0得分20
    
evaluationScore
int×0点检项标准分 100
    
money
int×0奖惩金额 50
    
ruleDescription
string×0计分规则 测试
    
extraMark
string×0倒扣分 15
    
description
string×0描述测试
    
problemPicList
JSON×0问题图片 查看
    
picList
JSON×0图片查看
        
problemId
string×0testtest
        
path
string×0testtest
        
pictureName
string×0testtest
        
picId
int×0testtest
        
attachType
int×0testtest
        
url
int×0testtest
        
size
int×0testtest
        
videoTime
int×0testtest
        
aICheckContents
int×0testtest
        
aiPic
boolean×0testtest
    
reformPicList
JSON×0整改后的图片 查看
    
presetName
string×0场景名称 测试
    
updateTime
string×0已完成时间2023-07-03 12:00:00
    
checkStartTime
string×0巡店开始时间 2023-07-03 12:00:00
    
createTime
string×0考核时间2023-07-03 12:00:00
    
commitTime
string×0提交时间 2023-07-03 12:00:00
    
approvalTime
string×0审核时间 2023-07-03 12:00:00
    
isInvalid
boolean×0问题状态(1 已过期 0 未过期) 1
    
status2
string×0流程状态( 3:待复检,4:整改完成 ,5:待整改) 3
    
sourceTypeName
string×0检查形式 test
    
planTypeName
string×0计划类型(巡店任务、巡检计划、临时) 测试
    
rectifierName
string×0整改人名称 可能多整改人 用“|”隔开 测试
    
showName
string×0检查人名称 测试
    
roles
string×0检查人角色 测试
    
originName
string×0所属部门 测试
    
sourceType
string×0test测试
    
moneyType
string×0奖惩类型,0:奖励,1:处罚 1
    
allRules
string×0检查项所有的细则 测试
    
evaluationId
string×0检查项id 测试
    
checktaskId
int×0巡店任务id 111
    
templateId
int×0模板id 111
    
supervision
string×0督导 测试
    
regionalManager
string×0区域经理 测试

公共返回码#

返回码名称返回码返回码描述解决方案
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
0