Difference between revisions of "Module Products"

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
m
Line 9: Line 9:
  
 
= Introduction =
 
= Introduction =
This module manage a catalog of products.  
+
This module manages the product catalog.
  
See also [[Module Services En|Modules Services]] to manage a catalog of services or page [[Module Stocks En|Module Stocks]] to manage warehouses and stock.
+
See also [[Module Services En|Modules Services]] to manage a catalog of services, or page [[Module Stocks En|Module Stocks]] to manage warehouses and stock.
  
 
= Installation =
 
= Installation =
Line 21: Line 21:
 
= Definition =
 
= Definition =
 
== Products ==
 
== Products ==
A ''product'' is a good to manage as it is an object you sell to customers or it is an object you buy from suppliers. It is a material good, contrarily to [[ServicesEn|Services]].
+
A ''product'' is an object you sell to customers or it is an object you buy from suppliers. It is a physical object as opposed to [[ServicesEn|Services]].
  
 
A product follows this rules:
 
A product follows this rules:
 
* A product can be stocked into a warehouse (only products appears in module [[Module_StockEn|Stock]]. Services are not visible).
 
* A product can be stocked into a warehouse (only products appears in module [[Module_StockEn|Stock]]. Services are not visible).
* A product can be delivered (only products appears in module [[Module Shipment|Shipment]]. Services are not visible. Services are realized but can not be shipped).
+
* A product can be delivered (only products appears in module [[Module Shipment|Shipment]]. Services are not visible. Services are realized but cannot be shipped).
* A product is a material good. It's value often decrease with time (Value of an already used product is lower than same never used product).
+
* A product is a material good. It's value often decreases with time (the value of a used product is less than a new product).
  
Some fields are dedicated to products and not available on services like:
+
Some fields are dedicated to products and not available for Services like:
 
* Weight
 
* Weight
 
* Size
 
* Size
* Custom code = Commodity code = License code = HTS (A code on 6 char to define the international category of product)
+
* Customs code = Commodity code = License code = HTS (An international 6 character code to define the category of product)
  
== Virtual products (also called Pack products) ==
+
== Virtual products (kits, also called Pack products) ==
A product or service is a virtual father product consisting of other products. This function is activated from the Products module or service configuration page. It aims to define "packages" or "batches" of products that allow to reason about orders, invoices and inventory with a single element instead of the n products as Lot.
+
A product or service may be a virtual (parent) product comprising other (real) products. This function is activated from the Products module or the Service configuration page. It allows "packages" or "kits" of products that for use in orders, invoices and inventory as a single element instead of the n products as Lot.
  
 
A virtual product complies with the following rules:
 
A virtual product complies with the following rules:
* When adding a product in a document (proposals, invoice, order), only the line of virtual product father is shown.
+
* When adding a product in a document (proposals, invoice, order), only the line of the virtual parent product is shown.
* Product stock component virtual product is incremented / decremented when the virtual product is incremented / decremented.
+
* The stock of the individual components of the virtual product is incremented / decremented when the virtual product is incremented / decremented.
* A virtual product may itself be composed of other virtual products that contain them real products.
+
* A virtual product may itself be composed of other virtual products that contain the physical products.
  
 
Note:
 
Note:

Revision as of 08:37, 11 September 2018

Products
Numero/ID of module 50
User doc. of module This page
Developer doc. of module Module Products (developer)

Introduction

This module manages the product catalog.

See also Modules Services to manage a catalog of services, or page Module Stocks to manage warehouses and stock.

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.

Definition

Products

A product is an object you sell to customers or it is an object you buy from suppliers. It is a physical object as opposed to Services.

A product follows this rules:

  • A product can be stocked into a warehouse (only products appears in module Stock. Services are not visible).
  • A product can be delivered (only products appears in module Shipment. Services are not visible. Services are realized but cannot be shipped).
  • A product is a material good. It's value often decreases with time (the value of a used product is less than a new product).

Some fields are dedicated to products and not available for Services like:

  • Weight
  • Size
  • Customs code = Commodity code = License code = HTS (An international 6 character code to define the category of product)

Virtual products (kits, also called Pack products)

A product or service may be a virtual (parent) product comprising other (real) products. This function is activated from the Products module or the Service configuration page. It allows "packages" or "kits" of products that for use in orders, invoices and inventory as a single element instead of the n products as Lot.

A virtual product complies with the following rules:

  • When adding a product in a document (proposals, invoice, order), only the line of the virtual parent product is shown.
  • The stock of the individual components of the virtual product is incremented / decremented when the virtual product is incremented / decremented.
  • A virtual product may itself be composed of other virtual products that contain the physical products.

Note: It is not a function of "manufacturing / production" where the virtual product component products are consumed son of stock father for an additional product in stock. Here, the sub-components produced a virtual product are decremented stock at the time of consumption of the virtual product and remain independent manner consumables byproducts other, unlike a manufacturing module, wherein when that a by-product is used to manufacture a father module, the products under the same stock is decremented if the father product is not yet distributed, and often this byproducts can no longer do the reverse way back in stock.

Life cycle / Business rules

En verysmall.png Page waiting to complete. To complete, create an account, go back and clic on "Modify".
Fr verysmall.png Page en attente d'être complété. Pour compléter, créez un compte, revenez et cliquez sur "Modifier".
Es verysmall.png Página a completar. Para completarla, cree una cuenta, vuelva a la página y haga clic en "editar"
De verysmall.png Seite wartet auf Vervollständigung. Um zu helfen, erstelle ein Konto, gehe zurück und klicke auf "Bearbeiten".
Cn verysmall.png 待完成,欲帮助完成,注册帐号,点击“编辑"
Jp verysmall.png ページは未完成の状態です。完成させるにはアカウントを作成し、ページに戻って「編集」をクリックして下さい。

Examples of use cases

En verysmall.png Page waiting to complete. To complete, create an account, go back and clic on "Modify".
Fr verysmall.png Page en attente d'être complété. Pour compléter, créez un compte, revenez et cliquez sur "Modifier".
Es verysmall.png Página a completar. Para completarla, cree una cuenta, vuelva a la página y haga clic en "editar"
De verysmall.png Seite wartet auf Vervollständigung. Um zu helfen, erstelle ein Konto, gehe zurück und klicke auf "Bearbeiten".
Cn verysmall.png 待完成,欲帮助完成,注册帐号,点击“编辑"
Jp verysmall.png ページは未完成の状態です。完成させるにはアカウントを作成し、ページに戻って「編集」をクリックして下さい。

UCMP01:
Situation
Actions