Overview

This node operation creates a new coupon in the Salla e-commerce platform. It allows users to define various coupon attributes such as the unique coupon code, discount type (percentage or fixed amount), discount amount, expiry date, free shipping option, and whether to exclude sale products. Additional optional fields can be set, including coupon status, start date, application platform, usage limits, product/category inclusions or exclusions, group coupon settings, and marketing commission details. This operation is useful for automating the creation of promotional coupons to offer discounts or special deals to customers.

Use Case Examples

1. Creating a percentage discount coupon with a specific expiry date and free shipping enabled.
2. Generating a group of coupons with a usage limit and marketing commission activated.

Properties

Output

JSON

• code - The unique coupon code identifier.
• type - The type of discount (percentage or fixed).
• amount - The discount amount value.
• expiry_date - The expiration date of the coupon.
• free_shipping - Indicates if the coupon includes free shipping.
• exclude_sale_products - Indicates if sale products are excluded from the coupon.
• status - The status of the coupon (active or inactive).
• start_date - The start date of the coupon validity.
• applied_in - Where the coupon can be applied (all platforms, web only, app only).
• is_apply_with_offer - Whether the coupon can be applied with other offers.
• 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.
• show_maximum_amount - Whether to show the maximum discount amount to customers.
• 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 part of a group.
• 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 - Indicates if marketer commission is active.
• marketing_name - Name of the marketer.
• marketing_type - Type of marketer commission.
• marketing_amount - Amount of marketer commission.

Dependencies

• Salla.sa API
• An API key credential for Salla OAuth2 authentication

Troubleshooting

• Ensure the coupon code is unique to avoid conflicts.
• Verify that the expiry date is at least one day in the future to prevent validation errors.
• If creating a group of coupons, ensure group name, count, and suffix are provided and valid.
• Check API credentials and permissions if requests fail due to authentication errors.
• Review the format of product and category ID lists to ensure they are comma-separated and numeric where required.

Links

• Salla API Coupons Documentation - Official API documentation for managing coupons in Salla platform.