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

tmall.alihouse.trade.order.second.house.operate (租房资金存管项目,etc发起邀约,修改邀约)

租房资金存管项目,etc发起邀约,修改邀约

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
operate_request SecondHandOrderOperateRequest 必须 入参
  • └ source
  • String
  • 可选
  • LIANGCE_TRADE_CENTER
  • 来源,发起邀约必填
  • └ source_no
  • String
  • 可选
  • xxx
  • 案件号,发起邀约必填
  • └ operate_type
  • String
  • 必须
  • CREATE
  • 操作类型,CREATE-发起邀约,MODIFY-修改邀约
  • └ house_order_no
  • String
  • 可选
  • 2023xxx
  • 订单号,修改时必填
  • └ item_id
  • Number
  • 可选
  • 1022
  • 服务商品ID,发起邀约必填
  • └ store_id
  • Number
  • 可选
  • 10223
  • 门店ID
  • buyer_infos
  • UserInfoDTO []
  • 可选
  • []
  • 买家信息集合
  • └ name
  • String
  • 必须
  • 张三
  • 姓名
  • └ cert_type
  • Number
  • 必须
  • 1
  • 证件类型,1-身份证
  • └ card_no
  • String
  • 必须
  • 420xxx
  • 证件号码
  • └ phone
  • String
  • 可选
  • 186xxx
  • 手机号
  • └ address
  • String
  • 可选
  • 浙江省xxx
  • 联系地址
  • └ out_id
  • String
  • 必须
  • 12323
  • 外部ID
  • └ buyer_phone
  • String
  • 可选
  • 186xxx
  • 买家联系手机号
  • └ buyer_address
  • String
  • 可选
  • 浙江省xx
  • 买家联系地址
  • landlord_infos
  • UserInfoDTO []
  • 可选
  • []
  • 房东信息集合
  • └ name
  • String
  • 必须
  • 张三
  • 姓名
  • └ cert_type
  • Number
  • 必须
  • 1
  • 证件类型,1-身份证
  • └ card_no
  • String
  • 必须
  • 420xxx
  • 证件号码
  • └ phone
  • String
  • 可选
  • 186xx
  • 手机号
  • └ address
  • String
  • 可选
  • 浙江省xx
  • 联系地址
  • └ out_id
  • String
  • 必须
  • 12323
  • 外部ID
  • └ landlord_phone
  • String
  • 可选
  • 186xxx
  • 房东联系手机号
  • └ landlord_address
  • String
  • 可选
  • 浙江省xx
  • 房东联系地址
  • └ house_address
  • String
  • 可选
  • 浙江省xx
  • 房源地址,发起邀约必填
  • └ house_province
  • String
  • 可选
  • 101
  • 房源所在省code
  • └ house_city
  • String
  • 可选
  • 102
  • 房源所在市code
  • └ house_province_city_desc
  • String
  • 可选
  • 浙江省xx
  • 房源所在省市区描述
  • └ deed_record_number
  • String
  • 可选
  • A2023xx
  • 房产证件备案编号
  • └ deed_record_pics
  • String
  • 可选
  • http://xxx
  • 房产证件凭证
  • └ construction_area
  • String
  • 可选
  • 120
  • 建筑面积
  • └ cover_area
  • String
  • 可选
  • 110
  • 套内面积
  • └ house_deal_price
  • Number
  • 可选
  • 100000000
  • 房成交总额(单位分)
  • └ deposit_amount
  • Number
  • 可选
  • 10000000
  • 定金金额(单位分)
  • └ first_pay_amount
  • Number
  • 可选
  • 30000000
  • 首付金额(单位分)
  • └ loan_amount
  • Number
  • 可选
  • 60000000
  • 贷款金额(单位分)
  • └ final_pay_amount
  • Number
  • 可选
  • 0
  • 尾款金额(单位分)
  • └ service_fee_amount
  • Number
  • 可选
  • 100000
  • 服务费金额(单位分)
  • └ has_mortgage
  • String
  • 可选
  • Y
  • 是否有抵押,Y-是,N-否
  • └ has_lease
  • String
  • 可选
  • N
  • 是否有租赁,Y-是,N-否
  • └ delivery_deposit_amount
  • Number
  • 可选
  • 1000
  • 物业交割保证金金额(单位分)
  • └ house_support_equipment_price
  • Number
  • 可选
  • 2000
  • 房屋配套作价
  • └ house_support_remark
  • String
  • 可选
  • xxx
  • 房屋配套设备说明
  • └ include_parking_space
  • String
  • 可选
  • Y
  • 是否有车位,Y-是,N-否
  • └ parking_space_amount
  • Number
  • 可选
  • 2000
  • 车位金额(单位分)
  • └ house_contract_online_flag
  • String
  • 可选
  • Y
  • 房款合同
  • house_contract_infos
  • SecondHandOperateContractInfoDTO []
  • 可选
  • []
  • 房款合同信息集合
  • └ contract_online_flag
  • String
  • 必须
  • Y
  • 是否线上签约,Y-是,N-否
  • └ contract_type
  • String
  • 必须
  • DEPOSIT
  • 合同类型,DEPOSIT-定金合同,SALES-买卖合同
  • └ offline_contract_pics
  • String
  • 可选
  • xxx,yyy
  • 线下合同凭证
  • └ offline_contract_no
  • String
  • 可选
  • xx
  • 线下合同
  • └ depository_amount_types
  • String []
  • 可选
  • {}
  • 使用资金存管协议的资金类型集合,deposit_pay-定金,down_pay-首付,balance_pay-尾款
  • └ service_provider_id
  • String
  • 可选
  • xxx
  • 服务人ID,非必填
  • └ service_type
  • String
  • 可选
  • fundEscrow
  • 服务模板类型,fundEscrow-无贷款,fundEscrow_mortgage-贷款服务模版
  • └ landlord_payee_name
  • String
  • 可选
  • xxx
  • 房东收款账号户主名称
  • └ landlord_payee_bankcard_no
  • String
  • 可选
  • 222xxx
  • 房东收款账号
  • └ landlord_payee_bank_name
  • String
  • 可选
  • 中国银行
  • 房东收款账号的开户银行
  • └ sign_over_time_hour
  • Number
  • 可选
  • 24
  • 签约超时时间,默认24小时,可选值:24,36,48,72
  • └ landlord_payee_card_no
  • String
  • 可选
  • 420xxxx
  • 房东收款账号号主的身份证号,发起邀约必填
  • └ service_provider_name
  • String
  • 可选
  • 张三
  • 服务人姓名,发起邀约必填
  • └ service_provider_phone
  • String
  • 可选
  • 186xxx
  • 服务人手机号,发起邀约必填
  • └ service_provider_card_no
  • String
  • 可选
  • 420xxx
  • 服务人身份证号,非必填

响应参数

名称 类型 示例值 描述
result Result 出参
  • └ code
  • String
  • 4000
  • 错误码
  • └ message
  • String
  • xxx
  • 错误描述
  • └ is_success
  • Boolean
  • true
  • 是否成功
  • data
  • SecondHandOrderOperateResponse
  • 返回结果
  • └ template_id
  • String
  • xxx
  • 服务模板ID
  • └ house_order_no
  • String
  • 2023xxx
  • 履约单号
  • └ buyer_url
  • String
  • xxx
  • 买家应约地址
  • └ landlord_url
  • String
  • xxxx
  • 房东应约地址
  • └ store_id
  • Number
  • 1023
  • 门店ID

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallAlihouseTradeOrderSecondHouseOperateRequest req = new TmallAlihouseTradeOrderSecondHouseOperateRequest();
TmallAlihouseTradeOrderSecondHouseOperateRequest.SecondHandOrderOperateRequest obj1 = new TmallAlihouseTradeOrderSecondHouseOperateRequest.SecondHandOrderOperateRequest();
obj1.setSource("LIANGCE_TRADE_CENTER");
obj1.setSourceNo("xxx");
obj1.setOperateType("CREATE");
obj1.setHouseOrderNo("2023xxx");
obj1.setItemId(1022L);
obj1.setStoreId(10223L);
List<TmallAlihouseTradeOrderSecondHouseOperateRequest.UserInfoDTO> list3 = new ArrayList<TmallAlihouseTradeOrderSecondHouseOperateRequest.UserInfoDTO>();
TmallAlihouseTradeOrderSecondHouseOperateRequest.UserInfoDTO obj4 = new TmallAlihouseTradeOrderSecondHouseOperateRequest.UserInfoDTO();
list3.add(obj4);
obj4.setName("张三");
obj4.setCertType(1L);
obj4.setCardNo("420xxx");
obj4.setPhone("186xxx");
obj4.setAddress("浙江省xxx");
obj4.setOutId("12323");
obj1.setBuyerInfos(list3);
obj1.setBuyerPhone("186xxx");
obj1.setBuyerAddress("浙江省xx");
List<TmallAlihouseTradeOrderSecondHouseOperateRequest.UserInfoDTO> list6 = new ArrayList<TmallAlihouseTradeOrderSecondHouseOperateRequest.UserInfoDTO>();
TmallAlihouseTradeOrderSecondHouseOperateRequest.UserInfoDTO obj7 = new TmallAlihouseTradeOrderSecondHouseOperateRequest.UserInfoDTO();
list6.add(obj7);
obj7.setName("张三");
obj7.setCertType(1L);
obj7.setCardNo("420xxx");
obj7.setPhone("186xx");
obj7.setAddress("浙江省xx");
obj7.setOutId("12323");
obj1.setLandlordInfos(list6);
obj1.setLandlordPhone("186xxx");
obj1.setLandlordAddress("浙江省xx");
obj1.setHouseAddress("浙江省xx");
obj1.setHouseProvince("101");
obj1.setHouseCity("102");
obj1.setHouseProvinceCityDesc("浙江省xx");
obj1.setDeedRecordNumber("A2023xx");
obj1.setDeedRecordPics("http://xxx");
obj1.setConstructionArea("120");
obj1.setCoverArea("110");
obj1.setHouseDealPrice(100000000L);
obj1.setDepositAmount(10000000L);
obj1.setFirstPayAmount(30000000L);
obj1.setLoanAmount(60000000L);
obj1.setFinalPayAmount(0L);
obj1.setServiceFeeAmount(100000L);
obj1.setHasMortgage("Y");
obj1.setHasLease("N");
obj1.setDeliveryDepositAmount(1000L);
obj1.setHouseSupportEquipmentPrice(2000L);
obj1.setHouseSupportRemark("xxx");
obj1.setIncludeParkingSpace("Y");
obj1.setParkingSpaceAmount(2000L);
obj1.setHouseContractOnlineFlag("Y");
List<TmallAlihouseTradeOrderSecondHouseOperateRequest.SecondHandOperateContractInfoDTO> list9 = new ArrayList<TmallAlihouseTradeOrderSecondHouseOperateRequest.SecondHandOperateContractInfoDTO>();
TmallAlihouseTradeOrderSecondHouseOperateRequest.SecondHandOperateContractInfoDTO obj10 = new TmallAlihouseTradeOrderSecondHouseOperateRequest.SecondHandOperateContractInfoDTO();
list9.add(obj10);
obj10.setContractOnlineFlag("Y");
obj10.setContractType("DEPOSIT");
obj10.setOfflineContractPics("xxx,yyy");
obj10.setOfflineContractNo("xx");
obj1.setHouseContractInfos(list9);
obj1.setDepositoryAmountTypes("{}");
obj1.setServiceProviderId("xxx");
obj1.setServiceType("fundEscrow");
obj1.setLandlordPayeeName("xxx");
obj1.setLandlordPayeeBankcardNo("222xxx");
obj1.setLandlordPayeeBankName("中国银行");
obj1.setSignOverTimeHour(24L);
obj1.setLandlordPayeeCardNo("420xxxx");
obj1.setServiceProviderName("张三");
obj1.setServiceProviderPhone("186xxx");
obj1.setServiceProviderCardNo("420xxx");
req.setOperateRequest(obj1);
TmallAlihouseTradeOrderSecondHouseOperateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_alihouse_trade_order_second_house_operate_response>
    <result>
        <code>4000</code>
        <message>xxx</message>
        <is_success>true</is_success>
        <data>
            <template_id>xxx</template_id>
            <house_order_no>2023xxx</house_order_no>
            <buyer_url>xxx</buyer_url>
            <landlord_url>xxxx</landlord_url>
            <store_id>1023</store_id>
        </data>
    </result>
</tmall_alihouse_trade_order_second_house_operate_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部