우리 서비스에서 템플릿 관리

담당자가 모두싸인에 따로 접속하지 않고, 우리 서비스 안에서 계약서 템플릿을 만들고 고칠 수 있게 합니다. 모두싸인의 템플릿 편집 화면을 우리 서비스에 그대로 띄우고, 저장된 템플릿은 법인·계약 유형 같은 분류값과 함께 우리 서비스의 템플릿 목록에 자동으로 등록됩니다. 등록한 템플릿으로 서명 요청을 보내는 방법은 사내 시스템에서 확인 후 전송을 참고하세요.

한눈에 보는 흐름

이런 경우에 맞습니다

• 그룹웨어·ERP의 전자계약 메뉴에서 담당자가 직접 계약서 양식을 만들고 고치는 경우
• 여러 고객사·가맹점이 쓰는 플랫폼에서 고객사마다 자기 템플릿을 관리하게 하는 경우
• 법인·부서·계약 유형별로 템플릿이 많아 우리 서비스에서 나눠 보여 줘야 하는 경우
• 법무팀이 바꾼 양식을 담당자가 바로 고쳐 쓰게 하려는 경우

준비할 것

연동 흐름

sequenceDiagram
    autonumber
    participant U as 담당자
    participant S as 우리 서비스
    participant M as 모두싸인
    U->>S: [새 템플릿] 선택
    S->>M: 임베디드 초안 생성 (redirectUrl 포함)
    M-->>S: 편집 화면 주소 (embeddedUrl)
    S->>U: 템플릿 편집 화면 띄우기
    U->>M: 계약서 올리고 입력란 배치 후 템플릿 저장
    M-->>S: redirectUrl로 이동 (templateId·eventType)
    S->>M: 템플릿 메타데이터 변경 (분류값 등록)
    Note over S: 템플릿 목록에 등록

1. 새 템플릿: 담당자가 우리 서비스에서 [새 템플릿]을 누릅니다.
2. 임베디드 초안 생성: 서버가 임베디드 초안 생성 API를 호출합니다. 저장 후 돌아올 redirectUrl을 함께 넣습니다.
3. 편집 화면 주소: 응답으로 편집 화면 주소(embeddedUrl)를 받습니다.
4. 편집 화면 띄우기: 주소 뒤에 mode=create-template을 붙여 우리 서비스 안에 띄웁니다.
5. 템플릿 저장: 담당자가 계약서를 올리고 서명자와 입력란을 정한 뒤 템플릿을 저장합니다.
6. redirectUrl로 이동: 저장하면 화면이 redirectUrl로 이동하고, 주소에 새 템플릿의 ID(templateId)가 함께 전달됩니다.
7. 메타데이터 등록: 받은 ID로 템플릿 메타데이터 변경 API를 호출해 법인·계약 유형 같은 분류값을 넣고 목록에 등록합니다. 이후에는 템플릿 리스트 조회의 메타데이터 필터로 분류별 목록을 가져올 수 있습니다.

이미 만든 템플릿을 고칠 때는 임베디드 템플릿보기 url 조회 API에 redirectUrl을 넣어 호출하고, 받은 수정 화면 주소를 그대로 띄웁니다(mode는 붙이지 않습니다). 자세한 연동 방법은 임베디드 템플릿 생성과 임베디드 템플릿 수정을 참고하세요.

사용하는 API

함께 보면 좋은 문서

• 임베디드 템플릿 생성
• 임베디드 템플릿 수정
• 메타데이터로 문서와 템플릿 분류하기
• 사내 시스템에서 확인 후 전송