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

- **What it is:** 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.
- **For:** Sales
- **Odoo versions:** 16.0, 17.0, 18.0, 19.0, 20.0 - Community and Enterprise
- **Runs on:** Odoo.sh or Odoo you host yourself - not Odoo Online, which accepts no third-party apps
- **Price:** 527 EUR, one-time, on the Odoo Apps Store
- **Technical name:** bambooforge_field_sales_distributor_stock
- **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:** https://docs.bambooforge.dev/bambooforge_field_sales_distributor_stock/
- **Live demo:** https://demo20.bambooforge.dev/odoo
- **Store page:** https://apps.odoo.com/apps/modules/20.0/bambooforge_field_sales_distributor_stock
- **Manual last updated:** 2026-11-11

---
# Field Sales Distributors with Inventory: Sell-in at Delivery

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

## Reference

The complete reference of this app is generated from the code on every release and published with
this manual at https://docs.bambooforge.dev/bambooforge_field_sales_distributor_stock/ under
*Reference*.

## 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](mailto: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.
