注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > 千牛业务API

cainiao.logisticscloud.isv.cpticket.create (创建快递公司工单)

创建快递公司工单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param0 TicketOrder 可选 请求分装对象
  • └ seller_id
  • Number
  • 必须
  • 9854
  • 商家公司ID
  • question_info_list
  • QuestionInfo []
  • 可选
  • Object
  • 请求列表
  • └ mail_no
  • String
  • 可选
  • 777*********6061
  • 快递单号
  • └ new_mobile
  • String
  • 可选
  • 131****3505
  • 新的手机号
  • └ address
  • String
  • 可选
  • 杭州市西湖区西溪首座
  • 旧的地址
  • └ new_name
  • String
  • 可选
  • 王小二
  • 新的姓名
  • └ question
  • String
  • 可选
  • 拦截退回
  • 问题描述
  • └ name
  • String
  • 可选
  • 李小四
  • 旧的姓名
  • └ mobile
  • String
  • 可选
  • 187****4598
  • 旧的手机
  • └ site_name
  • String
  • 可选
  • 杭州西溪一部
  • 站点名称
  • └ question_type
  • Number
  • 可选
  • 20
  • 拦截件类型
  • └ new_address
  • String
  • 可选
  • 上海市阿里中心
  • 新的地址
  • └ customer_code
  • String
  • 可选
  • 9876
  • isv身份标识,由我们提供

响应参数

名称 类型 示例值 描述
data String [] [{"77********4297":"af6hgj2"}] 返回生成的服务单号
  • └ mail_no
  • String
  • 77********4297
  • 下工单的快递单号
  • └ ticket_id
  • String
  • af6hgj2
  • 对应的服务单单号
success_i Boolean true 是否下单成功
error_message_i String isv不正确 错误信息
error_code_i String -1 错误码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
CainiaoLogisticscloudIsvCpticketCreateRequest req = new CainiaoLogisticscloudIsvCpticketCreateRequest();
CainiaoLogisticscloudIsvCpticketCreateRequest.TicketOrder obj1 = new CainiaoLogisticscloudIsvCpticketCreateRequest.TicketOrder();
obj1.setSellerId(9854L);
List<CainiaoLogisticscloudIsvCpticketCreateRequest.QuestionInfo> list3 = new ArrayList<CainiaoLogisticscloudIsvCpticketCreateRequest.QuestionInfo>();
CainiaoLogisticscloudIsvCpticketCreateRequest.QuestionInfo obj4 = new CainiaoLogisticscloudIsvCpticketCreateRequest.QuestionInfo();
list3.add(obj4);
obj4.setMailNo("777*********6061");
obj4.setNewMobile("131****3505");
obj4.setAddress("杭州市西湖区西溪首座");
obj4.setNewName("王小二");
obj4.setQuestion("拦截退回");
obj4.setName("李小四");
obj4.setMobile("187****4598");
obj4.setSiteName("杭州西溪一部");
obj4.setQuestionType(20L);
obj4.setNewAddress("上海市阿里中心");
obj1.setQuestionInfoList(list3);
obj1.setCustomerCode("9876");
req.setParam0(obj1);
CainiaoLogisticscloudIsvCpticketCreateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<cainiao_logisticscloud_isv_cpticket_create_response>
    <data>
        <string>
            <mail_no>77********4297</mail_no>
            <ticket_id>af6hgj2</ticket_id>
        </string>
    </data>
    <success_i>true</success_i>
    <error_message_i>isv不正确</error_message_i>
    <error_code_i>-1</error_code_i>
</cainiao_logisticscloud_isv_cpticket_create_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

返回
顶部