如何将值传递给echosign文档？

Question

我有一个需要签署的协议。在客户提供他们的公司和我们的服务的支付信息后，打开文档的链接。我如何将表单中的公司名称或帐单地址等值传递给文档？

现在客户点击“转到协议”，它会显示文档。问题在于他们不得不在echosign文档中重新输入刚刚在表单上提交的信息。

Answer 1

可以使用mergeFieldInfo此 样本有效载荷相同

{ 
    "documentCreationInfo": { 
    "fileInfos": [ 
     { 
     "libraryDocumentId": "xxxxxxxxxx" 
     } 
    ], 
    "name": "xxxxxxxxxx xxxxxxxxxx", 
    "message": "Please sign the agreement", 
    "recipientSetInfos": [ 
     { 
     "recipientSetRole": "SIGNER", 
     "recipientSetMemberInfos": [ 
      { 
      "email": "xxxx@xxxx.com" 
      } 
     ] 
     } 
    ], 
    "signatureType": "ESIGN", 
    "signatureFlow": "SENDER_SIGNATURE_NOT_REQUIRED", 
    "mergeFieldInfo": [ 
     { 
     "fieldName": "firstName", 
     "defaultValue": "xxxx" 
     }, 
     { 
     "fieldName": "lastName", 
     "defaultValue": "xxxx" 
     }, 
     { 
     "fieldName": "email", 
     "defaultValue": "xxxx@xxxx.com" 
     }, 
     { 
     "fieldName": "phone", 
     "defaultValue": "xxxxxxxxxxxxxxxxx" 
     }, 
     { 
     "fieldName": "companyName", 
     "defaultValue": "xxxx" 
     }, 
     { 
     "fieldName": "companyAddresss", 
     "defaultValue": "xxxx xxxx" 
     } 
    ], 
    "securityOptions": { 
     "passwordProtection": "NONE", 
     "kbaProtection": "NONE", 
     "webIdentityProtection": "NONE", 
     "protectOpen": false, 
     "internalPassword": "", 
     "externalPassword": "", 
     "openPassword": "" 
    } 
    }, 
    "options": { 
    "noChrome": false, 
    "authoringRequested": false, 
    "autoLoginUser": false 
    } 
} 

Answer 2

您可以使用POST /agreements API用于此目的。此API调用的请求主体具有一个名为“formFields”的可选参数，您可以在发送签名协议之前提供要在文档上嵌入的表单字段，还可以通过为它们设置不同的属性来自定义这些字段比如location，defaultValue，readOnly等等。

对于您的用例，您可以在POST调用中创建协议时传递此可选参数，指定您在前一次陡峭中从用户处获取的字段缺省值，以及要放置该字段的确切位置在文档上，如果您不希望用户更改这些字段，甚至可以将它们标记为只读。

为了更方便您PFB请求片断，你应该在你的POST调用提供 -

{ “formFields”：[{ “对齐”： “左”， “的borderStyle”： “实”， “FONTCOLOR”： “”， “的fontName”： “”， “BORDERCOLOR”： “”， “的DisplayLabel”： “”， “radioCheckType”： “圈子”， “calculatedExpression”： “”， “backgroundColor”：“＃0715cd”， “formatData”：“”， “displ ayFormat“： ”“， ”的contentType“： ”DATA“， ”验证“：假， ”计算“：假， ”最大长度“：-1， ”位置“：{ ”高度“：20， “宽度”：20， “PAGENUMBER”：1， “左”：100， “顶部”：100 }， “的minLength”：-1， “名称”： “定制字段2”， “inputType”：“TEXT_FIELD”， “customDateFormat”：“”， “specialFormula”：“”， “required”：true， “defaultValue”：“”， “minNumberVal UE“：0， ”maxNumberValue“：0， ”正则表达式“： ”“， ”showOrHide“： ”SHOW“， ”specialErrMsg“： ”“， ”格式“： ”NONE“， ”fontSize的“ ：-1， “掩蔽”：假， “anyOrAll”： “ANY”， “displayFormatType”： “DEFAULT”， “条件”：{ “值”： “”， “whenFieldLocationIndex”：-1 ， “字段名”： “”， “whenFieldName”： “”， “经营者”： “” }， “有效性规则”： “无”， “readOnly的”：假的， “borderWidth”：-1, “hidden”：false， “visibleOptions”：[]， “hiddenOptions”：[]， “tooltip”：“This is a sample。”， “recipientIndex”：1 }] }