완료 문서 자동 저장

서명이 끝난 계약서 PDF와 서명자가 입력한 값, 서명자가 올린 첨부파일을 우리 서비스에 자동으로 저장합니다. 서명 요청은 모두싸인 웹에서 하던 대로 보내고 완료 결과만 연동할 수 있어, API를 처음 도입할 때 작게 시작하기 좋습니다. 서명 요청까지 연동하는 다른 시나리오와 함께 쓰면 보낸 계약서의 결과까지 한 번에 관리할 수 있습니다.

한눈에 보는 흐름

이런 경우에 맞습니다

• 모두싸인 웹에서 보낸 계약서를 사내 문서 저장소나 ERP에 자동으로 모아 두는 경우
• 계약서에 입력된 거래처 정보·계약 금액을 정산이나 거래처 관리에 바로 쓰는 경우
• 서명자가 올린 신분증 사본·사업자등록증 같은 첨부파일을 고객 정보와 함께 보관하는 경우
• 담당자가 완료된 계약서를 내려받아 손으로 옮기던 일을 없애려는 경우

준비할 것

가져올 수 있는 것

연동 흐름

sequenceDiagram
    autonumber
    participant S as 우리 서비스
    participant M as 모두싸인
    participant C as 서명자
    Note over M: 모두싸인 웹이나 API로 서명 요청
    C->>M: 마지막 서명자 서명
    M-->>S: 서명 완료 알림 (웹훅)
    S->>M: 문서 상세 조회
    M-->>S: 문서 정보와 다운로드 링크
    S->>M: 완료 문서 PDF 내려받기
    S->>M: 입력값·첨부파일 조회
    M-->>S: 입력값·첨부파일
    Note over S: 우리 서비스에 저장

1. 서명: 마지막 서명자가 서명을 마칩니다. 서명 요청을 모두싸인 웹에서 보냈든 API로 보냈든 같습니다.
2. 서명 완료 알림: 모두싸인이 우리 서비스의 웹훅 주소로 document_all_signed 이벤트를 보냅니다. 같은 알림이 두 번 이상 도착할 수 있으므로, 요청 헤더의 Modusign-Delivery-Id로 이미 처리한 알림인지 확인한 뒤 저장합니다.
3. 문서 상세 조회: 알림에 담긴 문서 ID로 문서 상세 조회 API를 호출합니다.
4. 다운로드 링크: 응답의 file.downloadUrl이 완료 문서 PDF, auditTrail이 감사추적인증서의 파일 정보입니다.
5. 완료 문서 내려받기: 다운로드 링크로 PDF를 내려받아 우리 서비스의 저장소에 보관합니다.
6. 입력값·첨부파일 조회: 필요한 값을 함께 가져옵니다. 서명자가 입력한 값은 서명자 입력란 조회, 요청할 때 채운 값은 요청자 입력 조회, 서명자가 올린 첨부파일은 첨부 파일 조회로 가져옵니다.
7. 응답: 받은 값을 입력란 이름(dataLabel)에 맞춰 우리 서비스의 항목에 저장합니다.

사용하는 API

함께 보면 좋은 문서

• Webhook 설정
• Webhook 전송 이력 확인하기
• 문서와 템플릿을 필터로 검색하기