Skip to main content Link Menu Expand (external link) Document Search Copy Copied

템플릿으로 일반 문서 대량 발송

개요

싸인오케이 전자계약문서를 서명자들에게 발송합니다.


URL

/api/v2/document/bulk/create

요청 데이터

항목타입위치설명
template_idStringbody템플릿 아이디
bulk_listArraybody발송할 문서 배열
redirect_urlStringbody서명제출 또는 거부 시 redirect 시킬 url(default signok)
auto_sendBooleanbody자동 송부 여부(Default false)
search_codeStringbody검색 코드
titleStringbody제목
transacntion_seqIntegerbodysigner의 key값 (일반문서 대량발송 문서 id 조회 시 필요)
signerArraybody서명 대상자 배열
    indexIntegerbody대상자 순번
    idStringbody대상자 ID값
    nameStringbody대상자 이름
    contactStringbody대상자 연락처(이메일/휴대폰)
itemsArraybody항목 배열
keyStringbodyAPI Key
valueStringbody
imageStringbodyBase64인코딩된 서명이미지(서명자 있을 때 , 간편서명)
checkedStringbodyRADIO, CHECKBOX 체크 여부
authObjectbody문서 열람 인증 설정
passwordStringbody비밀번호
simpleStringbody간편인증용 실명(설정 시 contact는 휴대폰번호 필수)
hpStringbody휴대폰인증용 실명(설정 시 contact는 휴대폰번호 필수)
biz_noStringbody법인 공동인증서 인증용 사업자번호(설정 시 contact는 이메일 필수)
memoStringbody전달메시지
cc_listArraybody참조자 리스트
contactStringbody연락처 정보 (이메일 또는 휴대폰번호)

응답 데이터

항목타입위치설명
resultObjectbody결과 데이터
    transaction_idStringbody대량발송 요청한 transaction_id
    signerArraybody-
        indexIntegerbody대상자 순번
        nameStringbody대상자 이름
        view_urlStringbody대상자 문서 URL
codeStringbody성공, 실패 코드
messageStringbody성공, 실패 메시지

응답 데이터 예시

{
    "result": {
        "transaction_id": "342c100e7039470f92ebf48ffaec8a74",
        "signer": [
            {
                "index": 1,
                "name": "name",
                "view_url": "https://doc.signok.com/linkUrl?abcdef"
            }
        ]
    },
    "code": "200",
    "message": "success"
}

Back to top

COPYRIGHT (C) 2022 KICA INC. ALL RIGHTS RESERVED