---
title: Tns
slug: oip-next/0qyimfpv0hzfdxzrlnlge
icon: {"lucideIcon":"📘"}
createdAt: 2024-04-08T10:17:29.000Z
---

# Tns

## Description

L'entité TNS contient les données d'un utilisateur client travailleur non salarié (indépendant).

## Relations

### Ascendantes

| Entité  | Propriété |
| ------- | --------- |
| Project | tns       |

### Descendantes

| Entité          | Propriété        |
| --------------- | ---------------- |
| GDPR            | GDPRs            |
| ActivePolicy    | activePolicies   |
| Address         | addresses        |
| Aml             | amls             |
| BankAccount     | bankAccounts     |
| Email           | emails           |
| Finance         | finances         |
| History         | history          |
| LegalProfile    | legalProfiles    |
| OfferNode       | offerNodes       |
| PersonalProfile | personalProfiles |
| Phone           | phones           |
| SocialSecurity  | socialSecurities |

## Propriétés

| Nom                                  | Type                               | Description                                                                                                                                                                                                    | Validateur | Lecture seule ? | Dépréciée ? | Dernière version modifiée |
| ------------------------------------ | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | --------------- | ----------- | ------------------------- |
| SSNumber                             | `String`                           | Numéro de sécurité sociale                                                                                                                                                                                     |            |                 |             | 2.6.0                     |
| birthCity                            | `String`                           | Ville de naissance                                                                                                                                                                                             |            |                 |             | 2.6.0                     |
| birthCountry                         | `String`                           | Pays de naissance                                                                                                                                                                                              |            |                 |             | 2.6.0                     |
| birthDate                            | `Date`                             | Date de naissance                                                                                                                                                                                              |            |                 |             | 2.6.0                     |
| birthDatePartner                     | `Date`                             | Date de naissance du conjoint                                                                                                                                                                                  |            |                 |             | 2.6.0                     |
| birthName                            | `String`                           | Nom de naissance                                                                                                                                                                                               |            |                 |             | 2.6.0                     |
| birthZipCode                         | `String`                           | Code postal de naissance                                                                                                                                                                                       |            |                 |             | 2.6.0                     |
| civility                             | `CivilityEnum`                     | Civilité                                                                                                                                                                                                       |            |                 |             | 2.6.0                     |
| corporateName                        | `String`                           | Nom de la société                                                                                                                                                                                              |            |                 |             | 2.6.0                     |
| dependentChildren                    | `Number`                           | Nombre d'enfants à charge                                                                                                                                                                                      |            |                 |             | 2.6.0                     |
| firstName                            | `String`                           | Prénom                                                                                                                                                                                                         |            |                 |             | 2.6.0                     |
| hasCertifiedOnTheHonor               | `Boolean`                          | Certifie sur l'honneur de l'exactitude des données renseignées                                                                                                                                                 |            |                 |             | 2.6.0                     |
| healthReimbursementMethod            | `TnsHealthReimbursementMethodEnum` | Mode de remboursement                                                                                                                                                                                          |            |                 |             | 2.6.0                     |
| isAlsaceMoselle                      | `Boolean`                          | Dépend ou non du régime d'Alsace-Moselle                                                                                                                                                                       |            |                 |             | 2.6.0                     |
| isContributionEmailConsent           | `Boolean`                          | L'adhérent souhaite recevoir les rappels de cotisation par email                                                                                                                                               |            |                 |             | 2.6.0                     |
| isDigitalContract                    | `Boolean`                          | Indique si le client accepte de recevoir les documents contractuels de manière dématérialisée (email, disponible dans espace adhérent)                                                                         |            |                 |             | 2.6.0                     |
| isDigitalHealthInsuranceCard         | `Boolean`                          | Indique si la carte tiers payant a été optée au format dématérialisé                                                                                                                                           |            |                 |             | 2.6.0                     |
| isMadelin                            | `Boolean`                          | La « loi Madelin » permet au travailleur non salarié (TNS) de déduire de son revenu imposable les cotisations sur un contrat Madelin                                                                           |            |                 |             | 2.6.0                     |
| isMember                             | `Boolean`                          | Est membre                                                                                                                                                                                                     |            |                 |             | 2.6.0                     |
| isProfessionalActivityExclusionAware | `Boolean`                          | Indique que l'adhérent a bien pris connaissances de la liste d'activités professionnelles exclues                                                                                                              |            |                 |             | 2.6.0                     |
| lastName                             | `String`                           | Nom                                                                                                                                                                                                            |            |                 |             | 2.6.0                     |
| madelinMonth                         | `MonthEnum`                        | La « loi Madelin » permet au travailleur non salarié (TNS) de déduire de son revenu imposable les cotisations sur un contrat Madelin. L'imposition est donc liée au mois d'exercice fiscal du TNS déclaré ici. |            |                 |             | 2.6.0                     |
| maritalStatus                        | `MaritalStatusEnum`                | Situation familiale                                                                                                                                                                                            |            |                 |             | 2.6.0                     |
| nationality                          | `TnsNationalityEnum`               | Nationalité                                                                                                                                                                                                    |            |                 |             | 2.6.0                     |
| professionalActivity                 | `ProfessionalActivityEnum`         | Activité professionnelle                                                                                                                                                                                       |            |                 |             | 2.6.0                     |
| professionalStatus                   | `TnsProfessionalStatusEnum`        | Statut professionnel                                                                                                                                                                                           |            |                 |             | 2.6.0                     |
| regime                               | `RegimeEnum`                       | Régime de sécurité sociale                                                                                                                                                                                     |            |                 |             | 2.6.0                     |
| regimeSpecification                  | `String`                           | Spécificité du régime de sécurité sociale                                                                                                                                                                      |            |                 |             | 2.6.0                     |
| retirementAge                        | `Number`                           | Age de départ à la retraite                                                                                                                                                                                    |            |                 |             | 2.6.0                     |
| id                                   | `String`                           | Identifiant de l'entité `Tns`                                                                                                                                                                                  |            | X               |             |                           |
| code                                 | `String`                           | Codification fonctionnelle de l'entité `Tns`                                                                                                                                                                   |            |                 |             |                           |
| externalId                           | `String`                           | Identifiant de l'entité `Tns` dans le système client                                                                                                                                                           |            |                 |             |                           |
| externalCode                         | `String`                           | Codification fonctionnelle de l'entité `Tns` dans le système client                                                                                                                                            |            |                 |             |                           |
| tnsId                                | `String`                           | Identifiant public de l'entité `Tns` dans l'OIP                                                                                                                                                                |            |                 |             |                           |
| label                                | `String`                           | Information relative au nom de l'entité `Tns` dans son contexte d'utilisation                                                                                                                                  |            |                 |             |                           |
| createdAt                            | `Date`                             | Date de création de l'entité `Tns`                                                                                                                                                                             |            | X               |             |                           |
| updatedAt                            | `Date`                             | Date de modification de l'entité `Tns`                                                                                                                                                                         |            | X               |             |                           |

## Enumérations

### TnsHealthReimbursementMethodEnum

- `BOTH`
- `DIGITAL`
- `POSTAL`

### TnsNationalityEnum

- `FRENCH` => `FRANCAISE`
- `OTHER` => `AUTRE`

### TnsProfessionalStatusEnum

- `COLLABORATING_PARTNER`
- `COLLABORATOR`
- `EMPLOYEE`
- `ENTREPRENEUR`
- `LIBERAL`
- `RETIRED`
- `SELF_EMPLOYED`
- `STUDENT`
- `UNEMPLOYED`

## Enumérations génériques

- CivilityEnum
- MaritalStatusEnum
- MonthEnum
- ProfessionalActivityEnum
- RegimeEnum

## Exemple

```javascript
import { Entities } from '@fasstech/oip-core';
import { getProjectId } from '@fasstech/oip-core/entities/Project';
import { getTnsBirthCity, getTnsBirthCountry, getTnsBirthDate, getTnsBirthDatePartner, getTnsBirthName, getTnsBirthZipCode, getTnsCivility, getTnsCode, getTnsCorporateName, getTnsDependentChildren, getTnsExternalCode, getTnsExternalId, getTnsFirstName, getTnsHasCertifiedOnTheHonor, getTnsHealthReimbursementMethod, getTnsId, getTnsIsAlsaceMoselle, getTnsIsContributionEmailConsent, getTnsIsDigitalContract, getTnsIsDigitalHealthInsuranceCard, getTnsIsMadelin, getTnsIsMember, getTnsIsProfessionalActivityExclusionAware, getTnsLabel, getTnsLastName, getTnsMadelinMonth, getTnsMaritalStatus, getTnsNationality, getTnsProfessionalActivity, getTnsProfessionalStatus, getTnsRegime, getTnsRegimeSpecification, getTnsRetirementAge, getTnsSSNumber, getTnsTnsId, setTnsBirthCity, setTnsBirthCountry, setTnsBirthDate, setTnsBirthDatePartner, setTnsBirthName, setTnsBirthZipCode, setTnsCivility, setTnsCode, setTnsCorporateName, setTnsDependentChildren, setTnsExternalCode, setTnsExternalId, setTnsFirstName, setTnsHasCertifiedOnTheHonor, setTnsHealthReimbursementMethod, setTnsIsAlsaceMoselle, setTnsIsContributionEmailConsent, setTnsIsDigitalContract, setTnsIsDigitalHealthInsuranceCard, setTnsIsMadelin, setTnsIsMember, setTnsIsProfessionalActivityExclusionAware, setTnsLabel, setTnsLastName, setTnsMadelinMonth, setTnsMaritalStatus, setTnsNationality, setTnsProfessionalActivity, setTnsProfessionalStatus, setTnsRegime, setTnsRegimeSpecification, setTnsRetirementAge, setTnsSSNumber, setTnsTnsId } from '@fasstech/oip-core/entities/Tns';
import { TnsHealthReimbursementMethodEnum, TnsNationalityEnum, TnsProfessionalStatusEnum } from '@fasstech/oip-core/entities/Tns/enums';
import { CivilityEnum, MaritalStatusEnum, MonthEnum, ProfessionalActivityEnum, RegimeEnum } from '@fasstech/oip-core/entities/enums';

(async () => {
  let project = await Entities('Project').create();
  const tns = await Entities('Tns').create();
  
  setTnsSSNumber('SSNumber', tns);
  setTnsBirthCity('birthCity', tns);
  setTnsBirthCountry('birthCountry', tns);
  setTnsBirthDate(new Date('2017-01-01'), tns);
  setTnsBirthDatePartner(new Date('2017-01-01'), tns);
  setTnsBirthName('birthName', tns);
  setTnsBirthZipCode('birthZipCode', tns);
  setTnsCivility(CivilityEnum.MISTER, tns);
  setTnsCorporateName('corporateName', tns);
  setTnsDependentChildren(100, tns);
  setTnsFirstName('firstName', tns);
  setTnsHasCertifiedOnTheHonor(true, tns);
  setTnsHealthReimbursementMethod(TnsHealthReimbursementMethodEnum.POSTAL, tns);
  setTnsIsAlsaceMoselle(false, tns);
  setTnsIsContributionEmailConsent(false, tns);
  setTnsIsDigitalContract(false, tns);
  setTnsIsDigitalHealthInsuranceCard(false, tns);
  setTnsIsMadelin(false, tns);
  setTnsIsMember(false, tns);
  setTnsIsProfessionalActivityExclusionAware(false, tns);
  setTnsLastName('lastName', tns);
  setTnsMadelinMonth(MonthEnum.AUGUST, tns);
  setTnsMaritalStatus(MaritalStatusEnum.DIVORCED, tns);
  setTnsNationality(TnsNationalityEnum.FRENCH, tns);
  setTnsProfessionalActivity(ProfessionalActivityEnum.COLLABORATING_PARTNER, tns);
  setTnsProfessionalStatus(TnsProfessionalStatusEnum.LIBERAL, tns);
  setTnsRegime(RegimeEnum.REGIME_INDEPENDANT, tns);
  setTnsRegimeSpecification('regimeSpecification', tns);
  setTnsRetirementAge(114, tns);
  setTnsCode('code', tns);
  setTnsExternalId('externalId', tns);
  setTnsExternalCode('externalCode', tns);
  setTnsTnsId('tnsId', tns);
  setTnsLabel('label', tns);
  
  project = await Entities('Tns').save(project, tns);
  await Entities('Project').save(project);
  
  const projectToTest = await Entities('Project').get({ id: getProjectId(project) });
  const tnsToTest = await Entities('Tns').get(projectToTest, { filter: ({ id }) => id === getTnsId(tns) });
  
  getTnsSSNumber(tnsToTest); // 'SSNumber'
  getTnsBirthCity(tnsToTest); // 'birthCity'
  getTnsBirthCountry(tnsToTest); // 'birthCountry'
  getTnsBirthDate(tnsToTest); // new Date('2017-01-01')
  getTnsBirthDatePartner(tnsToTest); // new Date('2017-01-01')
  getTnsBirthName(tnsToTest); // 'birthName'
  getTnsBirthZipCode(tnsToTest); // 'birthZipCode'
  getTnsCivility(tnsToTest); // CivilityEnum.MISTER
  getTnsCorporateName(tnsToTest); // 'corporateName'
  getTnsDependentChildren(tnsToTest); // 100
  getTnsFirstName(tnsToTest); // 'firstName'
  getTnsHasCertifiedOnTheHonor(tnsToTest); // true
  getTnsHealthReimbursementMethod(tnsToTest); // TnsHealthReimbursementMethodEnum.POSTAL
  getTnsIsAlsaceMoselle(tnsToTest); // false
  getTnsIsContributionEmailConsent(tnsToTest); // false
  getTnsIsDigitalContract(tnsToTest); // false
  getTnsIsDigitalHealthInsuranceCard(tnsToTest); // false
  getTnsIsMadelin(tnsToTest); // false
  getTnsIsMember(tnsToTest); // false
  getTnsIsProfessionalActivityExclusionAware(tnsToTest); // false
  getTnsLastName(tnsToTest); // 'lastName'
  getTnsMadelinMonth(tnsToTest); // MonthEnum.AUGUST
  getTnsMaritalStatus(tnsToTest); // MaritalStatusEnum.DIVORCED
  getTnsNationality(tnsToTest); // TnsNationalityEnum.FRENCH
  getTnsProfessionalActivity(tnsToTest); // ProfessionalActivityEnum.COLLABORATING_PARTNER
  getTnsProfessionalStatus(tnsToTest); // TnsProfessionalStatusEnum.LIBERAL
  getTnsRegime(tnsToTest); // RegimeEnum.REGIME_INDEPENDANT
  getTnsRegimeSpecification(tnsToTest); // 'regimeSpecification'
  getTnsRetirementAge(tnsToTest); // 114
  getTnsCode(tnsToTest); // 'code'
  getTnsExternalId(tnsToTest); // 'externalId'
  getTnsExternalCode(tnsToTest); // 'externalCode'
  getTnsTnsId(tnsToTest); // 'tnsId'
  getTnsLabel(tnsToTest); // 'label'
})();
```
