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

qimen.tmall.alihouse.trade.nhchannel.ordernotice (新房渠道履约单信息通知etc)

新房项目店和新房渠道共用一个奇门接口去通知etc,履约单状态变更

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
orderId Number 必须 123 履约单ID
tpOrderId Number 必须 1234 淘宝订单ID
originalAmount Number 必须 1000 订单金额
status Number 必须 10 10-待支付(创单) 20-确认中(付款成功) 30-待核销(确客或签约完成) 40-交易成功(核销完成) 50-订单关闭(取消订单/售中退款)
discountAmount Number 必须 1002 订单优惠金额
actualAmount Number 可选 998 实际付款金额
refundStatus Number 必须 10 0-未发生退款(撤销退款 或 无退款 的状态展示) 10 - 退款中 (商家审核中的状态展示) 20 - 退款成功 (商家同意退或者小二介入同意退) 30 - 退款拒绝(卖家拒绝退款) 40 - 退款关闭(小二介入拒绝退款)
refundOrderId Number 可选 100023 淘宝逆向订单ID
createTime Number 必须 2323 创建时间(时间戳)
refundTime Number 可选 2324 退款完成时间
payTime Number 可选 123 支付完成时间
finishTime Number 可选 124 交易完成时间
modifyTime Number 必须 125 状态修改时间
checkCustomerStatus Number 可选 10 0-不需要确客 10-待确客 20-确客通过 30-确客不通过
checkCustomerStartTime Number 可选 11 确客开始时间(时间戳)
checkCustomerEndTime Number 可选 123 确客结束时间(时间戳)
checkCustomerDeadLineTime Number 可选 125 确客截止时间(时间戳,毫秒数)
checkCustomerType Number 可选 1 0-系统 1-人工
checkCustomerRejectReason String 可选 xx 确客拒绝原因
outerId String 可选 afbccc 商家outerId
buyerOpenId String 可选 1232xxx 买家账号ID脱敏
bizScenarios String 可选 aliestate_deposit 业务场景
tradeNo String 可选 2022041710060006422245266328 统一订单号
projectStoreId Number 可选 202204 外部项目店
projectStoreName String 可选 新房项目店 项目店名
controlBuy Number 可选 1 是否需要异步销控, 1-需要异步销控 0-不需要异步销控
houseAmount String 可选 99999 房源总价
houseFavorabeAmount Number 可选 99991 房源优惠后价格
prepayAmount Number 可选 1000 预存金支付金额
buildingNo String 可选 21 楼栋号
buildingUnitNo String 可选 1 单元号
roomNo String 可选 4 房号
itemId Number 可选 1445532 天猫商品id
skuId Number 可选 2345232 商品SkuId
projectId Number 可选 1334553 外部楼盘id
sellerId Number 可选 123454321 卖家id
controlBuyStartTime Number 可选 123456765432 销控发起时间(时间戳,毫秒数)
controlBuyEndTime Number 可选 23454323456543 销控结束时间(时间戳,毫秒数)
controlBuyType Number 可选 0 销控方式
controlBuyRemark String 可选 拒绝销控 商家销控拒绝原因或者同意原因
controlBuyStatus Number 可选 0 销控状态 0-未确认 1-已确认 2-拒绝 20-超时取消
refundType Number 可选 0 退款方式
deadLineTime Number 可选 123456789876 核销有效期(核销截止时间)
identifyCode String 可选 FUF2DH3K 核销码
controlBuyDeadLineTime Number 可选 111234567654 销控截止时间(时间戳,毫秒数)
buyUserInfoDTOList BuyUserInfoDTO [] 可选
  • 最大列表长度:999
  • 买家真实姓名 买家手机号 买家证件号 买家证件类型 Integer 购房人类型 1 主购房人 2 次购房人 3 代购买人 Integer 购房人类型 1 主购房人 2 次购房人 3 代购买人
    • └ self
    • String
    • 可选
    • 1
    • 是否是本人
    • └ userType
    • String
    • 可选
    • 1
    • 购房人类型 1-主购房人 2-次购房人 3-代购买人
    • └ buyerCardType
    • String
    • 可选
    • 1
    • 身份证号
    • └ buyerCardNo
    • String
    • 可选
    • 500231199711151485
    • 买家证件号
    • └ buyerPhone
    • String
    • 可选
    • 18875220832
    • 买家手机号
    • └ buyerRealName
    • String
    • 可选
    • 代艳梅
    • 买家真实姓名
    contractType Number 可选 1 签约类型,1线上签约 2线下签约
    contractId Number 可选 234455 合同id
    payTool String 可选 ALIPAYACCOUNT 支付工具

    响应参数

    名称 类型 示例值 描述
    status Number 1 成功标志,1-成功,0-失败
    qmCode Number 200 返回码200成功,非200失败
    qmMsg String success 返回信息
    data Boolean true 返回信息

    请求示例

    {"buyUserInfoDTOList":[{"buyerPhone":"18875220832","buyerCardNo":"500231199711151485","self":"1","userType":"1","buyerRealName":"代艳梅","buyerCardType":"1"}],"orderId":123,"payTime":123,"contractType":1,"deadLineTime":0,"discountAmount":1002,"checkCustomerRejectReason":"xx","modifyTime":125,"sellerId":123454321,"controlBuy":1,"buildingNo":"21","controlBuyStartTime":0,"controlBuyDeadLineTime":0,"skuId":2345232,"finishTime":124,"tradeNo":"2022041710060006422245266328","roomNo":"4","tpOrderId":1234,"buildingUnitNo":"1","checkCustomerStatus":10,"checkCustomerEndTime":123,"refundOrderId":100023,"controlBuyStatus":0,"itemId":1445532,"bizScenarios":"aliestate_deposit","houseAmount":"99999","projectId":1334553,"controlBuyEndTime":0,"status":10,"controlBuyRemark":"拒绝销控","checkCustomerStartTime":11,"refundStatus":10,"houseFavorabeAmount":99991,"refundType":0,"prepayAmount":1000,"checkCustomerType":1,"buyerOpenId":"1232xxx","refundTime":2324,"actualAmount":998,"payTool":"ALIPAYACCOUNT","originalAmount":1000,"createTime":2323,"projectStoreId":202204,"contractId":234455,"outerId":"afbccc","projectStoreName":"新房项目店","identifyCode":"FUF2DH3K","controlBuyType":0,"checkCustomerDeadLineTime":125}

    响应示例

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

    验签示例

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

    错误码解释

    错误码 错误描述 解决方案

    API工具

    FAQ

    返回
    顶部