MyNotary

Vos dossiers, vos fiches, vos contrats et vos documents signés — pour classer une pièce reçue par mail, créer un dossier ou réagir à une signature.

Une connexion MyNotary permet au nœud MyNotary de travailler avec les dossiers, fiches, contrats et documents des cabinets rattachés à votre application : classer une pièce reçue par e-mail dans le drive d’un dossier, créer un dossier ou une fiche, créer un contrat depuis un modèle, suivre une signature. La même connexion alimente le déclencheur MyNotary — événement, qui démarre un workflow quand MyNotary signale un événement, par exemple une signature terminée.

La connexion porte une clé d’application MyNotary et un environnement. La clé est chiffrée au repos, appliquée par le serveur au moment de l’appel sous forme d’en-tête x-api-key, et n’apparaît jamais dans un workflow.

En bref

• Identifiant : mynotary
• Famille : Service
• Configurée par : Un membre (personnelle) ou un administrateur (partagée avec l’organisation)
• Authentification : Clé d’API ou jeton
• Type de credential : service:mynotary
• Documentation officielle de l’API : https://dev.mynotary.fr
• Environnements : Pré-production (preprod) — https://api-preprod.mynotary.fr/api/v1 ; Production (production) — https://api.mynotary.fr/api/v1
• Limite de débit appliquée par Mankomail : 300 requêtes par minute et par connexion ; jusqu’à 3 tentatives sur un 429 ou un 5xx
• Test de connexion : Oui

Pas à pas

Les mêmes étapes s’affichent dans le formulaire de connexion de l’application.

1. Demandez votre clé d’application à MyNotary (support@mynotary.fr) : une pour la pré-production, une pour la production. Elle n’est pas auto-délivrée.
2. Choisissez l’environnement ci-dessous : la clé de pré-production ne fonctionne pas en production, et l’inverse est vrai aussi.
3. Côté cabinet (abonnement PREMIUM requis), un administrateur ouvre « Paramètres du compte → Interconnexions » et copie la clé de son organisation.
4. Cette clé d’organisation s’échange UNE SEULE FOIS contre un identifiant, avec POST /clients : elle ne se conserve pas et n’est pas demandée ici.
5. Testez la connexion : les cabinets déjà rattachés à votre clé s’affichent, et le nœud vous les proposera dans une liste.

Champs de la connexion

Champ	Nature	Requis	Remarques
Environnement (environment)	Choix	Oui	La pré-production est un bac à sable : rien de ce qui y est signé n’a de valeur juridique. preprod (Pré-production (bac à sable)), production (Production) Défaut : production
Clé d’application (apiKey)	Secret — jamais réaffiché	Oui	Envoyée en en-tête x-api-key. Elle donne accès à TOUS les cabinets rattachés à votre application.

Avant de commencer

• La clé d’application n’est pas auto-délivrée. Demandez-la au support MyNotary (le guide de l’application donne l’adresse). Vous obtenez une clé pour la pré-production et une pour la production ; aucune ne fonctionne dans l’autre environnement.
• Côté cabinet, un abonnement PREMIUM est requis. Un administrateur du cabinet ouvre Paramètres du compte → Interconnexions et copie la clé de son organisation.
• La clé d’organisation s’échange une seule fois, par le POST /clients de MyNotary, contre un identifiant d’organisation rattaché à votre application. Mankomail ne fait pas cet échange et ne stocke jamais la clé d’organisation : faites-le une fois, en suivant la documentation développeur de MyNotary. Une fois rattaché, le cabinet apparaît dans la liste des cabinets du nœud.
• La clé d’application donne accès à tous les cabinets rattachés à votre application. Ne créez une connexion de portée Organisation que si chaque membre de l’organisation peut agir sur tous ces cabinets.
• L’API MyNotary ne permet pas d’envoyer un contrat en signature : l’envoi se fait dans l’interface MyNotary. Le workflow prépare le dossier, les fiches et le contrat ; une personne l’envoie ; le déclencheur réagit à la signature.

Autorisations

MyNotary n’a pas de scopes : la clé d’application peut tout ce que l’API permet, pour chaque cabinet rattaché. Presque chaque appel exige l’identifiant du cabinet, d’où le cabinet en racine de toutes les listes de l’éditeur :

Liste	Dépend de
Cabinet	— (les cabinets rattachés à la clé)
Utilisateur, Type de dossier, Dossier	Cabinet
Modèle de contrat	Cabinet → Type de dossier (un modèle de contrat n’existe qu’à l’intérieur d’un type de dossier)
Type de fiche	—

Le nœud propose six ressources : Dossier (lister, lire, créer, ajouter un intervenant), Contrat (lister les contrats d’un dossier, lire, créer depuis un modèle, suivre la signature), Fiche (chercher, lire, créer, mettre à jour), Document (lister le drive d’un dossier, obtenir un lien de téléchargement, télécharger, déposer), Utilisateur (lister) et Webhook (lister, créer, supprimer). MyNotary n’offre aucune clé d’idempotence : rejouer une étape de création après un incident crée une seconde fiche ou un second dossier ; cherchez avant de créer.

Chaque appel envoie aussi x-api-documents-version: 2, pour que les champs de documents portent des identifiants de fichier plutôt que des URL de téléchargement.

Environnements

C’est la connexion qui porte l’environnement, jamais le nœud : Pré-production (bac à sable) ou Production. Rien de ce qui est signé en pré-production n’a de valeur juridique.

• Le formulaire propose Production par défaut : vérifiez-le avant d’enregistrer.
• Si la valeur stockée est absente ou inconnue, la connexion se replie sur le premier environnement déclaré, la pré-production : une connexion abîmée mène au côté le moins risqué.
• Chaque environnement a sa propre clé. Pour travailler dans les deux, créez deux connexions (par exemple « MyNotary — pré-production » et « MyNotary — production ») ; l’environnement s’affiche en badge sur chaque connexion. Changer l’environnement d’une connexion existante sans ressaisir la clé n’est pas enregistré : créez plutôt une nouvelle connexion.

Ajouter la connexion

1. Ouvrez Connexions. Dans la section Services tiers, repérez la carte MyNotary et cliquez sur Connecter.
2. Donnez un Nom à la connexion, choisissez la Portée — Personnelle (vous seul) ou Organisation (toute l’organisation ; seul un administrateur peut la créer) — puis l’Environnement.
3. Collez la Clé d’application et cliquez sur Créer la connexion.
4. De retour dans la liste, cliquez sur Configurer sur la nouvelle connexion, puis sur Tester la connexion.

Le test appelle GET /organizations. Il affiche La connexion fonctionne, suivi du premier cabinet rattaché et du nombre des autres (« Nom du cabinet +2 »). Une clé valide sans cabinet rattaché passe le test sans nom : rattachez un cabinet par l’échange de la clé d’organisation avant de construire un workflow.

Dans un nœud, choisissez la connexion dans Connexion MyNotary, puis le cabinet, puis les listes qui en dépendent. Supprimer est refusé tant qu’un workflow publié utilise la connexion.

Webhooks

Le déclencheur MyNotary — événement reçoit les webhooks de MyNotary sur l’URL du workflow :

<PUBLIC_BASE_URL>/hooks/wf/<jeton>

• Obtenir l’URL. Le jeton est généré à la première publication du workflow et rendu une seule fois ; seule son empreinte est conservée. Vous pouvez en générer un nouveau avec POST /api/v1/workflows/{id}/webhook (voir l’API) : la réponse donne webhook.url (/hooks/wf/<jeton>), à préfixer par <PUBLIC_BASE_URL>. Générer une nouvelle URL invalide la précédente.
• S’abonner. Les abonnements MyNotary se gèrent par l’API : utilisez le nœud MyNotary, ressource Webhook, opération Créer un webhook, avec l’URL dans URL de réception. L’abonnement est créé avec authType: NONE. Supprimer un webhook le retire.
• Preuve d’origine. MyNotary ne signe rien. La seule preuve est le jeton de 256 bits de l’URL. Gardez l’URL confidentielle, et régénérez-la si elle a fuité.
• Filtrage. MyNotary envoie tous les événements de tous les cabinets rattachés à la clé sur la même URL. Mankomail lit eventId dans le corps et ne crée une exécution que s’il fait partie des Événements cochés sur le déclencheur (par défaut : Signature terminée). Rien de coché = tous les événements. Un événement écarté est acquitté par 202 et ne crée rien. Le champ Cabinet concerné est indicatif : pour ne traiter qu’un cabinet, comparez data.mynotary.organizationId dans une condition.
• Pas de déduplication. eventId nomme le type d’événement, pas la livraison : MyNotary ne fournit aucun identifiant de livraison. Une livraison rejouée par MyNotary crée une seconde exécution. Les workflows qui écrivent ailleurs doivent s’en protéger (table de correspondance, vérification d’un statut).
• Réponses. 202 avec un executionId quand une exécution démarre ; 202 sans corps pour un événement écarté ; 404 pour un jeton inconnu ou un workflow non publié ; 400 si le corps n’est pas du JSON ; 413 au-delà de 256 Ko ; 429 au-delà de 300 appels par minute depuis la même IP.

Le corps arrive sous data.mynotary (par exemple {{ data.mynotary.contractId }}). L’exécution n’a pas de mail porteur. MyNotary ne documentant aucune politique de réessai, un repli par sondage (un déclencheur Planification avec Suivre la signature) rattrape ce qu’un webhook perdu laisserait passer.

Erreurs fréquentes

Message ou code	Cause	Que faire
Test : « la clé est refusée par le service » (integration.unauthorized)	Mauvaise clé, ou clé de l’autre environnement.	Vérifiez l’Environnement ; si la clé est celle de l’autre, créez une nouvelle connexion avec le bon environnement.
Le test réussit sans nom de cabinet	La clé est valide mais aucun cabinet n’est encore rattaché.	Échangez la clé d’organisation du cabinet (POST /clients), puis testez à nouveau.
Test : « le quota du service est dépassé » (integration.rate_limited)	MyNotary a répondu 429.	La clé est bonne : réessayez dans un moment.
integration.unauthorized pendant une exécution	401 ou 403.	Remplacez la clé, ou vérifiez que le cabinet est toujours rattaché à votre application.
integration.not_found	404 : le dossier, le contrat, la fiche ou le fichier n’existe pas dans ce cabinet ou dans cet environnement.	Vérifiez les identifiants et l’environnement de la connexion.
integration.rejected	400 ou 422 : MyNotary a refusé le corps (par exemple un modèle de contrat qui n’appartient pas au type de dossier).	Corrigez le paramétrage du nœud.
integration.rate_limited	429 après les nouvelles tentatives. Mankomail envoie au plus 300 requêtes par minute et par connexion et réessaie jusqu’à 3 fois en respectant Retry-After.	Temporaire : le moteur reprend l’étape plus tard.
integration.unavailable	5xx, 409 ou panne réseau, après rejeu.	Temporaire : le moteur reprend l’étape plus tard.
integration.connection_unusable	La connexion a été supprimée, n’est pas active, est hors de votre portée, ou appartient à un autre service.	Choisissez une connexion valide dans le nœud.
Le déclencheur ne se déclenche jamais	Le workflow n’est pas publié, l’abonnement pointe vers une ancienne URL, ou l’événement n’est pas coché.	Publiez, vérifiez avec Lister les webhooks, régénérez l’URL si besoin, et relisez Événements.

Événements de webhook

Les événements proposés par le déclencheur. Un événement ajouté plus tard par le fournisseur reste accepté quand aucun événement n’est coché.

Événement	Libellé
signature_completed	Signature terminée
signature_created	Signature lancée
signature_cancel	Signature annulée
contract_created	Contrat créé
contract_deleted	Contrat supprimé
operation_created	Dossier créé
operation_deleted	Dossier supprimé
operation_merged	Dossiers fusionnés
legal_record_deleted	Fiche supprimée
register_letter_created	Recommandés envoyés
register_letter_cancel	Recommandés annulés
register_letter_completed	Recommandés terminés

Nœuds qui utilisent cette connexion

• MyNotary — événement — trigger.mynotary
• MyNotary — mynotary.api