如何將值傳遞給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 }] }