Module Tiers (développeur)

(Généralités sur les Modules)

Fonction du module

Le module société a pour vocation de permettre de gérer dans Dolibarr les entités suivantes:

• Les sociétés
• Les contacts
• Les RIB de sociétés

Une société représente un tiers moral ou physique (prospect, client, fournisseur). Le terme est mal choisi car il peut très bien s'agir d'un "particulier". Une société est caractérisée par des informations obligatoires comme le nom, pays et d'autres optionnelles comme le capital, identifiant professionnel, etc... Les contacts sont les personnes physiques d'une société. Dans le cas d'un particulier, les caractéristiques d'un contact sont les même que les caractiristiques de l'entité société.

Entité Société

La classe PHP pour manipuler cet entité est le fichier htdocs/societe.class.php. Elle contient principalement une methode fecth, insert, update, et delete.

• Une société peut avoir 1 à plusieurs contacts.
• Une société a une caractéristique qui peut être prospect (Dans ce cas l'entité Société une fois créée peut aussi etre manipulé comme entité Prospect), client (Dans ce cas l'entité Société une fois créée peut aussi etre manipulé comme entité Client) ou aucun des deux.
• Une société a une caractéristique fournisseur qui peut etre non ou oui (Dans ce cas l'entité Société une fois créée peut aussi etre manipulé comme entité Fournisseur).
• Il est possible de rattacher 1 à n commerciaux par défaut à une société
• A compléter...

Cycle de vie:

• Une société peut être créée (Provoque appel du trigger COMPANY_CREATE)
• Une société peut être modifiée (Provoque appel du trigger COMPANY_UPDATE)
• Un contact peut être ajouté à la société
• D'autres entités peuvent être créées sur cet société (commande, propal, facture, contrat, ...)
• Une société peut être supprimée (Provoque appel du trigger COMPANY_DELETE)

Entité Société Prospect

La classe PHP pour manipuler cet entité est le fichier htdocs/prospect.class.php.

Cycle de vie:

Un prospect peut avoir plusieurs état:

• A ne pas connecter (-1) ;
• Non contacté (0) ;
• A contacter (1) ;
• Contact en cours (2) ;
• Prospect contacté (3).

Entité Contact

La classe PHP pour manipuler cet entité est le fichier htdocs/contact.class.php. Elle contient principalement une methode fecth, insert, update, et delete.

Cycle de vie:

• Un contact peut être créé (Provoque appel du trigger CONTACT_CREATE)
• Un contact peut être modifié (Provoque appel du trigger CONTACT_UPDATE)
• Un contact peut être supprimée (Provoque appel du trigger CONTACT_DELETE)

Permissions

• ->societe->lire

A completer...

Tables SQL

• llx_societe Contient la liste des societes
• llx_contratdet Contient les produits associés aux contrats