API 레퍼런스  >  홈택스 연동

하위업체 수정

등록된 하위업체의 홈택스 계정 또는 로그인 방식을 변경합니다.

loginMethod를 생략하면 기존 로그인 방식을 유지하며, 입력한 계정(세금계산서·현금영수증)만 갱신합니다.

ID/PW 방식에서 인증서 방식(C)으로 변경하면 기존 ID/PW 계정이 삭제되며, 이후 인증서 등록 API 또는 인증서 등록 화면으로 공동인증서를 등록합니다. 이미 등록된 인증서가 있으면 그대로 사용하며, 자동수집 Job 등록·변경·재개 시 인증서 비밀번호(certPassword)를 입력해야 합니다.

인증서 방식에서 ID/PW 방식(A, Y)으로 변경하면 계정 입력이 필수입니다. 공동인증서는 세금계산서 발행에 사용되므로 삭제되지 않습니다.

로그인 방식 변경은 자동수집 Job이 사용 중이거나 실행 중이면 처리되지 않습니다. 자동수집 Job을 중지한 후 요청해주세요.

인증서 방식을 유지한 채 인증서를 교체하려면 인증서 등록 API 또는 인증서 등록 화면을 이용합니다. 교체 후 Job 등록·변경·재개 시에는 교체한 인증서의 비밀번호를 입력합니다.

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

Request

Request 항목 명세 ›
No 변수명 타입 길이 필수 설명 비고
1 venderno String 10 Y 하위업체 사업자등록번호 '-' 없이 입력
2 loginMethod String 1 N 홈택스 로그인 방식. A 또는 Y = ID·PW, C = 인증서 생략 시 기존 방식 유지
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/update

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

Body
{
    "venderno": "2222222222",
    "loginMethod": "A",
    "billhtid": "hometaxid01",
    "billhtpw": "hometaxpw01"
}

Response

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