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