一般的なDocuSignテンプレートの受信者を定義する上での混乱

Question

Webインタビューを行っているユーザーが最後に特定の文書に署名する必要がある署名付きアプリケーションがあります。ドキュメントは一般的なテンプレートであり、現在ユーザー名と電子メールアドレスが空白のまま定義されています。テンプレートに定義されている役割に一致する、エンベロープの作成にユーザー名、電子メールアドレス、およびclientUserIdを提供しています。しかし、私はエラーを取得し続けるUNKNOWN_ENVELOPE_RECIPIENT - あなたが識別した受信者は、指定された封筒の有効な受信者ではありません。汎用テンプレートの「有効な受信者」は何を構成しますか？私は、テンプレートのユーザーと電子メールのフィールドに何かを置くことになっていますか？よくわかりません。

以下のLarry Kの回答では、まさに私がやったことのようです。ここで

{ 
    "accountId":"1234567", 
    "emailSubject":"Certification Documents", 
    "status":"sent", 
    "compositeTemplates":[ 
     { 
      "serverTemplates":[ 
       { 
        "sequence":"1", 
        "templateId":"5ed3d600-5a57-4fee-931f-53233858dc65" 
       } 
      ], 
      "inlineTemplates":[ 
       { 
        "sequence":"1", 
        "recipients":{ 
         "signers":[ 
          { 
           "name":"John Doe", 
           "roleName":"Applicant", 
           "recipientId":"1", 
           "clientUserId":"62", 
           "email":"jd@mydomain.com", 
           "tabs":{ 
            "textTabs":[ 
             { 
              "tabLabel":"EmplName", 
              "value":"John Doe" 
             },{ 
              "tabLabel":"SSN", 
              "value":"123456789" 
             },{ 
              "tabLabel":"DoB", 
              "value":"08\/26\/1991" 
             } 
            ] 
           } 
          } 
         ] 
        } 
       } 
      ] 
     } 
    ] 
} 

をゲット受信者が応答である：ここではJSONはエラーになります封筒を作成する要求のためだ

{ 
    "signers": [ 
     { 
      "isBulkRecipient": "false", 
      "name": "", 
      "email": "", 
      "recipientId": "63543029", 
      "recipientIdGuid": "29a731f6-2f82-490f-9589-f551727414d9", 

      "requireIdLookup": "false", 
      "smsAuthentication": {}, 
      "routingOrder": "1", 
      "note": "", 
      "roleName": "Applicant", 
      "status": "created", 
      "declinedReason": "", 
      "deliveryMethod": "email", 
      "templateLocked": "false", 
      "templateRequired": "false" 
     } 
    ], 
    "agents": [], 
    "editors": [], 
    "intermediaries": [], 
    "carbonCopies": [ 
     { 
      "name": "Real Person", 

      "email": "rp@mydomain.com", 
      "recipientId": "83856197", 
      "recipientIdGuid": 
      "0f80a5ab-2050-472a-b072-7a18794a4726", 
      "requireIdLookup": "false", 
      "smsAuthentication": {}, 

      "routingOrder": "1", 
      "note": "", 
      "roleName": "Mancon", 
      "status": "created", 
      "declinedReason": "" 
     } 
    ], 
    "certifiedDeliveries": [], 
    "inPersonSigners": [], 
    "recipientCount": "2" 

} 

が、私はそれを持っています。デバッグ用のものとライブコードを混在させすぎて、コードを乱す反復が多すぎます。私はデバッグメッセージを踏んだので、エラーがエンベロープの作成から来ているように見えました。しかし、実際には、コードが実際にエラーを生成していた署名ビューのリクエストに行き着いていました。そして、あなたが推測するように、エンベロープと一致しなかったdebug clientUserIdがありました。私はそれが嫌いです！コーチングに感謝します。それは結局本当の問題に私を導いた。トラブルシューティングするには

Answer 1

別の解答二DocuSignのコンサルタントから：コールを作成

彼はおそらく、あなたがエラーを受信した理由は、あなたがまったく同じトリプレットを使用していなかったということであったことを示唆しています封筒への通話の両方での{受信者/署名者の名前、電子メール、クライアントID}：作成し、EnvelopeViewsへ：createRecipient

は次のように動作するはずです：封筒

コール：作成：

をEnvelopeViewsへ

{ 
    "emailSubject":"My subject", 
    "emailBlurb":"My blurb", 
    "templateId":"My template id", 
    "templateRoles":[ 
     { 
      "clientUserId":"123456789", 
      "roleName":"My role", 
      "name":"Name", 
      "email":"email" 
     } 
    ], 
    "status":"sent" 
} 

コール：createRecipient：

は

{ 
    "authenticationMethod": "password", 
    "email": "email", 
    "returnUrl": "https://www.docusign.com", 
    "userName": "Name", 
    "clientUserId": "123456789" 
} 

Answer 2

は、私はあなたが使用しているテンプレート（GET /v2/accounts/{accountId}/templates/{templateId}/recipients）用テンプレート受信者を取得要求を実行することをお勧めしたい、そして、あなたのの受信者の一部とその応答の内容を比較テンプレートから要求を封筒を作成します。エラーUNKNOWN_ENVELOPE_RECIPIENTが発生します。相違点を見つけることができない場合は、元のの郵便番号をリクエストと同様にから返信してください。（もちろん機密情報を削除してください）おそらくここにいる誰かが問題を見つけることができます。

Answer 3

当社のDocuSignコンサルタントのソリューションは以下の通りです。彼はテンプレートで受信者情報を合成することを推奨しています。ここでは封筒のためのJSONです：

{ 
"emailSubject": "Create Envelope with embedded recipient", 
"status": "sent", 
"compositeTemplates": [ 
    { 
     "serverTemplates": [ 
      { 
       "sequence": "1", 
       "templateId": "{Template ID}" 
      } 
     ], 
     "inlineTemplates": [ 
      { 
       "sequence": "2", 
       "recipients": { 
        "signers": [ 
         { 
          "clientUserId": "Unique Identifier", 
          "email": "signer1@example.com", 
          "name": "Signer One", 
          "recipientId": "1", 
          "roleName": "Customer" 
         } 
        ] 
       } 
      } 
     ] 
    } 
]}