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