文档中心 > API类目 > 天猫供应链

qimen.taobao.logistics.work.order.task.issue (淘天物流部--物流客服工单任务下发接口)

淘天物流部--物流客服工单任务下发广播接口

公共参数

请求地址：

环境	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	WorkOrderTaskIssueRequest	必须			请求的根结点
└ work_order_code String 必须 LW1000012233 物流部工单编码、全局唯一 └ scenario_code Number 必须 110 物流服务场景码 └ idempotent_id String 必须 19ed66c92aa14181930a6bc17e110c73 幂等id └ task_status Number 可选 1 任务状态 └ task_start_time String 必须 2023-08-22 00:00:00 任务创建时间 └ task_expire_time String 必须 2023-08-23 00:00:00 任务到期时间 └ description String 可选上门取件前-超时催上门取件任务描述 └ attachments String [] 可选附件下载URL，有效期X分钟。 structural_replys StructuralReply [] 必须结构化回复内容 └ operate_type Number 必须 1,2,101,201 操作类型（1:认责 2:不认责 101:回复 201:补充举证） └ reply_label String 必须已派单待取件-包裹激增回复文案 └ reply_value Number 必须 11001 回复值 reply_supplements ReplySupplements 必须二级结构化回复列表 reply_supplement ReplySupplement [] 必须二级结构化回复 └ field_label String 必须网点联系人二级结构化回复字段文案 └ field_name String 必须 contactName 二级结构化回复字段名 └ field_type String 必须 string 二级结构化回复字段类型 └ require Boolean 必须 true 二级结构化回复是否必填 └ field_value String 必须 "" 二级结构化回复字段值 └ extension String 可选 {"key": "value"} 扩展信息，实际为Map类型

响应参数

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

请求示例

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

<response>
  <request>
    <work_order_code>LW1000012233</work_order_code>
    <scenario_code>110</scenario_code>
    <idempotent_id>19ed66c92aa14181930a6bc17e110c73</idempotent_id>
    <task_status>1</task_status>
    <task_start_time>2023-08-22 00:00:00</task_start_time>
    <task_expire_time>2023-08-23 00:00:00</task_expire_time>
    <description>上门取件前-超时催上门取件</description>
    <attachments>
      <attachmentsItem></attachmentsItem>
    </attachments>
    <structural_replys>
      <structural_replysItem>
        <operate_type>0</operate_type>
        <reply_label>已派单待取件-包裹激增</reply_label>
        <reply_value>11001</reply_value>
        <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>
      </structural_replysItem>
    </structural_replys>
    <extension>{"key": "value"}</extension>
  </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"?>

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

天猫供应链

qimen.taobao.logistics.work.order.task.issue (淘天物流部--物流客服工单任务下发接口)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ