전자서명 템플릿 대량계약 페이지 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": {
    "items": [
      {
        "title": "테스트서명1",
        "participant": {
          "name": "김프릭",
          "send": "EMAIL",
          "email": "[e-mail]"
        },
        "customKey": "TEST-001",
        "items": [
          {
            "id": 13,
            "contents": "김프릭"
          }
        ]
      },
      {
        "title": "테스트서명2",
        "participant": {
          "name": "이래티스",
          "send": "EMAIL",
          "email": "[e-mail]",
          "message": "빠른 서명 요청드립니다."
        },
        "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	대량계약 시 계약과 연결할 고객의 custom key	yes
input.items.items	계약서 생성에 필요한 사전입력값 정보	yes
input.items.customerTitle	서명과 연결될 고객명	no
input.items.customKey	계약서 식별을 위한 사용자 정의 키 값	no

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	존재하지 않는 고객인 경우