API 레퍼런스  >  홈택스 연동

하위업체 등록

API 이용사의 SBKEY로 하위업체 사업자번호를 홈택스 자동수집 대상으로 등록합니다.

ID/PW 방식(A, Y)은 입력한 계정으로 홈택스 로그인을 확인한 후 저장합니다. 세금계산서·현금영수증 계정 중 하나 이상을 입력해야 합니다.

인증서 방식(C)은 인증서 등록 API 또는 인증서 등록 화면으로 하위업체의 공동인증서를 등록합니다. 홈택스 등록 화면에서는 인증서를 등록하지 않습니다.

등록한 공동인증서는 세금계산서 발행과 홈택스 수집에 함께 사용됩니다. 자동수집 Job 등록·변경·재개 시에는 인증서 비밀번호(certPassword)를 입력해야 합니다.

API 이용사 자신의 사업자번호는 하위업체로 등록할 수 없으며, 홈택스 계정 등록 API를 이용합니다.

하위업체의 수집 결과 조회 및 과금은 API 이용사 기준으로 처리됩니다.

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

Request

Request 항목 명세 ›
No 변수명 타입 길이 필수 설명 비고
1 venderno String 10 Y 하위업체 사업자등록번호 '-' 없이 입력
2 loginMethod String 1 Y 홈택스 로그인 방식. A 또는 Y = ID·PW, C = 인증서 C인 경우 인증서 등록 API 또는 인증서 등록 화면으로 인증서 등록
3 billhtid String N 세금계산서 수집용 홈택스 아이디 loginMethod가 A 또는 Y인 경우
4 billhtpw String N 세금계산서 수집용 홈택스 비밀번호 billhtid와 함께 전송
5 cashhtid String N 현금영수증 수집용 홈택스 아이디 loginMethod가 A 또는 Y인 경우
6 cashhtpw String N 현금영수증 수집용 홈택스 비밀번호 cashhtid와 함께 전송
Request JSON 샘플 ›
Request 항목 명세
POST https://api.sendbill.co.kr/api/agent/hometax/vendor/register

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

Body
{
    "venderno": "2222222222",
    "loginMethod": "A",
    "billhtid": "hometaxid01",
    "billhtpw": "hometaxpw01",
    "cashhtid": "hometaxid02",
    "cashhtpw": "hometaxpw02"
}

Response

Response 항목 명세 ›
NO 변수명 타입 설명
1 result Integer 처리 결과 코드. 성공 시 1, 실패 시 음수
2 message String 처리 결과 메시지
Response JSON 샘플 › 
{
    "result": 1,
    "message": "하위업체가 등록되었습니다."
}