모두싸인 고객센터

사내 시스템 내 서명 요청 및 서명 진행 통합 과정 구현하기

사내 시스템 등에 등록된 서명자 정보를 불러와 고정/비고정된 서식으로 서명 요청할 수 있으며, 서명자 또한 시스템 내에서 바로 서명할 수 있습니다.

연동 가이드 : 고정 서식 문서

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분 간 유효한 다운로드 링크 확인합니다.

  • 상세한 내용은 자동 저장/백업 가이드를 참고해주세요. (가이드 확인하기 >)