Lingxing
切换旧版

新增售后工单

POST/basicOpen/customerService/workOrder/add

支持为多平台订单创建仅退货类型的售后工单。

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/customerService/workOrder/addHTTPSPOST1

请求参数

platformOrderNosarray<any>必填
平台单号，来源：查询订单管理订单列表 返回的 data>>list>>item_info>>platform_order_no（去重）
afterInfoListarray<object>
平台订单列表信息；不传时无需传其子字段
隐藏子属性
titlestring必填
标题，来源：查询订单管理订单列表 返回的 data>>list>>item_info>>title
pidinteger必填
本地产品ID
asinstring必填
ASIN，来源：查询订单管理订单列表 返回的 data>>list>>item_info>>product_no（亚马逊返回 ASIN，其他平台返回平台商品ID）
handlerTypeinteger必填
处理方式：
1 重新上架
2 由WMS决定
3 暂存区
4 不良品
5 销毁
afterSaleQuantityinteger必填
售后数量
afterRemarkstring必填
售后说明
afterImagesarray<object>
售后凭证图片列表，未传时默认空数组
隐藏子属性
accessUrlstring必填
图片访问地址
fileNamestring必填
文件名
mappingKeystring必填
映射键
imagestring
商品图片地址，未传时默认空字符串
unitPriceAmountstring必填
单价，来源：查询订单管理订单列表 返回的 data>>list>>item_info>>unit_price_amount
quantityinteger必填
订购数量，来源：查询订单管理订单列表 返回的 data>>list>>item_info>>quantity
returnQuantityinteger必填
已退款数量，来源：查询订单已退货数量 返回的 data>>returnQty>>num，按本行 orderItemNo 匹配对应商品行
sellerSkustring必填
亚马逊定义的商品SKU，即MSKU，来源：查询订单管理订单列表 返回的 data>>list>>item_info>>msku
productNamestring必填
品名，来源：查询订单管理订单列表 返回的 data>>list>>item_info>>local_product_name
orderItemNostring必填
商品行号，来源：查询订单管理订单列表 返回的 data>>list>>item_info>>order_item_no
platformOrderNostring必填
平台单号，来源：查询订单管理订单列表 返回的 data>>list>>item_info>>platform_order_no
skustring必填
本地SKU，来源：查询订单管理订单列表 返回的 data>>list>>item_info>>local_sku
itemIdinteger必填
原商品项ID，仅作备份，来源：查询订单管理订单列表 返回的 data>>list>>item_info>>id
amountCurrencystring
订单币种代码，来源：查询订单管理订单列表 返回的 data>>list>>amount_currency
createManualWorkinteger
创建手工单：
0 无选择
1 立即创建
2 退货完成后创建
cutOffinteger必填
自发货截单：
0 不截单
1 截单
globalOrderNointeger必填
系统单号（汇总订单），来源：查询订单管理订单列表 返回的 data>>list>>global_order_no
globalPurchaseTimestring必填
实际订单下单时间，格式：yyyy-MM-dd HH:mm:ss，来源：查询订单管理订单列表 返回的 data>>list>>global_purchase_time（时间戳需转换为该格式）
hasPredictioninteger必填
三方仓预报：
0 不预报
1 预报
logisticsProviderstring
物流商
logisticsTypeinteger必填
物流类型：
1 自选物流
2 三方仓物流
platformCodestring
平台CODE
preArrivalTimestring
预计到货时间
reasonUuidstring必填
售后原因UUID，来源：查询售后原因 返回的 data>>list>>reasonId
remarkstring
备注
salesTypeinteger必填
退货类型：
1 买家退货
2 物流退货
siteCodestring必填
平台和站点唯一标识，来源：查询订单管理订单列表 返回的 data>>list>>site_code
sourceinteger必填
单据来源：
1 手工创建
2 线上同步
storeIdinteger必填
店铺唯一标识，来源：查询订单管理订单列表 返回的 data>>list>>store_id
sidinteger
店铺ID，来源：查询订单管理订单列表 返回的 data>>list>>store_id
tagListarray<any>
标签UUID组合，来源：查询全局标签 返回的 data>>pageList>>globalTagId
trackingNostring必填
跟踪号，来源：查询订单管理订单列表 返回的 data>>list>>logistics_info>>tracking_no
typeinteger必填
售后类型，目前仅支持：
2 仅退货
widinteger
发货仓库ID，来源：查询订单管理订单列表 返回的 data>>list>>wid
workOrderSupplementobject
补充信息
隐藏子属性
platformOrderNostring
平台单号
platformOrderNamestring
平台单号别名
addressLine1string
详情地址1
addressLine2string
详情地址2
addressLine3string
详情地址3
addressTypeinteger
地址类型：
1 住宅地址
2 商业地址
buyerChooseExpressstring
客选物流
buyerEmailstring
买家邮箱
buyerNamestring
买家姓名
buyerNostring
平台买家ID
buyerNotestring
买家留言
citystring
城市
customerShippingAmountinteger
客付运费
districtstring
县城
doorplateNostring
门牌号
postalCodestring
邮编
productInfoSaveListarray<object>
产品列表
隐藏子属性
pidinteger
本地商品表ID
quantityinteger
数量
sellerSkustring
卖家SKU
amountCurrencystring
订单币种代码
amountnumber
金额
productNamestring
品名
skustring
本地SKU
receiverCompanyNamestring
公司名称
receiverCountrystring
目的地国家
receiverCountryCodestring
国家代码
receiverCountryNamestring
国家名称
receiverMobilestring
收件人电话
receiverNamestring
收件人
remarkstring
客服备注（系统）
stateOrRegionstring
州
amountCurrencystring
币种代码，大写
returnWidinteger必填
退货仓库ID，目前仅支持领星WMS仓库，来源：查询仓库列表 返回的 data>>wid
returnWidDescstring
退货仓库描述，目前仅支持领星WMS仓库
logisticsTypeCodestring
物流商编码
logisticsProviderDescstring
物流商描述
deliveryTimeinteger
发货时间
globalTrackNostring
系统跟踪号
logisticsTypeIdinteger
物流方式ID，来源：查询订单管理订单列表 返回的 data>>list>>logistics_info>>logistics_type_id
platforminteger必填
平台来源：
1 亚马逊自发货
2 多平台
waybillNostring
运单号
wpTypeinteger必填
仓库类型：
1 本地仓
2 FBA仓
3 海外仓

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/customerService/workOrder/add?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
  "platformOrderNos": ["10022001"],
  "afterInfoList": [
    {
      "title": "商品标题",
      "pid": 19246,
      "asin": "B000000001",
      "handlerType": 1,
      "afterSaleQuantity": 1,
      "afterRemark": "商品破损",
      "afterImages": [
        {
          "accessUrl": "https://example.com/after-sale.jpg",
          "fileName": "after-sale.jpg",
          "mappingKey": "after-sale"
        }
      ],
      "image": "https://example.com/product.jpg",
      "unitPriceAmount": "100.00",
      "quantity": 1,
      "returnQuantity": 0,
      "sellerSku": "SKU-001",
      "productName": "商品名称",
      "orderItemNo": "ITEM-001",
      "platformOrderNo": "10022001",
      "sku": "LOCAL-SKU-001",
      "itemId": 1
    }
  ],
  "storeId": 17,
  "globalOrderNo": 103197777784349184,
  "globalPurchaseTime": "2026-07-29 17:24:50",
  "cutOff": 0,
  "hasPrediction": 0,
  "logisticsType": 1,
  "reasonUuid": "127193154373070880",
  "salesType": 1,
  "siteCode": "10001-US",
  "trackingNo": "SP728821",
  "type": 2,
  "returnWid": 1,
  "platform": 2,
  "wpType": 1
}'

返回结果

Json Object

codeinteger必填
状态码，0：成功
示例 0
messagestring必填
消息提示，创建成功时返回下游消息
示例 操作成功
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-08-31 12:00:00
datastring必填
售后工单业务ID，创建成功后可作为提交售后工单审批流接口的 businessIdList 入参
示例 202609020003
totalinteger必填
总数
示例 0

返回成功示例

{
  "code": 0,
  "message": "操作成功",
  "error_details": [],
  "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
  "response_time": "2026-08-31 12:00:00",
  "data": "202609020003",
  "total": 0
}