여러 명 순서대로 서명
한 문서에 여러 명이 서명해야 할 때 서명 순서를 정해 보냅니다. 앞 사람이 서명을 마쳐야 다음 사람에게 서명 요청이 전달되고, 우리 서비스는 웹훅으로 서명이 진행될 때마다 알림을 받아 지금 누구 차례인지 확인할 수 있습니다. 거래처가 먼저 서명하고 회사가 마지막에 서명하는 계약에 많이 씁니다.
한눈에 보는 흐름
이런 경우에 맞습니다
- 거래처가 먼저 서명하고 회사 대표나 담당자가 마지막에 서명(날인)하는 경우
- 미성년자 본인과 법정대리인이 함께 서명하는 경우
- 학생과 보호자, 신청자와 기관 담당자처럼 역할이 다른 사람이 차례로 서명하는 경우
- 플랫폼 이용자 양쪽이 모두 서명해야 계약이 성립하는 경우
준비할 것
| 어디서 | 준비할 것 |
|---|---|
| 모두싸인 | API를 쓸 수 있는 요금제, API Key, 서명자 역할과 순서를 정해 둔 템플릿(요청할 때 순서를 정한다면 없어도 됩니다) |
| 우리 서비스 | 서명자별 이름과 연락처, 서명 진행 알림을 받을 웹훅 주소(https), 회사 담당자가 우리 서비스 안에서 서명한다면 서명 화면을 띄울 화면 |
서명 순서를 정하는 두 가지 방법
| 방법 | 이렇게 동작합니다 |
|---|---|
| 템플릿에 순서 정해 두기 | 템플릿에서 서명자 역할(예: 거래처, 회사)과 순서를 정해 두고, 템플릿으로 서명 요청 API에서 역할마다 서명자를 지정합니다. 같은 계약을 반복해서 보낼 때 씁니다. |
| 요청할 때 순서 지정하기 | 서명 요청 API에서 서명자마다 signingOrder(1~30)로 순서를 지정합니다. 모든 서명자를 1로 지정하면 순서 없이 동시에 서명 요청이 전달됩니다. |
연동 흐름
아래는 거래처가 먼저 서명하고 회사 담당자가 마지막에 서명하는 흐름입니다.
sequenceDiagram
autonumber
participant S as 우리 서비스
participant M as 모두싸인
participant A as 거래처
participant B as 회사 담당자
Note over S: 계약 체결이 확정됨
S->>M: 서명 요청 (서명 순서: 거래처 → 회사)
M->>A: 카카오톡·이메일로 서명 요청 전달
A->>M: 계약서 확인 후 서명
M-->>S: 서명 입력 알림 (웹훅)
M->>B: 다음 차례에게 서명 요청 전달
B->>M: 계약서 확인 후 서명
M-->>S: 서명 완료 알림 (웹훅)
S->>M: 문서 상태 확인
Note over S: 계약 체결 처리
- 서명 요청: 서명 순서를 정해 서명 요청을 보냅니다. 템플릿을 쓰면 템플릿에 정해 둔 순서를 따르고, 서명 요청 API를 쓰면 서명자마다
signingOrder로 순서를 지정합니다. - 첫 번째 서명자에게 전달: 모두싸인이 첫 번째 순서의 서명자에게만 서명 요청을 보냅니다.
- 서명: 첫 번째 서명자가 계약서를 확인하고 서명합니다.
- 서명 입력 알림: 서명자가 서명할 때마다 우리 서비스의 웹훅 주소로
document_signed이벤트가 전달됩니다. 이 알림에는 누가 서명했는지 담겨 있지 않으므로, 문서 상세 조회의signings(서명한 참여자와 시간)와currentSigningOrder(지금 차례)로 진행 상황을 확인합니다. - 다음 차례에게 전달: 앞 사람이 서명을 마치면 모두싸인이 다음 순서의 서명자에게 서명 요청을 보냅니다.
- 서명: 마지막 서명자가 서명합니다.
- 서명 완료 알림: 모든 서명이 끝나면
document_all_signed이벤트가 전달됩니다. 마지막 서명자가 서명할 때는document_signed이벤트가 오지 않고 이 이벤트만 옵니다. - 상태 확인: 문서 상세 조회로 상태를 확인하고 계약 체결 처리를 진행합니다.
회사 담당자는 우리 서비스 안에서 서명하게 하려면회사 담당자를 임베디드 보안 링크(
SECURE_LINK)로 지정하면 이메일·카카오톡으로 받지 않고 우리 서비스 화면에서 서명할 수 있습니다.document_signed알림을 받은 뒤currentSigningOrder로 회사 담당자의 차례인지 확인하고, 임베디드 서명자의 보안링크 조회 API로 서명 화면을 열어 줍니다. 자세한 방법은 우리 서비스 화면 안에서 서명을 참고하세요.
앞 사람이 서명하지 않으면 다음 사람에게 넘어가지 않습니다서명 순서가 정해진 문서는 앞 사람이 서명을 마치기 전까지 다음 서명자에게 서명 요청이 전달되지 않습니다. 앞 서명자의 서명이 늦어지면 서명 요청 알림 재전송 API로 다시 알리세요. 앞 서명자가 입력한 내용이 잘못됐다면 서명내용 수정요청 API로 고쳐 달라고 요청할 수 있습니다.
서명자 수가 상황마다 달라진다면미성년자일 때만 법정대리인이 서명하는 것처럼 서명자 수가 달라지는 계약은, 템플릿 하나에 모든 서명자 역할을 넣어 두고 템플릿으로 서명 요청 API의
participantMappings에서 필요 없는 서명자를excluded로 빼면 됩니다. 뺀 서명자의 입력란은 문서에서 함께 빠집니다. 서명자 구성에 따라 계약서 양식 자체가 달라진다면 템플릿을 나눠 두고 조건에 맞는 템플릿을 골라 요청합니다.
사용하는 API
| 사용하는 API·기능 | 용도 |
|---|---|
| 템플릿으로 서명 요청 | 템플릿에 정해 둔 순서대로 역할마다 서명자를 지정해 보냅니다. |
| 서명 요청 | 서명자마다 signingOrder로 순서를 지정해 보냅니다. |
| 웹훅 | 서명자가 서명할 때마다, 그리고 모두 끝났을 때 알림을 받습니다. |
| 문서 상세 조회 | 누가 서명했고 지금 누구 차례인지 확인합니다. |
| 서명 요청 알림 재전송 | 서명이 늦어지는 서명자에게 알림을 다시 보냅니다. |
| 임베디드 서명자의 보안링크 조회 | 회사 담당자의 서명 화면을 우리 서비스 안에서 엽니다. |
| 서명내용 수정요청 | 앞 서명자가 잘못 입력한 내용을 고쳐 달라고 요청합니다. |
함께 보면 좋은 문서
다른 시나리오도 살펴보세요우리 회사 상황에 맞는 다른 시나리오는 API 도입 시나리오에서 찾을 수 있습니다. 전송 수단(이메일·카카오톡)과 임베디드 보안 링크의 차이도 이 문서에서 확인할 수 있습니다.
Updated about 2 hours ago
