📌 핵심 포인트
현재 이용 중인 ERP, CRM 등에 등록된 서명자 정보를 불러와 고정/비고정된 서식으로 서명요청을 진행할 수 있습니다.
해당 문서를 받은 서명자도 모두싸인 로그인이나 별도 창을 열지 않고 시스템 내에서 서명을 진행할 수 있습니다.
- 고정 / 비고정 서식의 문서에 따라 연동 방식이 상이하니 아래 매뉴얼 확인부탁드리겠습니다.
📌 연동 가이드 : 고정 서식 문서
1. Webhook(웹훅) 설정
- 연동한 계정으로 발송한 문서에 대한 진행 현황을 구독하기 위해 웹훅 설정을 진행해주셔야합니다. 자세한 웹훅 설정은 우측 매뉴얼 확인하기 버튼 클릭 부탁드리겠습니다. (매뉴얼 확인하기 >)
2. 모두싸인(클라우드) 서비스에서 템플릿 생성- 자체 DB와 연동할 필드는 '추가 내용 입력하기' 로 위치 및 폰트 설정을 진행합니다.
- 이때 각 필드별 라벨 커스텀이 가능합니다.
3. 템플릿 ID 확인 (링크 >)
4. [템플릿으로 서명 요청 API] 호출 (링크 >)- 3번의 템플릿 ID를 연동합니다.
- 수신자 정보 중 'signingMethod' - Type: SECURE_LINK로 지정합니다.
- Value(서명자의 서명 수단) 값에는 임의 이메일 주소 입력합니다. (*해당 이메일 주소는 검증되지 않습니다.)
- documentID와 participantID를 확인합니다.
5. 임베디드 서명자의 보안링크 조회 (링크 >)- 4번에서 확인한 documentID, participandID 값을 입력해 보안링크 조회를 진행합니다.
- 리턴에서 문서 접근이 가능한 URL을 확인합니다.
- 해당 URL 접근시 원하는 위치에서 템플릿 기반으로 발송된 문서 열람 및 서명이 가능합니다.
6. 진행 중 또는 완료 문서에 대한 Webhook 이벤트 수신 (링크 >)- 해당 이벤트에는 문서 ID, 서명자 정보가 포함되어 있습니다.
7. [문서 상세 조회 API] 또는 [문서 이력 조회 API] 호출을 통한 계약 상태값 업데이트- API 호출을 위한 정보 입력시 6번에서 획득한 문서 ID를 입력합니다.
- 문서 상태값 등 필요한 정보를 이용 중인 별도 DB에 저장해 계약 상태값을 업데이트 합니다.8. 완료문서 자동 다운로드를 위한 [문서 상세 조회 API] 호출 (링크 >)
- [문서 상세 조회 API] 호출시, 6번에서 획득한 문서 ID를 입력합니다.
- 바디 중에 'file' - downloadUrl에서 10분 간 유효한 다운로드 링크 확인합니다.
- 상세한 내용은 자동 저장/백업 가이드를 참고해주세요. (가이드 확인하기 >)
📌 연동 가이드 : 비고정 서식의 문서
1. Webhook(웹훅) 설정
- 연동한 계정으로 발송한 문서에 대한 진행 현황을 구독하기 위해 웹훅 설정을 진행해주셔야합니다. 자세한 웹훅 설정은 우측 매뉴얼 확인하기 버튼 클릭 부탁드리겠습니다. (매뉴얼 확인하기 >)
2. [서명요청 API] 에 기본 정보 입력- 문서 파일은 Base 64로 인코딩하여 업로드합니다.
- 서명자의 서명 위치 등 입력란은 X,Y 좌표값으로 설정합니다.
3. [서명요청 API]에 서명자의 서명수단 - SECURE_LINK 선택- 수신자 정보 중 'signingMethod' - Type: SECURE_LINK로 지정합니다.
- Value(서명자의 서명 수단) 값에는 문서를 전달할 상대방의 이메일 주소 또는 휴대폰 번호를 입력합니다.
4. 임베디드 서명자의 보안링크 조회 (링크 >)
- 3번에서 확인한 documentID, participandID 값을 입력해 보안링크 조회를 진행합니다.
- 리턴에서 문서 접근이 가능한 URL을 확인합니다.
- 해당 URL 접근시 원하는 위치에서 템플릿 기반으로 발송된 문서 열람 및 서명이 가능합니다.
5. 진행 중 또는 완료 문서에 대한 Webhook 이벤트 수신 (링크 >)
- 해당 이벤트에는 문서 ID, 서명자 정보가 포함되어 있습니다.
6. [문서 상세 조회 API] 또는 [문서 이력 조회 API] 호출을 통한 계약 상태값 업데이트- API 호출을 위한 정보 입력시 5번에서 획득한 문서 ID를 입력합니다.
- 문서 상태값 등 필요한 정보를 이용 중인 별도 DB에 저장해 계약 상태값을 업데이트 합니다.7. 완료문서 자동 다운로드를 위한 [문서 상세 조회 API] 호출 (링크 >)
- [문서 상세 조회 API] 호출시, 6번에서 획득한 문서 ID를 입력합니다.
- 바디 중에 'file' - downloadUrl에서 10분 간 유효한 다운로드 링크 확인합니다.
- 상세한 내용은 자동 저장/백업 가이드를 참고해주세요. (가이드 확인하기 >)
📌 그 외 가이드
- API 연동 기본 가이드 1 : Webhook (웹훅) (링크>)
- API 연동 기본 가이드 2 : 서명 요청하기 (링크>)
- 사내 시스템에 전자문서 통합 관리 화면 구현하기 (링크>)
- 모두싸인으로 체결된 문서를 사내 시스템에 자동 저장/백업하기 (링크>)
- 체결된 문서를 원하는 기준으로 분류할 수 있게 속성 부여하기 (링크>)
- 특정 일자 도래/계약 일자 만료 등 원하는 시점에 전자계약 자동 발송 및 자동 알림 구현하기 (링크>)
- API 연동 자주 묻는 질문 (링크>)
- 또 다른 API 연동 가이드, 상세한 설계 및 컨설팅을 원하시는 경우, 문의하기를 눌러 폼을 제출해주시면 전문 컨설턴트가 자세한 안내를 도와드리겠습니다. (문의하기 >)