找不到有关DocuSign高级签名功能的文档 [英] Can't find documentation about the DocuSign advanced signature feature

问题描述

我正在尝试创建具有高级签名的收件人。这意味着收件人必须通过短信收到OTP才能签名。它与访问身份验证不同，访问身份验证需要身份验证才能查看文档。

I'm trying to create a recipient with an advanced signature. It means that the recipient must receive an OTP by SMS in order to sign. It's different from the access authentification, which required an authentification to see the document.

以下是官方DocuSign对此功能的说明：官方文档

Here is the description given by the official DocuSign about this feature : Official documentation

我知道DocuSign具有该功能，它已在我的计算机上激活帐户，我可以在Web HMI中使用它。但是我找不到如何在API中使用它……我尝试了Signer类的其他字段，但没有成功。我也找不到互联网上的文档。

I know that DocuSign has the feature, it is activated on my account and I can use it in the web HMI. But I can't find how to use it with the API... I tried different fields of the class Signer but without success. I can't find documentation on the internet either.

有人有想法吗？一个文件？还是直接设置我需要设置的字段名称？一切都会很棒！我正在Java中使用REST API。

Does anyone have an idea ? A documentation ? Or directly the name of the field I need to set ? Anything would be great ! I'm using the REST API in Java.

非常感谢

CodingDawn>感谢您的帮助但您的回应与我的需求不符。您谈论的是 DocuSign Express签名，而我谈论的是 DocuSign EU Advanced签名。
此图片来自DocuSign的Web HMI，用于创建信封。您可以清楚地看到这两个签名是不相同的。例如， Docusign Express签名不需要电话号码。

CodingDawn > Thanks for your help but your response does not match with my need. You speak about the "DocuSign Express" signing and I speak about the "DocuSign EU Advanced" signing. This image is from the web HMI of DocuSign for creating an envelope. You can clearly see that these two signings are not the same. For example, the "Docusign Express" signing does not require a phone number.

但是，谢谢，您为我提供了更多搜索曲目。

But thanks, you gave me more tracks to search.

推荐答案

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

First determine the signature provider your signers will use from the following list. The list is being added to reasonably often. We will be publishing the new and updated list on docs.docusign.com in the future.

已更新：标准现在可以使用基于签名的API文档。

当前签名提供者选项

Current signature provider options

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

Electronic Signatures Electronic signatures that do not use digital certificates. These are the default type of signatures from DocuSign

• API signatureProviderName： UniversalSignaturePen_ImageOnly
  
• 必需的选项：无

快速签名
DocuSign生成的包含证书的通用即时数字签名。

Express Signature DocuSign-generated generic, "on-the-fly" digital signatures that includes a certificate.

• API签名提供者名称： UniversalSignaturePen_Default


• 必需的选项：无

欧盟高级签名
DocuSign生成的，符合eIDAS AES的签名。 更多信息。

• API signatureProvider名称： UniversalSignaturePen_OpenTrust_Hash_TSP


• 必需的选项：SMS或oneTimePassword

ItAgile
使用Itagile欧盟合格证书的QES签名
更多信息

• API signatureProviderName： UniversalSignaturePen_ItAgile_TSP


• 必需的选项：无

在信封中包含 recipientSignatureProviders 参数：创建通话

参数采用 recipientSignatureProvider 对象的数组。它记录在信封：创建

The parameter takes an array of recipientSignatureProvider objects. It is documented on the Envelopes: create page in the definitions section.

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

Also include at least the options listed above.

选项

• oneTimePassword
  说明：访问代码收件人在使用EU Advanced签名提供程序时需要输入的信息。

• oneTimePassword Description: Access code that a recipient needs to enter while using EU Advanced signature provider.

signerRole 说明：角色或能力收件人的姓名（例如：经理，批准人等）

signerRole Description: Role or capacity of the recipient (Example: Manager, Approver, etc)

sms 说明：收件人的电话号码应该会收到一个访问代码。收件人在使用EU Advanced时需要输入密码。请注意，该字符串必须是以+和国家/地区代码开头的字符串，后跟完整的手机号码，且没有任何空格或特殊字符。例如：+ 14155551234，+ 97235551234，+ 33505551234

sms Description: Phone number where recipient should receive an access code. Access code will be needed by recipient while using EU Advanced. Note that this has to be a string starting with + and country code followed by full mobile phone number without any spaces or special characters. Examples: [phone], [phone], [phone]

recipientSignatureProviders 示例

具有DS Express签名提供者的签名接收者

{          
    "signers": [{
        "routingOrder": 1,
        "name": "Darryl Sanders",
        "email": "[e-mail]",
        "deliveryMethod": "email",
        "recipientId": "69693724",
        "signingGroupId": "",
        "recipientSignatureProviders": [{
            "signatureProviderName": "universalsignaturepen_default"
        }]
    }]
}

一个收件人使用eSignature笔，一个收件人使用DS Express

{
    "signers": [{
        "routingOrder": 1,
        "name": "Doris Sunshine",
        "email": "[e-mail]",
        "deliveryMethod": "email",
        "recipientId": "68539752",
        "signingGroupId": "",
        "recipientSignatureProviders": [{
            "signatureProviderName": "universalsignaturepen_imageonly"
        }]
    },
    {
        "routingOrder": 2,
        "name": "Sam Tolliver",
        "email": "[e-mail]",
        "deliveryMethod": "email",
        "recipientId": "39578164",
        "signingGroupId": "",
        "recipientSignatureProviders": [{
            "signatureProviderName": "universalsignaturepen_default"
        }]
    }]
}

具有SMS的EUAdvanced接收者和具有访问代码的一个

{
    "signers": [{
        "routingOrder": 1,
        "name": "Sue Collins",
        "email": "[e-mail]",
        "deliveryMethod": "email",
        "recipientId": "39977897",
        "signingGroupId": "",
        "recipientSignatureProviders": [{
            "signatureProviderName": "universalsignaturepen_opentrust_hash_tsp",
            "signatureProviderOptions": {
                "oneTimePassword": "12345678"
            }
        }]
    },
    {
        "routingOrder": 2,
        "name": "Yan",
        "email": "[e-mail]",
        "deliveryMethod": "email",
        "recipientId": "89536038",
        "signingGroupId": "",
        "recipientSignatureProviders": [{
            "signatureProviderName": "universalsignaturepen_opentrust_hash_tsp",
            "signatureProviderOptions": {
                "sms": "[phone]"
            }
        }]
    }]
}

这篇关于找不到有关DocuSign高级签名功能的文档的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！