Tiers
API Reference : tiers
Description
Principales informations concernant les Tiers.
Un Tiers représente une ressource Client, Fournisseur, Tiers Salarié ou Autre.
Il n’est pas possible de créer un tiers en utilisant la ressource Tiers, il faut utiliser une des ressources : Client, Fournisseur, tiersSalarie ou tiersAutres.
La ressource Tiers offre l’avantage de pouvoir intégrer des développements pouvant concerner plusieurs types de tiers à la fois. Par exemple liste de tous les tiers situés à Marseille quels que soient leurs types.
La ressource Tiers est également nécessaire en relation sur les écritures.
Propriétés
Propriétés | Type | Description | Longueur |
---|---|---|---|
id | string | Id | |
dateModification | datetime | Date de modification | |
dateCreation | datetime | Date de création | |
numero | string | Compte de tiers | 17 |
type |
|
Type de tiers | |
intitule | string | Intitulé | 69 |
qualite | string | Qualité (société, indépendant, …) | 17 |
classement | string | Abrégé utilisé pour le Classement | 17 |
contact | string | Personne à contacter | 35 |
ape | string | Code NAF/APE | 7 |
identifiant | string | Numéro de TVA | 25 |
siret | string | Numéro SIRET | 14 |
commentaire | string | Commentaire | 35 |
telecom | telecom | Information télécommunication | |
adresse | adresse | Information adresse | |
sommeil | boolean | Mettre en sommeilPlus d'infos | |
simplifie | boolean | Statut simplifiéPlus d'infos | |
donneesEffacees | boolean | Données personnelles effacéesPlus d'infos | |
comptePrincipal ou | single-valued navigation | compte principal du tiers dans Comptes Plus d'infos | |
modeleReglement | single-valued navigation | modèle de règlement du tiers dans modelesReglement |
Telecom
Propriétés | Type | Description | Longueur |
---|---|---|---|
site | string | Site web | 69 |
string | 69 | ||
telephone | string | Numéro téléphone | 21 |
Adresse
Propriétés | Type | Description | Longueur |
---|---|---|---|
pays | string | Pays | 35 |
ville | string | Ville | 35 |
codePostal | string | Code postal | 9 |
adresse | string | Adresse | 35 |
complement | string | Complément adresse | 35 |
Relations
Navigation | Destination | Cardinalité | $expand |
---|---|---|---|
comptePrincipal | comptes | 1..1 |
Oui |
comptes | comptes | 1..+ |
|
modeleReglement | modelesReglement | 1..? |
Oui |
contacts | tiers/contacts | 1..* |
|
reglements | tiers/reglements | 1..* |
Principales routes
Verbe | Route | Description |
---|---|---|
/{datasetId}/tiers |
Liste des Tiers | |
/{datasetId}/tiers('{id}') |
Tiers d’après son Id | |
Utiliser les ressources Client, Fournisseur, Tiers Salarié ou Tiers Autres pour créer un tiers | ||
/{datasetId}/tiers('{id}') |
Suppression d’un tiers | |
/{datasetId}/tiers('{id}') |
Modification d’un tiers | |
/{datasetId}/tiers('{id}') |
Modification partielle d’un tiers | |
/{datasetId}/tiers('{id}')/effacerDonneesPersonnelles |
Effacer les données personnelles | |
Autres routes |
Contraintes Suppression
Pour qu’un tiers puisse être supprimé il ne faut pas de rattachement à :
- une écriture
Effacer les données personnelles
Si un tiers ne peut pas être supprimé car des écritures lui sont rattachées, l’action Effacer les données personnelles peut être appelée pour supprimer d’un point de vue RGPD des données personnelles tout en conservant les données légales ou fiscales liées au Tiers.
Verbe | Route | Description |
---|---|---|
/{datasetId}/tiers('{id}')/effacerDonneesPersonnelles |
Effacer les données personnelles |
Cette action aura le même impact que l’action équivalente disponible depuis l’interface du produit :
Pour le Tiers concerné :
- toutes les informations de la fiche seront effacées à l’exception du compte de tiers (
numero
) et de l’intitulé (intitule
), - la valeur de la propriété
sommeil
sera forcée à true, le Tiers sera alors mis en sommeil. - la valeur de la propriété
donneesEffacees
sera forcée à true. Dans l’interface, une mention sur la fiche du Tiers indiquera que les données personnelles ont été effacées.
Informations
- donneesEffacees : Cette propriété indique que les données du tiers sont effacées dans le cadre de la réglementation RGPD. La notion de données effacées correspond à une suppression mais le tiers est conservé anonymisé dans la base de données car des données légales ou fiscales lui sont encore rattachées.
- sommeil : Activez cette option si vous souhaitez que le compte ne soit plus mouvementé.
- tiersPayeur : Si cette propriété est non affectée en création d’un tiers, le tiers payeur sera implicitement le tiers créé.
- Compte Principal : Une valeur sera affectée par défaut si dans Codification des tiers / Comptes collectifs est paramétré un radical ou un compte général. Dans le cas contraire il sera obligatoire de renseigner une référence d’un compte.
- simplifie : permet d’identifier que le tiers a été créé avec des informations minimales en vue de pouvoir ensuite être requalifié.
Dans l’application, cette propriété est affectée à true lors de la saisie simplifiée d’un tiers.
En exemple, dans un développement de récupération d’écritures comptables, si on propose de créer les tiers inexistants à la volée, il sera pertinent d’affecter cette propriété à true pour que les tiers concernées pissent ensuite être requalifiés depuis l’application comme s’ils avaient été créé via la saisie simplifiée.