文档中心 > API类目 > 天猫好房交易API

qimen.tmall.alihouse.trade.coupon.notice.order.info (通知etc履约单信息)

通知etc测商家进行电商券的审核

公共参数

请求地址：

环境	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输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
tradeOrderInfo	TradeOrderInfo	必须			履约单信息
└ id Number 必须 100 履约单id └ status Number 必须 10 10-初始化 20-签约中 25-待支付 30-支付中 40-未使用 50-结算中 88-履约完成(已使用） 99-关闭 └ statusDesc String 必须初始化状态描述 └ name String 可选张三姓名 └ phone String 可选 18868878788 手机号 └ cardType Number 可选 1 证件类型： 1-身份证 └ cardNo String 可选 330324199909190309 身份证号 └ alipayAccountId String 可选 123123 支付宝账号id └ tbOrderId String 可选 123 淘宝订单id └ contractOrderId Number 可选 123123 签约单id └ couponCode String 可选 123 核销码 └ itemId String 必须 123123 skuId cancelNode HouseCouponCancel 可选取消节点 └ operatorType Number 可选 1 * 操作人类型 * 0-系统 * 1-用户 └ cancelNode Number 可选 1 * 取消节点 11-下单节点 12-核销节点 └ status Number 可选 1 * 状态： * 0 - 待审核 * 10 - 审核成功 * 20 - 取消成功 * 30 - 审核拒绝 * 40 - 取消关闭 └ statusDesc String 可选待审核状态描述 └ cancelRemark String 可选取消取消原因 └ startTime String 可选 2021-07-21 12:00:00 开始时间 └ cancelDeadlineTime String 可选 2021-07-21 12:00:00 取消截止时间 └ finishTime String 可选 2020-09-01 12:00:00 完结时间 └ skuId String 必须 123 skuId └ payTool String 可选支付宝支付方式 └ orderNo String 必须 1000 对外编号

响应参数

名称	类型	示例值	描述
qmCode	String	200	奇门code
qmMsg	String	成功	奇门消息
status	Number	1	奇门状态
data	Boolean	true	通知成功标识

请求示例

{"tradeOrderInfo":{"tbOrderId":"123","finishTime":"2020-09-01 12:00:00","statusDesc":"初始化","orderNo":"1000","cardType":1,"alipayAccountId":"123123","cardNo":"330324199909190309","payTool":"支付宝","itemId":"123123","cancelNode":{"cancelNode":1,"statusDesc":"待审核","cancelDeadlineTime":"2021-07-21 12:00:00","startTime":"2021-07-21 12:00:00","operatorType":1,"cancelRemark":"取消","status":1},"phone":"18868878788","contractOrderId":123123,"name":"张三","id":100,"couponCode":"123","skuId":"123","status":10}}

响应示例

{
    "qmCode":"200",
    "qmMsg":"成功",
    "status":1,
    "data":true
}

验签示例

{"qmCode":"sign-check-failure","qmMsg":"Illegal request","status":"不等于1"}

错误码解释

错误码	错误描述	解决方案
isp.http-read-timeout

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

淘宝开放平台

天猫好房交易API

qimen.tmall.alihouse.trade.coupon.notice.order.info (通知etc履约单信息)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ