결재 연동
- 인쇄
- PDF
결재 연동
- 인쇄
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
Classic/VPC 환경에서 이용 가능합니다.
결재 설정
결재 연동은 WORKPLACE의 결재 정보를 회사의 기업 정보 시스템과 연동하는 작업입니다. 결재 연동을 설정하면 WORKPLACE의 서식별 결재 상태가 회사의 기업 정보 시스템으로 자동 발송되기 때문에 회사 기업 정보 시스템에서 다양한 활용을 할 수 있습니다.
결재 연동 설정 및 처리 흐름:
문서의 처리 과정에서 발생하는 이벤트를 전송받기 위한 설정 방법은 다음과 같습니다.
- 네이버 클라우드 플랫폼 콘솔에서 Services > Business Applications > WORKPLACE 메뉴를 차례대로 클릭해 주십시오.
- Developers 메뉴를 클릭해 주십시오.
- 알림 팝업 창이 나타나는 경우, 팝업 창의 내용을 확인한 후 [닫기] 버튼을 클릭해 주십시오.
- 결재 연동 > 결재 설정을 차례대로 클릭해 주십시오.
- 서식 추가의 [찾아보기] 버튼을 클릭해 주십시오.
- 연동 설정할 서식을 선택한 후 [적용] 버튼을 클릭해 주십시오.
- 서식별 전송 받을 정보를 설정해 주십시오.
- 결재 상태 선택: 전송 받을 상태에 체크해 주십시오. 결재 관리자의 결재 구분, 처리 구분 설정에 따라 명칭이 다르게 보일 수 있습니다. (<예시> 승인/동의)
- Callback URL 입력: 서식의 Callback URL을 입력해 주십시오. 입력 방법은 Callback URL을 참조해 주십시오.
- 등록된 Callback URL의 처리는 이벤트 처리를 참조해 주십시오.
- [저장] 버튼을 클릭해 설정을 완료해 주십시오.
Callback URL 입력
서식별 발생되는 이벤트에 대해 전송 받을 Callback URL을 입력해 주십시오.
- 서식별 이벤트를 전송받고자 할 경우 Callback을 받는 URL을 각각 설정해 주십시오. 만약 같은 URL로 사용하고 싶다면 아래 예시와 같이
dfmId를 get 파라미터로 설정해 사용할 수 있습니다.
이벤트 Callback 시 전달하는 객체 구조는 아래와 같습니다.
| 필드 | 설명 |
|---|---|
| docDataUrl | 문서의 상세 정보 조회 API 링크(문서의 상세 정보 조회 v1 API 링크가 조회됨, 추후 v2 API로 변경 예정) |
| aprvDocId | 문서의 내부 PK |
| processYmdt | 이벤트 발생 일시 |
| docNo | 문서 번호 |
| sendTpCd | 이벤트 상태 |
| dfmId | 서식ID |
- 전송 가능한 이벤트(sendTpCd)는 아래 표를 참고해 주십시오.
| sendTpCd | 설명 | 상세 |
|---|---|---|
| DRAFT | 기안 | 작성자가 문서를 저장하는 이벤트 |
| REVISE | 수정 | 결재자가 문서를 수정하는 이벤트 |
| APPROVE | 동의, 합의, 자동 동의 | 결재자가 문서를 동의, 합의 또는 자동 동의 방식으로 승인하는 이벤트 |
| DELEGATE | 위임 | 결재자가 다른 사람에게 결재 위임하는 이벤트 |
| REJECT | 거절 | 결재자가 문서를 반려하는 이벤트 |
| APPROVED | 완료(승인함) | 문서가 완결되었을 때 발생하는 이벤트 |
| CANCELED | 취소(승인 취소된) | 관리자가 승인된 문서를 승인 취소했을 때 발생하는 이벤트 |
| DELETED | 삭제 | 관리자가 문서를 삭제했을 때 발생하는 이벤트 |
| AUTO_APPROVE | 자동 동의 | 문서를 자동 동의 방식으로 결재하는 이벤트 |
| COOPERATION | 합의 | 문서를 합의 방식으로 결재하는 이벤트 |
| RETRIEVE | 회수 | 작성자가 문서를 회수하는 이벤트 |
이벤트 처리
등록된 Callback URL을 PUT 메소드를 이용해 호출하여 결재 문서에서 발생하는 이벤트를 실시간으로 처리합니다. 처리 방법은 다음과 같습니다.
- Method: PUT
- Media Type: application/json
PUT 메소드 호출 결과의 응답 코드에 따라 아래와 같이 처리합니다.
- 응답 코드가 200번대로 리턴된 경우: 발송 성공으로 기록.
- 응답 코드가 400번대, 500번대로 리턴될 경우: 발송 실패로 기록.
처리 결과는 WORKPLACE 콘솔의 Developers에 기록됩니다. 발송 상세 내역은 발송 내역을 참조해 주십시오.
발송 내역 조회
고객사 기업 정보 시스템에 발송한 결재 정보의 설공 및 실패 내역을 조회하고 실패 내역을 재발송할 수 있습니다.
발송 내역 조회 화면은 다음과 같이 구성되어 있습니다.
| 영역 | 설명 |
|---|---|
| ① 검색 | 서식, 발송일, 문서 번호, 제목을 입력해 검색 |
| ② 재발송 | 발송 실패 내역 재발송 |
| ③ 다운로드 | 발송 내역 다운로드 |
| ④ 발송 내역 목록 | 발송 내역 확인 |
실패 내역 재발송
발송 실패한 내역을 재발송하는 방법은 아래와 같습니다.
- 네이버 클라우드 플랫폼 콘솔에서 Services > Business Applications > WORKPLACE 메뉴를 차례대로 클릭해 주십시오.
- Developers 메뉴를 클릭해 주십시오.
- 결재 연동 > 발송 내역 조회를 차례대로 클릭해 주십시오.
- 발송 성공 및 실패 내역을 선택해 주십시오.
- [재발송] 버튼을 클릭해 주십시오.
API를 이용한 문서 상세 조회
제공 API를 호출하면 전송 받은 문서의 상세 내용을 조회할 수 있습니다.
API는 2가지로 제공되며 aprvId를 이용한 조회가 가능합니다.
- V1 API: WORKPLACE 기본 서식의 문서 내용을 조회할 때 사용할 수 있습니다. 자세한 내용은 V1 API를 참조해 주십시오.
- API 호출 예시: https://workplace.apigw.ntruss.com/workflow/apigw/v1/company/52e6e775-6993-424d-bc58-62e17268ed29/doc/25025
- V2 API: 서식 만들기로 직접 생성한 서식의 문서 조회가 가능합니다. 자세한 내용은 V2 API를 참고해 주십시오.
- API 호출 예시: https://workplace.apigw.ntruss.com/workflow/apigw/v2/company/52e6e775-6993-424d-bc58-62e17268ed29/doc/25025
컴포넌트 Key 설정
생성한 서식의 특정 컴포넌트에 대해 회사 고유 컴포넌트 Key를 설정하도록 연동할 수 있습니다. 설정된 컴포넌트 Key 는 오픈 API를 이용한 문서 상세 조회 시 파라메터로 활용할 수 있습니다.
컴포넌트 Key 설정 및 활용의 흐름:
컴포넌트 Key를 설정할 서식을 추가하는 방법은 다음과 같습니다.
- 네이버 클라우드 플랫폼 콘솔에서 Services > Business Applications > WORKPLACE 메뉴를 차례대로 클릭해 주십시오.
- Developers 메뉴를 클릭해 주십시오.
- 결재 연동 > 컴포넌트 Key 설정을 차례대로 클릭해 주십시오.
- [찾아보기] 버튼을 클릭합니다.
- 서식을 선택합니다.
- 서식 만들기로 생성한 서식 중 사용으로 설정된 서식만 선택할 수 있습니다.
- [적용] 버튼을 클릭합니다.
- 연동된 서식은 컴포넌트에 회사 고유 ID를 설정하여 활용할 수 있습니다. 사용자 지정 ID 설정을 참조해 주십시오.
사용자 지정 ID 설정
연동된 서식은 서식 상세의 옵션 영역에 컴포넌트 연동 설정 옵션이 노출됩니다.
연동한 서식의 컴포넌트 사용자 지정 ID를 설정하는 방법은 다음과 같습니다.
- WORKPLACE PC 웹 화면에서 [서비스 메뉴] > [결재 관리] 버튼을 클릭해 주십시오.
- 서식 > 서식 관리 메뉴를 클릭해 주십시오.
- 연동 설정한 서식의
을 클릭해 주십시오. - 컴포넌트 연동 설정 영역에 사용자 지정 ID를 입력해 주십시오.
- [서식 저장] 버튼을 클릭해 저장해 주십시오.
을 클릭해 주십시오.- 입력한 사용자 지정 ID는 서식 정보 조회 API 호출 시 파라미터(componentCustomId)로 활용할 수 있습니다. 자세한 내용은 문서 상세 조회 API 가이드를 참조해 주십시오.
이 문서가 도움이 되었습니까?