找不到有关DocuSign高级签名功能的文档

时间:2017-04-21 06:59:48

标签: java rest docusignapi

我正在尝试使用高级签名创建收件人。这意味着收件人必须通过短信接收OTP才能签名。它与访问验证不同,访问验证需要验证才能查看文档。

以下是官方DocuSign关于此功能的说明:Official documentation

我知道DocuSign有这个功能,它在我的账户上激活,我可以在网络HMI中使用它。但是我找不到如何在API中使用它......我尝试了Signer类的不同领域,但没有成功。我也无法在互联网上找到文档。

有没有人有想法?文件?或者直接我需要设置的字段名称?什么都会很棒!我在Java中使用REST API。

非常感谢,

CodingDawn>感谢您的帮助,但您的回复与我的需求不符。您谈到“Doc​​uSign Express”签约,我谈到“Doc​​uSign EU Advanced”签约。 This image来自DocuSign的Web HMI,用于创建信封。你可以清楚地看到这两个引援不一样。例如,“Docusign Express”签名不需要电话号码。

但是谢谢,你给了我更多的搜索曲目。

2 个答案:

答案 0 :(得分:1)

您必须设置requireSignerCertificate属性

以下是PostEnvelope请求

的示例
POST /v2/accounts/{accountId}/envelopes

{
  "status": "sent",
  "emailSubject": "Advanced Electronic Signature",
  "emailBlurb": "Advanced Electronic Signature",
  "recipients": {
    "signers": [
      {
        "recipientId": 1,
        "email": "AdvancedElectronicSignature@acme.com",
        "name": "Signer Name",
        "requireSignerCertificate": "docusign_express",
        "requireIdLookup": true,
        "idCheckConfigurationName": "SMS Auth $",
        "smsAuthentication": {
          "senderProvidedNumbers": [
            "555-555-5555"
          ]
        },
        "tabs": {
          "signHereTabs": [
            {
              "documentId": 1,
              "pageNumber": 1,
              "xPosition": 100,
              "yPosition": 100
            }
          ]
        }
      }
    ]
  },
  "documents": [
    {
      "documentId": 1,
      "fileExtension": "pdf",
      "name": "BlankDoc.pdf",
      "documentBase64": : "Specify document bytes here"
    }
  ]
}

答案 1 :(得分:1)

首先从以下列表中确定签名者将使用的签名提供程序。该名单正在合理地加入。我们将在docs.docusign.com上发布新的和更新的列表。

已更新:Standards Based Signatures API docs现已推出。

当前签名提供商选项

电子签名 不使用数字证书的电子签名。这些是DocuSign

的默认签名类型
  • API signatureProviderName:UniversalSignaturePen_ImageOnly
  • 必填项:无

快速签名 DocuSign生成的通用“动态”数字签名,包括证书。

  • API signatureProviderName:UniversalSignaturePen_Default
  • 必填项:无

欧盟高级签名 DocuSign生成的符合eIDAS AES标准。 More information.

  • API signatureProviderName:UniversalSignaturePen_OpenTrust_Hash_TSP
  • 必填选项:SMS或oneTimePassword

<强> ItAgile QES签名使用Itagile欧盟合格证书 More information

  • API signatureProviderName:UniversalSignaturePen_ItAgile_TSP
  • 必填项:无

在信封中加入recipientSignatureProviders参数:创建通话

该参数采用recipientSignatureProvider个对象的数组。它记录在定义部分的Envelopes: create页面上。

还至少包括上面列出的选项。

选项

  • oneTimePassword 描述:使用EU Advanced签名提供程序时收件人需要输入的访问代码。

  • signerRole描述:收件人的角色或能力(例如:经理,审批人等)

  • sms说明:收件人应收到访问代码的电话号码。使用EU Advanced时,收件人将需要访问代码。请注意,这必须是以+和国家/地区代码开头的字符串,后跟完整的移动电话号码,不带任何空格或特殊字符。示例:+14155551234,+ 97235551234,+ 33505551234

recipientSignatureProviders示例

DS Express签名提供程序的签名者收件人

{          
    "signers": [{
        "routingOrder": 1,
        "name": "Darryl Sanders",
        "email": "darryl@example.com",
        "deliveryMethod": "email",
        "recipientId": "69693724",
        "signingGroupId": "",
        "recipientSignatureProviders": [{
            "signatureProviderName": "universalsignaturepen_default"
        }]
    }]
}

一位收件人使用eSignature笔,一位使用DS Express

{
    "signers": [{
        "routingOrder": 1,
        "name": "Doris Sunshine",
        "email": "doris@foobar.com",
        "deliveryMethod": "email",
        "recipientId": "68539752",
        "signingGroupId": "",
        "recipientSignatureProviders": [{
            "signatureProviderName": "universalsignaturepen_imageonly"
        }]
    },
    {
        "routingOrder": 2,
        "name": "Sam Tolliver",
        "email": "sam@me.com",
        "deliveryMethod": "email",
        "recipientId": "39578164",
        "signingGroupId": "",
        "recipientSignatureProviders": [{
            "signatureProviderName": "universalsignaturepen_default"
        }]
    }]
}

带有短信的EUAdvanced收件人和带有访问代码的收件人

{
    "signers": [{
        "routingOrder": 1,
        "name": "Sue Collins",
        "email": "sue@example.com",
        "deliveryMethod": "email",
        "recipientId": "39977897",
        "signingGroupId": "",
        "recipientSignatureProviders": [{
            "signatureProviderName": "universalsignaturepen_opentrust_hash_tsp",
            "signatureProviderOptions": {
                "oneTimePassword": "12345678"
            }
        }]
    },
    {
        "routingOrder": 2,
        "name": "Yan",
        "email": "jim@me.com",
        "deliveryMethod": "email",
        "recipientId": "89536038",
        "signingGroupId": "",
        "recipientSignatureProviders": [{
            "signatureProviderName": "universalsignaturepen_opentrust_hash_tsp",
            "signatureProviderOptions": {
                "sms": "+1 330-310-3330"
            }
        }]
    }]
}