Lingxing
切换旧版

商品维度 - 修改运营计划

POST/basicOpen/product/operationPlan/update

支持修改运营计划基本信息，以及任务和目标的新增、更新、删除数据。

当前不支持指标增量更新或删除，请通过 planTargetDTOList 整体替换计划指标。

接口信息

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

请求参数

planDTOobject必填
要修改的计划信息
隐藏子属性
idstring必填
运营计划ID，来源：查询运营计划列表返回的 data>>records>>id
planNamestring
计划名称，来源：查询运营计划列表返回的 data>>records>>planName
asinstring
原计划为 asin 维度时必传，仅用于校验，不会修改；来源：查询运营计划列表返回的 data>>records>>asin
parentAsinstring
原计划为 parentAsin 维度时必传，仅用于校验，不会修改；来源：查询运营计划列表返回的 data>>records>>parentAsin
skustring
原计划为 sku 维度时必传，仅用于校验，不会修改；来源：查询运营计划列表返回的 data>>records>>sku
currencyCodestring
sku维度必传；其他维度回传原值，来源：查询运营计划列表返回的 data>>records>>currencyCode
chargeUidinteger
修改计划负责人时传入，来源：查询用户管理列表返回的 data>>uid
remarkstring
计划备注
fileUrlstring
附件地址
planTaskDTOAddListarray<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
任务备注
planTaskDTOUpdateListarray<object>
修改已有任务
隐藏子属性
idstring必填
要修改的任务ID
handleUidinteger
新处理人UID，来源：查询用户管理列表返回的 data>>uid
remarkstring
新备注
planTaskDTODeleteListarray<object>
删除任务
隐藏子属性
idstring必填
要删除的任务ID
planTargetDTOListarray<object>
替换计划指标；不传、传 null 或空数组时保留原指标
隐藏子属性
targetKeystring必填
指标编码，见附加说明
targetDetailstring
sale、salesVolume、orderQuantity 必传 sum 或 avg；其他指标传空字符串或不传
targetValuestring必填
指标值，数字字符串且不能带 %
targetTypeinteger
指标分类
1：销售指标
2：广告指标

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/product/operationPlan/update?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "planDTO": {
        "id": "1869668821036392450",
        "planName": "ASIN测试计划",
        "asin": "B07R3WDSZR",
        "currencyCode": "USD",
        "chargeUid": 10326572,
        "remark": "更新测试备注",
        "fileUrl": "[]"
    },
    "planTaskDTOAddList": [
        {
            "taskName": "新增发货计划任务",
            "taskDeliver": "发货计划编号",
            "expectStartTime": "2026-08-31",
            "expectEndTime": "2026-09-04",
            "handleUid": 10326572
        }
    ],
    "planTaskDTOUpdateList": [
        {
            "id": "139734943726116960",
            "handleUid": 10326572
        }
    ],
    "planTaskDTODeleteList": [
        {
            "id": "139734943726116961"
        }
    ],
    "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
}

附加说明

更新计划基础信息时，只有 planName、remark、fileUrl、chargeUid、currencyCode 会实际更新。dimension、店铺、开始/结束日期、计划状态及统计信息均由后端保留或控制。

销售指标：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 传空字符串或不传。