add purchase_rappel. manage rappel commission for vendors

purchase_rappel/README.md

@@ -0,0 +1,40 @@
+# 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.