轻易云
注册体验

领星ERP新增售后工单接口

所属平台
领星ERP
类型
WebAPI
作用
EXECUTE
接口版本
1.0
适配器
\Adapter\LingXing\LXExecuteAdapter
授权方式
OTHER
描述
客服 · POST · 请求参数 87 个(必填 34) · 响应参数 7 个 · 限流令牌桶容量 1
更新日期
2026-11-21

新增售后工单

POST/basicOpen/customerService/workOrder/add
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/customerService/workOrder/add"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/customerService/workOrder/add?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n  \"platformOrderNos\": [\"10022001\"],\n  \"afterInfoList\": [\n    {\n      \"title\": \"商品标题\",\n      \"pid\": 19246,\n      \"asin\": \"B000000001\",\n      \"handlerType\": 1,\n      \"afterSaleQuantity\": 1,\n      \"afterRemark\": \"商品破损\",\n      \"afterImages\": [\n        {\n          \"accessUrl\": \"https://example.com/after-sale.jpg\",\n          \"fileName\": \"after-sale.jpg\",\n          \"mappingKey\": \"after-sale\"\n        }\n      ],\n      \"image\": \"https://example.com/product.jpg\",\n      \"unitPriceAmount\": \"100.00\",\n      \"quantity\": 1,\n      \"returnQuantity\": 0,\n      \"sellerSku\": \"SKU-001\",\n      \"productName\": \"商品名称\",\n      \"orderItemNo\": \"ITEM-001\",\n      \"platformOrderNo\": \"10022001\",\n      \"sku\": \"LOCAL-SKU-001\",\n      \"itemId\": 1\n    }\n  ],\n  \"storeId\": 17,\n  \"globalOrderNo\": 103197777784349184,\n  \"globalPurchaseTime\": \"2026-07-29 17:24:50\",\n  \"cutOff\": 0,\n  \"hasPrediction\": 0,\n  \"logisticsType\": 1,\n  \"reasonUuid\": \"127193154373070880\",\n  \"salesType\": 1,\n  \"siteCode\": \"10001-US\",\n  \"trackingNo\": \"SP728821\",\n  \"type\": 2,\n  \"returnWid\": 1,\n  \"platform\": 2,\n  \"wpType\": 1\n}'",
  "responseExample": {
    "code": 0,
    "message": "操作成功",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-08-31 12:00:00",
    "data": "202609020003",
    "total": 0
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1platformOrderNos平台单号array<any>—必填平台单号,来源:查询订单管理订单列表 返回的 data>>list>>item_info>>platform_order_no(去重)
2afterInfoList平台订单列表信息array<object>—可选平台订单列表信息;不传时无需传其子字段
2.1title标题string—必填标题,来源:查询订单管理订单列表 返回的 data>>list>>item_info>>title
2.2pid本地产品IDinteger—必填本地产品ID
2.3asinasinstring—必填ASIN,来源:查询订单管理订单列表 返回的 data>>list>>item_info>>product_no(亚马逊返回 ASIN,其他平台返回平台商品ID)
2.4handlerType处理方式integer—必填处理方式: 1 重新上架 2 由WMS决定 3 暂存区 4 不良品 5 销毁
2.5afterSaleQuantity售后数量integer—必填售后数量
2.6afterRemark售后说明string—必填售后说明
2.7afterImages售后凭证图片列表array<object>—可选售后凭证图片列表,未传时默认空数组
2.7.1accessUrl图片访问地址string—必填图片访问地址
2.7.2fileName文件名string—必填文件名
2.7.3mappingKey映射键string—必填映射键
2.8image商品图片地址string—可选商品图片地址,未传时默认空字符串
2.9unitPriceAmount单价string—必填单价,来源:查询订单管理订单列表 返回的 data>>list>>item_info>>unit_price_amount
2.10quantity订购数量integer—必填订购数量,来源:查询订单管理订单列表 返回的 data>>list>>item_info>>quantity
2.11returnQuantity已退款数量integer—必填已退款数量,来源:查询订单已退货数量 返回的 data>>returnQty>>num,按本行 orderItemNo 匹配对应商品行
2.12sellerSku亚马逊定义的商品SKUstring—必填亚马逊定义的商品SKU,即MSKU,来源:查询订单管理订单列表 返回的 data>>list>>item_info>>msku
2.13productName品名string—必填品名,来源:查询订单管理订单列表 返回的 data>>list>>item_info>>local_product_name
2.14orderItemNo商品行号string—必填商品行号,来源:查询订单管理订单列表 返回的 data>>list>>item_info>>order_item_no
2.15platformOrderNo平台单号string—必填平台单号,来源:查询订单管理订单列表 返回的 data>>list>>item_info>>platform_order_no
2.16sku本地SKUstring—必填本地SKU,来源:查询订单管理订单列表 返回的 data>>list>>item_info>>local_sku
2.17itemId原商品项IDinteger—必填原商品项ID,仅作备份,来源:查询订单管理订单列表 返回的 data>>list>>item_info>>id
3amountCurrency订单币种代码string—可选订单币种代码,来源:查询订单管理订单列表 返回的 data>>list>>amount_currency
4createManualWork创建手工单integer—可选创建手工单: 0 无选择 1 立即创建 2 退货完成后创建
5cutOff自发货截单integer—必填自发货截单: 0 不截单 1 截单
6globalOrderNo系统单号(汇总订单)integer—必填系统单号(汇总订单),来源:查询订单管理订单列表 返回的 data>>list>>global_order_no
7globalPurchaseTime实际订单下单时间string—必填实际订单下单时间,格式:yyyy-MM-dd HH:mm:ss,来源:查询订单管理订单列表 返回的 data>>list>>global_purchase_time(时间戳需转换为该格式)
8hasPrediction三方仓预报integer—必填三方仓预报: 0 不预报 1 预报
9logisticsProvider物流商string—可选物流商
10logisticsType物流类型integer—必填物流类型: 1 自选物流 2 三方仓物流
11platformCode平台CODEstring—可选平台CODE
12preArrivalTime预计到货时间string—可选预计到货时间
13reasonUuid售后原因UUIDstring—必填售后原因UUID,来源:查询售后原因 返回的 data>>list>>reasonId
14remark备注string—可选备注
15salesType退货类型integer—必填退货类型: 1 买家退货 2 物流退货
16siteCode平台和站点唯一标识string—必填平台和站点唯一标识,来源:查询订单管理订单列表 返回的 data>>list>>site_code
17source单据来源integer—必填单据来源: 1 手工创建 2 线上同步
18storeId店铺唯一标识integer—必填店铺唯一标识,来源:查询订单管理订单列表 返回的 data>>list>>store_id
19sid店铺IDinteger—可选店铺ID,来源:查询订单管理订单列表 返回的 data>>list>>store_id
20tagList标签UUID组合array<any>—可选标签UUID组合,来源:查询全局标签 返回的 data>>pageList>>globalTagId
21trackingNo跟踪号string—必填跟踪号,来源:查询订单管理订单列表 返回的 data>>list>>logistics_info>>tracking_no
22type售后类型integer—必填售后类型,目前仅支持: 2 仅退货
23wid发货仓库IDinteger—可选发货仓库ID,来源:查询订单管理订单列表 返回的 data>>list>>wid
24workOrderSupplement补充信息object—可选补充信息
24.1platformOrderNo平台单号string—可选平台单号
24.2platformOrderName平台单号别名string—可选平台单号别名
24.3addressLine1详情地址1string—可选详情地址1
24.4addressLine2详情地址2string—可选详情地址2
24.5addressLine3详情地址3string—可选详情地址3
24.6addressType地址类型integer—可选地址类型: 1 住宅地址 2 商业地址
24.7buyerChooseExpress客选物流string—可选客选物流
24.8buyerEmail买家邮箱string—可选买家邮箱
24.9buyerName买家姓名string—可选买家姓名
24.10buyerNo平台买家IDstring—可选平台买家ID
24.11buyerNote买家留言string—可选买家留言
24.12city城市string—可选城市
24.13customerShippingAmount客付运费integer—可选客付运费
24.14district县城string—可选县城
24.15doorplateNo门牌号string—可选门牌号
24.16postalCode邮编string—可选邮编
24.17productInfoSaveList产品列表array<object>—可选产品列表
24.17.1pid本地商品表IDinteger—可选本地商品表ID
24.17.2quantity数量integer—可选数量
24.17.3sellerSku卖家SKUstring—可选卖家SKU
24.17.4amountCurrency订单币种代码string—可选订单币种代码
24.17.5amount金额number—可选金额
24.17.6productName品名string—可选品名
24.17.7sku本地SKUstring—可选本地SKU
24.18receiverCompanyName公司名称string—可选公司名称
24.19receiverCountry目的地国家string—可选目的地国家
24.20receiverCountryCode国家代码string—可选国家代码
24.21receiverCountryName国家名称string—可选国家名称
24.22receiverMobile收件人电话string—可选收件人电话
24.23receiverName收件人string—可选收件人
24.24remark客服备注(系统)string—可选客服备注(系统)
24.25stateOrRegion州string—可选州
24.26amountCurrency币种代码string—可选币种代码,大写
25returnWid退货仓库IDinteger—必填退货仓库ID,目前仅支持领星WMS仓库,来源:查询仓库列表 返回的 data>>wid
26returnWidDesc退货仓库描述string—可选退货仓库描述,目前仅支持领星WMS仓库
27logisticsTypeCode物流商编码string—可选物流商编码
28logisticsProviderDesc物流商描述string—可选物流商描述
29deliveryTime发货时间integer—可选发货时间
30globalTrackNo系统跟踪号string—可选系统跟踪号
31logisticsTypeId物流方式IDinteger—可选物流方式ID,来源:查询订单管理订单列表 返回的 data>>list>>logistics_info>>logistics_type_id
32platform平台来源integer—必填平台来源: 1 亚马逊自发货 2 多平台
33waybillNo运单号string—可选运单号
34wpType仓库类型integer—必填仓库类型: 1 本地仓 2 FBA仓 3 海外仓

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0:成功
2message消息提示string操作成功必填消息提示,创建成功时返回下游消息
3error_details数据校验失败时的错误详情array<any>—必填数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583必填请求链路id
5response_time响应时间string2026-08-31 12:00:00必填响应时间
6data售后工单业务IDstring202609020003必填售后工单业务ID,创建成功后可作为提交售后工单审批流接口的 businessIdList 入参
7total总数integer0必填总数

领星ERP的接口:新增售后工单(/basicOpen/customerService/workOrder/add),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。