L’API Partenaires permet à des logiciels partenaires ainsi que des cabinets membres de récupérer et d'envoyer de l'information depuis/vers MyUnisoft.

L’authentification du partenaire/cabinet est principalement basée sur:

• une clé X-Third-Party fournie par MyUnisoft (à fournir en en-tête HTTP pour chaque requête). C'est une clé unique qui ne doit surtout pas être communiqué en dehors de nos équipes techniques respectives.
• une clé JWT (API Token) pour chaque cabinet et/ou société.

IMPORTANT

Ces deux clés sont nécessaires pour pouvoir utiliser les routes définies sur la documentation postman: https://docs.api.myunisoft.fr/

👀 Prérequis

✏️ Les éléments et informations à fournir

• nom partenaire.
• description courte partenaire (3 lignes 25 char maximum).
• description longue.
• logo partenaire (png, hauteur 50px).
• texte complémentaire (par exemple ou coller la clé sur votre interface ou lien vers une doc/vidéo d’utilisation avec myunisoft)
• nom, prénom, email pour un accès à myunisoft.
• nom, prénom, email pour une invitation slack/teams.

👉 Ce que nous renvoyons une fois les éléments ci-dessus en notre possession

• Clé X-Third-Party (C’est une clé secrète unique entre vous et nous qui sera nécessaire pour requêter l’API).
• Un compte au sein d'un schéma (cabinet) dédié aux tests d'intégration.
• Lien vers la documentation postman (https://docs.api.myunisoft.fr/#intro).

N'attendez pas pour rejoindre l'écosystème MyUnisoft connected riche de plus d'une centaine d'intégrations!

Activation de la clé secrète X-Third-Party

Vous n'avez rien à faire pour activer cette clé, ce sont les équipes MyUnisoft qui s'occupent de la générer et de l'activer (càd la rendre valide vis à vis de l'API partenaires).

NOTE

Il peut y avoir un certain délai entre la génération de la clé et son activation. La clé ne sera pas reconnue par notre API tant que la clé n'a pas été activée!

🔬 Type d'accès

Notre API partenaires a deux types distincts d'accès, chacun de ces accès permet d'interconnecter nos solutions de manière permanente par le biais d'un jeton n'ayant pas de date d'expiration (il peut être néanmoins révoqué par le gestionnaire du dossier/cabinet ou par nos équipes techniques).

Il vous sera nécessaire de choisir l'un des deux type d'accès (ou de discuter plus amplement avec nous pour vous guider vers la bonne abstraction):

🔸 Un accès restreint a une société (dossier de production) d'un cabinet.

🔹 Un accès à l'intégralité d'un cabinet.

NOTE

Le terme de cabinet ou firm est souvent utilisé à tort pour parler d'un schéma MyUnisoft. Un schéma peut contenir un à plusieurs cabinets et représente un client signé sur le plan commercial et technique.

TIP

Pour récupérer la liste et le paramétrage de plusieurs dossiers il est nécessaire d'avoir un accès cabinet. Il en va de même pour la récupération des entités qui ne sont pas liées au dossier (comme les utilisateurs et les portefeuilles).

(retour en haut de page)

🔐 Authentification

Partenaire

Voici la marche à suivre concernant l'authentification si vous êtes un partenaire: Comment s'authentifier ?

Formule API Cabinet (destiné aux cabinets eux-mêmes).

Voici la marche à suivre concernant l'authentification si vous êtes un cabinet ayant souscrit à l'offre API Cabinet: Comment s'authentifier ?

(retour en haut de page)

💡 A savoir

La racine de notre API partenaires est la suivante: https://api.myunisoft.fr/api/v1

---

Lors de l’utilisation d’une route exposée il est nécessaire d’avoir l’API Token en Bearer token dans l'en-tête Authorization.

Il est aussi nécessaire d’ajouter une en-tête “X-Third-Party-Secret” contenant la clé secrète communiqué par notre équipe.

$ curl --location
--request GET 'https://api.myunisoft.fr/api/v1/vat_param' \
--header 'X-Third-Party-Secret: xxx-L8vlKfjJ5y7zwFj2J49xo53V' \
--header 'Authorization: Bearer {{API_TOKEN}}'

Pour plus d'informations nous vous invitons à consulter les sous documentations suivantes selon la nature de votre accès:

• 🔸 Usage API avec l'accès société
• 🔹 Usage API avec l'accès cabinet
• 🔑 Liste des routes accessibles
• 🚥 Rate limiting des routes exposées
• ⚠️ Gestion et compréhension des retours/codes d'erreurs

📌 Documentation

Une liste de guides qui pourront certainement vous aider dans la réalisation de l'interconnexion avec MyUnisoft.

• Collection + Environment postman
• beta Webhooks

Guides sur les API cabinets

• Création et mise à jour d'un dossier de production
• Récupérer les utilisateurs et personnes physiques
• Récupérer les dossiers accessibles pour un utilisateur
• Récupérer les dossiers de productions (entreprises)
• Récupérer le paramétrage comptable d'un dossier de production
• Récupérer les filiales associées à une entreprise

Guides sur les API comptabilités

• beta MAD (MyUnisoft Accounting Data)
• Récupérer et travailler avec le plan comptable
  • Comprendre les informations diverses et complémentaires d'un compte client ou fournisseur
  • Mise à jour de la liste de contacts d'un compte client ou fournisseur
  • Mise à jour complète d'un compte client ou fournisseur
• Récupération et/ou création d'un compte
• Gérer l'analytique d'une société (dossier)
• Récupération des données liées aux widgets et dashboards

Ecritures et mouvements

• Import JSON, TRA+PJ, FEC, Factur-X
• Export JSON, FEC, EDI
• Attacher une pièce jointe à une écriture existante
• Récupérer et créer des drapeaux (flag) sur des lignes/mouvements
• Ajout ou modification d'un commentaire sur une écriture

Historique

Les guides et API suivantes seront prochainement remplacés par MAD.

• Récupérer les exercices
• Récupérer les banques (RIBS / IBAN)
• Récupérer les TVA
• Récupérer les journaux
• Récupérer les méthodes de paiement

👥 Contact

Prénom - Nom	Rôle(s)	Email
Thierry Davoigniot	PMO	t.davoigniot@myunisoft.fr
Thomas Gentilhomme	Lead Développeur API & Connecteurs	partners.tech@myunisoft.fr

(retour en haut de page)