이 문서에서는 Sign.Plus eSignature API를 사용하여 템플릿으로 서명을 위한 문서를 보내는 과정을 안내합니다.
다음 단계를 따라 템플릿에서 봉투를 생성하고, 수신자 세부정보를 설정한 다음, 서명을 위해 봉투를 발송합니다.
사전 준비 사항
1단계: 템플릿에서 봉투 생성하기
- 템플릿으로부터 새 봉투를 만들려면 POST /v2/envelope/from_template/{template_id} 엔드포인트를 사용하세요.
-
{template_id}를 기존 템플릿의 ID로 바꾸세요.
템플릿 ID는 어디에서 찾을 수 있나요?-
https://app.sign.plus/templates 로 이동합니다.
- 원하는 템플릿 이름을 클릭합니다.
- 오른쪽 사이드바에서 ID를 복사합니다.
-
https://app.sign.plus/templates 로 이동합니다.
- 다음 JSON 본문과 함께
POST /v2/envelope/from_template/{template_id}요청을 보내세요:{"name": "My wonderful envelope from template"} -
Authorization헤더에 API 키를 포함하세요. - 성공하면
an Envelope객체를 받습니다.{"id": "66eb7d0467d2d549b89fcb6d",// ..."signing_steps": [{"recipients": [{"id": "66eb7d0467d2d549b89fcb70","uid": null,"name": "","email": "","role": "SIGNER","verification": null}]},{"recipients": [{"id": "66eb7d0467d2d549b89fcb71","uid": null,"name": "","email": "","role": "RECEIVES_COPY","verification": null},{"id": "66eb7d0467d2d549b89fcb72","uid": null,"name": "","email": "","role": "SIGNER","verification": null}]}],"documents": [// ...],"notification": {// ...}} - 앞으로의 API 호출에 사용할
id를envelope_id로 저장하세요. - 서명 절차에서 나중에 사용할 각 수신자의
id를 기록하세요.
예시:-
66eb7d0467d2d549b89fcb71: 첫 번째SIGNER(1단계) -
66eb7d0467d2d549b89fcb71:RECEIVES_A_COPY(1단계) -
66eb7d0467d2d549b89fcb72: 두 번째SIGNER(2단계)
-
2단계: 수신자 세부정보 설정
템플릿에 고정된 수신자가 없고 수신자 세부정보를 설정하거나 업데이트해야 하는 경우:
- POST /v2/envelope/{envelope_id}/signing_steps 엔드포인트를 사용하여 수신자 정보를 업데이트하세요.
-
{envelope_id}를 1단계에서 받은 ID로 바꾸세요. - 다음 JSON 본문으로
POST요청을 보내세요:{
"signing_steps": [
{
"recipients": [
{
"id": "66eb7d0467d2d549b89fcb70",
"name": "John Doe",
"email": "john.doe@example.com",
"role": "SIGNER"
}
]
},
{
"recipients": [
{
"id": "66eb7d0467d2d549b89fcb71",
"name": "Mark Twain",
"email": "m.twain@example.com",
"role": "RECEIVES_COPY"
},
{
"id": "66eb7d0467d2d549b89fcb72",
"name": "Jane Smith",
"email": "j.smith@example.com",
"role": "SIGNER"
}
]
}
]
} - 성공하면
SigningStep객체의 배열을 받게 됩니다.
3단계: 서명을 위해 봉투 보내기
- POST /v2/envelope/{envelope_id}/send 엔드포인트를 사용하여 봉투를 보내세요.
-
{envelope_id}를 1단계에서 얻은 봉투 ID로 바꾸세요. - 이 엔드포인트로
POST요청을 보내세요. - 성공하면 봉투가 수신자에게 서명을 위해 전송됩니다.
결론
이제 Sign.Plus eSignature API와 템플릿을 사용하여 서명용 문서를 성공적으로 전송했습니다. 수신자는 문서에 서명할 수 있는 링크가 포함된 이메일 알림을 받게 됩니다.
템플릿을 사용하면 특히 레이아웃과 서명 요구 사항이 일정한 자주 사용되는 문서의 경우 문서 서명 워크플로를 크게 간소화할 수 있습니다.