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

tmall.alihouse.trade.rent.lease.query (天猫好房etc查询租约单意向状态)

天猫好房etc查询租约单意向状态

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
querystatusreq QueryStatusDTO 必须 入参
  • └ lease_order_no
  • String
  • 必须
  • 123
  • 租约单号
  • └ bill_no_list
  • String []
  • 可选
  • 账单编号集合
  • └ phase
  • Number
  • 可选
  • 1
  • 账期
  • └ type
  • Number
  • 必须
  • 1
  • 0-查租约单 1-按账期查账单 2-按账单编号查账单,2-查租约单且按账单编号查账单 3-查询分佣信息
  • └ merchant_open_id
  • Number
  • 必须
  • 1232
  • 经营主体ID

响应参数

名称 类型 示例值 描述
result Result 出参
  • └ message
  • String
  • 系统出错
  • 错误信息
  • └ code
  • String
  • b1001-102
  • 错误码
  • data
  • EtcLeaseOrderDTO
  • 返回数据
  • └ lease_order_no
  • String
  • 1232
  • 租约单号
  • └ status
  • String
  • TENANT_INITIATE
  • 租约单状态 租客发起-TENANT_INITIATE 房东确认-LANDLORD_CONFIRM 房东发起-LANDLORD_INITIATE 意向达成-ACHIEVEMENT 签约完成-SIGN_FINISH 租约到期-EXPIRE 租约关闭-CLOSED
  • bill_dto_list
  • HouseBillDTO []
  • 账单信息集合
  • └ bill_no
  • String
  • 123
  • 账单编号
  • └ bill_type
  • Number
  • 2
  • 账单类型 0-押金 1-租金 2-退款 3-加收费用 4-定金 5-水费 6-电费 7-气费 8-热水费 9-冷水费 10-退租应付 11-退租应收 12-押金减免 13-租金减免 14-其他
  • └ amount
  • Number
  • 1000
  • 账单金额
  • └ status
  • String
  • INIT
  • 账单状态 待确认-'INIT' 待支付-'PAYABLE' 支付成功-'SUCCEED' 关闭-'CLOSED'
  • └ is_lock
  • String
  • Y
  • 是否支付中,Y-是,N-否
  • └ phase
  • Number
  • 1
  • 账期
  • └ pay_rent_mill_second
  • Number
  • 12323
  • 交租日,时间戳
  • └ is_online
  • String
  • Y
  • 是否线上,Y-是,N-否
  • └ is_overdue
  • String
  • N
  • 是否逾期,Y-是,N-否
  • └ finish_mill_second
  • Number
  • 122323
  • 完成时间,时间戳(已支付:支付时间,关闭:关闭时间)
  • └ payable
  • Number
  • 1
  • 可支付状态 0-无可支付账单 1-账单待支付 2-账单支付中
  • └ close_reason
  • String
  • TENANT_CANCEL_INTENTION
  • 关闭原因 TENANT_CANCEL_INTENTION 租客取消意向 LANDLORD_CANCEL_INTENTION 房东取消意向 TENANT_REJECT_INTENTION 租客拒绝意向 LANDLORD_REJECT_INTENTION 房东拒绝意向 TENANT_CONFIRM_INTENTION_OVERTIME 租客确认意向超时 LANDLORD_CONFIRM_INTENTION_OVERTIME 房东确认意向超时 TENANT_INITIATE_CANCEL 租客发起解约,房东同意关闭 TENANT_INITIATE_CANCEL_OVERTIME 租客发起解约,超时关闭
  • settle_info_list
  • SettleInfo []
  • 分佣信息模块
  • └ is_settle
  • String
  • Y
  • 是否分佣 N-否 Y-是
  • └ settle_order_no
  • String
  • 123123241343
  • 天猫好房结算流水号
  • └ transfer_order_no
  • String
  • 452541252452
  • 网商银行代发流水号
  • └ settle_time
  • Number
  • 1653148800000
  • 分佣时间 时间戳
  • └ settle_amount
  • Number
  • 20000
  • 金额 单位:分
  • └ rent_pay_price
  • Number
  • 200000
  • 租约-月租金金额 单位:分
  • └ settle_detailed
  • String
  • abc
  • 明目 - 运营服务费
  • └ biz_channel
  • String
  • B2C
  • 场景 B2C-(交易宝)
  • └ tp_order_id
  • String
  • 2739706993540986035
  • 淘宝单号
  • └ commission_rule
  • String
  • 1
  • 分账规则
  • └ oaid
  • String
  • aw45aws5a454a45a5
  • aid
  • bill_market_info_list
  • BillMarketInfo []
  • 账单关联营销信息列表
  • └ bill_no_list
  • String []
  • 账单编号列表
  • └ pay_order_no
  • String
  • 2143413413513515
  • 支付单号
  • sbt_info_list
  • TpMarketingInfo []
  • 红包信息列表
  • └ id
  • String
  • 800001
  • 红包id
  • └ amount
  • String
  • 2000
  • 红包金额(分)
  • discount_info_list
  • TpMarketingInfo []
  • 优惠券信息列表
  • └ id
  • String
  • coupon_1231_123123
  • 券id
  • └ amount
  • String
  • 20000
  • 券金额(分)
  • └ support_landlord_terminate
  • String
  • Y
  • 是否支持房东发起解约,Y-是,N-否
  • └ terminate_role_type
  • Number
  • 1
  • 解约发起人角色,1-租客,2-房东
  • └ cancel_order_no
  • String
  • 2022xxx
  • 解约单号,唯一确认一条解约单
  • └ cancel_order_status
  • Number
  • 0
  • 解约单状态,0-待审核,10-审核成功,20-退款成功,30-审核拒绝,40-退款关闭
  • └ terminate_audit_reason
  • String
  • 同意
  • 解约审核意见
  • └ trade_init_broker_id
  • Number
  • 123
  • 交易发起经纪人id
  • └ house_service_broker_id
  • Number
  • 123
  • 房源服务经纪人id
  • └ kpi_belong_broker_id
  • Number
  • 123
  • 业绩归属经纪人id
  • └ biz_belong
  • Number
  • 1
  • 直营
  • └ biz_label
  • String
  • through_train
  • 直通车
  • └ is_success
  • Boolean
  • true
  • 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallAlihouseTradeRentLeaseQueryRequest req = new TmallAlihouseTradeRentLeaseQueryRequest();
TmallAlihouseTradeRentLeaseQueryRequest.QueryStatusDTO obj1 = new TmallAlihouseTradeRentLeaseQueryRequest.QueryStatusDTO();
obj1.setLeaseOrderNo("123");
obj1.setBillNoList("");
obj1.setPhase(1L);
obj1.setType(1L);
obj1.setMerchantOpenId(1232L);
req.setQuerystatusreq(obj1);
TmallAlihouseTradeRentLeaseQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_alihouse_trade_rent_lease_query_response>
    <result>
        <message>系统出错</message>
        <code>b1001-102</code>
        <data>
            <lease_order_no>1232</lease_order_no>
            <status>TENANT_INITIATE</status>
            <bill_dto_list>
                <house_bill_d_t_o>
                    <bill_no>123</bill_no>
                    <bill_type>2</bill_type>
                    <amount>1000</amount>
                    <status>INIT</status>
                    <is_lock>Y</is_lock>
                    <phase>1</phase>
                    <pay_rent_mill_second>12323</pay_rent_mill_second>
                    <is_online>Y</is_online>
                    <is_overdue>N</is_overdue>
                    <finish_mill_second>122323</finish_mill_second>
                </house_bill_d_t_o>
            </bill_dto_list>
            <payable>1</payable>
            <close_reason>TENANT_CANCEL_INTENTION</close_reason>
            <settle_info_list>
                <settle_info>
                    <is_settle>Y</is_settle>
                    <settle_order_no>123123241343</settle_order_no>
                    <transfer_order_no>452541252452</transfer_order_no>
                    <settle_time>1653148800000</settle_time>
                    <settle_amount>20000</settle_amount>
                    <rent_pay_price>200000</rent_pay_price>
                    <settle_detailed>abc</settle_detailed>
                    <biz_channel>B2C</biz_channel>
                    <tp_order_id>2739706993540986035</tp_order_id>
                    <commission_rule>1</commission_rule>
                </settle_info>
            </settle_info_list>
            <oaid>aw45aws5a454a45a5</oaid>
            <bill_market_info_list>
                <bill_market_info>
                    <pay_order_no>2143413413513515</pay_order_no>
                    <sbt_info_list>
                        <tp_marketing_info>
                            <id>800001</id>
                            <amount>2000</amount>
                        </tp_marketing_info>
                    </sbt_info_list>
                    <discount_info_list>
                        <tp_marketing_info>
                            <id>coupon_1231_123123</id>
                            <amount>20000</amount>
                        </tp_marketing_info>
                    </discount_info_list>
                </bill_market_info>
            </bill_market_info_list>
            <support_landlord_terminate>Y</support_landlord_terminate>
            <terminate_role_type>1</terminate_role_type>
            <cancel_order_no>2022xxx</cancel_order_no>
            <cancel_order_status>0</cancel_order_status>
            <terminate_audit_reason>同意</terminate_audit_reason>
            <trade_init_broker_id>123</trade_init_broker_id>
            <house_service_broker_id>123</house_service_broker_id>
            <kpi_belong_broker_id>123</kpi_belong_broker_id>
            <biz_belong>1</biz_belong>
            <biz_label>through_train</biz_label>
        </data>
        <is_success>true</is_success>
    </result>
</tmall_alihouse_trade_rent_lease_query_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

返回
顶部