# ◦ 요청(송신) 메시지 규격

## [붙임] 거주지행정코드(관내주민) 자격여부 메시지 규격

## ◦ 거주지행정코드(관내주민) 자격여부 서비스 개요

- 기관코드, 주민등록번호, 이름을 요청하면 기관코드, 주민등록번호, 이름, 행정동코드, 거주행정기관확인결과 값을 응답하는 서비스

| 구분 | 메시지 |
| --- | --- |
| 송 신 (⇨) | 기관코드, 주민등록번호, 이름 |
| 수 신 (⇦) | 기관코드, 주민등록번호, 이름, 행정동코드, 거주행정기관확인결과 |

※ 보유기관 : 주민과

# ◦ 요청(송신) 메시지 규격

- - 요청 메시지 항목은 다음과 같다.

| 태그명 | 요소명 | 비고 |
| --- | --- | --- |
| orgCode | 기관코드 |  |
| id | 주민등록번호 |  |
| name | 성명 |  |

- - 공통 헤더부를 포함한 전체 요청 메시지 형식 예시는 다음과 같

다. 네임스페이스 등 전체 메시지 형식을 준수해야 한다.

※ 공통 헤더부 작성은 개발 가이드를 참조한다.

| <Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/"> <Header> <commonHeader<br><br>xmlns="http://ccais.mopas.go.kr/dh/jmn/services/jumin/ResideInsttCnfirm/types"> <serviceName>ResideInsttCnfirmService</serviceName> <useSystemCode>ESBTEST</useSystemCode> <certServerId>SVR1311000030</certServerId> <transactionUniqueId>2017121113110597438275152</transactionUniqueId> <userDeptCode>1380000</userDeptCode> <userName>홍길동</userName><br><br></commonHeader> </Header> <Body><br><br><getResideInsttCnfirm<br><br>xmlns="http://ccais.mopas.go.kr/dh/jmn/services/jumin/ResideInsttCnfirm/types"> <orgCode>1174000001</orgCode> <id>1111111111111</id> <name>박**</name><br><br></getResideInsttCnfirm> </Body><br><br></Envelope> |
| --- |

# ◦ 응답(수신) 메시지 규격(정상 응답 시)

- - 응답 메시지 항목은 다음과 같다.

| 태그명 | 요소명 | 비고 |
| --- | --- | --- |
| orgCode | 기관코드 | 1174000001 |
| id | 주민등록번호 | 주민등록번호 |
| name | 이름 | 이름 |
| hangkikCd | 행정동코드 | 행정동코드 |
| serviceResult | 거주행정기관확인결과 | 1:성공<br><br>2:주민등록번호오류<br><br>3:성명오류<br><br>4:거주자아님 9:시스템오류 99:등록된이용기관이아님<br><br><br> |

- - 공통 헤더부를 포함한 전체 요청 메시지 형식 예시는 다음과 같

다. 네임스페이스 등 전체 메시지 형식을 준수해야 한다.

※ 공통 헤더부의 경우 요청 메시지의 내용이 그대로 전달된다.

| <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Header> <commonHeader<br><br>xmlns="http://ccais.mopas.go.kr/dh/jmn/services/jumin/ResideInsttCnfirm/types"> <serviceName>ResideInsttCnfirmService</serviceName> <useSystemCode>ESBTEST</useSystemCode> <certServerId>SVR1311000030</certServerId><br><br><transactionUniqueId>2017121113110597438275152</transactionUniqueId> <userDeptCode>1380000</userDeptCode> <userName>홍길동</userName><br><br></commonHeader> </soap:Header> <soap:Body><br><br><getResideInsttCnfirmResponse<br><br>xmlns="http://ccais.mopas.go.kr/dh/jmn/services/jumin/ResideInsttCnfirm/types"> <orgCode>1174000000</orgCode> <id>1111111111111</id> <name>박**</name> <hangkikCd>4711125000</hangkikCd> <serviceResult>1</serviceResult><br><br></getResideInsttCnfirmResponse> </soap:Body><br><br></soap:Envelope> |
| --- |

# ◦ 응답(수신) 메시지 규격(오류가 발생한 경우)

- 서비스 수행 도중 오류가 발생한 경우 Body 태그 안에 Fault 태그를 이용하여 오류 내용을 표시한다.

※ 오류 발생 원인에 따라 굵은색 부분의 내용은 달라질 수 있음

| <?xml version="1.0" encoding="UTF-8"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"><br><br><soap:Body><br><br><soap:Fault> <faultcode>soap:Server</faultcode> <faultstring>Fault occured</faultstring><br><br></soap:Fault> </soap:Body> </soap:Envelope> |
| --- |