Docs › Sales › Field Sales Distributors with Inventory: Sell-in at Delivery

Field Sales Distributors with Inventory: Sell-in at Delivery
With Inventory installed, goods sold to a distributor enter its stock when the delivery is validated, and leave it again when they come back - installed by itself alongside Field Sales Distributors and Inventory.
bambooforge_field_sales_distributor_stockKey facts
- Not for
- Count what is still in your warehouse. A confirmed order not delivered is not sell-in.; Keep the ledger after an order is cancelled. Cancelling a sales order removes its sell-in lines, deliveries already done included: reverse a delivery with a return instead.; Add a screen. It changes when the ledger is written.
- Manual last updated
- 2026-11-11
With Odoo's Inventory installed on Odoo 20, goods sold to a distributor enter its stock when the delivery is validated, and leave it again when they come back. This small module installs by itself when Field Sales Distributors and Inventory are both there.
This page is the complete manual of that bridge.
Overview
For whom. A company using Field Sales Distributors with Odoo's Inventory on Odoo 20. Without this module the sell-in is written when the order is confirmed, the only sign the goods left without Inventory.
What it does
Sell-in at delivery. Each validated delivery to a distributor adds what it carried: a part delivery adds the part.
Returns come off. A validated return from the distributor takes its quantity off.
The product's unit. Two dozen on the order are 24 units on the ledger.
At install, a recount. Orders confirmed before it was installed are replaced by what they really delivered, so nothing counts twice.
What it does not do
Count what is still in your warehouse. A confirmed order not delivered is not sell-in.
Keep the ledger after an order is cancelled. Cancelling a sales order removes its sell-in lines, deliveries already done included: reverse a delivery with a return instead.
Add a screen. It changes when the ledger is written.
What it needs
Field Sales Distributors and Odoo's Inventory (sale_stock) on Odoo 20, Community or Enterprise.
Concepts
Sell-in. What you delivered to the distributor, on its ledger.
Delivery move. The validated stock move that wrote a line.
Install and first run
Install Field Sales Distributors and Inventory: this module installs by itself.
Expected: nothing new on the screens.
Confirm a sales order to a distributor and validate its delivery.
Expected: Field Sales > Distributors > Distributor Stock shows the units as sold to the distributor only once the delivery is validated.
Uninstalling
Uninstalling leaves the ledger lines written so far and goes back to writing the sell-in at confirmation.
Flows
What you see of the bridge.
What you see
Validate a delivery to a distributor.
Open Distributors > Distributor Stock, or the button Stock at the Distributor on the distributor: the sell-in has its date and quantity.
Validate a return: the sell-in goes down.
How it works
When a line is written
A line is written for each done move of a sales order to a distributor that crosses the customer location: positive going out, negative coming back. With a warehouse that ships in two or three steps only the step that reaches the customer counts. A move is written once.
Who reads and writes what
The lines are written as the superuser when a delivery is validated; who may read them is set by Field Sales Distributors.
How we make sure it works
Before every release, 4 automated checks run against this app on Odoo 16, 17, 18, 19 and 20. Among them:
Orders confirmed before install are not counted twice.
Nothing until the goods leave.
A return comes off.
In the products unit.
The complete list is in the source you receive.
For managers
This bridge has no analysis of its own: its figures show under Field Sales > Distributors > Distributor Stock.
Troubleshooting and FAQ
This bridge raises no message of its own.
Questions people ask
Do I have to install it? It installs by itself.
Does a part delivery count? Yes, for what it carried.
Support
Write to support@bambooforge.dev with your Odoo series and what the screen said.
Changelog
20.0.1.0.1
A help text on the delivery move.
This manual.
Reference
Generated from the module's own code (version 20.0.1.0.1, series 20.0) on 2026-11-12; every menu, field, setting, scheduled action, group, rule, report and endpoint below is read from the files, not written by hand.
Models
sale.order (extends Odoo's sale.order)
Adds no fields.
bf.fs.dist.stock (extends bambooforge_field_sales_distributor's bf.fs.dist.stock)
Field |
Technical name |
Type |
Help |
Flags |
|---|---|---|---|---|
Delivery Move |
stock_move_id |
Many2one to stock.move |
The validated delivery or return that wrote this line. |
readonly |
stock.move (extends Odoo's stock.move)
Adds no fields.