创建销售计划组

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

ParamOptions

— header required

Body

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

Language

curl --request POST \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601/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' \
     --data '
{
  "description": "This is a description",
  "merchant_code": "Subscription plan group default name\t",
  "name": "Subscription plan group default name\t",
  "options": [
    "[\"delivery every 1 months\", \"delivery every 2 months\", \"delivery every 3 months\"]"
  ],
  "position": 1,
  "product_ids": [
    "[\"16057039432335097907370282\"]"
  ],
  "selling_plans_to_create": [
    {
      "billing_policy": {
        "policy_type": "RECURRING",
        "recurring": {
          "interval": "DAY",
          "interval_count": 10,
          "max_cycles": 1,
          "min_cycles": 1
        }
      },
      "description": "This is a description",
      "name": "Subscription plan group default name\t",
      "options": [
        "[\"Delivery every 10 days\"]"
      ],
      "position": 1,
      "pricing_policies": [
        {
          "fixed": {
            "adjustment_type": "FIXED_AMOUNT",
            "adjustment_value": {
              "fixed_value": "10",
              "percentage": "10.5"
            }
          },
          "policy_type": "FIXED"
        }
      ]
    }
  ]
}
'
Examples
创建销售计划组
Request
{
  "app_id": "c41ac9e6736785502d2333d1b1153aca795075c4",
  "description": "Thisisadescription",
  "id": "14156200245844372441120009",
  "merchant_code": "Subscriptionplangroupdefaultname",
  "name": "Subscriptionplangroupdefaultname",
  "options": [
    "deliveryevery1months"
  ],
  "position": 1,
  "product_ids": [
    "16060878916899800731963144"
  ],
  "selling_plans_to_create": [
    {
      "billing_policy": {
        "policy_type": "RECURRING",
        "recurring": {
          "interval": "DAY",
          "interval_count": 10,
          "max_cycles": 1,
          "min_cycles": 1
        }
      },
      "description": "Thisisadescription",
      "id": "14156200245844372441120009",
      "name": "deliveryevery1weeks",
      "options": [
        "Deliveryevery10days"
      ],
      "position": 1,
      "pricing_policies": [
        {
          "fixed": {
            "adjustment_type": "FIXED_AMOUNT",
            "adjustment_value": {
              "fixed_value": "10",
              "percentage": "10.5"
            }
          },
          "policy_type": "FIXED"
        }
      ]
    }
  ]
}
Response
{
  "selling_plan_group": {
    "app_id": "111afe2f9baceb93004af92b1276582619f1db26",
    "description": "Thisisadescription",
    "id": "14060881232364316992673144",
    "merchant_code": "Subscriptionplangroupdefaultname",
    "name": "Subscriptionplangroupdefaultname",
    "options": [
      "deliveryevery1months"
    ],
    "position": 1,
    "product_ids": [
      "16060878916899800731963144"
    ],
    "selling_plans": [
      {
        "billing_policy": {
          "policy_type": "RECURRING",
          "recurring": {
            "interval": "DAY",
            "interval_count": 10,
            "max_cycles": 1,
            "min_cycles": 1
          }
        },
        "description": "Thisisadescription",
        "id": "14160881232364316992693144",
        "name": "deliveryevery1weeks",
        "options": [
          "Deliveryevery10days"
        ],
        "position": 1,
        "pricing_policies": [
          {
            "fixed": {
              "adjustment_type": "FIXED_AMOUNT",
              "adjustment_value": {
                "fixed_value": "10.00"
              }
            },
            "policy_type": "FIXED"
          }
        ]
      }
    ]
  }
}
这篇文章对你有帮助吗？
SHOPLINE
SHOPLINE
SHOPLINE Enterprise
条款协议
隐私
条款
开发者协议
LinkedInEmail
LinkedInEmail
© Copyright 2013-2025 SHOPLINE Limited.