Update sales plan group

Requires write_selling_plan_group access scope.
For more info , refer to:
PUT https://{handle}.myshopline.com/admin/openapi/v20250601/selling_plan_groups/selling_plan_group.json
handle : The store's unique identifier, which is the prefix of the store's domain name. For example, if a store's domain name is open001.myshopline.com , the store handle is open001 .
Request Headers
  • Content-Type required
    The value of this field is fixed to application/json; charset=utf-8
  • Authorization string required
    The access token for the API. Please refer to App authorization to obtain the access token, and then put the obtained access token into the API request header in Bearer Token.
    Example:
    Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw
Request Body
  • description string
    Show the description to the seller
    Example: This is the description
  • id string required
    Sales plan group id
    Example: 14056200245844372441100008
  • merchant_code string
    Show the name to the seller
    Example: Subscription plan group default name
  • name string required
    Name of sales plan group to show buyers
    Example: Subscription plan group default name
  • options array
    List of sales plan group options
    Example: ["delivery every 1 months", "delivery every 2 months", "delivery every 3 months"]
  • position integer
    Display position , the smaller the more front
    Example: 1
  • selling_plans_to_createobject[]
    List of sales plans created
  • billing_policyobject
    Billing strategy
  • policy_type string
    Strategy type : RECURRING - periodic billing strategy
    Example: RECURRING
  • recurringobject
    Periodic billing strategy
  • interval string
    Billing frequency unit : DAY、MONTH、WEEK、YEAR , default MONTH
    Example: DAY
  • interval_count integer
    Billing interval , default is 1
    Example: 10
  • max_cycles integer
    Maximum billing cycle
    Example: 1
  • min_cycles integer
    Minimum billing cycle
    Example: 1
  • description string
    Description of sales plan to show to buyers
    Example: This is a description
  • name string
    Name of sales plan to show to buyers
    Example: delivery every 1 weeks
  • options array
    List of sales plan options
    Example: ["Delivery every 10 days"]
  • position integer
    Display position , the smaller the more front
    Example: 1
  • pricing_policiesobject[]
    Price policy
  • fixedobject
    Fixed price strategy content , required when type is fixed
  • adjustment_type string
    Discount type , FIXED_AMOUNT : minus , PERCENTAGE : discount ( minus percentage )
  • adjustment_valueobject
    Discount value
  • fixed_value string
    Deduction amount value range : [ 0 , 99999999999.99] precision reserved two decimal 4 and 5 in
  • percentage string
    Deduction percentage value range : [ 0 , 100] precision retention whole number 4 , 5 in
  • policy_type string
    Strategy type , FIXED : fixed price strategy
  • selling_plans_to_delete array
    Sales plan to be removed from the sales plan group
    Example: ["14156213099368001129070062"]
  • selling_plans_to_updateobject[]
    Updated selling plan list
  • billing_policyobject
    Billing strategy
  • policy_type string
    Strategy type : RECURRING- periodic billing strategy
    Example: RECURRING
  • recurringobject
    Periodic billing strategy
  • interval string
    Billing frequency unit : DAY、MONTH、WEEK、YEAR , default MONTH
    Example: DAY
  • interval_count integer
    Billing interval , default is 1
    Example: 10
  • max_cycles integer
    Maximum billing cycle
    Example: 1
  • min_cycles integer
    Minimum billing cycle
    Example: 1
  • description string
    Description of sales plan to show to buyers
    Example: This is a description
  • id string required
    Sales plan id
    Example: 14156213099368001129110062
  • name string
    Name of sales plan to show to buyers
    Example: delivery every 1 weeks
  • options array
    List of sales plan options
    Example: ["Delivery every 10 days"]
  • position integer
    Display position , the smaller the more front
    Example: 1
  • pricing_policiesobject[]
    Price policy
  • fixedobject
    Fixed price policy content
  • adjustment_type string
    Discount type : FIXED_AMOUNT- minus , PERCENTAGE- discount
    Example: FIXED_AMOUNT
  • adjustment_valueobject
    Discount value
  • fixed_value string
    Deduction amount , value range : [ 0 , 99999999999.99] , precision retention of two decimal 4 and 5 in
    Example: 10
  • percentage string
    Deduction percentage , value range : [ 0 , 100] , precision retention whole number , rounding
    Example: 10.5
  • policy_type string
    Strategy type : FIXED - fixed price strategy
    Example: FIXED
Response
For more information about status codes, see Http status code.
Response Headers
  • traceId
    traceId
Response Body
  • selling_plan_groupobject
    Sales plan group
  • app_id string
    Sales channel id
    Example: c41ac9e6736785502d2333d1b1153aca795075c4
  • description string
    Show the description to the seller
    Example: This is the description
  • id string
    Sales plan group id
    Example: 14056200245844372441100009
  • merchant_code string
    Show the name to the seller
    Example: Subscription plan group default name
  • name string
    Name of sales plan group to show buyers
    Example: delivery every 1 weeks
  • options array
    List of sales plan group options
    Example: ["delivery every 1 months", "delivery every 2 months", "delivery every 3 months"]
  • position integer
    Display position , the smaller the more front
    Example: 1
  • product_ids array
    Product id list for binding
    Example: ["16057039432335097907370282"]
  • selling_plansobject[]
    Sales plan list
  • billing_policyobject
    Billing strategy
  • policy_type string
    Strategy type : RECURRING- periodic billing strategy
    Example: RECURRING
  • recurringobject
    Periodic billing strategy
  • interval string
    Billing frequency unit : DAY、MONTH、WEEK、YEAR , default MONTH
    Example: DAY
  • interval_count integer
    Billing interval , default is 1
    Example: 10
  • max_cycles integer
    Maximum billing cycle
    Example: 1
  • min_cycles integer
    Minimum billing cycle
    Example: 1
  • description string
    Description of sales plan to show to buyers
    Example: This is a description
  • id string
    Sales plan id
    Example: 14156200245844372441120009
  • name string
    Name of sales plan to show to buyers
    Example: delivery every 1 weeks
  • options array
    List of sales program options
    Example: ["Delivery every 10 days"]
  • position integer
    Display position , the smaller the more front
    Example: 1
  • pricing_policiesobject[]
    Price policy
  • fixedobject
    Fixed price policy content
  • adjustment_type string
    Discount type , FIXED_AMOUNT : minus , PERCENTAGE : discount ( minus percentage )
    Example: FIXED_AMOUNT
  • adjustment_valueobject
    Discount value
  • fixed_value string
    Deduction amount value range : [ 0 , 99999999999.99] precision reserved two decimal 4 and 5 in
    Example: 10
  • percentage string
    Deduction percentage value range : [ 0 , 100] precision retention whole number 4 , 5 in
    Example: 10.5
  • policy_type string
    Strategy type : FIXED- fixed price strategy
    Example: FIXED
API Explorer
https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601

ParamOptions

— header required

Body

required
{
  "description": "This is the description",
  "id": "14056200245844372441100008",
  "merchant_code": "Subscription plan group default name",
  "name": "Subscription plan group default name",
  "options": [
    "[\"delivery every 1 months\", \"delivery every 2 months\", \"delivery every 3 months\"]"
  ],
  "position": 1,
  "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": "delivery every 1 weeks",
      "options": [
        "[\"Delivery every 10 days\"]"
      ],
      "position": 1,
      "pricing_policies": [
        {
          "fixed": {
            "adjustment_type": "",
            "adjustment_value": {
              "fixed_value": "",
              "percentage": ""
            }
          },
          "policy_type": ""
        }
      ]
    }
  ],
  "selling_plans_to_delete": [
    "[\"14156213099368001129070062\"]"
  ],
  "selling_plans_to_update": [
    {
      "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\"]"
      ],
      "position": 1,
      "pricing_policies": [
        {
          "fixed": {
            "adjustment_type": "FIXED_AMOUNT",
            "adjustment_value": {
              "fixed_value": "10",
              "percentage": "10.5"
            }
          },
          "policy_type": "FIXED"
        }
      ]
    }
  ]
}

Language

curl --request PUT \
     --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'
Examples
Update
Request
{
  "description": "This is a description",
  "id": "14060881435226695358213144",
  "merchant_code": "Subscription plan group default name\t",
  "name": "Subscription plan group default name",
  "options": [
    "delivery every 1 months"
  ],
  "position": "1",
  "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": "delivery every 2 weeks",
      "options": [
        "Delivery every 2 weeks"
      ],
      "position": "1",
      "pricing_policies": [
        {
          "fixed": {
            "adjustment_type": "FIXED_AMOUNT",
            "adjustment_value": {
              "fixed_value": "10",
              "percentage": "10.5"
            }
          },
          "policy_type": "FIXED"
        }
      ]
    }
  ],
  "selling_plans_to_delete": [
    "14160881435226695358233144"
  ],
  "selling_plans_to_update": [
    {
      "billing_policy": {
        "policy_type": "RECURRING",
        "recurring": {
          "interval": "DAY",
          "interval_count": "10",
          "max_cycles": "1",
          "min_cycles": "1"
        }
      },
      "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"
        }
      ]
    }
  ]
}
Response
{
  "selling_plan_group": {
    "app_id": "111afe2f9baceb93004af92b1276582619f1db26",
    "description": "This is a description",
    "id": "14060881435226695358213144",
    "merchant_code": "Subscription plan group default name\t",
    "name": "Subscription plan group default name",
    "options": [
      "delivery every 1 months"
    ],
    "position": 1,
    "product_ids": [
      "16060878906566210188893144"
    ],
    "selling_plans": [
      {
        "billing_policy": {
          "policy_type": "RECURRING",
          "recurring": {
            "interval": "DAY",
            "interval_count": 10,
            "max_cycles": 1,
            "min_cycles": 1
          }
        },
        "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.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",
        "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"
          }
        ]
      }
    ]
  }
}
Was this article helpful to you?
SHOPLINE
SHOPLINE
SHOPLINE Enterprise
Legal
Privacy
Terms
Developer Agreement
LinkedInEmail
LinkedInEmail
© Copyright 2013-2025 SHOPLINE Limited.