Tiers
Les tiers regroupent l’ensemble des entités utilisées dans le système, notamment :
- clients
- fournisseurs
- transporteurs
- thanatopracteurs
- tiers payeurs
Chaque tiers est identifié par un codeTiers (identifiant fonctionnel à utiliser dans les appels API).
Le type du tiers est porté par le champ typeTiers dans les réponses, et est également utilisé comme paramètre de chemin (path variable) dans les endpoints.
Exemples de valeurs possibles :
| typeTiers | Description |
|---|---|
| client | Client |
| fournisseur | Fournisseur |
| transport | Transporteur |
| thanatos | Thanatopracteur |
| tierspayeur | Tiers payeur |
Structure d’un tiers
| Champ | Description |
|---|---|
| idTiers | Identifiant technique du tiers |
| codeTiers | Identifiant fonctionnel du tiers |
| typeTiers | Type du tiers |
| personne | Informations d’identité |
| personne.isPhysique | true = personne physique, false = personne morale |
| personne.nom | Nom ou raison sociale |
| personne.prenomUsuel | Prénom usuel |
| personne.prenoms | Prénoms |
| personne.civilite | Civilité |
| domicile | Adresse |
| moyenContact | Moyens de contact |
Pagination
Les endpoints retournent une structure paginée.
| Champ | Description |
|---|---|
| content | Liste des tiers |
| totalPages | Nombre total de pages |
| totalElements | Nombre total de tiers |
| pageable.pageNumber | Numéro de la page |
| pageable.pageSize | Taille de la page |
Liste des endpoints disponibles
GET /v1/tiers/{typeTiers}/all
Retourne la liste paginée des tiers d’un type donné.
Path variables :
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| typeTiers | string | oui | Type de tiers (client, fournisseur, tierspayeur, etc.) |
Query parameters :
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| codeBu | string | oui | Code de la BU |
| page | integer | oui | Numéro de page (commence à 0) |
Exemple :
GET /v1/tiers/client/all?codeBu={{codeBu}}&page=0
Exemple tiers payeur :
GET /v1/tiers/tierspayeur/all?codeBu={{codeBu}}&page=0
GET /v1/tiers/{typeTiers}/{codeTiers}
Retourne un tiers spécifique.
Path variables :
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| typeTiers | string | oui | Type de tiers |
| codeTiers | string | oui | Code du tiers |
Query parameters :
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| codeBu | string | oui | Code de la BU |
Exemple :
GET /v1/tiers/client/CLI00775?codeBu={{codeBu}}
Exemple tiers payeur :
GET /v1/tiers/tierspayeur/TP00012?codeBu={{codeBu}}
GET /v1/tiers/{typeTiers}/latest
Retourne les tiers créés ou modifiés depuis une date.
Path variables :
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| typeTiers | string | oui | Type de tiers |
Query parameters :
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| codeBu | string | oui | Code de la BU |
| depuis | string | oui | Date de synchronisation |
| page | integer | oui | Numéro de page |
Format :
dd/MM/yyyy HH:mm:ss
Exemple :
GET /v1/tiers/client/latest?codeBu={{codeBu}}&depuis=01/01/2026 00:00:00&page=0
GET /v1/tiers/{typeTiers}/delete/latest
Retourne les tiers supprimés depuis une date.
Path variables :
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| typeTiers | string | oui | Type de tiers |
Query parameters :
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| codeBu | string | oui | Code de la BU |
| depuis | string | oui | Date de synchronisation |
| page | integer | oui | Numéro de page |
Format :
dd/MM/yyyy HH:mm:ss
Exemple :
GET /v1/tiers/client/delete/latest?codeBu={{codeBu}}&depuis=01/01/2026 00:00:00&page=0
Note importante
Le paramètre typeTiers est une path variable et non un query parameter.
Exemple valide :
/v1/tiers/client/all
Exemple invalide :
/v1/tiers/all?typeTiers=client