PKIsigning(미리 보기)
PKIsigning 플랫폼 커넥터를 사용하여 문서 서명 요구 사항을 자동화합니다. PKIsigning 플랫폼에 문서 보내기 초대를 보내고 서명된 문서를 검색합니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | PKIsigning 지원 |
| URL | https://pkisigning.nl/support |
| 전자 메일 | support@pkisigning.nl |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | SBRS B.V. |
| 웹 사이트 | https://pkisigning.nl |
| 개인 정보 보호 정책 | https://pkisigning.nl/privacy |
| 카테고리 | 합작; 생산력 |
PKIsigning을 통해 조직은 승인, 서명 및 고객 및 제3자에게 문서를 보내는 프로세스를 자동화, 간소화 및 보호할 수 있습니다. 이 플랫폼은 네덜란드의 자격을 갖춘 신뢰할 수 있는 서비스 공급자의 모든 eIDAS 개인 서명 인증서를 지원하며 ISO27001 인증을 받았습니다. 따라서 PKIsigning은 법률, 금융 및 의료 기관 및 정부에 이상적인 파트너입니다. PKisigning과 연결하여 문서 서명 프로세스를 자동화, 간소화 및 보호합니다.
필수 조건
PKIsigning 커넥터를 사용하려면 "전문" 구독 내에서 PKIsigning 플랫폼에 대한 계정이 필요합니다. 유료 구독에 등록하려면 PKIsigning에 문의 하세요.
자격 증명을 가져오는 방법
구독에 등록한 후 사용자는 자신의 계정을 설정하라는 초대가 포함된 이메일을 받게 됩니다. 등록한 후 해당 계정을 이 커넥터와 함께 직접 사용할 수 있습니다.
커넥터 시작
문서 서명을 시작하는 기본 흐름은 다음과 같습니다.
- 서류 만들기
- 문서 추가
- 행위자 추가
- 워크플로 시작
- 트리거를 사용하여 상태 변경 알림 받기
- 서류 다운로드
서류 문서
PKIsigning은 항상 먼저 서류를 만들어야 합니다. 서류는 문서와 행위자를 위한 컨테이너 역할을 합니다. Dossiers_Create 작업을 사용하여 서류를 만들 수 있습니다. 서류가 만들어지면 반환된 PkisId를 향후 작업에 대한 참조로 사용하세요.
문서
서류가 생성되면 올바른 dossierId를 사용하여 Documents_Add 작업으로 문서를 추가할 수 있습니다. 작업에서는 문서 파일 자체에서 방해가 되므로 다른 매개 변수가 필요하지 않습니다. 서류에 있는 문서 수에는 제한이 없습니다. 추가된 모든 행위자에서 모든 문서를 보고 다운로드할 수 있습니다.
중요: 서명의 위치와 행위자가 서명해야 하는 위치를 나타내기 위해 문서에는 서명 수에 따라 하나 이상의 고유한 텍스트 개체 틀이 필요합니다. 이 텍스트는 문서의 모든 위치에 있는 텍스트일 수 있습니다. 행위자를 추가할 때 자리 표시자 매개 변수를 사용하여 자리 표시자를 정의할 수 있습니다. 예: signature1, signature2 등...
Actors
세 번째 단계는 문서에 행위자를 추가하는 것으로 구성됩니다. 이 작업은 올바른 dossierId 및 documentId를 사용하여 Actor_Create 작업으로 수행됩니다.
워크플로 시작
워크플로를 시작하고 제공된 순서대로 문서에 서명하거나 다운로드하기 위해 모든 행위자에게 초대를 효과적으로 보내려면 올바른 dossierId와 함께 Dossiers_StartWorkflow 작업을 사용합니다.
트리거를 사용하여 상태 변경 알림 받기
문서가 서명된 후 가져오려면 트리거를 사용하여 알림을 구독합니다. 상태 알림을 받으려면 이벤트 필드에 '상태'를 지정합니다.
서류 다운로드
트리거에 상태 업데이트 알림이 표시되면 문서의 상태가 '완료됨'인지 확인합니다. 그 순간, 그것은 하나의 zipfile에 서류의 모든 문서를 다운로드 할 수 있습니다. PKIsigning 플랫폼 내의 설정에서 audittrail을 생성해야 하는 경우 이 설정도 포함됩니다.
알려진 문제 및 제한 사항
게시 시점에 알려진 문제는 없습니다.
일반적인 오류 및 해결
트리거를 통한 상태 업데이트 없음
트리거가 상태 업데이트에 응답하지 않는 경우 이벤트 필드에 'status' 값이 제공되었는지 확인하세요.
HTTP 오류 402 결제 필요
PKIsigning 플랫폼은 작업을 수행하는 데 크레딧이 필요했습니다. 행위자가 추가되면 크레딧은 작업이 수행될 수 있도록 예약되며 초대자는 사용 가능한 크레딧 수 부족과 관련된 문제에 직면하지 않습니다. 많은 초대가 행위자에게 전송되는 경우 크레딧 번들에 예약할 크레딧이 더 이상 남아 있지 않을 수 있습니다. 이때 HTTP 402 오류가 반환됩니다.
이 문제를 해결하려면 PKIsigning을 지원 하여 신용 잔액을 상향 조정하거나 플랫폼의 휴지통에 있는 행위자를 사용하여 분개하지 않은 서류를 정리합니다. 그런 다음 사용하지 않은 크레딧을 다시 사용할 수 있게 됩니다.
자주 묻는 질문(FAQ)
기술 자료를 참조하거나 다음으로 문의하세요.support@pkisigning.nl
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| 다운로드 요청 |
요청 및 해당 내용을 .zip 파일로 다운로드합니다. |
| 문서 데이터 가져오기 |
특정 문서에 대한 모든(메타) 데이터를 반환합니다. |
| 문서 만들기 |
새 문서를 만들고 특정 요청에 추가합니다. |
| 문서 삭제 |
특정 문서를 영구적으로 삭제합니다. |
| 문서 업데이트 |
특정 문서의 데이터를 변경합니다. |
| 문서별로 행위자 데이터 가져오기 |
특정 문서에 대한 모든 행위자의 모든 데이터를 반환합니다. |
| 사용자에 대한 작업 그룹 가져오기 |
특정 조직의 특정 사용자에 대한 모든 작업 그룹 목록을 반환합니다. |
| 업데이트 요청 |
특정 요청에 대한 데이터를 변경합니다. |
| 요청 데이터 가져오기 |
특정 요청에 대한 모든(메타) 데이터를 반환합니다. |
| 요청 만들기 |
새 요청을 만듭니다. |
| 요청 보내기 |
워크플로를 시작하고 특정 요청에 대한 첫 번째 행위자에게 초대를 줄에 보냅니다. |
| 요청 삭제 |
특정 요청을 영구적으로 삭제합니다. |
| 요청으로 행위자 데이터 가져오기 |
특정 요청에 대한 모든 행위자의 모든 데이터를 반환합니다. |
| 조직을 위한 작업 그룹 가져오기 |
특정 조직의 모든 작업 그룹 목록을 반환합니다. |
| 초대 다시 보내기 |
특정 요청에 대해 현재 행위자의 초대를 줄에 다시 보냅니다. |
| 초대 철회 |
특정 요청에 대한 줄에서 현재 행위자의 초대를 철회합니다. |
| 행위자 데이터 가져오기 |
특정 행위자의 모든 데이터를 반환합니다. |
| 행위자 만들기 |
새 행위자를 만들어 문서에 추가합니다. |
| 행위자 삭제 |
특정 행위자를 영구적으로 삭제합니다. |
| 행위자 업데이트 |
특정 행위자의 데이터를 변경합니다. |
다운로드 요청
요청 및 해당 내용을 .zip 파일로 다운로드합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요청 ID
|
requestId | True | guid |
요청의 고유 ID입니다. |
반환
- response
- file
문서 데이터 가져오기
특정 문서에 대한 모든(메타) 데이터를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요청 ID
|
requestId | True | guid |
요청의 고유 ID입니다. |
|
문서 ID
|
documentId | True | guid |
문서의 고유 ID입니다. |
반환
문서의 일반 메타데이터
문서 만들기
새 문서를 만들고 특정 요청에 추가합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요청 ID
|
requestId | True | guid |
이 문서가 속할 요청의 고유 ID입니다. |
|
File
|
file | True | file |
처리할 파일(특정 파일 형식만)입니다. |
반환
문서의 일반 메타데이터
문서 삭제
특정 문서를 영구적으로 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요청 ID
|
requestId | True | guid |
요청의 고유 ID입니다. |
|
문서 ID
|
documentId | True | guid |
문서의 고유 ID입니다. |
문서 업데이트
특정 문서의 데이터를 변경합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요청 ID
|
requestId | True | guid |
요청의 고유 ID입니다. |
|
문서 ID
|
documentId | True | guid |
문서의 고유 ID입니다. |
|
문서 이름
|
name | string |
특정 문서의 이름 |
|
|
문서 파일 이름
|
filename | string |
특정 문서의 파일 이름 |
|
|
문서 유형
|
documentType | True | string |
특정 문서의 형식입니다. (예: 일반 PDF, 회계 명세서, 감사 보고서 등). |
반환
문서의 일반 메타데이터
문서별로 행위자 데이터 가져오기
특정 문서에 대한 모든 행위자의 모든 데이터를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요청 ID
|
requestId | True | guid |
요청의 고유 ID입니다. |
|
문서 ID
|
documentId | True | guid |
문서의 고유 ID입니다. |
|
작업 완료
|
hasActed | boolean |
작업을 완료했거나 완료하지 않은 행위자만 반환하고 모든 행위자를 반환하려면 비워 둡니다. |
반환
- response
- array of ExtendedSignerModel
사용자에 대한 작업 그룹 가져오기
특정 조직의 특정 사용자에 대한 모든 작업 그룹 목록을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
조직 ID
|
organisationId | True | guid |
조직의 고유 ID입니다. |
|
사용자 이름
|
username | True |
사용자의 Emailaddress |
반환
- response
- array of OrganisationWorkgroup
업데이트 요청
특정 요청에 대한 데이터를 변경합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요청 ID
|
requestId | True | guid |
요청의 고유 ID입니다. |
|
요청 이름
|
name | True | string |
특정 요청의 이름입니다. |
|
작업 그룹 ID
|
workgroupId | guid |
작업 그룹의 고유 ID입니다. |
|
|
보안 통관 수준
|
clearancelevel | True | integer |
특정 요청에 대한 보안 허가 수준입니다. |
|
요청 소유자
|
owner |
특정 요청의 소유자인 사용자입니다. |
반환
요청 데이터 가져오기
특정 요청에 대한 모든(메타) 데이터를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요청 ID
|
requestId | True | guid |
요청의 고유 ID입니다. |
|
인증 키
|
callbackAuthenticationKey | string |
트리거에서 제공하는 인증 키입니다. |
반환
요청 만들기
새 요청을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요청 이름
|
name | True | string |
특정 요청의 이름입니다. |
|
작업 그룹 ID
|
workgroupId | guid |
작업 그룹의 고유 ID입니다. |
|
|
보안 통관 수준
|
clearancelevel | True | integer |
특정 요청에 대한 보안 허가 수준입니다. |
|
요청 소유자
|
owner |
특정 요청의 소유자인 사용자입니다. |
반환
요청 보내기
워크플로를 시작하고 특정 요청에 대한 첫 번째 행위자에게 초대를 줄에 보냅니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요청 ID
|
requestId | True | guid |
요청의 고유 ID입니다. |
요청 삭제
특정 요청을 영구적으로 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요청 ID
|
requestId | True | guid |
요청의 고유 ID입니다. |
요청으로 행위자 데이터 가져오기
특정 요청에 대한 모든 행위자의 모든 데이터를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요청 ID
|
requestId | True | guid |
요청의 고유 ID입니다. |
|
요청에서 행위자가 동작했는지 확인
|
hasActed | boolean |
값을 읽어 행위자가 이미 문서에 대해 작업했는지 확인합니다. |
반환
- response
- array of ExtendedSignerModel
조직을 위한 작업 그룹 가져오기
특정 조직의 모든 작업 그룹 목록을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
조직 ID
|
organisationId | True | guid |
조직의 고유 ID입니다. |
반환
- response
- array of OrganisationWorkgroup
초대 다시 보내기
특정 요청에 대해 현재 행위자의 초대를 줄에 다시 보냅니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요청 ID
|
requestId | True | guid |
요청의 고유 ID입니다. |
초대 철회
특정 요청에 대한 줄에서 현재 행위자의 초대를 철회합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요청 ID
|
requestId | True | guid |
요청의 고유 ID입니다. |
행위자 데이터 가져오기
특정 행위자의 모든 데이터를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요청 ID
|
requestId | True | guid |
요청의 고유 ID입니다. |
|
문서 ID
|
documentId | True | guid |
문서의 고유 ID입니다. |
|
행위자 ID
|
actorId | True | guid |
행위자의 고유 ID입니다. |
반환
행위자 만들기
새 행위자를 만들어 문서에 추가합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요청 ID
|
requestId | True | guid |
요청의 고유 ID입니다. |
|
문서 ID
|
documentId | True | guid |
문서의 고유 ID입니다. |
|
조치
|
action | True | string |
행위자가 수행해야 하는 작업입니다. |
|
이름 (이름의 첫 부분)
|
firstname | True | string |
행위자의 이름입니다. |
|
프리픽스
|
prefix | string |
행위자의 접두사입니다. |
|
|
성(姓)
|
lastname | True | string |
행위자의 성입니다. |
|
전자 메일 주소
|
True | string |
행위자의 전자 메일 주소입니다. |
|
|
휴대폰 번호
|
mobile | True | string |
행위자의 휴대폰 번호입니다. |
|
Deadline
|
deadline | True | date-time |
행위자가 작업을 수행해야 하는 날짜 및 시간입니다. |
|
Language
|
language | True | string |
초대에 대한 언어입니다. |
|
강력한 확인 사용
|
validateRealIdentity | True | boolean |
이 행위자에 대해 더 강력한 식별 방법을 사용합니다. |
|
dossierPersonId
|
dossierPersonId | integer | ||
|
message
|
message | string | ||
|
서명 필드
|
fieldName | string |
이 행위자가 서명할 문서의 기존 서명 필드 이름입니다. |
|
|
Placeholder
|
placeholder | string |
행위자가 서명을 배치해야 하는 문서의 특정 자리 표시자의 텍스트입니다. |
반환
행위자 삭제
특정 행위자를 영구적으로 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요청 ID
|
requestId | True | guid |
요청의 고유 ID입니다. |
|
문서 ID
|
documentId | True | guid |
문서의 고유 ID입니다. |
|
행위자 ID
|
actorId | True | guid |
행위자의 고유 ID입니다. |
행위자 업데이트
특정 행위자의 데이터를 변경합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요청 ID
|
requestId | True | guid |
요청의 고유 ID입니다. |
|
문서 ID
|
documentId | True | guid |
문서의 고유 ID입니다. |
|
행위자 ID
|
actorId | True | guid |
행위자의 고유 ID입니다. |
|
조치
|
action | True | string |
행위자가 수행해야 하는 작업입니다. |
|
이름 (이름의 첫 부분)
|
firstname | True | string |
행위자의 이름입니다. |
|
프리픽스
|
prefix | string |
행위자의 접두사입니다. |
|
|
성(姓)
|
lastname | True | string |
행위자의 성입니다. |
|
전자 메일 주소
|
True | string |
행위자의 전자 메일 주소입니다. |
|
|
휴대폰 번호
|
mobile | True | string |
행위자의 휴대폰 번호입니다. |
|
Deadline
|
deadline | True | date-time |
행위자가 작업을 수행해야 하는 날짜 및 시간입니다. |
|
Language
|
language | True | string |
초대에 대한 언어입니다. |
|
강력한 확인 사용
|
validateRealIdentity | True | boolean |
이 행위자에 대해 더 강력한 식별 방법을 사용합니다. |
|
dossierPersonId
|
dossierPersonId | integer | ||
|
message
|
message | string |
반환
트리거
| 요청 시 이벤트가 발생하는 경우 |
상태 변경 시 콜백 URL을 등록합니다. PKIsigning 플랫폼은 이 조직 내 서류의 상태 조회를 이 URL에 보고합니다. |
요청 시 이벤트가 발생하는 경우
상태 변경 시 콜백 URL을 등록합니다. PKIsigning 플랫폼은 이 조직 내 서류의 상태 조회를 이 URL에 보고합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
이벤트 유형
|
Events | True | array of string |
이 트리거에 알림을 받을 요청 시 발생하는 이벤트 유형 목록 |
|
조직 ID
|
organisationId | True | guid |
조직의 고유 ID입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
요청 ID
|
PkisId | guid |
요청의 고유 ID입니다. |
|
요청 상태
|
DossierStatus | string |
서류의 상태입니다. |
|
이유
|
Reason | string |
변경 이유입니다. |
|
인증 키
|
AuthenticationKey | string |
요청에 대한 메타데이터를 가져오는 헤더입니다. |
정의
ExtendedSignerModel
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
서명 필드
|
fieldName | string |
이 행위자가 서명할 문서의 기존 서명 필드 이름입니다. |
|
Placeholder
|
placeholder | string |
행위자가 서명을 배치해야 하는 문서의 특정 자리 표시자의 텍스트입니다. |
|
조치
|
action | string |
행위자가 수행해야 하는 작업입니다. |
|
이름 (이름의 첫 부분)
|
firstname | string |
행위자의 이름입니다. |
|
프리픽스
|
prefix | string |
행위자의 접두사입니다. |
|
성(姓)
|
lastname | string |
행위자의 성입니다. |
|
전자 메일 주소
|
string |
행위자의 전자 메일 주소입니다. |
|
|
휴대폰 번호
|
mobile | string |
행위자의 휴대폰 번호입니다. |
|
Deadline
|
deadline | date-time |
행위자가 작업을 수행해야 하는 날짜 및 시간입니다. |
|
Language
|
language | string |
초대에 대한 언어입니다. |
|
강력한 확인 사용
|
validateRealIdentity | boolean |
이 행위자에 대해 더 강력한 식별 방법을 사용합니다. |
|
dossierPersonId
|
dossierPersonId | integer | |
|
message
|
message | string | |
|
행위자 ID
|
id | guid |
특정 행위자의 고유 ID입니다. |
|
완료 날짜
|
signingDate | date-time |
행위자가 작업을 수행한 날짜 및 시간입니다. |
|
작업 완료
|
hasSigned | boolean | |
|
전체 이름
|
fullName | string |
행위자의 이름, 접두사 및 성을 결합했습니다. |
|
상태 정보
|
emailActivity | array of EmailActivity |
행위자가 작업을 수행하는 프로세스에 대한 상태 정보입니다. |
|
documentId
|
documentId | guid |
EmailActivity
행위자에게 보내는 전자 메일 메시지의 메타데이터
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
이메일 활동
|
event | string |
특정 요청 및 행위자의 전자 메일 작업입니다. |
|
SMTP 정보
|
reason | string |
요청의 일부로 특정 행위자로 전송된 전자 메일에 대한 SMTP 정보입니다. |
|
전자 메일 날짜
|
timestamp | date-time |
요청의 일부로 특정 행위자로 전송된 전자 메일의 날짜입니다. |
|
전자 메일 유형
|
pkisMessageType | string |
요청의 일부로 특정 행위자에게 보낸 전자 메일을 입력합니다(예: 초대, 미리 알림 등). |
|
전자 메일 요청 ID
|
pkisInviteId | string |
요청의 일부로 특정 행위자로 전송된 전자 메일의 고유 ID입니다. |
|
전자 메일 주소
|
string |
요청의 일부로 특정 행위자로 전송된 전자 메일의 전자 메일 주소입니다. |
SignerModel
특수 유형의 행위자
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
조치
|
action | string |
행위자가 수행해야 하는 작업입니다. |
|
이름 (이름의 첫 부분)
|
firstname | string |
행위자의 이름입니다. |
|
프리픽스
|
prefix | string |
행위자의 접두사입니다. |
|
성(姓)
|
lastname | string |
행위자의 성입니다. |
|
전자 메일 주소
|
string |
행위자의 전자 메일 주소입니다. |
|
|
휴대폰 번호
|
mobile | string |
행위자의 휴대폰 번호입니다. |
|
Deadline
|
deadline | date-time |
행위자가 작업을 수행해야 하는 날짜 및 시간입니다. |
|
Language
|
language | string |
초대에 대한 언어입니다. |
|
강력한 확인 사용
|
validateRealIdentity | boolean |
이 행위자에 대해 더 강력한 식별 방법을 사용합니다. |
|
dossierPersonId
|
dossierPersonId | integer | |
|
message
|
message | string | |
|
서명 필드
|
fieldName | string |
이 행위자가 서명할 문서의 기존 서명 필드 이름입니다. |
|
Placeholder
|
placeholder | string |
행위자가 서명을 배치해야 하는 문서의 특정 자리 표시자의 텍스트입니다. |
DocumentMetaDataModel
문서의 일반 메타데이터
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
문서 이름
|
name | string |
특정 문서의 이름입니다. |
|
마지막 문서 업데이트
|
lastUpdate | date-time |
특정 문서의 마지막 업데이트 날짜입니다. |
|
문서 페이지 수
|
pages | integer |
특정 문서의 페이지 수입니다. |
|
문서 만들기 날짜
|
created | date-time |
특정 문서의 생성 날짜입니다. |
|
문서 ID
|
id | guid |
문서의 고유 ID입니다. |
|
문서 상태
|
status | string |
특정 문서의 상태입니다. (예: new, completed 등). |
|
문서에 서명이 포함되어 있습니다.
|
signed | boolean |
특정 문서에 하나 이상의 서명이 이미 포함되어 있는지 여부를 나타냅니다. |
|
문서 서명
|
signatures | array of SignatureData |
특정 문서에 대한 모든 서명 목록입니다. |
|
빈 서명 필드 문서화
|
emptySignatureFields | array of SignatureField |
특정 문서에 대한 모든 빈 서명 필드 목록입니다. |
|
빈 서명 필드
|
containsBlankSignatureFields | boolean |
특정 문서에 빈 서명 필드가 포함되어 있는지 여부를 나타냅니다. |
|
문서 행위자
|
actors | array of ExtendedSignerModel |
특정 문서에 대한 모든 행위자 목록입니다. |
|
요청 ID
|
requestId | guid |
요청의 고유 ID입니다. |
|
요청 인덱스
|
dossierIndex | integer |
특정 요청에 속하는 모든 문서의 인덱스입니다. |
|
documentSize
|
documentSize | integer |
특정 요청에 속하는 문서의 크기입니다. |
|
documentType
|
documentType | string |
특정 요청에 속하는 문서의 형식입니다. |
SignatureData
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
인증서 주체 필드
|
subject | array of KeyValuePairOfStringAndString |
특정 서명에 사용되는 인증서의 제목 줄에 있는 필드입니다. |
|
인증서 발급자 필드
|
issuer | array of KeyValuePairOfStringAndString |
특정 서명에 사용되는 인증서의 발급자 줄에 있는 필드입니다. |
|
서명 날짜
|
date | date-time |
특정 서명이 배치된 날짜 및 시간입니다. |
|
서명 위치
|
location | string |
서명 시 특정 행위자의 지리적 위치입니다. |
|
서명 이유
|
reason | string |
서명 시 특정 행위자가 제공한 서명 이유입니다. |
|
적격 전자 서명
|
euQualified | boolean |
특정 서명이 적격(QeS)이 eIDAS 규정을 준수하는지 여부를 나타냅니다. |
|
고급 전자 서명
|
advanced | boolean |
AeS(특정 서명)가 eIDAS 규정을 준수하는지 여부를 나타냅니다. |
|
정규화된 청어
|
eSeal | boolean |
서명 또는 봉인에 사용되는 특정 인증서가 eIDAS 규정을 준수하는 정규화된 청록색인지 여부를 나타냅니다. |
|
행위자 IP 주소
|
ipAddress | string |
특정 행위자의 IP 주소 |
|
서명 필드
|
signatureField | string |
서명된 필드 |
|
서명 이미지
|
signatureImage | string |
행위자가 선택한 특정 서명에 사용된 이미지 파일입니다. |
KeyValuePairOfStringAndString
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
key
|
key | string | |
|
value
|
value | string |
SignatureField
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
서명 필드 이름
|
name | string |
특정 서명 필드의 이름 |
|
서명 필드 페이지
|
page | integer |
특정 문서에 대한 특정 서명 필드가 배치되는 페이지입니다. |
|
서명 필드 너비 좌표
|
x | double |
특정 문서에 배치되는 페이지를 기준으로 특정 서명 필드의 위치 너비 값입니다. |
|
서명 필드 하이트 좌표
|
y | double |
특정 문서에 배치되는 페이지를 기준으로 특정 서명 필드에 대한 위치의 높음 값입니다. |
|
서명 필드 하이트
|
height | double |
특정 서명 필드의 하이트 값입니다. |
|
서명 필드 너비
|
width | double |
특정 서명 필드의 너비 값입니다. |
OrganisationWorkgroup
서류 내에서 사용되는 작업 그룹
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
작업 그룹 ID
|
id | guid |
작업 그룹의 고유 ID |
|
작업 그룹 이름
|
name | string |
특정 작업 그룹의 이름 |
RequestModel
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
요청 ID
|
id | guid |
요청의 고유 ID |
|
요청 이름
|
dossierName | string |
특정 요청의 이름입니다. |
|
문서 요청
|
documents | array of DocumentModel |
이 요청에 포함된 문서 목록입니다. |
|
요청 상태
|
status | string |
특정 요청에 대한 상태입니다. (예: new, completed 등). |
|
요청 행위자
|
actors | array of ExtendedSignerModel |
특정 요청에 대한 모든 행위자 목록입니다. |
|
문서 서명
|
signatures | array of SignatureData |
특정 요청에 대한 모든 서명 목록입니다. |
|
요청 유형
|
dossierType | string |
특정 요청에 대한 형식입니다. (E.g. PDF, SBR Assurance 등). |
|
취소 이유
|
reasons | string |
사용자 또는 행위자의 특정 요청에 대한 취소 이유입니다. |
|
서명자 메모
|
signerNote | string |
서명 이외의 다른 작업이 없는 하나 이상의 행위자를 적어 둡니다. |
|
받는 사람 메모
|
recipientNote | string |
다운로드 이외의 다른 작업이 없는 하나 이상의 행위자를 적어 둡니다. |
|
승인자 참고 사항
|
accorderNote | string |
요청을 승인하는 것 외에 다른 작업이 없는 하나 이상의 행위자를 적어 둡니다. |
|
요청 만료 날짜
|
expires | date-time |
특정 요청에 대한 만료 날짜 및 시간입니다. |
|
상태 정보
|
emailActivity | array of EmailActivity |
행위자가 작업을 수행하는 프로세스에 대한 상태 정보입니다. |
|
내 요청
|
myDossier | boolean |
특정 요청의 소유자인지 여부를 나타냅니다. |
|
작업 그룹 ID
|
workgroup | guid |
작업 그룹의 고유 ID입니다. |
|
보안 통관 수준
|
clearancelevel | integer |
특정 요청에 대한 보안 허가 수준입니다. |
DocumentModel
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
문서 ID
|
id | guid |
문서의 고유 ID |
|
문서 이름
|
name | string |
특정 문서의 이름 |
|
문서 유형
|
documentType | string |
특정 문서에 대한 형식입니다. |
|
요청 인덱스
|
dossierIndex | integer |
특정 요청에 속하는 모든 문서의 인덱스입니다. |
|
문서 상태
|
documentstatus | string |
특정 문서의 상태입니다. (예: new, completed 등). |
|
문서 행위자
|
actors | array of SignerModel |
특정 문서에 대한 모든 행위자 목록입니다. |
file
기본 데이터 형식 'file'입니다.