淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	更多限制	描述
request	WorkOrderIssueRequest	必须			请求的根节点
└ customer_type Number 必须 4 工单发起者类型 4: 淘天物流部 └ extension String 可选 {key:value} 扩展字段 └ work_order_code String 必须 LW1000012233 物流部工单编码、全局唯一 └ category_code String 必须 BEFORE-TIMEOUT 问题分类的编码，比如： “BEFORE-TIMEOUT” └ attachments String [] 可选 1,2,3 附件下载URL，有效期X分钟。 └ expire_time String 可选 2023-08-23 00:00:00 工单到期时间 └ description String 必须上门取件前-超时催上门取件工单问题描述 └ priority String 可选 0 优先紧急程度 0 - 低 1 - 中 2 - 高 3 - 紧急 └ biz_order_code String 必须 123456 业务单号 └ work_order_type Number 必须 0 工单类型 1: 咨询工单 2: 投诉工单 work_order_task WorkOrderTaskIssueRequest 必须任务节点 └ task_expire_time String 必须 2023-08-23 00:00:00 任务到期时间 └ task_status Number 可选 1 任务状态 structural_replys StructuralReply [] 必须 1,2,3 结构化回复内容 reply_supplements ReplySupplements 必须补充回复列表 reply_supplement ReplySupplement [] 必须补充回复 └ field_label String 必须网点联系人补充回复字段文案 └ field_name String 必须 contactName 补充回复字段名 └ field_type String 必须 string 补充回复字段类型 └ require Boolean 必须 true 补充回复是否必填 └ field_value String 必须 "" 补充回复字段值 └ reply_value Number 必须 101 回复值 └ reply_label String 必须已派单待取件-包裹激增回复文案 └ operate_type Number 可选 1,2,101 操作类型（1:认责 2:不认责 101:回复） └ description String 可选 TASK123456 task问题描述内容 └ task_start_time String 必须 2023-08-22 00:00:00 任务创建时间 └ attachments String [] 可选 task附件URL └ start_time String 必须 2023-08-22 00:00:00 工单创建时间 └ customer_name String 必须工单发起者名称工单发起者名称 └ category String 必须上门取件前-超时催上门取件问题分类的文字描述，比如： “上门取件前-超时催上门取件” └ status Number 必须 1 工单状态 1 处理中 2 已完成 └ scenario_code Number 必须 110 场景类型 110：逆向取退 goods_infos GoodsInfos 可选商品信息 goods_info GoodsInfo [] 可选商品列表信息 └ goods_total_value String 可选 10.00 商品价值 └ third_level_category_name String 可选手串三级问题分类 └ goods_pic_url String 可选 url 商品图片 └ goods_name String 可选测试商品名称 └ sku_name String 可选测试 SKU名称 └ goods_quantity String 可选 10 商品数量 └ return_quantity String 可选 10 退货数量 └ return_goods_amount String 可选 100 消费者退货商品总金额 └ actual_payment_amount String 可选 100 消费者实付金额 └ biz_order_type Number 必须 DELIVERY_ORDER 业务单类型 1:包裹运单, 2:履行单号

名称	类型	示例值	描述
response	WorkOrderIssueResponse		返回
└ biz_error_msg String 参数不合法错误信息 └ success Boolean true 是否成功 └ biz_error_code String PARAM_ERROR 错误编码

<?xml version="1.0" encoding="UTF-8"?>

<response>
  <request>
    <customer_type>4</customer_type>
    <extension>{key:value}</extension>
    <work_order_code>LW1000012233</work_order_code>
    <category_code>BEFORE-TIMEOUT</category_code>
    <attachments>
      <attachmentsItem>1,2,3</attachmentsItem>
    </attachments>
    <expire_time>2023-08-23 00:00:00</expire_time>
    <description>上门取件前-超时催上门取件</description>
    <priority>0</priority>
    <biz_order_code>123456</biz_order_code>
    <work_order_type>0</work_order_type>
    <work_order_task>
      <task_expire_time>2023-08-23 00:00:00</task_expire_time>
      <task_status>1</task_status>
      <structural_replys>
        <structural_replysItem>
          <reply_supplements>
            <reply_supplement>
              <reply_supplementItem>
                <field_label>网点联系人</field_label>
                <field_name>contactName</field_name>
                <field_type>string</field_type>
                <require>true</require>
                <field_value>""</field_value>
              </reply_supplementItem>
            </reply_supplement>
          </reply_supplements>
          <reply_value>101</reply_value>
          <reply_label>已派单待取件-包裹激增</reply_label>
          <operate_type>0</operate_type>
        </structural_replysItem>
      </structural_replys>
      <description>TASK123456</description>
      <task_start_time>2023-08-22 00:00:00</task_start_time>
      <attachments>
        <attachmentsItem></attachmentsItem>
      </attachments>
    </work_order_task>
    <start_time>2023-08-22 00:00:00</start_time>
    <customer_name>工单发起者名称</customer_name>
    <category>上门取件前-超时催上门取件</category>
    <status>1</status>
    <scenario_code>110</scenario_code>
    <goods_infos>
      <goods_info>
        <goods_infoItem>
          <goods_total_value>10.00</goods_total_value>
          <third_level_category_name>手串</third_level_category_name>
          <goods_pic_url>url</goods_pic_url>
          <goods_name>测试</goods_name>
          <sku_name>测试</sku_name>
          <goods_quantity>10</goods_quantity>
          <return_quantity>10</return_quantity>
          <return_goods_amount>100</return_goods_amount>
          <actual_payment_amount>100</actual_payment_amount>
        </goods_infoItem>
      </goods_info>
    </goods_infos>
    <biz_order_type>0</biz_order_type>
  </request>
</response>

<response>
    <biz_error_msg>参数不合法</biz_error_msg>
    <success>true</success>
    <biz_error_code>PARAM_ERROR</biz_error_code>
</response>

<?xml version="1.0" encoding="UTF-8"?>

错误码	错误描述	解决方案
response-body-parse-error

错误码查询工具 SDK下载

开放平台

天猫供应链

qimen.taobao.logistics.work.order.issue (淘天物流部--物流客服工单创建广播服务商接口)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ