万店掌 开放平台 巡店记录详情页

open.shopweb.liveCheck.getNewProfile (巡店记录详情页)

巡店记录详情页

接口描述#

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

公共请求参数#

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

业务请求参数#

参数类型是否必填最大长度描述示例值
historyId
string11取“已完成记录列”表中的taskHistorySubmitId字段123456

公共响应参数#

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

业务返回参数#

参数名称类型是否一定返回返回最大长度描述示例值
data
JSON×11返回json体查看
    
summary
string×0巡店总结JSON格式
    
cc
JSON×0抄送人ID集合查看
    
data
JSON×0data查看
        
deptId
int×0门店ID
        
deptName
string×0门店名称
        
deptArea
string×0门店区域
        
deptManager
string×0店长
        
shopId
string×0shopId
        
reportType
int×0巡店类型:1-点检, 8-现场巡店, 14-现场(巡店任务), 15-现场(巡检计划), 9-远程巡店, 13-远程(巡店任务), 21-远程(巡检计划),12-门店自检、17-门店自检(巡店任务),21:巡检计划-远程巡店
        
createrId
int×0巡店人ID
        
createrName
string×0巡店人名称
        
cooperatorNames
string×0协同巡店人员集合
        
reviewTime
string×0审核时间
        
reviewer
string×0审核人
        
endTime
string×0提交时间
        
createTime
string×0开始时间
        
evaluationCount
int×0检查项数
        
passCount
int×0合格数
        
notPassCount
int×0不合格数
        
notWorkCount
int×0不适用数
        
scoreRate
int×0得分率
        
totalScore
int×0总分
        
sketchyScore
int×0得分
        
scoreStr
int×0extraScore
        
moneyType
int×0奖惩类型:0 奖励钱 1 扣钱
        
money
int×0金额
        
companyName
string×0陪同人
        
stayTime
string×0页面停留时长
        
allTime
string×0总时长
        
isInRange
int×0提交范围 1:范围内 0:范围外
        
templateName
string×0模板名
        
templateId
int×0模板id
        
taskId
int×0任务id
        
onSiteUserId
int×0现场责任人
        
onSiteUserName
int×0现场责任人展示名
        
showOnSiteUser
int×0是否显示现场责任人 0-不显示, 1-显示
        
realCreator
string×0实际巡店人
        
resultEvaluate
int×0巡店结果评价ID
        
evaluateContent
string×0评价内容
        
planName
string×0计划巡店或巡检任务名
        
showCreator
int×0是否显示巡店人
        
templateEvaluationStr
string×0模板评价:1-优秀 2-合格 3-不合格
        
color
int×0color
        
locationList
string×0巡店过程中,中途定位记录【集合】
        
returnScore
int×0返还分
        
returnScoreRate
int×0返还分得分率
        
revertScoreDisplay
int×0
        
redudenceScore
int×0
        
inspectionItemQualifiedPercentage
int×0
    
signInOut
JSON×0object 签到签退信息查看
        
taskId
int×0巡店任务ID
        
signInAddress
string×0签到地址
        
signInPicUrl
string×0签到图片
        
signInPicId
string×0签到图片id
        
signInTime
string×0签到时间
        
signInInRange
int×0签到时,是否超出范围:0:不在有效范围内,1:在范围内
        
signOutPicUrl
string×0签退图片地址
        
signOutAddress
string×0签退地址
        
signOutTime
string×0签退时间
        
signOutInRange
int×0签退时,是否超出范围:0:不在有效范围内,1:在范围内
        
signOut
boolean×0是否有签退信息
        
signIn
boolean×0是否有签到信息
    
approveDetail
int×0附录内容,字符串
        
userId
int×0审核人ID
        
userName
string×0审核人展示名
        
isApproved
int×0审核状态:1 人工已审, 0 人工未审
        
createTime
string×0审核时间
        
updateTime
string×0updateTime
        
isAuto
int×0是否是自动通过(1 :自动通过 ,0: 非自动)
        
reject
boolean×0是否失效
        
operate
int×0操作:1:审核通过,2:失效
        
reason
int×0原因
        
reviewerSignUrl
string×0审核人签名图片Url
        
pics
string×0pics
    
sign
JSON×0object 签名信息查看
        
id
int×0签名信息
        
taskId
int×0
        
inspectorPicUrl
string×0
        
managerPicUrl
string×0店长签名图片url
        
shiplogUrl
int×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
0success