Qeasy Cloud
Get Started

领星ERP 新增售后工单 API

Platform
领星ERP
Type
WebAPI
Effect
EXECUTE
API Version
1.0
Adapter
\Adapter\LingXing\LXExecuteAdapter
Auth Mode
OTHER
Description
客服 · POST · 请求参数 87 个(必填 34) · 响应参数 7 个 · 限流令牌桶容量 1
Updated At
2026-11-21

新增售后工单

POST/basicOpen/customerService/workOrder/add
Factory
{
  "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
  }
}

Request Parameters

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

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0:成功
2message消息提示string操作成功Required消息提示,创建成功时返回下游消息
3error_details数据校验失败时的错误详情array<any>—Required数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583Required请求链路id
5response_time响应时间string2026-08-31 12:00:00Required响应时间
6data售后工单业务IDstring202609020003Required售后工单业务ID,创建成功后可作为提交售后工单审批流接口的 businessIdList 入参
7total总数integer0Required总数

The 新增售后工单 API (/basicOpen/customerService/workOrder/add) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.