상하수도요금납부 선조회

기본정보

  • 기능 : 상하수도요금 납부 정보를 조회합니다.
  • 방식 : HTTPS-POST
  • 호출정보 : InquireSewageFarePayment.nh
  • 호출결과 : JSON

NH API 입·출력 Layout

요청

상하수도요금납부 선조회 NH API 입 출력 Layout 요청
Element 한글명 Type Length optional Description
Header   공통부      
ElecCsmrNo 전자수용가번호 필드 15 필수 테스트에서는 '263201755751004' 고정값으로 입력
Acno 계좌번호 필드 20 필수 테스트에서는 '3020000000071' 고정값으로 입력
PageNo 페이지번호 필드 4   미입력시 default 1 세팅
테스트에서는 '1' 고정값으로 입력

응답

상하수도요금납부 선조회 NH API 입 출력 Layout 응답
Element 한글명 Type Length optional Description
Header   공통부      
TotCnt 총건수 필드 10 필수 전체 건수
IqtCnt 조회총건수 필드 10 필수 페이지 당 조회된 총건수
CtntDataYn 연속데이터여부 필드 1 필수 Y : 데이터 존재, N : 데이터 미존재
REC 상하수도목록 반복부   필수 페이지당 10건
PbtxGroNo 공과금 지로번호 필드 7 필수  
PbtxInstClasCd 공과금 기관분류코드 필드 2 필수  
PbtxPytxno 공과금 납세번호 필드 32 필수  
PbtxElcrPmntNo 공과금 전자납부번호 필드 19 필수  
Isnm 기관명 필드 40 필수  
TxitNm 세목명 필드 30 필수  
PbtxNtfFrmt 공과금 고지형태 필드 1 필수  
Tram 거래금액 필드 15 필수  
PbtxTmpmDsnc 공과금 납기구분 필드 1 필수  
TmpmWthnDay 공과금 납부기한 필드 8 필수  
PbtxAhstRcvDvCd 공과금 선결제입금구분코드 필드 1 필수  
PbtxAttrRgsnYn 공과금 자동이체등록여부 필드 1 필수  

추가정보

  • 본 API는 상하수도요금 납부 전에 반드시 호출해야한다.
  • 상하수도요금 납부를 위한 정보를 조회한다.

Request example

{
    "Header": {
        "ApiNm": "InquireSewageFarePayment",
        "Tsymd": "20191212",
        "Trtm": "112428",
        "Iscd": "000013",
        "FintechApsno": "001",
        "ApiSvcCd": "13E_002_00",
        "IsTuno": "0001232130",
        "AccessToken": "10b74dd7f5f0f521ecdc7ade82f793bdfc119c3635d2e5303ae6aba0c93d4246"
    },
    "ElecCsmrNo": "263201755751004",
    "Acno": "3020000000071",
    "PageNo": "1"
}

Response example

{
    "Header": {
        "ApiNm": "InquireSewageFarePayment",
        "IsTuno": "20191108142305000004",
        "Tsymd": "20191108",
        "Trtm": "142259",
        "Rsms": "정상 처리 되었습니다.",
        "FintechApsno": "001",
        "Iscd": "000013",
        "Rpcd": "00000",
        "ApiSvcCd": "13E_002_00"
    },
    "Iqtcnt": "3",
    "TotCnt": "3",
    "CtntDataYn": "N",
    "Rec": [
        {
        "PbtxGroNo": "1004102",
        "PbtxInstClasCd": "26",
        "PbtxPytxno": "2632017557510042632000017091002",
        "PbtxElcrPmntNo": "2632001709000428753",
        "Isnm": "부산광역시",
        "TxitNm": "상·하수도사용료",
        "PbtxNtfFrmt": "2",
        "Tram": "2400",
        "PbtxTmpmDsnc": "B",
        "TmpmWthnDay": "20191130",
        "PbtxAhstRcvDvCd": "3",
        "PbtxAttrRgsnYn": "Y"
        },
        {
        "PbtxGroNo": "1004102",
        "PbtxInstClasCd": "26",
        "PbtxPytxno": "2632017557510042632000017091002",
        "PbtxElcrPmntNo": "2632001709000428795",
        "Isnm": "부산광역시",
        "TxitNm": "상·하수도사용료",
        "PbtxNtfFrmt": "2",
        "Tram": "65260",
        "PbtxTmpmDsnc": "B",
        "TmpmWthnDay": "20191130",
        "PbtxAhstRcvDvCd": "3",
        "PbtxAttrRgsnYn": "Y"
        },
        {
        "PbtxGroNo": "1004102",
        "PbtxInstClasCd": "26",
        "PbtxPytxno": "2632017560910032632000017091002",
        "PbtxElcrPmntNo": "2632001709000429032",
        "Isnm": "부산광역시",
        "TxitNm": "상·하수도사용료",
        "PbtxNtfFrmt": "2",
        "Tram": "60360",
        "PbtxTmpmDsnc": "B",
        "TmpmWthnDay": "20191130",
        "PbtxAhstRcvDvCd": "3",
        "PbtxAttrRgsnYn": "Y"
        }
    ]
}