文档中心 > API类目 > 天猫服务商品API

tmall.servicecenter.contracts.search (获取合同类的服务工单信息)

获取合同类的服务工单信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
start Number 必须 12345678 开始时间: 开始时间和结束时间不能超过15分钟
end Number 必须 12345678 结束时间: 开始时间和结束时间不能超过15分钟

响应参数

名称 类型 示例值 描述
service_contract_packet ServiceContractPacket 和同类服务包装类
  • └ desc
  • String
  • 描述
  • 描述
  • service_list
  • ServiceContractDO []
  • 合同类服务列表
  • └ contract_status
  • Number
  • 1
  • 合同状态
  • └ service_count
  • Number
  • 1
  • 服务次数
  • └ buy_amount
  • Number
  • 1
  • 购买数量
  • └ service_phone
  • String
  • 111
  • 服务电话
  • └ service_name
  • String
  • 服务名称
  • 服务名称
  • └ contract_price
  • Number
  • 111
  • 商品价格
  • └ auction_price
  • Number
  • 111
  • 商品价格
  • └ buyer_mobile
  • String
  • 买家手机
  • 买家手机
  • └ contract_type
  • Number
  • 1
  • 合同类型
  • └ buyer_address
  • String
  • 买家地址
  • 买家地址
  • └ seller_nick
  • String
  • 卖家nick
  • 卖家nick
  • └ ext_price
  • Number
  • 111
  • 扩展价格
  • └ tp_feedback_info
  • String
  • 服务反馈信息
  • 服务反馈信息
  • └ auction_serial_num
  • String
  • 商品序列号
  • 商品序列号
  • └ seller_phone
  • String
  • 111
  • 卖家电话
  • └ receive_time
  • Date
  • 2000-01-01 00:00:00
  • 收货日期
  • └ pay_time
  • Date
  • 2000-01-01 00:00:00
  • 付款时间
  • └ pay_time_number
  • Number
  • 111
  • 付款时间
  • └ content
  • String
  • 合同内容
  • 合同内容
  • └ effect_date
  • Date
  • 2000-01-01 00:00:00
  • 生效时间
  • └ gmt_create
  • Date
  • 2000-01-01 00:00:00
  • 创建时间
  • └ category
  • String
  • 类目
  • 类目
  • └ flag
  • Number
  • 1
  • 异常标识
  • └ auction_id
  • Number
  • 11
  • 商品编号
  • └ tp_name
  • String
  • 供应商名称
  • 供应商名称
  • └ cancel_memo
  • String
  • cancelMemo
  • 服务取消备注
  • └ contract_url
  • String
  • www.xxoo.com
  • 电子合同url
  • └ seller_id
  • Number
  • 111
  • 卖家id
  • └ canceler
  • String
  • 服务取消人
  • 服务取消人
  • └ service_product
  • String
  • 服务产品
  • 服务产品
  • └ expire_date
  • Date
  • 2000-01-01 00:00:00
  • 失效时间
  • └ memo
  • String
  • 备注
  • 备注
  • └ contract_no
  • Number
  • 111
  • 电子合同编号
  • └ order_relation_id
  • Number
  • 111
  • 订购关系id
  • └ attribute
  • String
  • string
  • 属性
  • └ receive_time_number
  • Number
  • 111
  • 收货日期
  • └ buyer_zip_code
  • String
  • 买家邮编
  • 买家邮编
  • └ id
  • Number
  • 111
  • 合同id
  • └ buyer_phone
  • String
  • 买家电话
  • 买家电话
  • └ gmt_modify
  • Date
  • 2000-01-01 00:00:00
  • 修改时间
  • └ name
  • String
  • 合同名称
  • 合同名称
  • └ effect_date_number
  • Number
  • 111
  • 生效时间
  • └ expire_date_number
  • Number
  • 111
  • 失效时间
  • └ auction_name
  • String
  • 商品名称
  • 商品名称
  • └ life_cycle
  • Number
  • 1
  • 有效期
  • └ buyer_name
  • String
  • 买家姓名
  • 买家姓名
  • └ buyer_mail
  • String
  • 买家有限
  • 买家有限
  • └ contract_memo
  • String
  • 合同描述
  • 合同描述
  • └ parent_biz_order_id
  • Number
  • 111
  • 主交易订单编号
  • └ biz_order_id
  • Number
  • 111
  • 交易订单编号
  • └ shop_name
  • String
  • 店铺名称
  • 店铺名称
  • └ model_number
  • String
  • 型号
  • 型号
  • └ seller_mobile
  • String
  • 卖家手机
  • 卖家手机
  • └ brand
  • String
  • brand
  • 品牌
  • └ service_order_id
  • Number
  • 111
  • 服务订单编号
  • └ tp_id
  • Number
  • 111
  • 服务商编号
  • └ cancel_date
  • Date
  • 2000-01-01 00:00:00
  • 服务取消日期
  • └ name
  • String
  • 名字
  • 服务名字

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallServicecenterContractsSearchRequest req = new TmallServicecenterContractsSearchRequest();
req.setStart(12345678L);
req.setEnd(12345678L);
TmallServicecenterContractsSearchResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_servicecenter_contracts_search_response>
    <service_contract_packet>
        <desc>描述</desc>
        <service_list>
            <service_contract_d_o>
                <contract_status>1</contract_status>
                <service_count>1</service_count>
                <buy_amount>1</buy_amount>
                <service_phone>111</service_phone>
                <service_name>服务名称</service_name>
                <contract_price>111</contract_price>
                <auction_price>111</auction_price>
                <buyer_mobile>买家手机</buyer_mobile>
                <contract_type>1</contract_type>
                <buyer_address>买家地址</buyer_address>
                <seller_nick>卖家nick</seller_nick>
                <ext_price>111</ext_price>
                <tp_feedback_info>服务反馈信息</tp_feedback_info>
                <auction_serial_num>商品序列号</auction_serial_num>
                <seller_phone>111</seller_phone>
                <receive_time>2000-01-01 00:00:00</receive_time>
                <pay_time>2000-01-01 00:00:00</pay_time>
                <pay_time_number>111</pay_time_number>
                <content>合同内容</content>
                <effect_date>2000-01-01 00:00:00</effect_date>
                <gmt_create>2000-01-01 00:00:00</gmt_create>
                <category>类目</category>
                <flag>1</flag>
                <auction_id>11</auction_id>
                <tp_name>供应商名称</tp_name>
                <cancel_memo>cancelMemo</cancel_memo>
                <contract_url>www.xxoo.com</contract_url>
                <seller_id>111</seller_id>
                <canceler>服务取消人</canceler>
                <service_product>服务产品</service_product>
                <expire_date>2000-01-01 00:00:00</expire_date>
                <memo>备注</memo>
                <contract_no>111</contract_no>
                <order_relation_id>111</order_relation_id>
                <attribute>string</attribute>
                <receive_time_number>111</receive_time_number>
                <buyer_zip_code>买家邮编</buyer_zip_code>
                <id>111</id>
                <buyer_phone>买家电话</buyer_phone>
                <gmt_modify>2000-01-01 00:00:00</gmt_modify>
                <name>合同名称</name>
                <effect_date_number>111</effect_date_number>
                <expire_date_number>111</expire_date_number>
                <auction_name>商品名称</auction_name>
                <life_cycle>1</life_cycle>
                <buyer_name>买家姓名</buyer_name>
                <buyer_mail>买家有限</buyer_mail>
                <contract_memo>合同描述</contract_memo>
                <parent_biz_order_id>111</parent_biz_order_id>
                <biz_order_id>111</biz_order_id>
                <shop_name>店铺名称</shop_name>
                <model_number>型号</model_number>
                <seller_mobile>卖家手机</seller_mobile>
                <brand>brand</brand>
                <service_order_id>111</service_order_id>
                <tp_id>111</tp_id>
                <cancel_date>2000-01-01 00:00:00</cancel_date>
            </service_contract_d_o>
        </service_list>
        <name>名字</name>
    </service_contract_packet>
</tmall_servicecenter_contracts_search_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>

错误码解释

错误码 错误描述 解决方案
isv.missing-parameter:start-or-end 入参 start,end均不能为null 入参 start,end均不能为null
isv.invalid-parameter:The start time can not be greater than end time-or-Time period of not more than 15 minutes 起始时间,不能颠倒,时间间隔不能超过limitMin(15分钟) 起始时间,不能颠倒,时间间隔不能超过limitMin(15分钟)
isp.servtpservice-service-error: hsf error 内部异常 联系isp解决

API工具

如何获得此API

FAQ

返回
顶部