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

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

淘天物流部--物流客服工单创建广播接口

公共参数

请求地址：

环境	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	WorkOrderCreateRequest	必须			请求
work_order_task WorkOrderTaskCreateRequest 必须任务请求 └ operate_types String [] 必须该任务节点可操作类型 └ task_expire_time String 必须 2023-08-23 00:00:00 任务创建时间 └ task_start_time String 必须 2023-08-22 00:00:00 任务到期时间 └ task_status Number 必须 1 任务状态，1 处理中 2 已完成 3 已撤销 └ task_name String 必须服务商处理节点任务节点名字 └ task_id String 必须 TASK123456 任务节点ID └ extension String 可选 {key:value} 实际为Map类型 └ mail_no String 必须 123456 运单号 └ biz_status Number 可选 1 工单业务状态 └ status Number 必须 1 工单状态，1 处理中 2 已完成 3 已撤销 └ priority Number 可选 0 优先紧急程度，否 0 - 低 1 - 中 2 - 高 3 - 紧急 └ customer_name String 必须工单发起者名称商家或消费者,会脱敏 └ customer_type Number 必须 1 工单发起者类型，1 消费者 2 商家 └ expire_time String 必须 2023-08-23 00:00:00 工单到期时间 └ start_time String 必须 2023-08-22 00:00:00 工单创建时间 └ description String 必须咨询货物发货时间工单问题的主体内容 └ category String 必须货物类-逆向丢失问题分类描述，比如： “货物类-逆向丢失” └ work_order_type Number 必须 0 工单类型，0: 投诉工单 1: 咨询工单 └ work_order_code String 必须 WO123456 物流部工单编码、全局唯一 └ logistics_vendor_name String 可选物流服务商名称物流服务商名称 └ attachments String [] 可选附件下载地址 └ qimen_customer_id String 可选 ahaxg1323 货主在各服务商奇门配置里的customerId

响应参数

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

请求示例

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

<response>
  <request>
    <work_order_task>
      <operate_types>
        <operate_typesItem></operate_typesItem>
      </operate_types>
      <task_expire_time>2023-08-23 00:00:00</task_expire_time>
      <task_start_time>2023-08-22 00:00:00</task_start_time>
      <task_status>1</task_status>
      <task_name>服务商处理节点</task_name>
      <task_id>TASK123456</task_id>
    </work_order_task>
    <extension>{key:value}</extension>
    <mail_no>123456</mail_no>
    <biz_status>1</biz_status>
    <status>1</status>
    <priority>0</priority>
    <customer_name>工单发起者名称</customer_name>
    <customer_type>1</customer_type>
    <expire_time>2023-08-23 00:00:00</expire_time>
    <start_time>2023-08-22 00:00:00</start_time>
    <description>咨询货物发货时间</description>
    <category>货物类-逆向丢失</category>
    <work_order_type>0</work_order_type>
    <work_order_code>WO123456</work_order_code>
    <logistics_vendor_name>物流服务商名称</logistics_vendor_name>
    <attachments>
      <attachmentsItem></attachmentsItem>
    </attachments>
    <qimen_customer_id>ahaxg1323</qimen_customer_id>
  </request>
</response>

响应示例

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

验签示例

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

错误码解释

错误码	错误描述	解决方案
response-body-parse-error
http-service-unknown-error
isp.http-closed
isp.http-connection-timeout

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

淘宝开放平台

天猫供应链

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

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ