API 레퍼런스  >  홈택스 연동

홈택스 ID/PW 계정 등록

세금계산서 또는 현금영수증 홈택스 ID/PW를 실제 로그인으로 검증한 후 저장합니다.

두 업무 중 하나 이상의 완전한 ID/PW 쌍을 전송해야 합니다.

POST https://dev.sendbill.co.kr:444/api/agent/hometax/account/regist

Request

Request 항목 명세 ›
No 변수명 타입 길이 필수 설명 비고
1 jwt String Y 토큰 발급 API에서 발급한 사업자 JWT JSON Body로 전송
2 billhtid String 조건부 세금계산서 홈택스 ID billhtpw와 함께 전송
3 billhtpw String 조건부 세금계산서 홈택스 비밀번호 billhtid와 함께 전송
4 cashhtid String 조건부 현금영수증 홈택스 ID cashhtpw와 함께 전송
5 cashhtpw String 조건부 현금영수증 홈택스 비밀번호 cashhtid와 함께 전송
Request JSON 샘플 ›
Request 항목 명세
POST https://api.sendbill.co.kr/api/agent/hometax/account/regist

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

Body
{
    "jwt": "eyJhbGciOiJIUzI1NiJ9...",
    "billhtid": "sample_bill",
    "billhtpw": "your-password",
    "cashhtid": "sample_cash",
    "cashhtpw": "your-password"
}

Response

Response 항목 명세 ›
NO 변수명 타입 설명
1 Result Integer 처리 결과 코드. 성공 시 1, 실패 시 0
2 Message String 처리 결과 메시지
Response JSON 샘플 › 
{
    "Result": 1,
    "Message": "계정 정보가 갱신되었습니다."
}