Add Commission

Accessing the Add Commission Modal

The Add Commission modal can be accessed in two ways:

1. From the Partner Details screen:

   • Click the "Actions" button located in the top-right corner.
   • Select "Add Commission".

   

   
   

2. From the Commissionables section:

   • Click the "Add Commission" button located at the top of the section.

Modal Features

Product selection

• A Searchable List enables users to quickly look up products by name or description.
• Checkboxes let users select one or more products for commission configuration.
• "Select All Option": A checkbox to select all currently visible products.

Product Details and Fields

For each selected product, the following details and inputs are available:

1. Product Name: The product's description.

2. Quantity (QTY): The total units available for the product.

3. Start Pricing: Pricing options for the product.

4. Commission Fields:

   • Percentage: Input field to set a percentage commission.
   • Fixed Amount: Input field to set a fixed monetary value.
   
   

5. Currency Selection:

   • Options: USD (United States Dollar) or BRL (Brazilian Real).

   

   
   

Buttons

• Apply Button:

  • Enables once at least one product is selected.
  • Applies commission values to the selected products.

• Save Button:

  • Enables only when:
    • All required fields are complete.
    • At least one product is selected.
  • Saves all assigned commission settings and closes the modal.

• Cancel Button:

  • Closes the modal without saving any changes.

Pagination

The product list includes pagination controls at the bottom:

1. Range Display: Shows the range of currently displayed products (e.g., "1-6 of 100").
2. Items per Page: Allows users to select how many products to display per page (e.g., 10, 25, 50).
3. Navigation Buttons:
   • Previous: Go to the previous page.
   • Next: Move to the next page of products.

Behavior and Validation

1. Validation Rules:

   • Products already related to the partner (with any commission active) are excluded from the product list.
   • Percentage commission total:
     • Cannot exceed 100% for a product.
     • Validation error: "Amount exceeds the selected prices."
   • Fixed commission value:
     • Cannot exceed the product price.
     • Validation error: "Amount exceeds the selected prices."

2. Apply Settings:

   • Clicking the "Apply" button saves the entered commission settings temporarily for the session.

3. Save Settings:

   • Clicking "Save" applies all selected and validated commissions to the partner's account.
   • Validation ensures that all required fields are filled.
   • Displays a success message upon completion:
     • "Commission related successfully."

4. Cancel Action:

   • Clicking "Cancel" closes the modal and discards all changes.

5. Pagination:

   • Allows seamless navigation through the list of products.

Success Message

Upon successfully saving commissions for the partner, the user is shown this confirmation:

"Commission related successfully."

Additional Notes

• Ensure that percentage-based commissions do not exceed 100%.
• Fixed commissions must stay within the bounds of the product price.
• Use the pagination controls for smoother navigation when managing large product lists.