API 레퍼런스  >  인증서 관리

인증서 등록

- (세금)계산서를 발행하기 위해 인증서를 센드빌에 등록합니다.

토큰과 인증서 파일 및 비밀번호를 전송 및 요청 시, 인증서 유효성 체크 후 센드빌에 인증서를 업로드 합니다.

센드빌에서 제공하는 인증서 등록 폼 사용을 희망 시 "인증서 등록 View URL 생성" 메뉴를 참고 바랍니다.

등록한 인증서는 세금계산서 발행과 홈택스 자동수집(인증서 방식)에 함께 사용됩니다.

인증서를 교체하면 홈택스 자동수집에도 새 인증서가 사용됩니다. 홈택스 자동수집 Job 등록·변경·재개 시에는 교체한 인증서의 비밀번호(certPassword)를 입력해야 합니다.

홈택스 자동수집이 실행 중이면 인증서를 교체할 수 없습니다(-11510). 수집이 끝난 후 다시 요청해주세요.

POST https://dev.sendbill.co.kr:444/api/agent/certificate/uploadcert

Request

Request 항목 명세 ›
변수명 타입 길이 필수 설명
jwt String - Y 토큰 생성 클래스 반환 값 (사업자 등록 번호 / 인증서 일치 필수)
password String - Y 인증서 비밀번호
certderfile String - Y 인증서 signCert.der 파일 (Base64 인코딩)
certkeyfile String - Y 인증서 signPri.key 파일 (Base64 인코딩)
Request JSON 샘플 ›
Request 항목 명세
POST https://api.sendbill.co.kr/api/agent/certificate/uploadcert

SBKEY: xxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json;charset=UTF-8
Accept-Charset: UTF-8			

Body
{
    "jwt" : "xxxxxxxxxx",
    "password" : "xxxxxxxxxx",
    "certderfile" : "xxxxxxxxxx",
    "certkeyfile" : "xxxxxxxxxx"
}

Response

Response 항목 명세 ›
NO 변수명 타입 설명
1 Result int 결과 코드
성공 : 1, 실패 : 음수
2 Message String 결과 메시지
Response JSON 샘플 › 
{
    "Result" : 1,
    "Message" : "성공"
}