BambooForge Labs

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.

Buy on the Odoo Apps StoreOpen the live demo
Runs onOdoo 16 to 20Community or Enterprise, self-hosted or Odoo.sh
NeedsSales; includes field sales distributorno Enterprise module
Price527 EURone-time, per series, on the Odoo Apps Store
Demodemo20.bambooforge.devlogin page already filled in
Supportsupport@bambooforge.devfirst reply within one business day
Version20.0.1.0.1bambooforge_field_sales_distributor_stock
Store page per series:Odoo 16.0Odoo 17.0Odoo 18.0Odoo 19.0Odoo 20.0

Key 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

  1. Install Field Sales Distributors and Inventory: this module installs by itself.

    Expected: nothing new on the screens.

  2. 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

  1. Validate a delivery to a distributor.

  2. Open Distributors > Distributor Stock, or the button Stock at the Distributor on the distributor: the sell-in has its date and quantity.

  3. 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.