POPBill Developers
가이드

서비스에 대한 정확한 이해로
최적의 구현방식을 적용합니다.

API Reference

서비스에 대한 정확한 이해로
최적의 구현방식을 적용합니다.

SDK

다수 개발자에게 검증받은
SDK Example을 제공합니다.

추가 개발언어는 신청주시면
검토 후 지원합니다.
API Reference
홈택스수집
ASP
  • API Reference 홈택스수집 ASP 객체정보

    A. 객체정보

    Response

    순번변수명타입길이설명
    code Long - API 처리에 대한 응답코드
    1성공
    message String - API 처리에 대한 응답메시지

    Err

    순번변수명타입길이설명
    Number Long - API 처리 실패에 대한 오류코드
    음의 정수 8자리 숫자값 [참고] 오류코드
    Description String - API 처리 실패에 대한 오류메시지

    HTCBFlatRate

    순번변수명타입길이설명
    referenceID Integer 10 사업자번호 ('-' 제외)
    contractDT String 14 정액제 서비스 시작일시
    형식 : yyyyMMddHHmmss
    useEndDate String 8 정액제 서비스 만료일자
    형식 : yyyyMMdd
    baseDate Integer 2 자동연장 결제일
    5
    15
    25
    state String 1 정액제 서비스 상태
    1사용 또는 사용제한
    2해지
    closeRequestYN Boolean - 정액제 서비스 해지신청 여부
    True신청
    False미신청
    useRestrictYN Boolean - 정액제 서비스 사용제한 여부
    True사용제한
    False사용
    closeOnExpired Boolean - 정액제 서비스 해지 구분
    True일반해지 (정액제 서비스 만료일 해지)
    False중도해지 (요청 즉시 해지)
    unPaidYN Boolean - 미수금 보유 여부
    True보유
    False미보유

    ChargeInfo

    순번변수명타입길이설명
    unitCost String 12 요금
    chargeMethod String 3 과금유형
    연동
    파트너
    rateSystem String 3 요금제도
    정액제
    종량제

    JoinForm

    순번변수명타입길이필수설명
    ID String 50 Y 아이디
    6자 이상 50자 이하
    Password String 20 Y 비밀번호
    8자 이상 20자 이하
    영문, 숫자, 특수문자(~!@#$%^&*()_+) 포함
    LinkID String 20 Y 파트너 링크아이디
    팝빌에서 발급한 링크아이디
    CorpNum String 10 Y 사업자번호 ('-' 제외)
    CEOName String 100 Y 대표자 성명
    CorpName String 200 Y 회사명
    Addr String 300 Y 사업장 주소
    BizType String 100 Y 업태
    BizClass String 100 Y 종목
    ContactName String 100 Y 담당자 성명
    ContactEmail String 100 Y 담당자 이메일
    ContactTEL String 20 Y 담당자 휴대폰

    CorpInfo

    순번변수명타입길이필수설명
    ceoname String 100 Y 대표자 성명
    corpName String 200 Y 회사명
    addr String 300 Y 주소
    bizType String 100 Y 업태
    bizClass String 100 Y 종목

    ContactInfo - 입력부

    순번변수명타입길이필수설명
    id String 50 Y 아이디
    6자 이상 50자 이하
    password String 20 조건부 비밀번호
    8자 이상 20자 이하
    영문, 숫자, 특수문자(~!@#$%^&*()_+) 포함
    함수 [RegistContact - 담당자 추가]호출을 위한 필수값
    personName String 100 Y 담당자 성명
    tel String 20 Y 담당자 휴대폰
    email String 100 Y 담당자 이메일
    searchRole Integer 1 N 권한
    1개인권한
    2읽기권한
    3회사권한 : 기본값

    ContactInfo - 출력부

    순번변수명타입길이설명
    id String 50 아이디
    personName String 100 담당자 성명
    tel String 20 담당자 휴대폰
    email String 100 담당자 이메일
    regDT String 14 등록일시
    형식 : yyyyMMddHHmmss
    searchRole Integer 1 권한
    1개인권한
    2읽기권한
    3회사권한
    mgrYN Boolean - 역할
    True관리자
    False담당자
    팝빌 사이트 [마이페이지] > [회사정보] > [담당자 관리]에서 수정 가능
    state Integer 1 계정상태
    1사용중

    RefundHistory

    순번변수명타입길이설명
    reqDT String 14 신청일시
    형식 : yyyyMMddHHmmss
    requestPoint String 18 환불 신청포인트
    accountBank String 10 환불계좌 은행명
    accountNum String 50 환불계좌번호
    accountName String 70 환불계좌 예금주명
    state Integer 1 상태
    • 1 접수대기
    • 2 심사중
    • 3 입금대기
    • 4 환불완료
    • 5 취소
    reason String 200 환불사유

    RefundHistoryResult

    순번변수명타입길이설명
    code Long - API 처리에 대한 응답코드
    1성공
    total Long - 총 검색결과 건수
    perPage Long - 페이지당 목록 건수
    pageNum Long - 페이지 번호
    pageCount Long - 페이지 개수
    list List<RefundHistory> 환불내역

    RefundForm

    순번변수명타입길이필수설명
    contactName String 100 Y 담당자명
    tel String 20 Y 담당자 연락처
    requestPoint String 18 Y 환불 신청 포인트
    accountBank String 10 Y 은행명
    accountNum String 50 Y 계좌번호
    accountName String 70 Y 예금주명
    reason String 200 N 환불사유

    PaymentHistory

    순번변수명타입길이설명
    productType String 3 결제 내용
    포인트
    정액제
    미수금
    productName String 30 결제 상품명
    settleType String 7 결제유형
    무통장
    신용카드
    실시간계좌이체
    settlerName String 100 담당자명
    settlerEmail String 100 담당자메일
    settleCost String 18 결제금액
    settlePoint String 18 충전포인트
    settleState Integer 1 결제상태
    • 1대기
    • 2승인
    • 3실패
    • 45취소
    regDT String 14 등록일시
    형식 : yyyyMMddHHmmss
    stateDT String 14 상태일시
    형식 : yyyyMMddHHmmss

    PaymentHistoryResult

    순번변수명타입길이설명
    code Long - API 처리에 대한 응답코드
    1성공
    total Long - 총 검색결과 건수
    perPage Long - 페이지당 목록 건수
    pageNum Long - 페이지 번호
    pageCount Long - 페이지 개수
    list List<PaymentHistory> 결제내역

    UseHistoryResult

    순번변수명타입길이설명
    code Long - API 처리에 대한 응답코드
    1성공
    total Long - 총 검색결과 건수
    perPage Long - 페이지당 목록 건수
    pageNum Long - 페이지 번호
    pageCount Long - 페이지 개수
    list List<UseHistory> 사용내역

    RefundResponse

    순번변수명타입길이설명
    code Long - API 처리에 대한 응답코드
    1성공
    message String - API 처리에 대한 응답메시지
    refundCode String 18 환불코드

    PaymentForm

    순번변수명타입길이필수설명
    settlerName String 100 N 담당자명
    settlerEmail String 100 N 담당자 이메일
    notifyHP String 20 N 담당자 휴대폰
    무통장 입금 승인 알림톡이 전송될 번호
    paymentName String 70 Y 입금자명
    settleCost String 18 Y 결제금액

    PaymentResponse

    순번변수명타입길이설명
    code Long - 응답코드
    message String - 응답메시지
    settleCode String 18 정산코드