# 대량전송 계약 시작 * 계약 대량 전송을 시작합니다. * 대량 계약시 서명 순서는 서식을 작성 할 때 설정한 단계에 따라 고객, 담당자가 문서를 받을 순서가 결정됩니다. (1단계만 설정 시 고객에게만 전달) 담장자는 생성자로 고정되며 고객정보는 unset\_player\_list 에 들어간 값으로 결정됩니다. unset\_player\_list에 들어있는 모든 고객에게 계약이 발전송니다. * 참조자는 서식에 등록되어있는 계정을 따라가며 따로 설정하지않습니다. * 2단계C 의 경우 담당자 항목이 없기때문에 고객 B의 정보를 추가로 기입해야하기때문에 Body에 \ customer\_list*파라미터를 추가 기입하여 설정 해 주셔야합니다.* * 2단계C의 경우\ 고객 ( unset\_player\_list ) → 고객 B ( customer\_list ) ## API 주소 정보 | Url | Type | **Code** | | ------------------------------------------ | ---- | -------- | | | POST | 1410Q | ## Request ### Parameters #### Headers | **Parameter Name** | DataType | Required | **Description** | | ------------------ | -------- | -------- | ----------------- | | Content-Type | String | Required | application/json | | Authorization | String | Required | esignon ${발급받은토큰} | #### Body Body - Header Parameter | **Parameter Name** | DataType | Required | **Description** | | ------------------ | -------- | -------- | -------------------------------- | | request\_code | String | Required | "1410Q"(API 고유 코드) | | request\_msg | String | Optional | "Work Flow Bulk Sending를 시작합니다." | | session\_id | String | Required | "thread\_023" | | version | String | Required | "9.9.99" | Body - Body Parameter | **Parameter Name** | DataType | Required | **Description** | | -------------------------------------------- | -------- | -------- | -------------------------------------------------------------------------- | | comp\_id | String | Required | 회사 ID / companyId | | biz\_id | String | Required | "0" | | memb\_email | String | Required | 생성자 이메일 | | workflow\_name | String | Required |

unset\_player\_list.workflow\_name 이름을

설정하지 않을경우 기본으로 지정되는 문서

| | workflow\_lib\_id | String | Required |

서식을 생성하면 생성되는 lid\_id
서식ID와는 다른값입니다.

(서식목록조회에서 확인가능합니다.)

| | unset\_player\_list | Data | Required | 서명하는 고객의 정보를 입력 | | unset\_player\_list.memb\_id\_type | String | Required | "EMail" or "Mobile" | | unset\_player\_list.email | String | Required |

memb\_id\_type 에 따라

이메일 or 전화번호

| | unset\_player\_list.name | String | Required | 계약 진행자 이름 | | unset\_player\_list.language | String | Optional | "ko-KR","en-US","ja-JP" | | unset\_player\_list.workflow\_name | String | Optional | 문서명 ( 계약서 이름 ) | | unset\_player\_list.enable\_mobile\_cert | String | Required | 휴대폰 인증 기능 "true or false" | | unset\_player\_list.mobile\_number | String | Required | 본인인증에 사용할 번호 / - 없이 | | unset\_player\_list.enable\_password\_cert | String | Required | 비밀번호 인증 기능 "true or false" | | unset\_player\_list.password\_hint | String | Required | 비밀번호 힌트 | | unset\_player\_list.password | String | Required | 비밀번호 | | unset\_player\_list.field\_list | Data | Required |

미리 설정할 값이 있을경우 입력

여러개 설정가능.

| | unset\_player\_list.field\_list.doc\_id | String | Required | 서식 ID | | unset\_player\_list.field\_list.field\_name | String | Required | 서식 필드 이름 | | unset\_player\_list.field\_list.field\_value | String | Required | 서식 필드 | | comment | String | Required | 전달할 메세 | | enable\_legal\_agreement | String | Required | "false" | | customer\_list | Data | Optional |

서식의 설정이 2단계 C일 경우에 설정

고객 B의 정보

| | customer\_list.memb\_id\_type | String | Required | "EMail" or "Mobile" | | customer\_list.email | String | Required |

memb\_id\_type 에 따라

이메일 or 전화번호

| | customer\_list.name | String | Required | 계약 진행자 이름 | | customer\_list.language | String | Optional | "ko-KR","en-US","ja-JP" | | customer\_list.enable\_mobile\_cert | String | Required | 휴대폰 인증 기능 "true or false" | | customer\_list.mobile\_number | String | Required | 본인인증에 사용할 번호 / - 없이 | | customer\_list.enable\_password\_cert | String | Required | 비밀번호 인증 기능 "true or false" | | customer\_list.password\_hint | String | Required | 비밀번호 힌트 | | customer\_list.password | String | Required | 비밀번호 | ## 요청 Body 예시) ```javascript { "header": { "request_code": "1410Q", "api_name": "Work Flow Bulk Sending를 시작합니다.", "session_id": "", "version" : "9.9.99" }, "body": { "comp_id": "{회사 ID}", "biz_id": "0", "memb_email": "{ 사용자 이메일 }", "workflow_lib_id": "{ 서식의 lib_id }", "workflow_name": "", "unset_player_list": [{ "memb_id_type" : "{ EMail or Mobile }", "email": "{ memb_id_type 에 따라 번호나 이메일 }", "name" : "{ 받는 사람 이름 }", "language": "{ko-KR or ja-JP or en-US}", "workflow_name" : "{서식 이름}", "enable_mobile_cert" : "{ 휴대폰 본인인증 여부 true or false }", "mobile_number" : "{ 본인 인증에 사용할 전화번호 }", "enable_password_cert":"{true or false}", "password_hint":"{계약자가 볼 비밀번호 힌트}", "password":"{설정할 문서 비밀번호}", "field_list": [{ "doc_id": "{ 서식 ID }", "field_name": "{ 서식 필드명 }", "field_value": "{ 서식 필드 값 }" }] }], "customer_list": [{ "memb_id_type": "{ 2단계 C 서식 사용시에만 기입해주세요 }", "email": "", "name": "", "language": "", "enable_mobile_cert":"", "mobile_number":"", "enable_password_cert":"", "password_hint":"", "password":"" }], "comment": "", "enable_legal_agreement":"false" } } ``` ## Response | Code | **Description** | **Reference** | | ---- | --------------- | -------------------------- | | 200 | 성공 | 형식이 잘못 된 경우 result\_msg 참조 | | 400 | 연결 실패 | | #### Result\_msg | Code | **Description** | **Reference** | | ---- | --------------- | ------------------------------------- | | 00 | 성공 | 성공 | | -1 | 실패 | 수신 메세지의 Body 정보가 잘못된 형태여서 파싱하지 못했습니다. | | 10 | 실패 | 해당 Work Flow Library가 존재하지 않습니다. | | 11 | 실패 | 실패하였습니다. | | 12 | 실패 | 허용된 저장 용량이 초과되었습니다 | | 13 | 실패 | 가능한 문서 수를 초과합니다. | | 14 | 실패 | 이용기간이 만료되었습니다. | | 15 | 실패 | 작성자 설정이 올바르지 않습니다. | ## 응답 Body 예시) ```javascript } "body":{ "workflow_list":[{ "workflow_id": "{문서ID}", "unset_player_email": "{서명자 이메일 or 전화번호}", "unset_player_name": "{서명자 이름}", "result": "OK", "description": "", "workflow_name": "{서식 이름}", "token": "{인증 토큰 코드}", "lang": "ko-KR", "reg_date": "{회사 결제 갱신일}"}], "comp_id": "{회사 ID}", "biz_id": "0", "memb_email": "{생성자 이메일}", "workflow_lib_id": "{서식 lib_id}" }, "header":{ "session_id": "thread_023", "response_code": "1410A", "result_code": "00", "result_msg": "Work Flow bulk Sending이 시작됩니다.", "version": "9.9.99" } } ```