API 레퍼런스  >  홈택스 연동

하위업체 조회

등록된 하위업체의 로그인 방식과 홈택스 계정·공동인증서 등록 상태를 조회합니다.

ID/PW 방식(A, Y)이면 계정 등록 여부와 마스킹된 아이디를, 인증서 방식(C)이면 인증서 등록 상태를 반환합니다.

POST https://dev.sendbill.co.kr:444/api/agent/hometax/vendor/detail

Request

Request 항목 명세 ›
No 변수명 타입 길이 필수 설명 비고
1 venderno String 10 Y 하위업체 사업자등록번호 '-' 없이 입력
Request JSON 샘플 ›
Request 항목 명세
POST https://api.sendbill.co.kr/api/agent/hometax/vendor/detail

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

Body
{
    "venderno": "2222222222"
}

Response

Response 항목 명세 ›
NO 변수명 타입 설명
1 result Integer 처리 결과 코드. 성공 시 1, 실패 시 음수
2 message String 처리 결과 메시지
3 vendor Object 하위업체 정보. 실패 시 null
4 vendor.venderno String 하위업체 사업자등록번호
5 vendor.loginMethod String 홈택스 로그인 방식. A 또는 Y = ID·PW, C = 인증서
6 vendor.billRegistered Boolean 세금계산서 홈택스 계정 등록 여부 (ID/PW 방식)
7 vendor.billMaskedId String 마스킹된 세금계산서 홈택스 아이디 (ID/PW 방식)
8 vendor.cashRegistered Boolean 현금영수증 홈택스 계정 등록 여부 (ID/PW 방식)
9 vendor.cashMaskedId String 마스킹된 현금영수증 홈택스 아이디 (ID/PW 방식)
10 vendor.certificateState String 공동인증서 상태. NOT_REGISTERED 미등록, REGISTERED 등록, EXPIRED 만료 (인증서 방식)
11 vendor.certificateExpiredate String 공동인증서 만료일 (인증서 방식)
12 vendor.certificateRegdt String 공동인증서 등록일시 (인증서 방식)
Response JSON 샘플 › 
{
    "result": 1,
    "message": "성공",
    "vendor": {
        "venderno": "2222222222",
        "loginMethod": "A",
        "billRegistered": true,
        "billMaskedId": "hom******01",
        "cashRegistered": true,
        "cashMaskedId": "hom******02",
        "certificateState": null,
        "certificateExpiredate": null,
        "certificateRegdt": null
    }
}