addons-cm/purchase_rappel/README.md

40 lines
1.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Purchase Rappel Commission
This module allows managing **rappel commission invoices** for vendors.
## Features
- Configure a rappel commission rate per vendor.
- Automatically mark vendor bills as "pending commission".
- Generate customer (sale) invoices from selected vendor bills via a wizard.
- Group invoices by vendor and compute commission amounts based on the taxable base.
## Configuration
Go to **Purchase > Configuration > Settings > Invoicing** and set:
- **Rappel Journal**: Sales journal where rappel commission invoices will be posted.
- **Commission Product**: Product used as invoice line in rappel commission invoices (should have an income account and taxes configured).
Open a vendor contact and go to the **Sales & Purchases** tab:
- Enable **Rappel Commission**.
- Set the **Commission Rate (%)** (e.g., 5.00).
## Usage
When a vendor bill is created for a partner with rappel enabled, the bill is automatically marked as **Pending Commission**. This flag is visible in the vendor bill list and form views.
To generate rappel invoices:
1. Go to **Invoicing > Vendors > Bills**.
2. Select one or more posted vendor bills with pending commission.
3. Click **Action > Create Rappel Commission Invoice**.
4. In the wizard, confirm the **Invoice Date**, **Journal**, and **Product**.
5. Click **Create Rappel Invoice(s)**.
The system will create one sale invoice per vendor, with one line per original bill. The commission amount is computed as:
taxable_base × commission_rate / 100
The original vendor bills are automatically unmarked as pending.