Création et mise à jour de la composition du capital et des associés d'une société (dossier de production)
Avec ce guide, vous allez être accompagné afin de créer et/ou mettre à jour la composition du capital et les associés d'une société.
Dans MyUnisoft, pour gérer ces éléments vous devez accéder à l'onglet Associés par le module CRM : Ecosystème > CRM > Entreprises.
Sélectionnez le dossier de production pour lequel vous souhaitez gérer la liste des associés et la composition du capital.
Vous obtenez les différents onglets de l'entreprise interrogée. Cliquez sur Associés pour accéder à celui-ci et pouvoir compléter les éléments requis.
API
Ce module est composé de trois thématiques sur lesquelles vous pouvez opérer séparément : Capital, personnes physiques, personnes morales
Capital
La route https://api.myunisoft.fr/api/v1/society/capital permet d'ajouter et/ou mettre à jour les données du capital social via l'API partenaire.
IMPORTANT
🔹 Accès cabinet : L'accès cabinet nécessitera la présence de l'en-tête HTTP society-id avec l'id du dossier de production.
curl --location 'https://api.myunisoft.fr/api/v1/society/capital' \
--header 'X-Third-Party-Secret: nompartenaire-L8vlKfjJ5y7zwFj2J49xo53V' \
--header 'society-id: 1;' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{API_TOKEN}}' \
--data '{
"effective_date": "2023-07-15",
"capital": 35000,
"social_part": 100
}'Une fois la requête exécutée, l'API vous retournera une réponse au format JSON :
Exemple de retour JSON de l'API
{
"historical_id": 1526,
"date": "2023-07-15",
"capital": 35000,
"social_part": 100,
"social_part_value": 350
}La route attend un body au format JSON composé de propriétés de l'interface suivante :
Interface TypeScript Capital
export interface Capital {
effective_date: string,
capital: number,
social_part: number
}NB : Le format de date de la propriété effective_date est le suivant : "YYYY-MM-DD".
Personnes physiques
La route https://api.myunisoft.fr/api/v1/associate/natural_person permet d'ajouter et/ou mettre à jour les associés personnes physiques via l'API partenaire.
IMPORTANT
🔹 Accès cabinet : L'accès cabinet nécessitera la présence de l'en-tête HTTP society-id avec l'id du dossier de production.
curl --location 'https://api.myunisoft.fr/api/v1/associate/natural_person' \
--header 'X-Third-Party-Secret: nompartenaire-L8vlKfjJ5y7zwFj2J49xo53V' \
--header 'society-id: 1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{API_TOKEN}}' \
--data '{
"physical_person_id": 5861,
"signatory_function_id": 3,
"function_id": 10,
"start_date": "2023-08-10",
"end_date": "",
"social_part": {
"PP": 50,
"NP": 0,
"US": 0
},
"account_id": 18719593,
"effective_date": "2023-08-10"
}'Une fois la requête exécutée avec succès, l'API vous retournera une réponse au format JSON :
Exemple de retour JSON de l'API
{
"physical_person_link_id": 2588,
"physical_person": {
"id": 5861,
"firstname": "",
"name": "",
"account_id": 18719593
},
"effective_date": "2023-08-10",
"start_date": "2023-08-10",
"end_date": "",
"signatory_function": {
"id": 3,
"label": ""
},
"function": {
"id": 10,
"label": ""
},
"social_part": {
"PP": 50,
"NP": 0,
"US": 0,
"percent": 50
}
}La route attend un body au format JSON composé de propriétés de l'interface suivante :
Interface TypeScript Personne Physique
export interface PersonnePhysique {
physical_person_id: number,
signatory_function_id: number,
function_id: number,
start_date: string,
end_date: string,
social_part: {
PP: number,
NP: number,
US: number
},
account_id: number,
effective_date: string
}Voici quelques détails concernant certaines propriétés spécifiques et les moyens pour récupérer leurs valeurs applicables :
physical_person_id: Pour récupérer la liste des personnes physiques et leur id, vous pouvez consulter la section de la page Récupérer les utilisateurs et personnes physiques d'un schema.start_date/end_date/effective_date: il s'agit des dates d'entrée, de sortie, et de changement effectif d'un associé. La valeur attendue est une chaîne de caractère au format "YYYY-MM-DD".account_id: correspond à l'id des comptes courrants d'associés ou compte de débiteurs créditeurs divers. Pour récupérer la liste des comptes d'une société, vous pouvez consulter cette page.signatory_function_id: l'id de la fonction de signataire que vous souhaitez appliquer à l'associé (personne physique ou personne morale). Vous pouvez consulter la liste des valeurs statiques utilisables sur cette page.function_id: l'id de la fonction occupée par l'associé au sein de la structure. La liste des fonctions occupées est consultable sur cette page.social_part: il s'agit de la composition du nombre de parts d'associés classé par catégories. Les différentes catégories de parts sociales sont détaillées dans le tableau ci-dessous.clé correspondance PP"Pleine propriété" NP"Nue propriété" US"Usufruit"
Personnes morales
La route https://api.myunisoft.fr/api/v1/associate/legal_entity permet d'ajouter et/ou mettre à jour les associés personnes morales via l'API partenaire.
IMPORTANT
🔹 Accès cabinet : L'accès cabinet nécessitera la présence de l'en-tête HTTP society-id avec l'id du dossier de production.
curl --location 'https://api.myunisoft.fr/api/v1/associate/legal_entity' \
--header 'X-Third-Party-Secret: nompartenaire-L8vlKfjJ5y7zwFj2J49xo53V' \
--header 'society-id: 1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{API_TOKEN}}' \
--data '{
"society_id": 1,
"signatory_function_id": 6,
"start_date": "2023-08-15",
"end_date": "",
"social_part": {
"PP": 50,
"NP": 0,
"US": 0
},
"account_id": 18719588,
"effective_date": "2023-08-15",
"revenu_pro": false
}'Une fois la requête exécutée avec succès, l'API vous retournera une réponse au format JSON :
Exemple de retour JSON de l'API
{
"society_link_id": 2004,
"society": {
"id": 5303,
"address": "10 Avenue Granot 07800 BEAUCHASTEL FRANCE",
"name": "SCI Un, Deux, Trois",
"siret": "07955606400016",
"id_type_company": 1,
"account_id": 18719588,
"assujetti_unique": false,
"capital": 1000,
"date_capital": "2022-03-24",
"nb_part": 10,
"revenu_pro": false,
"start_date": "2023-08-15",
"end_date": "",
"effective_date": "2023-08-15"
},
"social_part": {
"NP": 0,
"PP": 50,
"US": 0,
"percent": 50
},
"signatory_function": {
"id": 6,
"label": ""
}
}La route attend un body au format JSON composé de propriétés de l'interface suivante :
Interface TypeScript Personne Morale
export interface PersonneMorale {
society_id: number,
signatory_function_id: number,
start_date: string,
end_date: string,
social_part: {
PP: number,
NP: number,
US: number
},
account_id: number,
effective_date: string,
revenu_pro: boolean
}Voici quelques détails concernant certaines propriétés spécifiques et les moyens pour récupérer leurs valeurs applicables :
society_id: il s'agit de l'id de la société (dossier comptable) qui détient des part dans le capital de cette structure. Pour récupérer cet identifiant, vous pouvez consulter la page suivante.start_date/end_date/effective_date: il s'agit des dates d'entrée, de sortie, et de changement effectif d'un associé. La valeur attendue est une chaîne de caractère au format "YYYY-MM-DD".account_id: correspond à l'id des comptes courrants d'associés ou compte de débiteurs créditeurs divers. Pour récupérer la liste des comptes d'une société, vous pouvez consulter sur cette page.signatory_function_id: l'id de la fonction de signataire que vous souhaitez appliquer à l'associé (personne physique ou personne morale). Vous pouvez consulter la liste des valeurs statiques utilisables sur cette page.social_part: il s'agit de la composition du nombre de parts d'associés classé par catégories. Les différentes catégories de parts sociales sont détaillées dans le tableau ci-dessous.clé correspondance PP"Pleine propriété" NP"Nue propriété" US"Usufruit"