Можно ли отправить конверт с помощью функции eWitness?

Question

В настоящее время я работаю над приложением для подписи и управления документами, которое использует API Docusign для обработки подписи документов. Документы должны позволять подписывать свидетеля, но мы не обязательно знаем, кто будет выступать в качестве свидетеля во время отправки конверта. Приложению нужно будет спросить подписавших лиц, которые будут свидетелями во время подписания.

После некоторых копаний я обнаружил функцию eWitness Docusign, которая делает именно то, что нам нужно для нашего приложения. Однако я не смог найти ничего в документации API, в которой описано, как использовать эту функцию.

В идеале я хотел бы использовать API для создания и отправки конверта из шаблона с помощью функции eWitness.

Любая помощь очень ценится!

Answer 1

Да!

Объект EnvelopeRecipients имеет новый атрибут witnesses Документы для обоих . witnesses - это массив witness объектов.

При отправке конверта через API:

1. Создайте объект получателя подписавшего. Запомните идентификатор получателя, который вы используете.
2. Создайте объект получателя-свидетеля с двумя атрибутами: receientId (новое значение) и witnessFor, для которого в качестве получателя указан идентификатор получателя.
3. Создайте SignHere вкладка для получателя подписи и получателя-свидетеля.
4. Отправьте конверт.
5. Когда подписывающий подпишется, ему будет предложено указать имя и адрес электронной почты свидетеля в своей подписи.
6. После того, как подписывающий подписывает, свидетель получает электронное письмо, которое позволяет им подписать документ в качестве свидетеля.

Получатель подписывающего лица может быть встроенным подписывающим лицом или «удаленным» подписывающим лицом и получать их приглашение подписать по электронной почте.

Возможно, вы сможете указать имя / адрес свидетеля при создании конверта, но я этого не проверял. Вы также можете установить свидетеля clientUserId, чтобы вы могли предоставить им встроенную подпись, но я также не проверял это. (Пожалуйста, дайте нам знать, если вы тестируете любой из этих потоков.)

Использование шаблона с получателем, у которого есть свидетель

Чтобы использовать шаблон с получателем, у которого есть свидетель, просто создайте шаблон с role, у которого включен свидетель. Затем при отправке конверта используйте шаблон и включите определение роли для получателя подписи (его имя / адрес электронной почты).

JSON пример

Вот рабочая JSON для встроенного подпись получателя со свидетелем. Подписывающее лицо вводит имя / адрес свидетеля во встроенную церемонию подписания.

  "envelopeDefinition": {
    "emailSubject": "Please sign the attached document",
    "status": "sent",
    "documents": [
      {
        "name": "Example document",
        "fileExtension": "pdf",
        "documentId": "1"
      }
    ],
    "recipients": {
      "signers": [
        {
          "email": "signer_email@example.com",
          "name": "Signer's name",
          "recipientId": "1",
          "clientUserId": "1000",
          "tabs": {
            "signHereTabs": [
              {
                "anchorString": "/sig1/",
                "anchorXOffset": "20",
                "anchorUnits": "pixels"
              }
            ]
          }
        }
      ],
      "witnesses": [
        {
          "recipientId": "2",
          "witnessFor": "1",
          "tabs": {
            "signHereTabs": [
              {
                "anchorString": "/sig1/",
                "anchorXOffset": "200",
                "anchorUnits": "pixels"
              }
            ]
          }
        }
      ]
    }