Développeur de signes OneSpan : Création d'un package notarié - Partie 1

Pour rationaliser le processus de notarisation, la fonction e-Notaire dans OneSpan Sign offre aux notaires la possibilité de voir, de signer et de sceller les documents électroniquement. Pour plus d'informations sur la façon de configurer cette fonctionnalité, veuillez visiter notre documentation eNotary pour des instructions plus détaillées. 

Après avoir examiné la documentation, ce blog fournira quelques informations supplémentaires sur la façon d'utiliser le système eNotary pour les utilisateurs intégrés et non intégrés.

Création d'un package notarié

Pour les utilisateurs ad hoc :

1. Le choix de la « notarisation » rendra l'option « signature en personne » indisponible.

2. OneSpan Sign vous demandera alors de sélectionner le notaire pour cet accord particulier. Tant qu'un signataire du système OneSpan Sign est identifié comme notaire, un bouton "Set as Notary" s'affiche à l'avant du nom du signataire.

3. Tous les champs de notaires disponibles configurés au niveau de l'expéditeur du notaire seront chargés sur la page Designer.

4. Une fois qu'un signataire est affecté au rôle de notaire, vous devez supprimer tous les champs de notaire avant que la désignation de notaire puisse être supprimée. Ainsi, un flux de travail correct pour revenir un paquet notarié à un paquet normal serait: 

• Supprimer tous les champs de notaire
• Supprimer le signataire en tant que notaire
• Décochez le bouton de notarisation

5. Après l'envoi, ce paquet notarié apparaîtra dans le tableau de bord du notaire.

Pour les utilisateurs intégrés :

1. Les champs notaires sont contenus dans l'attribut "professionalIdentityFields" sous le nœud "rôles". Voici un exemple JSON d'un nœud de rôle:

{
      "id": "825b2be2-6752-4239-8139-af2f89cd5220",
      "SpecialTypes": [
        "NOTAIRE"
      ],
      ......
      "signataires": [
        {
          "id": "6ee2a9b0-8102-4f0a-ad44-1f5d486503bf",
          ......
          "professionalIdentityFields": [
            {
              "id": "NotaryJurisdiction",
              "catégorie": "NOTARY",
              "traductions": [
                {
                  "description": "NotaryJurisdiction",
                  "langue": "en",
                  "id": "",
                  "données": nul,
                  "nom": "NotaryJurisdiction"
                }
              ],
              "données": nul,
              "type": "REGULAR",
              "valeur": "Montréal",
              "nom": ""
            },
            {
              "id": "NotaryLicenseExpiryDate",
              "catégorie": "NOTARY",
              "traductions": [
                {
                  "description": "NotaryLicenseExpiryDate",
                  "langue": "en",
                  "id": "",
                  "données": nul,
                  "nom": "NotaryLicenseExpiryDate"
                }
              ],
              "données": nul,
              "type": "REGULAR",
              "valeur": "2020-09-01",
              "nom": ""
            },
            ......
          ]
        }
      ]
    }

2. Comme avec les utilisateurs ad-hoc, workflows comme "supprimer un notaire" ou "télécharger la signature pour un notaire (se référer à ce blog)"pourrait être déroutant dans un scénario de signature de notaire, alors assurez-vous que vous avez passé quelques tests avant de réellement commencer à coder.

Comment créer et mettre à jour les champs de notaires:

1. L'identification d'un notaire et la mise en place des champs notaires doivent être complétées par notre équipe de soutien. S'il vous plaît contactez-nous avec les informations de compte et votre demande.

2. Une fois les champs de notaire créés, vous pouvez mettre à jour manuellement les valeurs. Cela peut être fait en utilisant l'API pour mettre à jour l'expéditeur du compte:

En-têtes HTTP
POST /api/account/senders/ 'senderId'
En-têtes HTTP
Accepter : application/json
Content-type: application/JSON
Autorisation: api_key de base
Demande de charge utile

{
    "professionalIdentityFields": [
        {
            "id": "NotaryJurisdiction",
            "type": "REGULAR",
            "valeur": "Montréal"
        },
        {
            "id": "NotaryLicenseExpiryDate",
            "type": "REGULAR",
            "valeur": "2020-09-15"
        },
        {
            "id": "STAMP",
            "type": "SEAL",
            "valeur": "20190609'nTest1'nTest2'nTest3"
        }
    ]
}

Note:

La nouvelle ligne est indiquée par « n » dans l'attribut « valeur ».

3. Une fois que vous pouvez mettre à jour les valeurs pour les champs de notaire vous-même, assurez-vous que NotaryLicenseExpiryDate est valide. Dans le cas contraire, il peut causer l'erreur ci-dessous:

"technical":"java.text.ParseException: Unparseable date: '2020-09-31'","messageKey":"error.internal.default","message":"Erreur inattendue. Nous nous excusons pour tout inconvénient que cela peut vous avoir causé, s'il vous plaît essayer à nouveau. Si le problème persiste, s'il vous plaît contacter notre équipe de soutien.","code":500,"name":"Erreur serveur non gérée"

Perspectives d'avenir de la série de paquets notariés

Les articles à venir dans cette série de blog apporteront des conseils encore plus utiles sur la fonction e-Notary et présenter quelques exemples de code pour faciliter votre intégration. Par exemple, la deuxième partie démontrera comment créer un paquet notarié par le biais d'un SDK. 

Si vous avez des questions concernant ce blog ou toute autre chose concernant l'intégration de OneSpan Sign dans votre application, visitez les Forums communautairesdes développeurs . Vos commentaires sont importants pour nous!

OneSpan Sign Developer Community

Rejoignez la communauté OneSpan Sign Developer! Forums, blogs, documentation, téléchargements SDK, et plus encore.

Joignez-vous aujourd'hui