Lingxing
切换旧版

商品维度 - 创建运营计划

POST/basicOpen/product/operationPlan/add

支持创建 asin、父 ASIN 或 SKU 维度的运营计划。

接口信息

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

请求参数

planDTOobject必填
运营计划基本信息
隐藏子属性
dimensionstring必填
计划维度
asin：ASIN
parentAsin：父ASIN
sku：SKU
planNamestring
计划名称，公司内不能重名
storeIdinteger
店铺ID，asin、parentAsin维度必传，来源：查询亚马逊店铺列表返回的 data[].sid
storeIdsstring
多个店铺ID，sku维度必传，英文逗号分隔，来源：查询亚马逊店铺列表返回的 data[].sid
asinstring
ASIN，dimension 为 asin 时必传
parentAsinstring
父ASIN，dimension 为 parentAsin 时必传
skustring
SKU，dimension 为 sku 时必传
currencyCodestring
统计币种，sku维度必传；asin、parentAsin维度可传空字符串
chargeUidinteger
计划负责人UID，来源：查询用户管理列表返回的 data>>uid
startTimestring必填
计划开始日期，格式 yyyy-MM-dd
endTimestring
计划结束日期，格式 yyyy-MM-dd
planStatusinteger
计划状态
0：未开始
1：进行中
2：已结束
remarkstring
计划备注
fileUrlstring
附件地址，空值由后端设置为空字符串
planTaskDTOListarray<object>
创建计划时一并新增的任务
隐藏子属性
taskNamestring必填
任务名称
taskDeliverstring必填
任务交付物
expectStartTimestring必填
预期开始日期，格式 yyyy-MM-dd
expectEndTimestring必填
预期结束日期，格式 yyyy-MM-dd
handleUidinteger必填
处理人UID，来源：查询用户管理列表返回的 data>>uid
opTemplateIdstring
计划模板ID，来源：查询运营计划模板列表返回的 data>>records>>id
opTemplateTaskIdstring
模板任务ID，来源：将本任务的 opTemplateId 传入查询运营计划模板任务，获取返回的 data>>id
taskSubjectstring
任务主题
taskTagstring
任务标签，自由字符串
remarkstring
任务备注
taskStatusinteger
任务状态
0：未开始
1：进行中
2：已完成
3：已取消
taskContentstring
任务内容
deliverContentstring
交付内容
planTargetDTOListarray<object>
创建计划时一并新增的目标指标
隐藏子属性
targetKeystring必填
指标编码，见附加说明
targetDetailstring
sale、salesVolume、orderQuantity 必传 sum 或 avg；其他指标传空字符串或不传
targetValuestring必填
指标值，数字字符串且不能带 %
targetTypeinteger
指标分类
1：销售指标
2：广告指标

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/product/operationPlan/add?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "planDTO": {
        "dimension": "sku",
        "planName": "SKU测试计划",
        "storeIds": "8,9,10,12",
        "sku": "00202192103",
        "currencyCode": "USD",
        "chargeUid": 10326572,
        "startTime": "2026-08-31",
        "endTime": "2026-09-30",
        "planStatus": 1,
        "remark": "新品运营计划",
        "fileUrl": "[]"
    },
    "planTaskDTOList": [
        {
            "taskName": "完成发货计划",
            "taskDeliver": "发货计划编号",
            "expectStartTime": "2026-08-31",
            "expectEndTime": "2026-09-04",
            "handleUid": 10326572
        }
    ],
    "planTargetDTOList": [
        {
            "targetKey": "sale",
            "targetDetail": "sum",
            "targetType": 1,
            "targetValue": "100"
        }
    ]
}'

返回结果

Json Object

codeinteger必填
状态码，0：成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路 id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-08-18 12:00:00
dataobject必填
无业务返回数据
totalinteger必填
总记录数
示例 0

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-08-18 12:00:00",
    "data": null,
    "total": 0
}

附加说明

销售指标：sale、salesVolume、orderQuantity、profitRate、estimatedGrossProfitRate、grossMargin、grossProfitRate、review。其中前三项的 targetDetail 只能传 sum 或 avg，SKU 维度不支持 review。

广告指标：adClickSum、adImpressionSum、adClickRate、adConvertRate、acos、adSpendSum、adSpendAvg、adSalesAmount、adOrderQuantity、advRate、acoas；其 targetDetail 传空字符串或不传。