api-partenaires

[!IMPORTANT] Ce guide ne contient pas toutes les clés JSON (n’hésitez pas à utiliser la console chrome)

Création et mise à jour d’un dossier de production (entreprise)

L’objectif de ce guide est de vous aider à créer et mettre à jour un dossier de production.

Dans MyUnisoft, la création d’un dossier s’effectue avec le module CRM: Ecosystème > CRM > Entreprises.

API

curl --location \
--request POST 'https://app.myunisoft.fr/api/v1/society' \
--header 'X-Third-Party-Secret: xxx-L8vlKfjJ5y7zwFj2J49xo53V' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer '

[!NOTE] Pour une mise à jour il vous suffira de changer le verbe HTTP pour PUT. La route ne nécessite pas un objet complet, elle fera une mise à jour partielle avec les propriétés présente dans le body.

Exemple “minimaliste” d’un BODY JSON:

{
  "member_id": 1,
  "name": "Nom du dossier",
  "siret": "84014327500039",
  "id_type_company": 1,
  "date_engage_letter": "20210728",
  "folder_reference": "Reference",

  "address_number": "54",
  "road_type_id": 9,
  "street_name": "RUE DU LAPIN",
  "postal_code": "75000",
  "city": "PARIS",
  "country": "FRANCE",
  "ape_id": 550,
  "activity": "Programmation informatique",
  "registration_date": "20210728",
}

[!IMPORTANT] Les propriétés du bas sont récupérables avec la route society/data_gouv_fields (attention quelques transformations sont parfois nécessaires)

Recherche d’informations à partir du SIREN/SIRET

curl --location \
--request GET 'https://app.myunisoft.fr/api/v1/society/data_gouv_fields?siren=&check=false' \
--header 'X-Third-Party-Secret: xxx-L8vlKfjJ5y7zwFj2J49xo53V' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer '

La route en question vous retournera un ensemble de propriétés qui pourront être injectées dans la création du dossier.

Visualiser la réponse JSON

Exemple de réponse pour le SIRET `84014327500039` (MY UNISOFT). ```json { "name": "MY UNISOFT", "address_number": "4", "address_bis": null, "street_name": "GALVANI", "postal_code": "91300", "city": { "label": "MASSY", "value": "MASSY" }, "tva_intraco": "FR73840143275", "country": "FRANCE", "form": null, "registration_date": "2021-03-22", "road_type": { "id": 9, "label": "Rue", "value": "Rue" }, "ape": { "id": 534, "label": "5829C", "value": "\u00c9dition de logiciels applicatifs" }, "activity": "\u00c9dition de logiciels applicatifs" } ```

Cabinet d’appartenance

Le cabinet correspond à la propriété member_id.

curl --location \
--request GET 'https://app.myunisoft.fr/api/v1/member' \
--header 'X-Third-Party-Secret: xxx-L8vlKfjJ5y7zwFj2J49xo53V' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer '

Vous pouvez visualiser la réponse avec la collection postman en ligne

Type du dossier

Type du dossier qui correspond à la propriété id_type_company.

id	label
1	Client
2	Prospect
3	Suspect
4	Ancien client
5	Associé client
6	Filliale client
7	Partenaire
8	Prescripteur
9	Etablissement
10	Cabinet

Utilisateurs (Expert comptable, Manager et Collaborateur)

Cet affichage correspond à l’onglet Utilisateurs du CRM, permettant de configurer les responsables du dossier (personnes physiques).

Les trois champs doivent être mis à jour en utilisant les clés suivantes, chacune contenant l’ID de la personne physique (préalablement récupéré via l’API users_v2) :

Expert-comptable : id_accountant
Manager : id_rm
Collaborateur : id_collab

Pour plus d’informations, consultez le guide : Récupérer les utilisateurs et personne physiques d’un schéma (cabinet)

(retour en haut de page)