자동견적 '계약중' 저장 시 전자계약 발송 및 계약완료 시 상태 자동 반영

전자계약(UCAN Sign) 연동

자동견적 실시간 문의현황에 ‘계약중’(상태코드 7) 추가.

견적 저장 시 상태를 ‘계약중’으로 선택하면, 해당 문의를 UCAN Sign으로 전자계약 발송.

발송 성공 시 문의와 계약 문서를 매핑해 저장하여, 이후 웹훅 수신 시 해당 문의를 찾을 수 있도록 처리.

관리자 설정

관리자 > 동기화 관리 > UCAN Sign에서 다음 항목 설정 가능.

API Key, 템플릿 ID, API Base URL, 웹훅용 마스터 이메일.

(선택) 발송 API 경로, 테스트 모드 등.

웹훅 연동

UCAN Sign 개발자 설정에서 웹훅 URL을 https://(도메인)/theme_api/webcustom_ucansign_webhook 로 등록하고, 모든 서명 완료(signing_completed_all) 이벤트를 구독.

서명이 모두 완료되면 UCAN Sign 서버가 해당 URL로 POST 요청을 보내며, 수신 시 해당 문의 상태를 ‘계약완료’(상태코드 3) 로 자동 변경.

웹훅은 외부 서버에서 호출하므로, 진입점(bootstrap)에서 해당 URL에 한해 CSRF 검증을 우회하도록 처리함.

기술 요약

전자계약 발송: API Key로 access token 발급 후 POST /openapi/templates/:documentId 호출, 참여자 정보(signingMethodType, signingContactInfo) 및 customValue(uniq_id) 전달.

웹훅 수신: eventType, customValue/documentId로 문의 식별 후 CRUD API로 상태를 ‘계약완료’로 업데이트.