taobao.auction.zc.merchantnotice.collateral.update (招商公告添加或者更新抵押物)

招商公告添加或者更新抵押物

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
proxy_nick String 必须 tiangu3 替哪个用户发布招商公告,如果是自己给自己发布,这里填自己的淘宝帐号
merchant_notice_id Number 可选 6688
  • 默认值:0
  • 招商公告ID
    collateral Collateral 可选 抵押物
    • └ building_area
    • String
    • 可选
    • 100.12
    • 建筑面积,单位平米
    • └ collateral_id
    • Number
    • 可选
    • 321
    • 抵押物ID,为空表示在公告上添加抵押物,不为空表示编辑
    • └ detail_address
    • String
    • 必须
    • 浙江省杭州市西湖区华星路99号
    • 抵押物详细地址
    • └ location_code
    • Number
    • 必须
    • 330100
    • 所在地区域码,参见taobao.auction.gov.get.division
    • └ original_warrant
    • String
    • 可选
    • 原始权证...
    • 原始权证
    • └ other_warrant
    • String
    • 可选
    • 他项权证...
    • 他项权证
    • └ pic_urls
    • String []
    • 可选
    • ["https://img.alicdn.com/bao/uploaded/i1/3258232187/TB2CobIpSFjpuFjSszhXXaBuVXa_!!0-paimai.jpg_300x300"]
    • 图片地址,参见taobao.auction.gov.publish.upload.pic
    • └ site_area
    • String
    • 可选
    • 10000.00
    • 占地面积单位平米
    • └ title
    • String
    • 可选
    • xxx公司债权项目
    • 标题
    • └ asset_type
    • Number
    • 可选
    • 1
    • 抵质押物类型1-住宅 2-商业 3-写字楼 4-净地 5-工业地产 6-在建工程 7-船舶 8-设备 9-股权 10-其他
    • └ guarantee_type
    • Number
    • 必须
    • 2
    • 担保类型1-保证 2-抵(质)押+保证 3-抵(质)押 4-信用
    • └ detail
    • String
    • 必须
    • ...
    • 抵质押物详细描述

    响应参数

    名称 类型 示例值 描述
    result_code String success errorCode
    result_msg String 操作成功 errorMsg
    value Number 321 抵押物ID

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AuctionZcMerchantnoticeCollateralUpdateRequest req = new AuctionZcMerchantnoticeCollateralUpdateRequest();
    req.setProxyNick("tiangu3");
    req.setMerchantNoticeId(6688L);
    AuctionZcMerchantnoticeCollateralUpdateRequest.Collateral obj1 = new AuctionZcMerchantnoticeCollateralUpdateRequest.Collateral();
    obj1.setBuildingArea("100.12");
    obj1.setCollateralId(321L);
    obj1.setDetailAddress("浙江省杭州市西湖区华星路99号");
    obj1.setLocationCode(330100L);
    obj1.setOriginalWarrant("原始权证...");
    obj1.setOtherWarrant("他项权证...");
    obj1.setPicUrls(""https://img.alicdn.com/bao/uploaded/i1/3258232187/TB2CobIpSFjpuFjSszhXXaBuVXa_!!0-paimai.jpg_300x300"");
    obj1.setSiteArea("10000.00");
    obj1.setTitle("xxx公司债权项目");
    obj1.setAssetType(1L);
    obj1.setGuaranteeType(2L);
    obj1.setDetail("...");
    req.setCollateral(obj1);
    AuctionZcMerchantnoticeCollateralUpdateResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <auction_zc_merchantnotice_collateral_update_response>
        <result_code>success</result_code>
        <result_msg>操作成功</result_msg>
        <value>321</value>
    </auction_zc_merchantnotice_collateral_update_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>

    错误码解释

    错误码 错误描述 解决方案
    isp.success 操作成功
    isp.unknown_exception 未知异常 联系拍卖开发人员解决
    isp.appkey_not_specify appkey未指定 检查是否传递appkey参数
    isp.proxynick_not_specify 代理用户未指定 检查是否设置proxy_nick参数
    isp.proxynick_not_found 代理用户不存在 检查proxy_nick是否合理
    isp.proxy_relation_not_found 代理关系不存在 提供appkey和proxy_nick让拍卖开发人员添加代理关系
    isp.add_or_update_collateral_failed 添加或者更新抵押物失败 联系拍卖开发人员解决
    isp.merchant_notice_not_specify 招商公告未指定 检查merchant_notice_id参数是否设置
    param_not_specify 参数未指定 检查collateral参数是否设置
    isp.collateral_not_found 未找到抵押物 检查collateral_id是否存在
    isp.query_collateral_failed 查询抵押物失败 联系拍卖开发人员
    isp.collateral_type_not_specify 抵押物类型未指定 检查asset_type参数是否设置
    isp.collateral_type_is_illegal 抵押物类型不合法 检查 asset_type参数是否文档中提及
    isp.guaranttype_not_specify 保证类型未指定 检查guarantee_type参数是否设置
    isp.guaranttype_is_illegal 保证类型不合法 检查guarantee_type是否文档提及
    isp.collateral_title_not_specify 抵押物标题未指定 检查 title是否设置
    isp.collateral_title_exceed_length 抵押物标题超长 检查抵押物标题是否50字以内
    isp.locationcode_not_specify 区域码未指定 检查location_code参数是否设置
    isp.locationcode_is_illegal 非法的区域码 检查区域码是否合法,是否taobao.auction.gov.get.division接口返回的区域码
    isp.collateral_detail_address_not_specify 抵押物详细地址未指定 检查detail_address参数是否设置
    isp.collateral_detail_address_exceed_length 抵押物详细地址超长 检查detail_address是否200字以内
    isp.collateral_detail_not_specify 抵押物详细描述未指定 检查detail参数是否设置
    isp.pic_too_many 图片过多 检查pic_urls数组大小,不能超过5
    isp.original_warrant_exceed_length 原始权证超长 检查 original_warrant是否1000字以内
    isp.other_warrant_exceed_length 他项权证超长 检查other_warrant是否1000字以内

    API工具

    如何获得此API

    FAQ

    返回
    顶部