Module Tiers (développeur): Difference between revisions

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
VisualWikitext
mNo edit summary
m (Import interlang links (links to translated versions of this page in other languages) from origin English page "Module_Third_Parties_(developer)".)
 
(38 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<!-- BEGIN interlang links -->
<!-- Do NOT edit this section
    Links below are automatically managed by PolyglotBot
    You can edit links on the English source page : Module_Third_Parties_(developer) -->
[[en:Module_Third_Parties_(developer)]]
[[es:Módulo_Terceros_(desarrollador)]]
<!-- END interlang links -->
[[Category:Société]]
[[Category:Société]]
{{Tableau doc dev module|
{{TemplateDocDev}}
nom=société|  
{{TemplateModFR_Développeur}}
module=[[Module Société]]|
{{BasculeDevUser|
userdoc=[[Sociétés]]|}}
nom=société|
num=1|
devdoc=Cette page|
userdoc=[[Module Tiers]]|}}


(Généralités sur les [[Modules]])
= Fonction du module =


== Fonction du module ==
Le module tiers a pour vocation de permettre de gérer dans Dolibarr les entités suivantes:
 
* Les tiers (sociétés, associations, ...)
Le module société a pour vocation de permettre de gérer dans Dolibarr les entités suivantes:
* Les contacts/adresses
* Les sociétés
* Les informations bancaires de tiers
* 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é 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".
Line 18: Line 27:
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 caractéristiques de l'entité société.
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 caractéristiques de l'entité société.


== Entité Société ==
= Entité Tiers =
{{TemplateDocDevEntityFr|
class=htdocs/societe/class/societe.class.php}}


La classe PHP pour manipuler cette entité est le fichier ''htdocs/societe.class.php''.
'''Règles de gestion''':
Elle contient principalement une méthode 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), aucun des deux ou les deux.
* Une société peut avoir 1 à plusieurs [[Contacts|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).
* 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é
* Il est possible de rattacher 1 à n commerciaux (Utiliateurs Dolibarr) à une société
* A compléter...
* A compléter...


'''Cycle de vie''':
'''Cycle de vie''':
* Une société peut être créée (Provoque appel du trigger COMPANY_CREATE)
* 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)
* Une société peut être modifiée (Provoque appel du trigger COMPANY_UPDATE)
* Un contact peut être ajouté à la société
* Un contact/adresse peut être ajouté sous le Tiers
* D'autres entités peuvent être créées sur cette société (commande, propal, facture, contrat, ...)
* D'autres entités peuvent être créées sur cette société (commande, propal, facture, contrat, ...)
* Une société peut être supprimée (Provoque appel du trigger COMPANY_DELETE)
* Une société peut être supprimée (Provoque appel du trigger COMPANY_DELETE)


== Entité Société Prospect ==
= Entité Tiers Client / Prospect / Fournisseur =
Un client, prospect ou fournisseur est juste un tiers qui est défini comme client / prospect / fournisseur (ou une combinaison des 3). Il y a des classes particulières héritant du Tiers pour manipuler ces entités:<br><br>


La classe PHP pour manipuler cette entité est le fichier ''htdocs/prospect.class.php''.
 
{{TemplateDocDevEntityFr|class=htdocs/comm/prospect/class/prospect.class.php}}<br><br>
 
{{TemplateDocDevEntityFr|class=htdocs/comm/class/client.class.php}}<br><br>
 
{{TemplateDocDevEntityFr|class=htdocs/fourn/class/fournisseur.class.php}}<br><br>


'''Cycle de vie''':
'''Cycle de vie''':


Un prospect peut avoir plusieurs états :
Un prospect peut avoir plusieurs états :
* A ne pas connecter (-1) ;
* Ne pas contacter(-1) ;
* Non contacté (0) ;
* Non contacté (0) ;
* A contacter (1) ;
* A contacter (1) ;
Line 50: Line 64:
* Prospect contacté (3).
* Prospect contacté (3).


== Entité Contact ==
= Entité Contact =
 
{{TemplateDocDevEntityFr|
La classe PHP pour manipuler cette entité est le fichier ''htdocs/contact.class.php''.
class=htdocs/contact/class/contact.class.php}}
Elle contient principalement une méthode fecth, insert, update, et delete.


'''Cycle de vie''':
'''Cycle de vie''':
* Un contact peut être créé (Provoque appel du trigger CONTACT_CREATE)
* 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 modifié (Provoque appel du trigger CONTACT_UPDATE)
* Un contact peut être supprimé (Provoque appel du trigger CONTACT_DELETE)
* Un contact peut être supprimé (Provoque appel du trigger CONTACT_DELETE)


== Permissions ==
= Permissions =


* ->societe->lire
* ->societe->lire
A completer...
* ->societe->creer
* ->societe->supprimer
* ->societe->export
* ->societe->client->voir
* ->societe->contact->lire
* ->societe->contact->creer
* ->societe->contact->supprimer
* ->societe->contact->export


== Tables SQL ==
= Tables SQL =
* [[Table llx_societe|llx_societe]] Contient la liste des societes
* [[Table llx_societe|llx_societe]] Contient la liste des tiers
* [[Table llx_contratdet|llx_contratdet]] Contient les produits associés aux contrats
* [[Table llx_socpeople|llx_socpeople]] Contient la liste des contacts de tiers
* [[Table llx_societe_remise|llx_societe_remise]] Contient les réductions en attente ou consommés par le tiers
* [[Table llx_societe_rib|llx_societe_rib]] Contient la liste des modes de paiements du Tiers (Coordonnées bancaires / SEPA, compte de paiement en ligne Stripe, ...)

Latest revision as of 13:21, 23 July 2019

Retour index
Documentation développeur

File Doc dev.png

Retour index
liste des modules
Art.png

société
Numéro/ID du module 1
Doc utilisateur du module Module Tiers
Doc développeur du module Cette page

Fonction du module

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

  • Les tiers (sociétés, associations, ...)
  • Les contacts/adresses
  • Les informations bancaires de tiers

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 caractéristiques de l'entité société.

Entité Tiers

La classe PHP pour manipuler ces objets est le fichier htdocs/societe/class/societe.class.php.

Elle contient les méthodes principales CRUD pour créer (C), lire (R), mettre à jour (U) et effacer (D) un enregistrement.

Règles de gestion:

  • 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), aucun des deux ou les 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 (Utiliateurs Dolibarr) à 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/adresse peut être ajouté sous le Tiers
  • D'autres entités peuvent être créées sur cette société (commande, propal, facture, contrat, ...)
  • Une société peut être supprimée (Provoque appel du trigger COMPANY_DELETE)

Entité Tiers Client / Prospect / Fournisseur

Un client, prospect ou fournisseur est juste un tiers qui est défini comme client / prospect / fournisseur (ou une combinaison des 3). Il y a des classes particulières héritant du Tiers pour manipuler ces entités:

La classe PHP pour manipuler ces objets est le fichier htdocs/comm/prospect/class/prospect.class.php.

Elle contient les méthodes principales CRUD pour créer (C), lire (R), mettre à jour (U) et effacer (D) un enregistrement.

La classe PHP pour manipuler ces objets est le fichier htdocs/comm/class/client.class.php.

Elle contient les méthodes principales CRUD pour créer (C), lire (R), mettre à jour (U) et effacer (D) un enregistrement.

La classe PHP pour manipuler ces objets est le fichier htdocs/fourn/class/fournisseur.class.php.

Elle contient les méthodes principales CRUD pour créer (C), lire (R), mettre à jour (U) et effacer (D) un enregistrement.

Cycle de vie:

Un prospect peut avoir plusieurs états :

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

Entité Contact

La classe PHP pour manipuler ces objets est le fichier htdocs/contact/class/contact.class.php.

Elle contient les méthodes principales CRUD pour créer (C), lire (R), mettre à jour (U) et effacer (D) un enregistrement.

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é (Provoque appel du trigger CONTACT_DELETE)

Permissions

  • ->societe->lire
  • ->societe->creer
  • ->societe->supprimer
  • ->societe->export
  • ->societe->client->voir
  • ->societe->contact->lire
  • ->societe->contact->creer
  • ->societe->contact->supprimer
  • ->societe->contact->export

Tables SQL

  • llx_societe Contient la liste des tiers
  • llx_socpeople Contient la liste des contacts de tiers
  • llx_societe_remise Contient les réductions en attente ou consommés par le tiers
  • llx_societe_rib Contient la liste des modes de paiements du Tiers (Coordonnées bancaires / SEPA, compte de paiement en ligne Stripe, ...)
Retrieved from "https://wiki.dolibarr.org/index.php?title=Module_Tiers_(développeur)&oldid=42568"