更新销售计划组

需要 write_selling_plan_group 权限点。
更多权限点使用信息，请参考：
访问权限。
PUT https://{handle}.myshopline.com/admin/openapi/v20260301/selling_plan_groups/selling_plan_group.json
handle ：店铺的唯一标识符，值为店铺域名的前缀。例如，域名为 open001.myshopline.com 的店铺，其 handle 是 open001 。
更新销售计划组
请求头
  • Content-Type string required
    字段值固定为 application/json; charset=utf-8。
  • Authorization string required
    资源的访问令牌。参考 应用授权 获取访问令牌，然后将获取到的访问令牌以 Bearer 格式传入。
    例子:
    Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw
请求体
  • description string
    展示给卖家看的描述
    例子: This is a description
  • name string required
    展示给买家看的销售计划组名称
    例子: Subscription plan group default name
  • position integer
    展示位置，越小越靠前
    例子: 1
  • id string required
    销售计划组id
    例子: 14056200245844372441100009
  • selling_plans_to_createobject[]
    创建的销售计划列表
  • position integer
    展示位置，越小越靠前
    例子: 1
  • pricing_policiesobject[]
    价格策略
  • fixedobject
    固定价格策略内容，当 type 为 fixed 时必填
  • adjustment_valueobject
    优惠值
  • percentage string
    扣减百分比 取值范围：[0, 100] 精度保留整数 4 舍 5入
  • fixed_value string
    扣减金额 取值范围：[0, 99999999999.99] 精度保留两位小数 4 舍 5 入
  • adjustment_type string
    优惠类型, FIXED_AMOUNT: 减额，PERCENTAGE: 折扣(减去百分比)
  • policy_type string
    策略类型，FIXED: 固定价格策略
  • billing_policyobject
    计费策略
  • recurringobject
    周期性计费策略
  • interval string
    计费频率单位：DAY、MONTH、WEEK、YEAR，默认 MONTH
    例子: DAY
  • interval_count integer
    计费间隔， 默认是 1
    例子: 10
  • max_cycles integer
    最大计费周期
    例子: 1
  • min_cycles integer
    最小计费周期
    例子: 1
  • policy_type string
    策略类型：RECURRING - 周期性计费策略
    例子: RECURRING
  • description string
    展示给买家看的销售计划描述
    例子: This is a description
  • name string
    展示给买家看的销售计划名称
    例子: delivery every 1 weeks
  • options array
    销售计划选项列表
    例子: ["[\"Delivery every 10 days\"]"]
  • options array
    销售计划组选项列表
    例子: ["[\"delivery every 1 months\", \"delivery every 2 months\", \"delivery every 3 months\"]"]
  • selling_plans_to_updateobject[]
    更新的销售计划列表
  • options array
    销售计划选项列表
    例子: ["[\"Delivery every 10 days\"]"]
  • position integer
    展示位置，越小越靠前
    例子: 1
  • pricing_policiesobject[]
    价格策略
  • fixedobject
    固定价格策略内容
  • adjustment_type string
    优惠类型：FIXED_AMOUNT - 减额，PERCENTAGE - 折扣
    例子: FIXED_AMOUNT
  • adjustment_valueobject
    优惠值
  • fixed_value string
    扣减金额，取值范围：[0, 99999999999.99]，精度保留两位小数 4 舍 5 入
    例子: 10
  • percentage string
    扣减百分比，取值范围：[0, 100]，精度保留整数，四舍五入
    例子: 10.5
  • policy_type string
    策略类型：FIXED - 固定价格策略
    例子: FIXED
  • billing_policyobject
    计费策略
  • policy_type string
    策略类型：RECURRING - 周期性计费策略
    例子: RECURRING
  • recurringobject
    周期性计费策略
  • interval string
    计费频率单位：DAY、MONTH、WEEK、YEAR，默认 MONTH
    例子: DAY
  • interval_count integer
    计费间隔， 默认是 1
    例子: 10
  • max_cycles integer
    最大计费周期
    例子: 1
  • min_cycles integer
    最小计费周期
    例子: 1
  • description string
    展示给买家看的销售计划描述
    例子: This is a description
  • id string required
    销售计划ID
    例子: 14156213099368001129110062
  • name string
    展示给买家看的销售计划名称
    例子: delivery every 1 weeks
  • merchant_code string
    展示给卖家看的名称
    例子: Subscription plan group default name
  • selling_plans_to_delete array
    要从销售计划组中删除的销售计划
    例子: ["[\"14156213099368001129070062\"]"]
状态码
更多状态码信息，参考 HTTP 状态码。
响应头
  • traceId
    请求的全局唯一标识符。用于追踪请求在系统中的流转，以便于问题发生时进行定位和调试。
响应体
  • selling_plan_groupobject
    销售计划组
  • id string
    销售计划组id
    例子: 14056200245844372441100009
  • position integer
    展示位置，越小越靠前
    例子: 1
  • app_id string
    销售渠道ID
    例子: c41ac9e6736785502d2333d1b1153aca795075c4
  • description string
    展示给卖家看的描述
    例子: This is a description
  • name string
    展示给买家看的销售计划组名称
    例子: delivery every 1 weeks
  • options array
    销售计划组选项列表
    例子: ["[\"delivery every 1 months\", \"delivery every 2 months\", \"delivery every 3 months\"]"]
  • merchant_code string
    展示给卖家看的名称
    例子: Subscription plan group default name
  • product_ids array
    绑定的商品id列表
    例子: ["[\"16057039432335097907370282\"]"]
  • selling_plansobject[]
    销售计划列表
  • pricing_policiesobject[]
    价格策略
  • fixedobject
    固定价格策略内容
  • adjustment_valueobject
    优惠值
  • fixed_value string
    扣减金额 取值范围：[0, 99999999999.99] 精度保留两位小数 4 舍 5 入
    例子: 10
  • percentage string
    扣减百分比 取值范围：[0, 100] 精度保留整数 4 舍 5入
    例子: 10.5
  • adjustment_type string
    优惠类型：FIXED_AMOUNT - 减额，PERCENTAGE - 折扣
    例子: FIXED_AMOUNT
  • policy_type string
    策略类型：FIXED - 固定价格策略
    例子: FIXED
  • billing_policyobject
    计费策略
  • recurringobject
    周期性计费策略
  • interval string
    计费频率单位：DAY、MONTH、WEEK、YEAR，默认 MONTH
    例子: DAY
  • interval_count integer
    计费间隔， 默认是 1
    例子: 10
  • max_cycles integer
    最大计费周期
    例子: 1
  • min_cycles integer
    最小计费周期
    例子: 1
  • policy_type string
    策略类型：RECURRING - 周期性计费策略
    例子: RECURRING
  • description string
    展示给买家看的销售计划描述
    例子: This is a description
  • id string
    销售计划id
    例子: 14156200245844372441120009
  • name string
    展示给买家看的销售计划名称
    例子: delivery every 1 weeks
  • options array
    销售计划选项列表
    例子: ["[\"Delivery every 10 days\"]"]
  • position integer
    展示位置，越小越靠前
    例子: 1
API Explorer
https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301

ParamOptions

— header required

Body

required
{
  "name": "Subscription plan group default name",
  "position": 1,
  "selling_plans_to_delete": [
    "[\"14156213099368001129070062\"]"
  ],
  "selling_plans_to_update": [
    {
      "position": 1,
      "pricing_policies": [
        {
          "fixed": {
            "adjustment_value": {
              "fixed_value": "10",
              "percentage": "10.5"
            },
            "adjustment_type": "FIXED_AMOUNT"
          },
          "policy_type": "FIXED"
        }
      ],
      "billing_policy": {
        "policy_type": "RECURRING",
        "recurring": {
          "interval": "DAY",
          "interval_count": 10,
          "max_cycles": 1,
          "min_cycles": 1
        }
      },
      "description": "This is a description",
      "id": "14156213099368001129110062",
      "name": "delivery every 1 weeks",
      "options": [
        "[\"Delivery every 10 days\"]"
      ]
    }
  ],
  "id": "14056200245844372441100009",
  "merchant_code": "Subscription plan group default name\t",
  "options": [
    "[\"delivery every 1 months\", \"delivery every 2 months\", \"delivery every 3 months\"]"
  ],
  "selling_plans_to_create": [
    {
      "name": "delivery every 1 weeks",
      "options": [
        "[\"Delivery every 10 days\"]"
      ],
      "position": 1,
      "pricing_policies": [
        {
          "policy_type": "",
          "fixed": {
            "adjustment_type": "",
            "adjustment_value": {
              "fixed_value": "",
              "percentage": ""
            }
          }
        }
      ],
      "billing_policy": {
        "recurring": {
          "max_cycles": 1,
          "min_cycles": 1,
          "interval": "DAY",
          "interval_count": 10
        },
        "policy_type": "RECURRING"
      },
      "description": "This is a description"
    }
  ],
  "description": "This is a description"
}

Language

curl --request PUT \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301/selling_plan_groups/selling_plan_group.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json'
Examples
更新销售计划组
Request
{
  "merchant_code": "Subscription plan group default name\t",
  "position": "1",
  "selling_plans_to_update": [
    {
      "description": "This is a description",
      "id": "14160881435226695358253144",
      "name": "delivery every 3 weeks",
      "options": [
        "Delivery every 3 weeks"
      ],
      "position": "1",
      "pricing_policies": [
        {
          "fixed": {
            "adjustment_type": "FIXED_AMOUNT",
            "adjustment_value": {
              "fixed_value": "10",
              "percentage": "10.5"
            }
          },
          "policy_type": "FIXED"
        }
      ],
      "billing_policy": {
        "recurring": {
          "max_cycles": "1",
          "min_cycles": "1",
          "interval": "DAY",
          "interval_count": "10"
        },
        "policy_type": "RECURRING"
      }
    }
  ],
  "options": [
    "delivery every 1 months"
  ],
  "description": "This is a description",
  "selling_plans_to_delete": [
    "14160881435226695358233144"
  ],
  "id": "14060881435226695358213144",
  "name": "Subscription plan group default name",
  "selling_plans_to_create": [
    {
      "options": [
        "Delivery every 2 weeks"
      ],
      "position": "1",
      "pricing_policies": [
        {
          "policy_type": "FIXED",
          "fixed": {
            "adjustment_type": "FIXED_AMOUNT",
            "adjustment_value": {
              "fixed_value": "10",
              "percentage": "10.5"
            }
          }
        }
      ],
      "billing_policy": {
        "policy_type": "RECURRING",
        "recurring": {
          "interval": "DAY",
          "interval_count": "10",
          "max_cycles": "1",
          "min_cycles": "1"
        }
      },
      "description": "This is a description",
      "name": "delivery every 2 weeks"
    }
  ]
}
Response
{
  "selling_plan_group": {
    "description": "This is a description",
    "id": "14060881435226695358213144",
    "name": "Subscription plan group default name",
    "merchant_code": "Subscription plan group default name\t",
    "options": [
      "delivery every 1 months"
    ],
    "position": 1,
    "product_ids": [
      "16060878906566210188893144"
    ],
    "selling_plans": [
      {
        "id": "14160881435226695358253144",
        "name": "delivery every 3 weeks",
        "options": [
          "Delivery every 3 weeks"
        ],
        "position": 1,
        "pricing_policies": [
          {
            "fixed": {
              "adjustment_type": "FIXED_AMOUNT",
              "adjustment_value": {
                "fixed_value": "10.00"
              }
            },
            "policy_type": "FIXED"
          }
        ],
        "billing_policy": {
          "policy_type": "RECURRING",
          "recurring": {
            "interval": "DAY",
            "interval_count": 10,
            "max_cycles": 1,
            "min_cycles": 1
          }
        },
        "description": "This is a description"
      },
      {
        "description": "This is a description",
        "id": "14160881492658964472013144",
        "name": "delivery every 2 weeks",
        "options": [
          "Delivery every 2 weeks"
        ],
        "position": 1,
        "pricing_policies": [
          {
            "fixed": {
              "adjustment_type": "FIXED_AMOUNT",
              "adjustment_value": {
                "fixed_value": "10.00"
              }
            },
            "policy_type": "FIXED"
          }
        ],
        "billing_policy": {
          "policy_type": "RECURRING",
          "recurring": {
            "interval": "DAY",
            "interval_count": 10,
            "max_cycles": 1,
            "min_cycles": 1
          }
        }
      }
    ],
    "app_id": "111afe2f9baceb93004af92b1276582619f1db26"
  }
}
这篇文章对你有帮助吗？
SHOPLINE
SHOPLINE
SHOPLINE Enterprise
条款协议
隐私
条款
开发者协议
LinkedInEmail
LinkedInEmail
© Copyright 2013-2025 SHOPLINE Limited.