Line 1:
Line 1:
−
[[Category:Produit]]
+
<!-- BEGIN origin interlang links -->
+
<!-- You can edit this section but do NOT remove these comments
+
Links below will be automatically replicated on translated pages by PolyglotBot -->
+
[[fr:Module_Produits]]
+
[[es:Módulo_Productos]]
+
[[de:Modul_Produkte]]
+
[[zh:产品模块]]
+
<!-- END interlang links -->
+
+
[[Category:Product]]
{{TemplateDocUser}}
{{TemplateDocUser}}
{{TemplateModEN}}
{{TemplateModEN}}
Line 8:
Line 17:
userdoc=This page|}}
userdoc=This page|}}
−
= 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=
{{NoInstallModuleEn}}
{{NoInstallModuleEn}}
−
= Configuration =
+
=Configuration=
{{ActivationModuleEn}}
{{ActivationModuleEn}}
−
= 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 delivered (only products appears in module [[Module Shipment|Shipment]]. Services are not visible. Services are realized but can not 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).
−
== Virtual products (also called Pack products) ==
+
*A product can be stocked into a warehouse (only products appears in module [[Module_StockEn|Stock]]. Services are not visible).
−
{{ToTranslate}}
+
*A product can be delivered (only products appears in module [[Module Shipment|Shipment]]. Services are not visible. Services are realized but cannot be shipped).
−
Un produit ou service virtuel est un produit père, constitué d'autres produits. Cette fonction s'active depuis la page de configuration du module Produits ou Service.
+
*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).
−
Elle a pour vocation à définir des "packages" ou "lots" de produits qui permettent de raisonner sur les commandes, factures et stocks avec un seul élément au lieu des n produits
+
−
constituant le lot.
+
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)
+
+
==Kits products (also called Pack Products or Virtual Products)==
+
A product or service may be registered as a Kit (a "parent") product, that is, containing other (single) products. This function is activated from the ''Products'' or the ''Service'' module settings page. It allows "packages" or "kits" of products to be dealt with as a single lot, within orders, invoices and inventory, instead of dealing individually with the components.
+
+
A Kit product complies with the following rules:
+
+
*When adding a product in a document (proposals, invoice, order), only the line of the virtual product (the "parent") is shown.
+
*The stock of each individual component inside the virtual product is incremented / decremented when the parent product is acquired / delivered.
+
*A virtual product may itself be composed of other virtual products that contain other (single) products.
+
+
Note:
+
+
This is meant as a distinct function from "manufacturing / production" where another "container" product uses the existing stock of its sub-components to produce an additional product which will then be kept in stock as such.
+
Here in fact, in the "kit product or service" function, the sub-components of a virtual product will only be decrementing the respective stock at the time of delivery of the virtual product. Till then, these sub-products remain at full disposal, to be possibly integrated in other sales processes as single independent products also.
+
+
Again, the ''manufacturing'' module acted differently : from the moment it registered a "container product", it immediately purveyed that its by-products were unusable for any other purpose. Therefore, their stock was immediately decremented whether or not the container product left the store, as it was to be considered that the sub-components could no longer be reverse engineered as single products in stock.
+
+
==Rules to manage sales prices==
+
There are 4 ways to manage sales prices in Dolibarr.
+
+
*One and only one price per product
+
*Different prices per segment of customers (see next chapter)
+
*Different prices per customer
+
*Different prices per quantity (experimental)
+
+
You must choose one and only one into the Setup of the module "Products".
+
+
===Price per segment of customers===
+
Dolibarr can accept several prices per customer segment. By default, there are 5 segments (i.e. 5 groups of different customers), but you can also edit this figure.
+
Each customer can be associated with 1 and only 1 segment, and therefore he or she will be assigned the price defined for that segment (segment 1 if the customer segment is not yet defined).
+
+
As of v12 the REST API supports getting, but not setting, multiprices per segment for a product. Prices for a product and customer segment can be set from the backoffice only.
+
+
==Categories==
+
Products can be added to one or to multiple categories.
−
Un produit virtuel répond aux règles suivantes:
+
To set categories of a product with API, you must use the APIs /categories/...
−
* Lors de l'ajout d'un produit dans un document (propositions, facture, commande), seule la ligne du produit virtuel père est affichée.
−
* Le stock de produit composant le produit virtuel est incrémenté/décrémenté quand le produit virtuel est incrémenté/décrémenté.
−
* Un produit virtuel peut lui même être constitué d'autres produits virtuels qui eux contiennent de vrais produits.
−
Remarque:
+
==Image==
−
Il ne s'agit pas d'une fonction de "fabrication/production" où les produits fils composant le produit virtuel seraient consommés du stock pour obtenir un produit père supplémentaire en stock.
+
A product can have one or multiple images. This can be manually set from the tab "Linked files" of a product.
−
Ici, les sous-produits composants un produit virtuel ne sont décrémentés du stock qu'au moment de la consommation du produit virtuel et restent des sous-produits consommables de manière indépendantes des autres, contrairement à un de module de fabrication, où lorsque qu'un sous-produits est utilisé pour fabriquer un module père, le sous produits est décrémenté du stock même si le produit père n'est pas encore distribué, et souvent ce sous-produits ne peut plus faire le chemin inverse pour revenir en stock.
−
= Life cycle / Business rules =
+
To get or set an image of a product using the APIs, you must use the API /documents (with "modulepart" parameter = "product" or "service").
+
+
==Variants==
+
A product can have multiple variants, e.g. for sizes or colors.
+
+
As of v12 the REST API supports both getting, setting and deleting variants for a product.
+
+
=Life cycle / Business rules=
{{ToComplete}}
{{ToComplete}}
−
= Examples of use cases =
+
=Related videos=
−
{{ToComplete}}
+
<youtube width="200" height="120">Qm0k1G4BYsE</youtube>
−
{{ExamplesCaseEn
+
−
|name=UCMP01:
+
−
|situation=
+
(vocal in french but subtitles are available and review in this language)
−
|actions=
+
−
}}
+
<youtube width="200" height="120">pm5i_1ij2zw</youtube>