Difference between revisions of "Module Shipments"

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
Tag: 2017 source edit
Tag: 2017 source edit
 
(8 intermediate revisions by the same user not shown)
Line 18: Line 18:
 
= Introduction =
 
= 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.
 
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 =
 
= Installation =
Line 27: Line 29:
 
= Usage =
 
= Usage =
 
== In standard configuration ==
 
== In standard configuration ==
When the module is activated, it becomes possible to create a shipment from a purchase order. The workflow for an expedition is as follows:
+
When the module is activated, it becomes possible to create a shipment from a sale order. The workflow for an expedition is as follows:
  
 
<pre>
 
<pre>
Draft (0) ---X---> Validated = Prepared / Shipped or Shipped (1) ------> Processed (Closed / Shipped) '' (2)
+
Draft (0) ---X---> Validated = Prepared / To ship or Shipped (1) ---X---> Processed (Closed / Shipped) '' (2)
 
                                                 \                                  /
 
                                                 \                                  /
 
                                                   <---------------------------------
 
                                                   <---------------------------------
Line 44: Line 46:
  
 
* 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) ?
 
* 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) ?
* Rename option "Closed" into "Shipped" Add option "Decrease real stocks on shipping classification to Closed / Shipped" when the lot module is active. When the module "Lot" is on, you must be able to enter the batches and change quantity before going to closed/shipped.
+
* 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 ?
 
* 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 ?
  
== With the hidden option WORKFLOW_BILL_ON_SHIPMENT (not supported, unstable) ==
+
== Using the hidden option WORKFLOW_BILL_ON_SHIPMENT (not supported, unstable) ==
If the hidden option WORKFLOW_BILL_ON_SHIPMENT is set, the Closed step is replaced by Billed.
+
With v18-: If the hidden option WORKFLOW_BILL_ON_SHIPMENT is set, the Closed step is replaced by Billed.
 
 
 
<pre>
 
<pre>
Draft (0) --X--> Validated (1) -> Invoiced (2)
+
Draft (0) --X--> Validated (1) ---> Invoiced (2)
 
</pre>
 
</pre>
  
 
+
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).
TODO This option should disappear in favor of a separation of ClassifyBilled and ClassifyClosed which must be de-correlated.
 
 
 
It requires:
 
* Addition of an invoiced field / status (apart) called "billed" in the shipment table.
 
  
 
== Note ==
 
== Note ==
  
Depending on the configuration of the stock module, the stock can be decremented by validation of shipments or not.
+
Depending on the configuration of the [[Module Stocks En|Stock module]], the stock can be decremented by:
  
The "Closed" step is therefore of little interest for the moment. Ultimately, we must be able to decrement the stock on it.
+
* 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)
+
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)

Latest revision as of 19:30, 3 September 2023

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 Cog circle.svg 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)