文档中心 > API类目 > 菜鸟末端商业

qimen.cainiao.cntec.locallife.communitylife.pushorder (社区服务工厂订单新增)

社区服务新增订单时，需要向工厂发送订单新增信息

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	描述
orderType	String	必须	安装维修	工单业务类型
brandName	String	必须	厂商品牌	品牌
orderNo	String	必须	hq20180518_001	厂商工单号
data	OrderDataReqDTO	必须		工单业务节点业务数据
└ orderType String 必须 PT 工单类型 └ city String 必须青岛市城市 └ reportUnit String 可选 xxx 保修单位 └ companyName String 必须京东方厂商名称 └ appointTimeRange String 可选上午预约时间范围 └ appointDate String 可选 2018-03-22 预约时间 └ projectOrderNo String 可选 xxx 工程单主单号 └ customerPhone String 必须 17660624163 联系电话 └ customerType String 可选 0 客户类别 └ province String 必须山东省省份 └ machineBuyDate String 可选 2017-03-15 购机日期 └ guaranteeMode String 可选 0 保修方式 └ productSeries String 可选电视产品系列 └ brand String 必须京东方品牌 └ appointInstallDate String 可选 xxx 预约装送时间 └ machineType String 可选 0 机器类型 └ customerServiceType String 必须维修客户要求服务类型 └ customerAddress String 必须延安三路202号乙客户地址 └ machineBuyWay String 可选 1 渠道 └ orderNo String 必须 hq20180518_001 厂商工单号 └ oprFlag String 必须 1 操作标识 └ ifProjectOrder String 必须 0 工程单标识 └ problemDescription String 可选屏幕不亮反映问题描述 └ middleProductType String 可选家用电视产品中类 └ remark String 可选备注工单备注 └ customerName String 必须刘先生客户姓名 └ machineBuyMall String 可选利群购买商场 └ dispatchTime String 必须 2018-03-21 16:09:23 厂商工单派工时间 └ guaranteeEndDate String 可选 2018-03-15 截至保修日期 └ guaranteeType String 可选 2 保修类型 └ bigProductType String 必须电视产品大类 └ customerServiceMode String 可选登门维修客户要求服务方式 └ customerSparePhone String 可选 0538-2712011 其他电话 └ region String 必须市南区区县 └ productModelVersion String 可选 48PFF5071/T3 产品型号、版本 └ expectDate String 必须 2018-03-22 期望上门日期 └ customerRemark String 可选 xxx 用户备注 └ productRemark String 可选 xxx 产品备注 └ deliveredFinishDate String 可选 2018-03-21 16:09:23 物流妥投时间
orderNode	String	必须	厂商工单推送	工单业务节点
companyName	String	必须	厂商名称	厂商

响应参数

名称	类型	示例值	描述
errMsg	String	""	错误信息
status	String	1	错误编码
success	Boolean	false	调用是否成功

请求示例

{"orderType":"安装维修","brandName":"厂商品牌","orderNo":"hq20180518_001","data":{"orderType":"PT","city":"青岛市","reportUnit":"xxx","companyName":"京东方","appointTimeRange":"上午","remark":"备注","appointDate":"2018-03-22","projectOrderNo":"xxx","customerPhone":"17660624163","customerType":"0","province":"山东省","machineBuyDate":"2017-03-15","guaranteeMode":"0","productSeries":"电视","brand":"京东方","appointInstallDate":"xxx","machineType":"0","customerServiceType":"维修","customerAddress":"延安三路202号乙","machineBuyWay":"1","orderNo":"hq20180518_001","customerRemark":"xxx","oprFlag":"1","ifProjectOrder":"0","problemDescription":"屏幕不亮","middleProductType":"家用电视","productRemark":"xxx","deliveredFinishDate":"2018-03-21 16:09:23","customerName":"刘先生","machineBuyMall":"利群","dispatchTime":"2018-03-21 16:09:23","guaranteeEndDate":"2018-03-15","guaranteeType":"2","bigProductType":"电视","customerServiceMode":"登门维修","customerSparePhone":"0538-2712011","region":"市南区","productModelVersion":"48PFF5071/T3","expectDate":"2018-03-22"},"orderNode":"厂商工单推送","companyName":"厂商名称"}

响应示例

{
    "errMsg":"\"\"",
    "status":"1",
    "success":false
}

验签示例

{"success":"false","errMsg":"Illegal request","status":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

菜鸟末端商业

qimen.cainiao.cntec.locallife.communitylife.pushorder (社区服务工厂订单新增)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ