전자서명 템플릿 대량계약 페이지 API

전자서명 템플릿 대량계약 기능은 기본적으로 프릭스 서비스를 통해 사용할 수 있지만, API를 통해서 페이지 URL을 얻어 사용할 수도 있습니다.

API 응답으로 대량계약 페이지의 url을 내려주며, 해당 경로를 새 창이나 새 탭으로 띄워서 대량계약을 진행할 수 있습니다.

• 참여자가 한 명인 템플릿으로만 대량계약을 이용할 수 있습니다.

POST kit-api/v1/signature-templates/[key]/bulk-url

Method: POST Endpoint: kit-api/v1/signature-templates/[key]/bulk-url Param: key는 전자서명 템플릿의 id(숫자) 혹은 slug(문자)를 의미

Example

...kit-api/v1/signature-templates/4328/bulk-url

{
  "input": {
    "customerId": 3,
    "customerCustomKey": "CUSTOMER-TEST-001",
    "items": [
      {
        "title": "테스트서명1",
        "participant": {
          "name": "김프릭",
          "send": "EMAIL",
          "email": "[email protected]"
        },
        "customKey": "TEST-001",
        "items": [
          {
            "id": 13,
            "contents": "김프릭"
          }
        ]
      },
      {
        "title": "테스트서명2",
        "participant": {
          "name": "이래티스",
          "send": "EMAIL",
          "email": "[email protected]",
          "phone": "010-1234-1234", // 참여자 전화번호
          "message": "빠른 서명 요청드립니다.",
          "extraAuthList": [
            {
              // 추가 휴대폰 본인인증이 필요한 경우 해당 값 사용
              "type": "MOBILE_IDENTIFICATION",
              "phoneNumber": "010-1234-1234" // 참여자 명의의 휴대폰 번호
            },
            {
              // 추가 암호인증이 필요한 경우 해당 값 사용
              "type": "CODE",
              "code": "secret1234"
            }
          ]
        },
        "customerTitle": "ABC컴퍼니",
        "items": [
          {
            "id": 13,
            "contents": "이래티스"
          }
        ]
      }
    ]
  }
}

Request Body

Key	Description	Required
input.customerId	대량계약 시 계약과 연결할 고객의 id	no
input.customerCustomKey	대량계약 시 계약과 연결할 고객의 custom key	no
input.items	대량계약 서명자 및 서명 정보 기본값	no

Request Body (input.items)

Key	Description	Required
input.items.title	각 서명 제목	yes
input.items.participant	대량계약 서명자 정보	yes
input.participant.name	대량계약 서명자 이름	yes
input.participant.send	대량계약 서명 발송 수단 (EMAIL, PHONE)	yes
input.participant.email	대량계약 서명자 이메일 (email 또는 phone 중 하나 필수)	no
input.participant.phone	대량계약 참여자 전화번호 (email 또는 phone 중 하나 필수)	no
input.participant.extraAuthList	추가 인증 정보 목록	no
input.items.items	계약서 생성에 필요한 사전입력값 정보	yes
input.items.customerTitle	서명과 연결될 고객명	no
input.items.customKey	계약서 식별을 위한 사용자 정의 키 값	no

*추가 인증은 2가지 방식을 사용할 수 있습니다.

1. 휴대폰 본인 인증 휴대폰 본인 인증 시, 서명 참여자 이름(participant.name)이 실명이어야 하며, 본인 명의의 휴대폰 번호를 입력해야 합니다.

2. 암호 인증

Response

{
  "ok": true, // api 성공 여부
  "message": undefined, // Error가 존재하면 message(string)로 전달
  "data": {
    "url": "https://www.prix.im/..." // 대량계약을 생성할 수 있는 페이지 주소
  }
}

Status Code	Error Code	Description
400	SIGNATURE_TEMPLATE_BULK_PARTICIPANT_COUNT	대량서명을 이용할 수 없는 템플릿인 경우 (참여자가 1명이 아닌 경우)
401	INVALID_BUSINESS	전자서명 템플릿에 권한이 없는 경우
404	SIGNATURE_TEMPLATE_NOT_FOUND	전자서명 템플릿이 존재하지 않는 경우
404	NOT_FOUND_CUSTOMER	존재하지 않는 고객인 경우