Independent product studio · Swedenhello@karelialabs.com

Guide

How to manage ship-and-debit claims in Odoo

Short answerIn ship-and-debit, a supplier approves a special price for a customer and the distributor claims the difference back after the goods ship. Standard Odoo records the sales and the vendor credit notes, but nothing links one to the other. You can build claims in a spreadsheet from exported invoice lines, or use Karelia MarginClaim to build them from delivered, invoiced sales in Odoo and settle them with a supplier credit.

Updated

What standard Odoo offers

  • Vendor pricelists record what you pay the supplier, not what the supplier pays back on a particular sale.
  • Sales records the delivered and invoiced quantity on each order line.
  • Vendor credit notes can be entered by hand and reconciled against the supplier's bills.
  • There is no supplier program or claim: nothing ties a credit to the sales that earned it, or stops the same sale from being claimed twice.

The usual workaround

Export the invoice lines for the approved customers and products to a spreadsheet, multiply the units by the agreed amount, and send the file to the supplier. When the supplier agrees, enter a vendor credit note. The link between the credit and the sales lives in the spreadsheet, nothing stops a line from turning up again in next month's claim, and a return after the claim is easy to miss.

Claims built from delivered sales

  1. Install Karelia MarginClaim on Odoo.sh or your own server (Odoo 18, 19 or 20).
  2. Create a program under MarginClaim / Programs: the supplier and its authorization, start and end dates, eligible customers and products, the fixed amount per product base unit and the rebate account. Attach the agreement. A manager activates the program, and its terms are then frozen.
  3. Create a claim and add posted customer invoice lines. The claimed units come from what was delivered and invoiced; lines outside the program's customers, products or invoice dates are refused, and each invoice line can be in one claim only. Claims can also be imported from a CSV file.
  4. Submit the claim. A manager approves it and prepares a draft supplier credit note with one line per sale, to review and post in Accounting. Print the supplier claim statement with the source quantities and the authorization.
  5. When the posted credit is fully reconciled against the supplier's bills, confirm the settlement.
Approved supplier margin claim in Odoo 20 with program, supplier, claim amount and approved amount, synthetic demo data
A claim, approved and ready for the supplier credit

Returns and customer credit notes after a claim lower what you have earned. The claim then shows a warning, and a manager can prepare a draft vendor bill that reverses the rebate on the returned units.

FAQ

Does Odoo have ship-and-debit or supplier rebate claims?

No. Standard Odoo records vendor prices, sales and vendor credit notes, but has no supplier program or claim that ties them together.

Can the same sale be claimed twice?

Not in Karelia MarginClaim. Each customer invoice line can belong to one claim only.

Which programs does it handle?

Supplier-approved programs in one currency that pay a fixed amount per product base unit, on fully delivered sales with one invoice line per sales order line. Percentage rebates, volume tiers and supplier portals are not covered.

More guides

More from Karelia Labs