Salla icon

Salla

Interact with Salla.sa e-commerce platform API

Actions45

Coupon → Update

AI-generated

Overview

This node operation updates an existing coupon in the Salla e-commerce platform. It allows users to modify various coupon attributes such as status, start date, application platform, usage limits, product/category inclusions or exclusions, group coupon settings, and marketing commission details. This operation is useful for managing and adjusting coupon details dynamically to reflect changes in marketing strategies or business rules.

Use Case Examples

  1. Updating the status of a coupon to 'inactive' to temporarily disable it.
  2. Changing the usage limit per user to restrict how many times a customer can use the coupon.
  3. Modifying the list of product IDs that the coupon applies to, to target specific products.

Properties

Name Meaning
ID The unique identifier of the coupon to update, required to specify which coupon to modify.
Additional Fields A collection of optional fields to update various coupon attributes such as status, start date, application platform, usage limits, product/category inclusions or exclusions, group coupon settings, and marketing commission details.

Output

JSON

  • id - The unique identifier of the updated coupon.
  • code - The coupon code.
  • type - The type of discount (percentage or fixed).
  • amount - The discount amount.
  • status - The current status of the coupon.
  • start_date - The start date of the coupon.
  • applied_in - Where the coupon can be applied (all, web, app).
  • usage_limit - Total usage limit of the coupon.
  • usage_limit_per_user - Usage limit per user.
  • minimum_amount - Minimum purchase amount required to use the coupon.
  • maximum_amount - Maximum discount amount allowed.
  • products_include - List of product IDs included in the coupon.
  • products_exclude - List of product IDs excluded from the coupon.
  • list_include_categories - List of category IDs included in the coupon.
  • list_exclude_categories - List of category IDs excluded from the coupon.
  • is_group - Indicates if the coupon is a group coupon.
  • group_name - Name of the coupon group.
  • group_coupons_count - Number of coupons in the group.
  • group_suffix - Suffix for the group coupons.
  • marketing_active - Whether marketer commission is active.
  • marketing_name - Name of the marketer.
  • marketing_type - Type of marketer commission.
  • marketing_amount - Amount of marketer commission.

Dependencies

  • Salla API with OAuth2 authentication

Troubleshooting

  • Ensure the coupon ID provided exists; otherwise, the update will fail with a resource not found error.
  • Validate that numeric fields such as usage limits and amounts are non-negative and logically consistent.
  • If updating group coupon fields, ensure all required group fields (group name, count, suffix) are provided when 'Is Group Coupon' is true.
  • Check API authentication credentials are valid and have permissions to update coupons.

Links

Discussion