Module Shipments

Shipments
Numéro/ID du module 80
Doc utilisateur du module This page
Doc développeur du module Module Shipments (developer)

Introduction

The Shipping module allows you to manage product shipments from a sales order. It becomes possible to follow the quantities dispatched and quantities remaining to be dispatched, to generate a packing slip, to see proof of distribution.

Note: For receptions, see Module Reception.

Installation

This module is included with the Dolibarr distribution, so there is no need to install it.

Configuration

To use this module, you must first enable it using an administrator account, via the menu option "Home - Setup - Modules".

Choose the tab where the module is listed. Then click on "Activate".

The module is now activated.

If a cog icon appears   on module thumb or at end of the line of the module, click on it to access the setup page specific to the module.

Usage

In standard configuration

When the module is activated, it becomes possible to create a shipment from a sale order. The workflow for an expedition is as follows:

Draft (0) ---X---> Validated = Prepared / To ship or Shipped (1) ---X---> Processed (Closed / Shipped) '' (2)
                                                 \                                  /
                                                  <---------------------------------

Note:

  • For status other than "Draft", the quantity can no longer be modified.
  • Number in parenthesis: Numeric value of the status in the database
  • X means that the stock can be automatically decremented during this step (depending on the stock decrement configuration of Stock Module).


TODO Evolution to plan:

  • Can edit a shipment when in draft mode. Move form used in create mode into the edit draft page. Add a button to switch (one warehouse / all warehouse) ?
  • When the module "Lot" is on, you must be able to enter the batches and change quantity before going to closed/shipped.
  • Make it possible to modify the number shipped when the shipment is in "Validated" status. It will then be possible to create good shipments WITHOUT an order, serving as a preparation order without an order ?

Using the hidden option WORKFLOW_BILL_ON_SHIPMENT (not supported, unstable)

With v18-: If the hidden option WORKFLOW_BILL_ON_SHIPMENT is set, the Closed step is replaced by Billed.

Draft (0) --X--> Validated (1) ---> Invoiced (2)

With v19+: Workflow is the same, no change into the label of status, when value is set to 0 of not defined (default). If set to 1, then, it is no more possible to create an invoice from the order (can be done from the shipment only).

Note

Depending on the configuration of the Stock module, the stock can be decremented by:

  • Validation of shipments.
  • Closing a shipment.

For companies managing shipments, the Closed step can also mean the udder in charge by the carrier, the Validated step being the processing of the order internally (making the package, issuing the BL)