Difference between revisions of "Module Third Parties (developer)"

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
Line 5: Line 5:
 
nom=Third parties|
 
nom=Third parties|
 
num=1|
 
num=1|
devdoc=Cette page|
+
devdoc=This page|
 
userdoc=[[Module Third Parties]]|}}
 
userdoc=[[Module Third Parties]]|}}
  
= Fonction du module =
+
= Feature =
 
{{ToTranslate}}
 
{{ToTranslate}}
  
Le module société a pour vocation de permettre de gérer dans Dolibarr les entités suivantes:
+
The Third Party module is used to manage the following objects:
* Les sociétés
+
* Companies
* Les contacts
+
* Contacts/Addresses
* Les RIB de sociétés
+
* Bank information of companies
  
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".
+
A third party is a moral or physical entity (prospect, customer, supplier). This can be a company, foundation but also be a physical person.
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...
+
A third party is defined by mandatory information like name and country but also by optional information like capital, professional id, 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é.
+
Contacts/Addresses are physical persons of a company or generic addresses. For a physical person, properties of a contact has similar values than properties of contact.
  
= Entité Société =
+
= Element Third Party =
 
{{TemplateDocDevEntityEn|
 
{{TemplateDocDevEntityEn|
 
class=htdocs/societe/class/societe.class.php}}
 
class=htdocs/societe/class/societe.class.php}}
  
 
'''Business rules''':
 
'''Business rules''':
* Une société peut avoir 1 à plusieurs contacts.
+
* A third party can have 1 or more contacts/addresses.
* 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.
+
* A third party has a property to define if it's a prospect, a customer, none or both.
* 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).
+
* A third party has a property to define if it's a supplier or not.
* Il est possible de rattacher 1 à n commerciaux par défaut à une société
+
* You can attach one to n sales representative (Dolibarr users) to a third party.
* A compléter...
+
* To complete...
 
 
'''Cycle de vie''':
 
  
 +
'''Life cycle''':
 +
{{ToComplete}}
 
* 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)

Revision as of 10:33, 16 February 2011

Third parties
Numéro/ID du module 1
Doc utilisateur du module Module Third Parties
Doc développeur du module This page

Feature

En verysmall.png Page waiting for translation. To translate, create an account, go back and clic on "Modify".
Fr verysmall.png Page en attente de traduction. Pour traduire, créez un compte, revenez et cliquez sur "Modifier".
Es verysmall.png Página a traducir. Para traducirla, cree una cuenta, vuelva a la página y haga clic en "editar".
It verysmall.png Pagina da tradurre. Per tradurla, crea un utente, torna indietro e clicca su "modifica".
Pt verysmall.png Página a aguardar por tradução. Para traduzir, crie uma conta, volte atrás e clique em "Modificar".
De verysmall.png Seite wartet auf Übersetzung. Um Übersetzung zu erstellen, richte einen Account ein, geh zurück und klicke auf "bearbeiten".
Zh verysmall.png 页面等待翻译。若要翻译本页,先创建一个帐户、登录并返回本页后单击“编辑”。

The Third Party module is used to manage the following objects:

  • Companies
  • Contacts/Addresses
  • Bank information of companies

A third party is a moral or physical entity (prospect, customer, supplier). This can be a company, foundation but also be a physical person. A third party is defined by mandatory information like name and country but also by optional information like capital, professional id, etc... Contacts/Addresses are physical persons of a company or generic addresses. For a physical person, properties of a contact has similar values than properties of contact.

Element Third Party

The PHP class to use to manipulate such object is file htdocs/societe/class/societe.class.php.

It contains CRUD methods to create (C), read (R), update (U) and delete (D) this object.

Business rules:

  • A third party can have 1 or more contacts/addresses.
  • A third party has a property to define if it's a prospect, a customer, none or both.
  • A third party has a property to define if it's a supplier or not.
  • You can attach one to n sales representative (Dolibarr users) to a third party.
  • To complete...

Life cycle:

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 ページは未完成の状態です。完成させるにはアカウントを作成し、ページに戻って「編集」をクリックして下さい。

  • 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 cette société (commande, propal, facture, contrat, ...)
  • Une société peut être supprimée (Provoque appel du trigger COMPANY_DELETE)

Entité Société Prospect

The PHP class to use to manipulate such object is file htdocs/comm/prospect/class/prospect.class.php.

It contains CRUD methods to create (C), read (R), update (U) and delete (D) this object.

Cycle de vie: Un prospect peut avoir plusieurs états :

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

Entité Contact

The PHP class to use to manipulate such object is file htdocs/contact/class/contact.class.php.

It contains CRUD methods to create (C), read (R), update (U) and delete (D) this object.

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