> For the complete documentation index, see [llms.txt](https://docs.xorosoft.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xorosoft.com/xoroerp-1/admin/item/item-rebate.md).
# Item Rebate
### What is Item Rebate Module?
The **Item Rebate module** in XoroERP provides access-based functionality that enables users to apply rebates directly to the *Item Unit Cost*. It improves flexibility compared to the VAS Item module by allowing rebates to be applied selectively, based on pre-defined conditions.
Key highlights:
* Rebates can be configured as a **fixed amount, percentage, or custom rules**.
* Rebates integrate with **Sales Orders (SO)** and **Invoices**, supporting both manual creation and bulk uploads.
* Custom rules enable selective rebates for specific items or customers.
* **GL account mapping** ensures proper financial tracking of rebate adjustments.
This module gives businesses better control over **promotional strategies, discount structures, and customer rebate programs**.
***
**Navigation Path**
To access the Item Rebate Module, navigate through the system hierarchy: **Menu > Admin > Item > Item Rebate**.
This centralized location ensures administrators can efficiently manage all rebate configurations from a single interface.
### Fields and Options
#### Rebate Details Section
* **Item Rebate Name** – The name/identifier of the rebate setup. Helps users easily recognize the rebate.
* **Entity Type** – Defines whether the rebate applies to a customer.
* **Income Account** – GL account where rebate income is recorded. Useful for tracking rebates as inflows.
* **Expense Account** – GL account where rebate expense is tracked. Ensures accounting accuracy.
* **Rebate Adjustment Type** – Determines the method of rebate calculation:
* **$ (Fixed Amount):** A flat monetary adjustment.
* **% (Percentage):** A percentage of the Item Unit Cost.
* **Custom:** Allows creating detailed Item Rebate Rules with conditions.
#### Advanced Rebate Attributes**:**
* **Apply Rebate to Entity** – Applies rebate at the entity level (customer) instead of only at the item level. This feature allows comprehensive customer rebate programs that span multiple products and services. If **Apply Rebate to Entity** is enabled, the rebate amount will be captured and posted to the configured GL account when the transaction is processed, and the invoice is created.
* **Taxable** – Critical checkbox determining whether rebates are subject to taxation. This setting ensures compliance with local tax regulations and proper financial reporting for rebate transactions.
* **Discountable** – Controls whether rebates can be combined with other discount mechanisms. This flexibility allows businesses to create sophisticated pricing strategies with multiple promotional layers.
* **Active** – Allows users to activate or deactivate rebate configurations without deletion. This feature enables temporary promotional campaigns and seasonal adjustments.
***
#### Item Rebate Rules (Enabled when Custom is selected)
* **Country** – Restrict rebate to a specific country.
* **State/Province** – Restrict rebate within a selected state/province.
* **Item Number** – Apply rebate only to the selected item(s).
* **Select Entity** – Choose a specific customer entity to apply rebate.
* **Item Tags** – Use tags to apply rebates across item groups.
* **Customer Tags** – Apply rebate for customers tagged under specific attributes.
* **Item Category** – Apply rebate to items within a category.
* **Customer Group** – Apply rebate for customers belonging to a defined group.
* **HS Code** – Apply rebate to items identified by Harmonized System code. Useful for global trade compliance.
* **Item Default Vendor** – Restrict rebate to items purchased from a specific vendor.
* **Refund Adjustment Rule Type** – Select how rebate is refunded (*% or $*).
* **Item Rebate Rule Cost Amount** – The cost adjustment value defined by the rule.
* **Add Item Rebate Rule Button** – Adds the configured rule to the rule list.
***
#### Item Rebate Rule Details (after rules are created)
* **Entity** – The entity for which rebate applies (customer).
* **Country** – Country restriction applied to the rule.
* **State/Province** – Regional restriction applied.
* **Item#** – Item(s) covered under the rule.
* **Item Category** – Category applied for grouping rebates.
* **Item Default Vendor Name** – Vendor linked with the rebate rule.
* **Cost Type** – Defines whether the adjustment is fixed or percentage.
* **Amount** – Value of rebate applied.
* **Item Tags** – Tags linked to item(s).
* **Customer Tags** – Tags linked to customer(s).
* **HS Code** – HS Code defining the rebate applicability.
* **Customer Group** – Group of customers receiving rebate.
### Rule Management and Implementation
**Rule Creation Process**
The **Add Item Rebate Rule** functionality enables systematic creation of complex rebate conditions. Users can configure multiple parameters simultaneously, creating sophisticated business rules that automatically apply appropriate rebates based on transaction characteristics.
Each rule encompasses entity specifications, geographic limitations, item categorizations, and cost adjustment parameters. The system validates rule consistency and prevents conflicts between overlapping conditions.
The **Item Rebate Rule Cost Amount** field allows a precise definition of rebate values, while the Refund Adjustment Rule Type ensures proper calculation methodology for each specific scenario.
**Rule Details Management**
Once created, rules are displayed in a comprehensive details section showing Entity, Country, State/Province, Item Numbers, Categories associations, Cost Types, and Amounts. This transparency enables administrators to quickly review and modify existing configurations.
The system maintains complete audit trails of rule modifications, ensuring compliance and enabling troubleshooting of rebate calculations. Tag associations for both items and customers provide additional flexibility in rule application.
HS Code integration supports international trade compliance, while Customer Group associations enable bulk rebate management across customer segments.
***
#### Header Options
* **Save** – Saves the rebate configuration.
* **Delete** – Deletes a rebate setup.
***
### **Item Rebate Implementation in Sales Order and Invoice**
The Item Rebate functionality is extended to:
* **Create Sales Order (SO)**
* **Upload Sales Order**
* **Create Invoice**
It ensures that rebate fields and calculations are integrated seamlessly into the transaction workflow.
Item Rebate fields are visible in:
* **Sales Order Detail Centre**
* **Invoice Detail Centre**
* **Invoice Sub-Form**
* **Sales Order Sub-Form**
{% hint style="info" %}
GL account mapping for Item Rebates works similar to the **VAS module**, ensuring that rebates are accurately posted in financials wherever applicable.
{% endhint %}
#### Sales Order Integration
**Sales Order Creation**
Item Rebate functionality seamlessly integrates into the Create Sales Order process, automatically calculating and applying appropriate rebates based on established rules during order entry.
**Bulk Upload Processing**
Upload Sales Order functionality now includes rebate processing, enabling bulk transaction handling while maintaining rebate calculation accuracy across large data sets.
**Dynamic Adjustment**
Sales Order Sub-Form allows real-time editing of Item Rebate values and Item Rebate Unit Cost, providing flexibility during order processing and customer negotiations.
The Add Item Sub-Form automatically applies established rebates when items are selected, streamlining the order creation process while ensuring pricing accuracy.
This integration eliminates manual rebate calculations and reduces errors in order processing. Sales representatives can focus on customer relationships while the system handles complex rebate logic automatically, improving both efficiency and accuracy in the sales process.
#### Invoice Processing Enhancement
The Create Invoice functionality now incorporates Item Rebate processing, ensuring that rebate adjustments are properly reflected in customer billing. This integration maintains consistency between sales orders and final invoicing, preventing discrepancies in customer charges.
Invoice Detail Centre displays comprehensive rebate information, enabling accounting teams to verify rebate applications and resolve customer inquiries efficiently. The Invoice Sub-Form provides detailed rebate breakdowns for each line item, supporting transparent billing practices.
### Use Cases
1. **Promotions & Seasonal Discounts**\
Run limited-time promotions with % rebates on categories or tagged items.
2. **Customer Group Pricing**\
Offer rebates for specific customer groups (e.g., wholesalers vs. retailers).
3. **Geography-Based Rebates**\
Apply rebates by region (state/country) for local promotions.
4. **Compliance with Trade Rules**\
Use HS Code conditions to align rebates with international trade regulations.
### Transformational Impact on XoroERP Ecosystem
The **Item Rebate** module centralizes rebate management across Sales Orders and Invoices, ensuring consistent pricing and eliminating data silos. By replacing static pricing with rule-based rebate logic, it automates cost adjustments, improves pricing accuracy, and reduces manual effort, while giving sales teams real-time visibility into rebate impacts.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.xorosoft.com/xoroerp-1/admin/item/item-rebate.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.