DocuSign REST API - RecipientView 예외 "UNKNOWN_ENVELOPE_RECIPIENT"

Question

현재 docusign을 사용하여 통합 웹 솔루션을 개발하는 동안 기술적 인 어려움이 있습니다. 다음 사항에 대해 조언 해 주실 수 있습니까?

1) 휴식 API 전화를 기반으로 문서에 수신자에게 서명하는 순서는 어떻게 지정합니까? json 예제를 사용할 수 있습니까?

2) 현재 작성된 봉투에 추가 된 사용자의 서명 URL을 검색 할 수 없습니다. 이 코드는 이전에 템플리트 기반 봉투 작성을 위해 작동했지만 PDF를 사용하여 작성된 코드에서는 작동하지 않습니다.

docusign API에 대한 호출 및 응답 (암호가 제거 된 상태)이 아래에 나와 있습니다. 실패한 두 종류의 인증 방법이 시도되었습니다. 봉투에서 찾은 전자 메일 중 하나를 통한 검색도 실패합니다.

POST \\https://demo.docusign.net/restapi/v2/accounts/426142/envelopes/3b2d7418-27d3-4a80-8969-d875b6fb9548/views/recipient HTTP/1.1 
X-DocuSign-Authentication: {"Username":"18f90756-70b1-4f5f-b360-48b198a17215","Password":"*REMOVED*","IntegratorKey":"*REMOVED*"} 
Accept: application/json, application/xml, text/json, text/x-json, text/javascript, text/xml 
Content-Type: application/json 
Host: demo.docusign.net<http://demo.docusign.net> 
Content-Length: 128 
Accept-Encoding: gzip, deflate 

{ 
    "authenticationMethod": "email", 
    "userName": "Simon", 
    "email": "test@email", 
    "returnUrl": "http://www.google.com" 
} 

HTTP/1.1 400 Bad Request 
Cache-Control: no-cache 
Content-Length: 274 
Content-Type: application/json; charset=utf-8 
Date: Fri, 24 Jan 2014 12:11:38 GMT 
Strict-Transport-Security: max-age=7776000; includeSubDomains 

{ 
"errorCode": "UNKNOWN_ENVELOPE_RECIPIENT", 
"message": "The recipient you have identified is not a valid recipient of the specified envelope. Envelope recipient could not be determined. 'clientUserId', 'email', or 'userName' in request and envelope may not match." 
} 

많은 감사

Answer 1

첫째, 수신자 지정하는 순서에 대해이 단순히 각받는 사람의 routingOrder 속성을 설정하여 수행됩니다. 예를 들어,이 샘플 JSON 존 먼저 봉투를 받아야 지정 받는 구조를 나타낸다 (routingOrder = 1), 제인 봉투 초 (routingOrder = 2)를 수신한다 :

"recipients": { 
    "signers": [ 
     { 
      "name": "John Doe", 
      "email": "johnsemail@outlook.com", 
      "recipientId": "1", 
      "routingOrder": "1", 
     }, 
     { 
      "name": "Jane Smith", 
      "email": "janesemail@outlook.com", 
      "recipientId": "2", 
      "routingOrder": "2", 
     } 
    ] 
} 

을 POST 수신자보기 요청에 대한 응답으로받는 "UNKNOWN_ENVELOPE_RECIPIENT"오류 메시지는 사용자가 제공하는 수신자 정보가 사용자의 봉투에있는 수신자에 대한 정보와 (정확히/완전히) 일치하지 않는다는 것을 의미합니다. 다시 지정하십시오.

먼저, 다음,받는 사람의 서명 세션을 시작하는 데 사용할 수있는 URL을 검색 할 POST받는 사람보기 호출을 사용하고자하는 경우 둘다 봉투를 요청하고 만들기 것을 명심 POST받는 사람보기 요청에는받는 사람에 대해 동일한 () clientUserId 속성 값이 포함되어야합니다. (당신이 게시 요청 JSON은 clientUserId 포함되지 않습니다.)

을 POST받는 사람의보기에 clientUserId 속성을 포함하는 경우 요청 기능이 이후의 문제를 해결하기 위해, 문제가 해결되지 않습니다, 나는 좋을 것 받는 사람 받기 같은 봉투를 요청하고 응답의받는 사람 속성을 (성공하지 못했음) POST받는 사람보기 호출에서 제공하는 속성 값과 비교하십시오. GET받는 요청은 단순히 :

GET /accounts/{accountId}/envelopes/{envelopeId}/recipients