[별표1]

데이터 및 코드전송방식 신고부분 프로토콜 정의서

(제5조 제12호 관련)

1. 전송규칙

가. 전송방식 : HTTP

나. 전송형식 : XML

다. 신고는 소방청에서 지정한 IP와 PORT로 다매체신고시스템에 전송하여야 한다.

1) IP(URL) : sokbo.119.go.kr

2) PORT : 8000(TCP)

라. 소방청 다매체신고시스템에 자동으로 신고를 위한 인터페이스 전문은 제2호의 인터페이스 정의에 따른다.

2. 인터페이스 정의

No	필드명(한글)	필드명(영문)	DATA타입	길이 (byte)	세부내용 및 예시	비고
1	신고유형	STTEMNT_TY_CODE	VARCHAR	9	"700000001" 고정 (화재속보기 신고)	필수
2	화재속보기ID	SOKBO_STTEMNT_SN	VARCHAR	22	화재속보기ID (일련번호, 유일한 값)	필수
3	위험물여부	DGST_AT	CHAR	1	위험물여부 (여:Y, 부:N)	필수
4	문화재 여부	CRLTS_AT	CHAR	1	문화재여부 (여:Y, 부:N)	필수
5	성능인증번호	TRMNL_SN	VARCHAR	10	속보기 장비 성능인증	필수
6	장비 유형	TRMNL_TY	VARCHAR	10	속보기 단말기 유형 (0:일반속보기신고)	필수
7	위도	GPS_X	VARCHAR	20	GPS좌표(위도) 서울 성북구 정릉동 위도인 경우 "37.60611"	필수
8	경도	GPS_Y	VARCHAR	20	GPS좌표(경도) 서울 성북구 정릉동 경도인 경우 "127.01056"	필수
9	신고내용	STTEMNT_CN	VARCHAR	1000	신고내용 상세 기술	필수
10	신고접수전화번호	APLCNT_TELNO	VARCHAR	20	-없이 숫자로만 전화번호 표시	필수
11	재난종별코드	MSFRTN_KN_CODE	VARCHAR	10	재난종별코드 0040001:화재	필수
12	측위유형	GPS_CRDNT_TY	VARCHAR	30	GPS,WIFI, 그외는 빈문자
13	신고자명	APLCNT_NM	VARCHAR	20
14	발생일시	OCCRRNC_TIME	VARCHAR	14	YYYYMMDDHH24MISS (예시:20200920202122)	필수
15	주소구분값	ADDR_TY	VARCHAR	1	주소구분 : “1”(법정동)	필수
16	시도 코드	CTRD_CODE	VARCHAR	2	법정동 시도 코드	필수
17	시군구코드	SIGNGU_CODE	VARCHAR	3	법정동 시군구코드	필수
18	동코드	DONG_CODE	VARCHAR	3	법정동 동코드
19	리코드	LI_CODE	VARCHAR	2	법정동 리코드
20	산여부	MNTN_AT	CHAR	1	산 여부(여:1, 부:0)
21	주지번	MNNM	VARCHAR	4
22	부지번	SLNO	VARCHAR	4
23	상세주소	ETC_ADDR	VARCHAR	100		필수
24	도로명 관리 번호 [새주소]	RN_MGR_NO	VARCHAR	12
25	지하여부	UNDGRND_SE	VARCHAR	1	지상 0 :, 지하 1 :, 공중 : 2
26	건물 본번	BULD_MNNM	VARCHAR	5
27	건물 부번	BULD_SLNO	VARCHAR	5
28	건물명	BULD_NM	VARCHAR	20

가. 기본 구조

※ 다매체신고시스템에서 데이터를 송신할 때 위의 형식을 따른다.

나. 공통사항

1) 인터페이스 정의에서 기술된 항목 중 필수항목인 경우에는 반드시 해당 값을 입력해서 전송해야 하며, 선택항목인 경우에는 Null 값을 전송하거나 입력 값을 전송하여야 한다.

※ 작성 예) 필수항목 : 시도코드(CTRD_CODE)

<CTRD_CODE></CTRD_CODE>

26

필수 입력

※ 작성 예) 선택항목 : 건물명(BULD_NM)

<BULD_NM></BULD_NM>

Null 값

※ 필수항목 : 신고유형, 화재속보기ID, 위험물여부, 문화재여부, 장비일련번호,장비유형, 위도, 경도, 신고내용, 신고접수전화번호, 재난종별코드,발생일시, 주소값 구분, 시도코드, 시군구코드, 상세주소

※ 선택항목 : 필수항목을 제외한 필드

2) 입력 값이 한글인 경우 1글자가 3Byte, 영문,숫자인 경우 1Byte로 계산하여야 한다.

※ 작성 예) 홍길동 → “홍”(3Byte) + “길” (3Byte)  + “동” (3Byte) →  9Byte

다. 필드별 구조

1) 화재속보기ID(SOKBO_STTEMNT_SN)

가) 화재속보기ID는 성능인증을 받은 다른 화재속보기 ID와 중복되지 아니하여야 한다.

나) 화재속보기ID는 22Byte 이내로 등록하여야 한다.

(1) 전송 단말기 일련번호 필드는 제조사 단말 고유 ID를 입력하여야 하며, 고유 ID는 처음 2자리는 영문으로 2자리로 한다. 다만, 제조사가 2개 이상의 성능인증을 보유하게 되는 경우 영문으로 3자리로 할 수 있다.

※ 성능인증 시 고유 ID의 처음 2자리 또는 3자리는 성능인증 별로 부여한다.

(2) 처음 2자리 : 제조사명(영문 2자리 또는 3자리), 다음 2자리 : 생산년도(뒤에 두자리만표시), 다음 자리 : 제품생산번호

※ 작성 예) HK20101

HK   : 제조사 이니셜 두자리

2010 : 2010년

1 : 제품 생산번호

※ 작성 예) HK20101001

HK   : 제조사 이니셜 두자리

2010 : 2010년

1001 : 제품 생산번호

2) 성능인증번호(TRMNL_SN)

가) 성능인증 승인시 받은 성능인증번호를 이어야 한다. 이 경우 성능인증 번호 중 ‘속보’는 ‘SB’로 표시하여야 한다.

나) 작성 예) 성능인증번호 : 속보23-1 → SB23-1 / 속보23-50→ SB23-1

3) 위도/경도(GPS_X, GPS_Y_)

가) 화재속보기 설치 장소의 GPS좌표를 입력해야 한다.

나) 화재속보 다매체신고를 위한 좌표계는 지리좌표계(EPSG4326)를 사용해야 한다.

※ 위도와 경도는 구글지도 또는 GPS 좌표 앱 등을 이용하여 확인할 수 있다

※ 작성 예) 소방청  → GPS_X : 36.4841   GPS_Y : 127.2612

4) 신고내용

신고내용을 상세하게 기술하며 한글은 최대 500자까지 입력가능하다. 다만, 신고내용은 최대 1000byte까지이며, 영문의 경우 최대 1000자(한글 500자)입력이 가능하다.

※ 작성 예) 자동화재속보설비의 속보기에 의한 신고입니다. 속보기 설치위치 ○○○○도 ○○○시 ○○○로 ○○○이며 홍길동건물에 있으며 수신기의 설치 위치는 ○○○○입니다. 대표전화번호는 0000000000이며 관계인 연락처는 0000000000 및 00000000000입니다.

5) 신고접수전화번호

가) 신고접수전화번호는 ‘-’ 없이 숫자로만 표시해야 한다. 이 경우 지역번호, 이동전화번호, 070 번호이어도 무방하다.

※ 작성 예) 02-1234-5678 → 0212345678

010-2345-6789  →  01023456789

070-5678-1234  →  07056781234

나) 신고접수전화번호는 화재발생시 연락이 가능한 번호이어야 한다.

6) 발생일시

가) 화재 발생일시는 연월일시분초로 표현한다.

나) 시간 표시법은 24시 체계(YYYYMMDDHH24MISS)로 표현한다.

※ 작성 예) 2022년03월27일 오전 10시30분27초 : 20220327103027

2022년03월27일 오후 03시30분27초 : 20220327153027

7) 주소 구분값

주소 구분값은  ‘1’(법정동)로 한다.

구분	크기	비고
주소 구분값	1 byte	1:법정동

8) 시도코드, 시구분 코드 등

구분	크기	내용
시도코드	2 byte	ex) 서울특별시 : 11
시군구코드	3 byte	ex) 종로구 : 110
동코드	3 byte	ex) 청운동 : 101
리코드	2 byte	ex) 없음 : 00, 내양리 : 25
산여부	1 byte	여:1, 부:0
주번지	4 byte	ex) 415
부번지	4 byte	ex) 15
상세주소	100byte	최대 한글 50글자 ex) OO빌딩

※ 법정동 주소 코드는 행정표준코드관리시스템(https://www.code.go.kr/)에서 법정동 정보를 조회하여 작성하여야 한다.

※ 17개 시도 코드

서울특별시 : 11, 부산광역시 : 26, 대구광역시 : 27, 인천광역시 : 28, 광주광역시 : 29, 대구광역시 : 30, 울산광역시 : 31, 세종특벽자치시 : 36, 경기도 : 41, 강원도 : 42, 충청북도 : 43, 충청남도 : 44, 전라북도 : 45, 전라남도 : 46, 경상북도 : 47, 경상남도 : 48, 제주도 : 50

※ 작성 예) 법정동 코드 : 1111010100 (서울특별시 종로구 청운동)

11

110

101

00

서울특별시

종로구

리 없음

청운동

3. 전문 예시

<?xml version="1.0" encoding="UTF-8" standalone="no"?>

<WDS>

<Set name="default" version="1.0">

<Service key="" name="MARKET" version="1.0">

<Values>

<STTEMNT_TY_CODE>700000001</STTEMNT_TY_CODE>     // 신고유형 : 700000001로 고정

<SOKBO_STTEMNT_SN>HK20101</SOKBO_STTEMNT_SN>  // 화재속보기ID

<DGST_AT>Y</DGST_AT>	// 위험물여부

<CRLTS_AT>N</CRLTS_AT>             // 문화재 여부

<TRMNL_SN>SB23-1</TRMNL_SN>         // 성능인증번호

<TRMNL_TY>1</TRMNL_TY> // 장비 유형 속보기 단말기 유형	(0 : 일반 속보기 신고)

<GPS_X>37.60611</GPS_X>            // 위도

<GPS_Y>127.01056</GPS_Y>	// 경도

<APLCNT_TELNO>01012345678</APLCNT_TELNO>	// 신고접수전화번호

<STTEMNT_CN>자동화재속보설비의 속보기에 의한 신고입니다..</STTEMNT_CN>  // 신고내용

<APLCNT_NM>신고자</APLCNT_NM>	// 신고자

<MSFRTN_KN_CODE>0040001</MSFRTN_KN_CODE>	// 재난종별코드

<GPS_CRDNT_TY></GPS_CRDNT_TY>	// 측위유형(GPS,WIFI,그 외는 빈문자)

<OCCRRNC_TIME>20200920202122</OCCRRNC_TIME>

// 발생일시 YYYYMMDDHH24MISS (예시:20200920202122)

<ADDR_TY>1</ADDR_TY>	// 주소구분 1로 고정

<CTRD_CODE>26</CTRD_CODE>	// 법정동 시도 코드

<SIGNGU_CODE>110</SIGNGU_CODE>	// 법정동 시군구코드

<DONG_CODE>000</DONG_CODE>	// 법정동 동코드

<LI_CODE>00</LI_CODE>	// 법정동 리코드

<MNTN_AT>0</MNTN_AT>	// 산 여부(여:1, 부:0)

<MNNM>1</MNNM>	// 주번지

<SLNO>2</SLNO>	// 부번지

<ETC_ADDR>상세주소1</ETC_ADDR>	// 상세주소

<RN_MGR_NO>00000</RN_MGR_NO>	// 도로명 관리 번호[새주소]

<UNDGRND_SE>0</UNDGRND_SE>	// 지하여부(지상 0 :, 지하 1 :, 공중 : 2)

<BULD_MNNM>11</BULD_MNNM>	// 건물 본번

<BULD_SLNO>22</BULD_SLNO>	// 건물 부번

<BULD_NM>건물명</BULD_NM>	// 건물명

</Values>

</Service>

</Set>

</WDS>