java - 发送嵌入的签名电子邮件并设置签名顺序

Question

所以基本上我需要使用嵌入式签名功能来获取 URL 并嵌入到我的应用程序中，然后我的客户可以从我这边签署文档。除此之外，我的客户在文件上签字后，他需要要求债务人也在同一份文件上签字。因此，在 DocuSign UI 上，我发现我可以设置签名顺序，这意味着第二个收件人在第一个收件人签名后立即收到电子邮件(完全符合我的要求)。 setting on UI但是，在第一个签名者签名后，第二个收件人无法收到电子邮件，即使在 UI 上显示已发送。

public Envelope embeddedSigning(Long debtorId, String signerEmail, String signerName, String templateId) throws ApiException, IOException {
    // create an envelop
    EnvelopeDefinition envelope = makeEnvelope(debtorId, signerEmail, signerName, templateId);

    ApiClient apiClient = baseRestApiClient();
    apiClient.addDefaultHeader("Authorization", "Bearer " + getToken());
    EnvelopesApi envelopesApi = new EnvelopesApi(apiClient);
    EnvelopeSummary summary = envelopesApi.createEnvelope(accountId, envelope);
    RecipientViewRequest viewRequest = makeRecipientViewRequest(debtorId, signerEmail, signerName);
    ViewUrl viewUrl = envelopesApi.createRecipientView(accountId, summary.getEnvelopeId(), viewRequest);

    // @formatter:off
    return Envelope.builder()
        .envelopId(summary.getEnvelopeId())
        .redirectUrl(viewUrl.getUrl()).build();
    // @formatter:on
  }

private EnvelopeDefinition makeEnvelope(Long debtorId, String signerEmail, String signerName, String templateId) throws IOException {
    EnvelopeDefinition envelopeDefinition = new EnvelopeDefinition();
    envelopeDefinition.setEmailSubject("Please sign this document");
    envelopeDefinition.setTemplateId(templateId);

    TemplateRole signer = new TemplateRole();
    signer.setEmail(signerEmail);
    signer.setName(signerName);
    signer.clientUserId(String.valueOf(debtorId));
    signer.setRoleName("signer0");
    signer.setRoutingOrder("1");

    TemplateRole signer1 = new TemplateRole();
    signer1.setEmail("xxx");
    signer1.setName("xxx");
    signer1.clientUserId(String.valueOf(xxx));
    signer1.setRoleName("signer1");
    signer1.setRoutingOrder("2");

    envelopeDefinition.setTemplateRoles(Arrays.asList(signer, signer1));
    envelopeDefinition.setStatus("sent");
    return envelopeDefinition;
  }

Answer 1

您正在设置 signer1.clientUserId(String.valueOf(xxx)); 这意味着您正在使签名者成为嵌入式签名者。默认情况下，DocuSign 不会向嵌入式签名者发送电子邮件。通过将签名者设置为嵌入式签名者，您是在告诉 DocuSign，调用应用程序将负责决定何时为该签名者主持签名仪式，因此 DocuSign 不会发送电子邮件，因为他们不会从电子邮件进行签名，而是由您进行签名当签名者使用您的应用程序时，该应用程序将生成签名 URL。因此，如果您删除 signer1.clientUserId(String.valueOf(xxx)); 代码，那么您将看到 Signer1 将收到来自 DocuSign 的电子邮件。

Docs有关嵌入式签名的更多详细信息。