open.shopweb.crm.getConstructionOrderInfo （获取施工单详情）

获取施工单详情

接口描述#

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

公共请求参数#

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

业务请求参数#

参数	类型	是否必填	最大长度	描述	示例值
orderNo	string	√	11	施工单号

公共响应参数#

参数	类型	最大长度	描述	示例值
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格式数据，具体数据格式会在业务返回参数中定义)	查看

业务返回参数#

参数名称	类型	是否一定返回	返回最大长度	描述	示例值
data	JSON	×	11	返回data	查看
id	int	×	0	施工单id
orderNo	string	×	0	施工单编号
groupId	int	×	0	企业id
groupName	string	×	0	企业名称
deliveryAfterName	string	×	0	交付/售后名称
deliveryAfterPhone	string	×	0	交付/售后电话
deptName	string	×	0	门店名称
deptAddress	string	×	0	施工地址
deptContacts	string	×	0	施工联系人
contactNumber	string	×	0	施工联系电话
shopAddress	string	×	0	行政区划
expectedDoorTime	string	×	0	期望上门施工时间
serviceDescription	string	×	0	施工要求(服务内容描述)
attachmentList	JSON	×	0	施工资料列表	查看
filename	string	×	0	附件名称
fileurl	string	×	0	附件名称
filetype	string	×	0	附件类别
suffix	string	×	0	文件后缀
attachId	string	×	0	关联Id
checkDocList	JSON	×	11	验收资料列表	查看
id	int	×	0	验收项目id
serialNo	string	×	0	序号
projectName	string	×	0	验收项目名称
required	string	×	0	是否必传(0:必传,1:非必传)
remark	int	×	0	备注
field_8	int	×	0	至少上传数量
attachmentList	JSON	×	0	示例验收资料列表(同验收文件列表)	查看
id	int	×	0
filename	string	×	0	附件名称
fileurl	string	×	0	附件url
filetype	string	×	0	附件类别
suffix	string	×	0	文件后缀
acceptanceAttachmentList	JSON	×	0	验收文件列表	查看
id	int	×	0	id
filename	string	×	0	附件名称
fileurl	string	×	0	附件url
filetype	string	×	0	附件类别
suffix	string	×	0	文件后缀
createTime	string	×	0	创建时间
createBy	string	×	0	创建人
templateId	string	×	0	模板id
receiverList	JSON	×	11	快递信息列表	查看
receiver	string	×	0	收件人
phoneNo	string	×	0	收件人手机号
logistics	string	×	0	物流公司
expressNo	string	×	0	快递单号
productModelList	JSON	×	0	合同产品列表	查看
productId	int	×	0	产品id
productName	string	×	0	产品名称
materialCoding	string	×	0	物料编码
quantity	int	×	0	数量
unit	string	×	0	单位
remark	string	×	0	备注
productTypeId	string	×	0	产品分类id
typeName	string	×	0	产品分类名称
id	int	×	0	主键
serviceOrderId	string	×	0	服务单id
maxQuantity	string	×	0	最大数量
contractNos	string	×	0	合同编码集合
constructionStatus	string	×	0	施工状态（4-施工完成，5-验收失败）
deptNumber	string	×	0	客户门店编码
demandNumber	int	×	0	客户需求单号
pmPhone	string	×	0	项目经理手机号
pmName	string	×	0	项目经理姓名
closingDescription	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	0	success