차세대 세외수입 개별시스템 연계 표준지침

차세대 지방세입정보시스템 구축 2단계 사업

개별시스템 연계 표준지침

(차세대 세외수입시스템과의 연계 전환구축을 위한 자치단체 개별시스템 안내용)

Version 1.0

목 차

1. 개요	5

1.1. 목적	5

1.2. 적용 대상 및 범위	5

1.3. 지방세외수입 개별·특화시스템 정의 및 구분	5

1.4. 개별시스템 연계 규약	6

1.5. 차세대 세외수입 시스템과 자치단체 개별시스템 연계 추진절차	6

2. 업무별 연계 인터페이스 정의	7

2.1. 전체 인터페이스 목록	7

2.2. 과태료대장 연계 인터페이스 정의	8

2.2.1. 개요	8

2.2.2. 과태료 대장 단속 정보 등록(실시간)	8

2.2.3. 과태료 대장 등록 자료 일괄 조회(전일자 변동자료)	11

2.2.4. 과태료 대장 등록 자료 상세 조회(실시간)	14

2.3. 주정차위반과태료대장 연계 인터페이스 정의	17

2.3.1. 개요	17

2.3.2. 주정차위반과태료 단속사진 등록 레이아웃1	17

2.3.3. 주정차위반과태료 단속사진 등록 레이아웃2	19

2.4. 전용차로위반과태료대장 연계 인터페이스 정의	21

2.4.1. 개요	21

2.4.2. 전용차로위반과태료 단속사진 등록 레이아웃1	21

2.4.3. 전용차로위반과태료 단속사진 등록 레이아웃2	23

2.5. 부과·징수 연계 인터페이스 정의	25

2.5.1. 개요	25

2.5.2. 부과정보연계(실시간)	26

2.5.3. 부과/수납정보(일배치)	29

2.5.4. 부과결과정보(실시간)	32

2.5.5. 부과취소정보(실시간)	34

2.5.6. 수납정보(실시간)	35

2.5.7. 감액정보(실시간)	37

2.5.8. 부과체납정보(전일자 변동자료)	39

2.5.9. 수납정보(전일자 변동자료)	42

2.5.10. 감액정보(전일자 변동자료)	44

2.5.11. 과오납정보(전일자 변동자료)	45

2.5.12. 결손정보(전일자 변동자료)	47

3. 개별시스템 연계 프로그램 개발 지침	49

3.1. 개별시스템 연계 구성도	49

3.2. 공통 인터페이스 ID	50

3.2.1. 인터페이스 ID 구성	50

3.2.2. 공통 인터페이스 ID	50

3.3. 실시간(RESTFUL API) 연계 개발지침	51

3.3.1. RESTFUL API(HTTP + JSON) 연계 흐름 : 송신 (차세대 세외수입 → 자치단체 시스템)	51

3.3.2. RESTFUL API(HTTP + JSON) 연계 흐름 : 수신 (차세대 세외수입 ← 자치단체 시스템)	51

3.3.3. 실시간 연계 전문 표준	52

3.4. 배치(File to File) 연계 개발지침(연계 모듈 활용)	53

3.4.1. 개별시스템 파일 연계 시 파일명 규칙	53

3.4.2. FILE 연계 흐름 : 송신 (차세대 세외수입 → 자치단체 시스템)	53

3.4.3. FILE 연계 흐름 : 수신 (차세대 세외수입 ← 자치단체 시스템)	54

3.4.4. 배치파일 연계 전문 표준 (데이터 파일 구조)	54

3.5. 실시간 방식 참고 사항	56

3.5.1. 개요	56

3.5.2. 통신규격	56

3.5.3. 상세 전문 연동 규격	57

3.6. 실시간 전문 호출 Sample	59

3.6.1. 개요	59

3.6.2. 개별시스템 수신 (차세대 세외수입 -> 개별시스템)  HTTPS SSL 설정 참고	61

4. 개별시스템 연계 모듈 설치	62

4.1. 연계 환경 구성도	62

4.1.1. 연계 환경 구성	62

4.2. 연계모듈 설치	62

4.2.1. 설치 환경 확인	62

4.2.2. 방화벽 확인	62

4.2.3. 지역별 사용 포트 (검증 / 운영 동일)	63

4.2.4. 모듈 설치	64

4.2.5. 설정파일 수정	64

4.2.6. 지역별 파일 Upload, Download 스케줄 설정	66

4.2.7. 라이선스 파일 경로	67

4.2.8. 모듈 기동과 종료	67

4.3. 파일 송·수신 테스트	68

4.3.1. 파일명 규칙	68

4.3.2. 파일 송신 테스트	68

4.3.3. 파일 수신 테스트	68

4.4. 관리콘솔	69

4.4.1. 관리콘솔 접속	69

4.4.2. 모니터링	69

4.5. 방화벽 오픈 테스트	70

5. 개별시스템 연계 신청서	71

5.1. 개요	71

5.2. 연계신청서 항목 확인 예시	73

[붙임 1] 공통코드 정보

개요

목적

다원화되어 있는 지방세외수입 업무의 분산된 운영환경(표준 시스템, 자치단체 개별시스템, 특화시스템, 새올행정시스템 등)에서 세외수입 업무시스템 간 연계 표준방안을 통해 지방세외수입 통계 정합성 확보와 자치단체 특성에 맞는 지방세외수입 자체 서비스 강화를 지원하고자 함

(추진근거) 「지방세입정보시스템의 운영 및 관리 규정」제20조(정보시스템을 통한 업무처리)를 준용하여 지방행정제재ㆍ부과금의 부과․징수 업무를 처리하는 개별시스템은 지방세외수입정보시스템으로 통합*

*「지방행정제재ㆍ부과금의 징수 등에 관한 법률」제20조(지방세외수입 징수 및 관리 업무의 정보화) 를 통해 설치된 “지방세외수입정보통신망”의 운영 및 관리에 관한 규정인「지방세입정보시스템의 운영 및 관리 규정」 제20조(정보시스템을 통한 업무처리)를 준용

적용 대상 및 범위

본 지침은 현행 표준지방세외수입정보시스템과 연계 중인 자치단체 개별시스템과 차세대 지방세입정보시스템 구축사업 기간 중 차세대 세외수입 시스템과의 연계를 요청한 자치단체 개별시스템을 대상으로 함

현행 표준지방세외수입정보시스템과 연계 중인 자치단체 개별시스템

→ 128개 지방자치단체 203개 개별시스템 연계 (23개 업체 32개 시스템)

차세대 시스템과의 통합 및 연계를 신청한 자치단체 개별시스템(설문조사 결과)

(공문) 「차세대지방세외수입정보시스템 구축 관련 민간보급 개별시스템 데이터 이관·연계 계획 안내 및 설명회 참석 요청」 (2022.7.7. 행정안전부 세외수입보조금정보과-971)

→ 지방자치단체 민간보급 개별시스템 데이터 이관 통합 및 연계 대상(118개 시스템)

차세대 세외수입 개별시스템 연계 표준지침에 맞춰 연계 신청, 프로그램 개발, 연계 테스트 등 추진 단계별 검증이 완료된 개별시스템에 대해서 차세대 지방세입정보시스템 개통 시 연계 적용됨

차세대 시스템 개통 이후 세외수입 개별시스템 연계는 별도 절차와 지침을 통해 추진 (차세대 시스템 개통 이후 별도 안내)

차세대 세외수입 시스템의 기능 개선으로 현세대 시스템에서 제공하던 일부 연계 항목은 제외되거나 범위가 축소될 수 있음(예: 차세대 시스템에서는 ‘온나라 전자결재시스템’과 연동되며, 기존 현세대 시스템에서 제공하던 전자결재 관련 연계는 제공하지 않음)

지방세외수입 개별·특화시스템 정의 및 구분

(개별시스템) 표준지방세외수입정보시스템이 아닌 자치단체 업무시스템에서 세외수입 부과·징수 업무를 처리하거나 부과 대상 식별을 위한 기초자료(단속정보 등)를 관리하는 자치단체 자체 구축시스템

(연계 자료) 부과자료 연계, 과태료 대장 연계, 주정차위반과태료 단속정보(사진) 연계,
전용차로위반과태료 단속정보(사진) 연계

→ 부과 대상 정보, 납부자 정보, 부과 기본 정보(과태료 등)을 개별시스템에서 자체 관리

(주요 시스템) 장애인주정차위반관리시스템, 흡연단속시스템, 도로점용허가시스템, 도로굴착시스템, 밤샘주차단속시스템, 공공예약관리시스템 등

(특화시스템) 지방세외수입 부과·징수 관리 이외에 지방세외수입 관련 대민서비스 제공과 지방세외수입 행정업무 편의성을 위해 자치단체에서 구축한 시스템

(연계 자료) 지방세외수입 부과·징수자료 연계 등

(주요 시스템) 개인정보통합관리시스템, 통합민원콜센터, 차량영치시스템, CCTV통합관제, 공간정보시스템, 통합체납관리시스템 등

개별시스템 연계 규약

연계 규약

구분	주요 내용	비고
실시간 방식 (RESTFUL API)	□ 프로토콜 : HTTPS □ 전문형식 : JSON □ 캐릭터 Set : UTF-8	□ 헤더부 + 데이터부 구성
배치 방식 (File to File)	□ 프로토콜 : SFTP □ 파일형식 : CSV □ 인코딩 : UTF-8 (한글 3 Byte 표현)	□ 연계 모듈(ESB Agent) 활용

차세대 세외수입 시스템과 자치단체 개별시스템 연계 추진절차

개별시스템 연계 추진절차

절차	주요 내용	비고
연계 신청서 제출	□ 차세대 세외수입 개별시스템 연계 신청서 제출	10월
□
연계 프로그램 개발	□ 차세대 세외수입 개별시스템 연계 표준지침을 참고하여 연계 프로그램 개발	10월 ∼ 11월
□
연계 모듈제공 (ESB Agent)	□ 개별시스템 연계 신청 기관을 대상으로 연계 모듈(ESB Agent) 및 라이센스 파일 개별제공(이메일) ※ 연계 신청 기관별 안내	11월
□
방화벽 설정	□ 차세대 세외수입 개별시스템 연계 표준지침을 참고하여 연계 신청서에 명시한 네트워크 환경 접근 허용	11월
□
연계 모듈 설치	□ 차세대 세외수입 개별시스템 연계 표준지침을 참고하여 연계 모듈을 개별시스템에 직접 설치	11월
□
연계 프로그램 테스트	□ 차세대 세외수입 시스템과 개별시스템 간 연계 테스트 ※ 상세 테스트 방안 별도 안내	11월 ∼ 12월
□
차세대 지방세입정보시스템 개통 (연계전환 구축)	□ 차세대 세외수입 시스템 개통계획에 따라 자치단체 개별시스템 연계 전환구축 ※ 자치단체 환경에 따라 초기자료 구축 필요	2023년 1월 25일

업무별 연계 인터페이스 정의

전체 인터페이스 목록

순번	업무 구분	연계목록명	송·수신(호출방향)	주기	신청기준
1	과태료대장(3종) (A)	과태료 대장 단속 정보 등록(실시간)	개별시스템 □ 차세대	수시	A01
2		과태료 대장 등록 자료 일괄 조회(전일자 변동자료)	차세대 □ 개별시스템	일배치	A02
3		과태료 대장 등록 자료 상세 조회(실시간)	개별시스템 □ 차세대	수시	A03
4	주정차위반 과태료대장(2종) (B)	주정차위반과태료 단속사진 등록 레이아웃1	개별시스템 □ 차세대	수시	B01
5		주정차위반과태료 단속사진 등록 레이아웃2	개별시스템 □ 차세대	수시
6	전용차로위반 과태료대장(2종) (C)	전용차로위반과태료 단속사진 등록 레이아웃1	개별시스템 □ 차세대	수시	C01
7		전용차로위반과태료 단속사진 등록 레이아웃2	개별시스템 □ 차세대	수시
8	부과· 징수(11종) (D)	부과정보연계(실시간)	개별시스템 □ 차세대	수시	D01
9		부과/수납정보(일배치)	개별시스템 □ 차세대	일배치	D02
10		부과결과정보(실시간)	차세대 □ 개별시스템	수시	D03
11		부과취소정보(실시간)	차세대 □ 개별시스템	수시	D04
12		수납정보(실시간)	차세대 □ 개별시스템	수시	D05
13		감액정보(실시간)	차세대 □ 개별시스템	수시	D06
14		부과체납정보(전일자 변동자료)	차세대 □ 개별시스템	일배치	D07
15		수납정보(전일자 변동자료)	차세대 □ 개별시스템	일배치
16		감액정보(전일자 변동자료)	차세대 □ 개별시스템	일배치
17		과오납정보(전일자 변동자료)	차세대 □ 개별시스템	일배치
18		결손정보(전일자 변동자료)	차세대 □ 개별시스템	일배치

과태료대장 연계 인터페이스 정의

개요

연계목록(3종)

순번	연계목록명	송·수신(호출방향)	주기	신청기준
1	과태료 대장 단속 정보 등록(실시간)	개별시스템 □ 차세대	수시	A01
2	과태료 대장 등록 자료 일괄 조회(전일자 변동자료)	차세대 □ 개별시스템	일배치	A02
3	과태료 대장 등록 자료 상세 조회(실시간)	개별시스템 □ 차세대	수시	A03

과태료 대장 단속 정보 등록(실시간)

기본정보

항목	내용	비고
연계명	과태료 대장 단속 정보 등록(실시간)
인터페이스ID
연계유형	RESTFUL API(Http+Json)
업무처리 설명	과태료 대장 단건 등록
송신기관	개별시스템
수신기관	차세대세외수입
주기	수시

상세 Layout

순번	한글컬럼	영문컬럼	길이	필수	기본값	설명
<헤더>
연계표준지침 참조 구성
<요청>(개별시스템 → 차세대세외수입)
1	자치단체코드	sgbCd	7	○		행정표준코드관리시스템의 자치단체코드
2	연계대상코드	linkTrgtCd	15	○		세외수입에서 부여한 시스템코드(연계 확정시 코드부여) 연계기관코드(7)+연계시스템코드(3)+연계일련번호(5) 국가보급시스템인 경우 연계기관코드와 자치단체코드가 다를 수 있음
3	연계관리키	linkMngKey	50			연계대상 기관에서 관리하는 유일키 자치단체코드 + 연계대상코드 + 연계관리키는 unique 해야함
4	부서코드	dptCd	7	○		행정표준코드관리시스템의 부서코드
5	접수연도	rcptYr	4	○		현재연도
6	특별회계사업코드	spclFisBizCd	4	○	“0000”	특별회계 세목코드를 사용한 경우 특별회계사업코드 필요(회계구분이 '51','61' 인경우에만 해당)
7	회계구분코드	actSeCd	2	○		국세:16, 시도세:31, 시군구세:41. 특별회계시도세:51, 특별회계시군구세:61
8	대표세입과목코드	rprsTxmCd	6	○
9	운영항목코드	operItemCd	3	○	“000”
10	과태료과징금구분코드	finScrgSeCd	2	○	'01'	01:과태료 02:과징금
11	납부자구분코드	pyrSeCd	2	○		01:개인 02:법인 03:단체 05:외국인
12	납부자번호	pyrNo	13	○
13	납부자명	pyrNm	200	○
14	대표납부자번호	rprsPyrNo	24	○		법인의 경우 대표 납부자번호 필수
15	대표납부자명	rprsPyrNm	200	○		법인의 경우 대표 납부자명 필수
16	연락처	cnpc	11			- 빼고 숫자만
17	연락처구분코드	cnpcSeCd	2			01: 전화번호, 02:휴대전화
18	납부자이메일주소	pyrEmlAddr	50
19	납부자상태코드	pyrSttCd	2	○	'10'	[붙임1] 참조
20	지번도로주소구분코드	lotnoRoadAddrSeCd	2	○		01:지번주소, 02:도로명주소
21	우편번호	zip	6	○
22	도로명코드	roadNmCd	12			도로명주소인경우 필수
23	지하여부	addrUdgdYn	1		'N'	Y:지하, N:지상
24	건물본번	bmno	5			도로명주소인경우 필수
25	건물부번	bsno	5
26	법정동코드	stdgCd	10	○		필수
27	행정동코드	dongCd	10
28	산구분코드	addrMtnYn	2		'01'	01:일반번지, 02:산번지
29	본번	mno	4			번지. 지번주소인 경우 필수
30	부번	sno	4			호
31	특수동	spclAddr	30			상세주소 동
32	특수호	spclDg	15			상세주소 호
33	특수주소	spclHo	450			상세주소
34	도로명주소	roadNmAddr	300			도로명 주소를 텍스트 형태로 관리하는 시스템일 경우
35	도로명상세주소	roadNmDaddr	300			도로명 주소를 텍스트 형태로 관리하는 시스템일 경우
36	도로명전체주소	roadNmAlAddr	750			도로명 주소를 텍스트 형태로 관리하는 시스템일 경우
37	지번주소	lotnoAddr	200			지번주소를 텍스트로 관리하는 시스템일 경우
38	지번상세주소	lotnoDaddr	300			지번주소를 텍스트로 관리하는 시스템일 경우
39	지번전체주소	lotnoAlAddr	500			지번주소를 텍스트로 관리하는 시스템일 경우
40	물건지명	glNm	500	○
41	물건지지번도로주소구분코드	glLotnoRoadAddrSeCd	2			01:지번주소, 02:도로명주소
42	물건지우편번호	glZip	6
43	물건지도로명코드	glRoadNmCd	12			도로명주소인경우 필수
44	물건지주소지하여부	glAddrUdgdYn	1		'N'	Y:지하, N:지상
45	물건지건물본번	glBmno	5			도로명주소인경우 필수
46	물건지건물부번	glBsno	5
47	물건지법정동코드	glStdgCd	10			필수
48	물건지행정동코드	glDongCd	10
49	물건지산구분코드	glMtnYn	2		'01'	01:일반번지, 02:산번지
50	물건지본번	glMno	4			번지. 지번주소인 경우 필수
51	물건지부번	glSno	4			호
52	물건지특수동	glSpclAddr	30			상세주소 동
53	물건지특수호	glSpclDg	15			상세주소 호
54	물건지특수주소	glSpclHo	450			상세주소
55	물건지도로명기본주소	glRoadNmAddr	300			도로명 주소를 텍스트 형태로 관리하는 시스템일 경우
56	물건지도로명상세주소	glRoadNmDaddr	300			도로명 주소를 텍스트 형태로 관리하는 시스템일 경우
57	물건지도로명전체주소	glRoadNmAlAddr	750			도로명 주소를 텍스트 형태로 관리하는 시스템일 경우
58	물건지지번기본주소	glLotnoAddr	300			지번주소를 텍스트로 관리하는 시스템일 경우
59	물건지지번상세주소	glLotnoDaddr	300			지번주소를 텍스트로 관리하는 시스템일 경우
60	물건지지번전체주소	glLotnoAlAddr	750			지번주소를 텍스트로 관리하는 시스템일 경우
61	부과대상구분코드	lvyTrgtSeCd	2		9	[붙임1] 참조
62	등록일자	regYmd	8			위반일자
63	과태료과징금금액	finScrgAmt	15	○	0
64	시설구분코드	fcltSeCd	2			[붙임1] 참조 금연구역흡연위반 과태료인 경우만 입력
65	등록구분코드	regSeCd	2		99	폐기물관리법위반 과태료인 경우 01 투기, 02 소각, 99 기타
66	감경사유구분코드	rdtRsnSeCd	4			[붙임1] 참조
67	자동차등록번호	vhrno	30			차량 관련 과태료인 경우 필수
68	조례법령근거명	laoBssNm	450			과태료/과징금 법령 근거
69	관리1항목	mngItemCn1	200	○		과태료 부과 시 필요한 부과근거 1 위반장소
70	관리2항목	mngItemCn2	200			과태료 부과 시 필요한 부과근거 2 위반일시
71	관리3항목	mngItemCn3	200			과태료 부과 시 필요한 부과근거 3 법령근거
72	관리4항목	mngItemCn4	200			과태료 부과 시 필요한 부과근거 4 위반사항
73	관리5항목	mngItemCn5	200			과태료 부과 시 필요한 부과근거 5
74	관리6항목	mngItemCn6	200			과태료 부과 시 필요한 부과근거 6
75	비고내용	rmCn	4000
76	예비항목1	rsveItem1	200		NULL	예비항목1
77	예비항목2	rsveItem2	200		NULL	예비항목2
78	예비항목3	rsveItem3	200		NULL	예비항목3
79	예비항목4	rsveItem4	200		NULL	예비항목4
80	예비항목5	rsveItem5	200		NULL	예비항목5
<응답>(차세대세외수입 → 개별시스템)
1	자치단체코드	sgbCd	7			행정표준코드관리시스템의 자치단체코드
2	연계대상코드	linkTrgtCd	15
3	연계관리키	linkMngKey	50
4	연계 결과 코드	linkRstCd	30
5	연계 결과 메시지	linkRstMsg	200

과태료 대장 등록 자료 일괄 조회(전일자 변동자료)

기본정보

항목	내용	비고
연계명	과태료 대장 등록 자료 일괄 조회(전일자 변동자료)
인터페이스ID
연계유형	FileToFile
업무처리 설명	세외수입 과태료 대장으로 등록 요청한 자료에 대한 전일자 기준 변동내역을 일괄조회
송신기관	차세대세외수입
수신기관	개별시스템
자료생성 기준	전일 24시 기준으로 자료 생성
파일생성 기준	매일 04시

상세 Layout

순번	한글컬럼	길이	설명
1	기준일	8	연계기준일
2	자치단체코드	7	행정표준코드관리시스템의 자치단체코드
3	자치단체명	60	자치단체코드의 명
4	연계대상코드	15	세외수입에서 부여한 시스템코드(연계 확정시 코드부여) 연계기관코드(7)+연계시스템코드(3)+연계일련번호(5) 국가보급시스템인 경우 연계기관ID와 자치단체코드가 다를 수 있음
5	연계관리키	50	연계대상 기관에서 관리하는 유일키 자치단체코드 + 연계대상코드 + 연계관리키는 unique 해야함
6	과태료대장키	11	세외수입 과태료 대장 등록 키
7	부서코드	7	행정표준코드관리시스템의 부서코드
8	부서명	200	행정표준코드관리시스템의 부서코드의 명
9	접수연도	4
10	특별회계사업코드	4
11	특별회계사업명	50
12	회계구분코드	2	국세:16, 시도세:31, 시군구세:41. 특별회계시도세:51, 특별회계시군구세:61
13	회계구분명	100	국세:16, 시도세:31, 시군구세:41. 특별회계시도세:51, 특별회계시군구세:61
14	대표세입과목코드	6
15	대표세입과목명	100	세입과목명
16	운영항목코드	3
17	운영항목명	100	운영과목명
18	등록일자	8	등록일자(위반일자)YYYYMMDD
19	납부자구분명	10	개인, 법인, 단체, 사업자, 외국인
20	납부자번호	13	납부자의 고유식별번호, 주민번호 또는 법인번호, 외국인번호 등
21	납부자명	200	납부자의 성명
22	납부자상태코드	2	[붙임1] 참조
23	납부자상태명	20	[붙임1] 참조
24	납부자우편번호	6	납부자우편번호
25	납부자주소	750	납부자주소
26	전화번호	11	납부자 전화번호
27	휴대폰번호	11	납부자 휴대폰번호
28	납부자이메일	50	납부자 이메일주소
29	자동차등록번호	17	차량관련 과태료인 경우 (주정차, 전용차로, 자동차관리법, 의무보험미가입 제외한 차량과태료)
30	관리1항목	200	과태료 부과 시 필요한 부과근거 1 : 위반장소
31	관리2항목	200	과태료 부과 시 필요한 부과근거 2 : 위반일시
32	관리3항목	200	과태료 부과 시 필요한 부과근거 3 : 법령근거
33	관리4항목	200	과태료 부과 시 필요한 부과근거 4 : 위반사항
34	관리5항목	200	과태료 부과 시 필요한 부과근거 5
35	관리6항목	200	과태료 부과 시 필요한 부과근거 6
36	시설구분코드	2	[붙임1] 참조 금연구역흡연위반 과태료인 경우만 있음
37	시설구분명	2	폐기물관리법위반 과태료인 경우(01 투기, 02 소각, 99 기타)
38	등록구분코드	2	폐기물관리법위반 과태료인 경우(01 투기, 02 소각, 99 기타)
39	등록구분명	2	이관 시 과태료과징금사전통지내역의 동일 항목값으로 대체
40	사전통지일자	8
41	의견제출기한시작일자	8
42	의견제출기한종료일자	8
43	최초과태료과징금금액	15	법령에 의한 최초 과태료금액
44	감경사유구분코드	4	[붙임1] 참조
45	감경사유구분명	100
46	가중사유코드	2
47	감경가중율	3	질서위반행위규제법 시행령 제2조의2에 의한 감경율, 예) 50%인 경우 50
48	과태료과징금금액	15	질서위반행위규제법 제2조의2(과태료 감경) 로 인한 감경된 과태료 금액, 감경대상이 아니면 최초과태료 금액과 같음
49	사전감경율	0	의견제출기간 내에 자진납부 시 감경율(예) 20%인 경우 20)
50	사전감경금액	15
51	비고내용	4000
52	감경비고내용	1000	자진납부 감경부과에 대한 비고
53	고지서발송지구분코드	2	01:납부자, 02:물건지
54	고지서발송지구분명	100	01:납부자, 02:물건지
55	종료일자	8	과태료 업무가 종결되는 일자, 비부과처리일자(이첩, 면제 등)
56	종료사유내용	4000	과태료 업무가 종결되는 사유
57	수납구분명	20	수납, 미수납, 일부수납
58	전자납부번호	19	전자납부번호
59	가상계좌은행명1	30	자치단체에서 주요 거래은행으로 설정한 가상계좌 은행명
60	가상계좌번호1	20	자치단체에서 주요 거래은행으로 설정한 가상계좌 은행의 가상계좌번호
61	가상계좌은행명2	30	자치단체에서 설정한 가상계좌 은행명
62	가상계좌번호2	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
63	가상계좌은행명3	30	자치단체에서 설정한 가상계좌 은행명
64	가상계좌번호3	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
65	가상계좌은행명4	30	자치단체에서 설정한 가상계좌 은행명
66	가상계좌번호4	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
67	가상계좌은행명5	30	자치단체에서 설정한 가상계좌 은행명
68	가상계좌번호5	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
69	가상계좌은행명6	30	자치단체에서 설정한 가상계좌 은행명
70	가상계좌번호6	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
71	가상계좌은행명7	30	자치단체에서 설정한 가상계좌 은행명
72	가상계좌번호7	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
73	가상계좌은행명8	30	자치단체에서 설정한 가상계좌 은행명
74	가상계좌번호8	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
75	가상계좌은행명9	30	자치단체에서 설정한 가상계좌 은행명
76	가상계좌번호9	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
77	가상계좌은행명10	30	자치단체에서 설정한 가상계좌 은행명
78	가상계좌번호10	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
79	가상계좌은행명11	30	자치단체에서 설정한 가상계좌 은행명
80	가상계좌번호11	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
81	가상계좌은행명12	30	자치단체에서 설정한 가상계좌 은행명
82	가상계좌번호12	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
83	가상계좌은행명13	30	자치단체에서 설정한 가상계좌 은행명
84	가상계좌번호13	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
85	가상계좌은행명14	30	자치단체에서 설정한 가상계좌 은행명
86	가상계좌번호14	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
87	가상계좌은행명15	30	자치단체에서 설정한 가상계좌 은행명
88	가상계좌번호15	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
89	가상계좌은행명16	30	자치단체에서 설정한 가상계좌 은행명
90	가상계좌번호16	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
91	가상계좌은행명17	30	자치단체에서 설정한 가상계좌 은행명
92	가상계좌번호17	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
93	가상계좌은행명18	30	자치단체에서 설정한 가상계좌 은행명
94	가상계좌번호18	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
95	가상계좌은행명19	30	자치단체에서 설정한 가상계좌 은행명
96	가상계좌번호19	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
97	가상계좌은행명20	30	자치단체에서 설정한 가상계좌 은행명
98	가상계좌번호20	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
99	예비항목1	200	예비항목1
100	예비항목2	200	예비항목2
101	예비항목3	200	예비항목3
102	예비항목4	200	예비항목4
103	예비항목5	200	예비항목5

과태료 대장 등록 자료 상세 조회(실시간)

기본정보

항목	내용	비고
연계명	과태료 대장 등록 자료 상세 조회(실시간)
인터페이스ID
연계유형	RESTFUL API(Http+Json)
업무처리 설명	세외수입 과태료 대장으로 등록 요청한 자료에 대해 과태료 대장 상세 정보 조회 (단건)
송신기관	개별시스템
수신기관	차세대세외수입
주기	수시

상세 Layout

순번	한글컬럼	영문컬럼	길이	설명
<헤더>
연계표준지침 참조 구성
<요청>(개별시스템 → 차세대세외수입)
1	자치단체코드	sgbCd	7	[필수] 행정표준코드관리시스템의 자치단체코드
2	연계대상코드	linkTrgtCd	15	[필수] 세외수입에서 부여한 시스템코드(연계 확정시 코드부여)
3	연계관리키	linkMngKey	50	연계대상 기관에서 관리하는 유일키 연계관리키 또는 과태료과징금대장키 두 항목 중 하나는 필수
4	과태료과징금대장키	finScrgAcbKey	11	연계관리키 또는 과태료과징금대장키 두 항목 중 하나는 필수
<응답>(차세대세외수입 → 개별시스템)
1	연계 결과 코드	linkRstCd	30
2	연계 결과 메시지	linkRstMsg	200
3	자치단체코드	sgbCd	7	행정표준코드관리시스템의 자치단체코드
4	연계대상코드	linkTrgtCd	15	세외수입에서 부여한 시스템코드(연계 확정시 코드부여)
5	연계관리키	linkMngKey	50	연계대상 기관에서 관리하는 유일키
6	과태료과징금대장키	finScrgAcbKey	11
7	부서코드	dptCd	7	행정표준코드관리시스템의 부서코드
8	부서명	dptNm	200	행정표준코드관리시스템의 부서코드의 명
9	접수연도	rcptYr	4
10	특별회계사업코드	spclFisBizCd	4
11	특별회계사업명	spclFisBizNm	50
12	회계구분코드	actSeCd	2	국세:16, 시도세:31, 시군구세:41. 특별회계시도세:51, 특별회계시군구세:61
13	회계구분명	actSeNm	100	국세:16, 시도세:31, 시군구세:41. 특별회계시도세:51, 특별회계시군구세:61
14	대표세입과목코드	rprsTxmCd	6
15	대표세입과목명	rprsTxmNm	100	세입과목명
16	운영항목코드	operItemCd	3
17	운영항목명	operItemNm	100	운영과목명
18	등록일자	regYmd	8	등록일자(위반일자)YYYYMMDD
19	납부자구분명	pyrSeNm	10	개인, 법인, 단체, 사업자, 외국인
20	납부자번호	pyrNo	13	납부자의 고유식별번호, 주민번호 또는 법인번호, 외국인번호 등
21	납부자명	pyrNm	200	납부자의 성명
22	납부자상태코드	pyrSttCd	2	[붙임1] 참조
23	납부자상태명	pyrSttNm	20	[붙임1] 참조
24	납부자우편번호	pyrZip	6	납부자우편번호
25	납부자주소	pyrAddr	750	납부자주소
26	전화번호	telno	11	납부자 전화번호
27	휴대폰번호	mblTelno	11	납부자 휴대폰번호
28	납부자이메일	pyrEmlAddr	50	납부자 이메일주소
29	자동차등록번호	vhrno	17	차량관련 과태료인 경우 (주정차, 전용차로, 자동차관리법, 의무보험미가입 제외한 차량과태료)
30	관리1항목	mngItemCn1	200	과태료 부과 시 필요한 부과근거 1 : 위반장소
31	관리2항목	mngItemCn2	200	과태료 부과 시 필요한 부과근거 2 : 위반일시
32	관리3항목	mngItemCn3	200	과태료 부과 시 필요한 부과근거 3 : 법령근거
33	관리4항목	mngItemCn4	200	과태료 부과 시 필요한 부과근거 4 : 위반사항
34	관리5항목	mngItemCn5	200	과태료 부과 시 필요한 부과근거 5
35	관리6항목	mngItemCn6	200	과태료 부과 시 필요한 부과근거 6
36	시설구분코드	fcltSeCd	2	[붙임1] 참조 금연구역흡연위반 과태료인 경우만 있음
37	시설구분명	fcltSeNm	2	[붙임1] 참조 금연구역흡연위반 과태료인 경우만 있음
38	등록구분코드	regSeCd	2	폐기물관리법위반 과태료인 경우만 있음 01 투기, 02 소각, 99 기타
39	등록구분명	regSeNm	2	폐기물관리법위반 과태료인 경우만 있음 01 투기, 02 소각, 99 기타
40	사전통지일자	bfAvtsmtYmd	8	이관 시 과태료과징금사전통지내역의 동일 항목값으로 대체
41	의견제출기한시작일자	opnSbmsnTermBgngYmd	8
42	의견제출기한종료일자	opnSbmsnTermEndYmd	8
43	최초과태료과징금금액	frstFinScrgAmt	15	법령에 의한 최초 과태료금액
44	감경사유구분코드	rdtRsnSeCd	4	[붙임1] 참조
45	감경사유구분명	rdtRsnSeNm	100	[붙임1] 참조
46	가중사유코드	agvtRsnCd	2	01 : 위반의 내용, 정도에 따른 피해가 큰 경우 02 : 법 위반상태의 기간이 6개월 이상인 경우 03 : 그밖에 과징금을 늘일 필요가 있다고 인정되는 경우 04 : 타법령에의한가중 99 : 기타
47	감경가중율	agvtRsnNm	3	질서위반행위규제법 시행령 제2조의2에 의한 감경율 예) 50%인 경우 50
48	과태료과징금금액	finScrgAmt	15	질서위반행위규제법 제2조의2(과태료 감경) 로 인한 감경된 과태료 금액, 감경대상이 아니면 최초과태료 금액과 같음
49	사전감경율	bfRdtRt	0	의견제출기간 내에 자진납부 시 감경율 예) 20%인 경우 20
50	사전감경금액	bfRdtAmt	15
51	비고내용	rmCn	4000
52	감경비고내용	rdtRmCn	1000	자진납부 감경부과에 대한 비고
53	고지서발송지구분코드	nhtFrwarSeCd	2	01:납부자, 02:물건지
54	고지서발송지구분명	nhtFrwarSeNm	100	01:납부자, 02:물건지
55	종료일자	endYmd	8	과태료 업무가 종결되는 일자, 비부과처리일자(이첩, 면제 등)
56	종료사유내용	endRsnCn	4000	과태료 업무가 종결되는 사유
57	수납구분명	rcvmtSeNm	20	수납, 미수납, 일부수납
58	전자납부번호	epayNo	19	전자납부번호
59	가상계좌은행명1	vrActnoBankCd1	30	자치단체에서 주요 거래은행으로 설정한 가상계좌 은행명
60	가상계좌번호1	vrActno1	20	자치단체에서 주요 거래은행으로 설정한 가상계좌 은행의 가상계좌번호
61	가상계좌은행명2	vrActnoBankCd2	30	자치단체에서 설정한 가상계좌 은행명
62	가상계좌번호2	vrActno2	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
63	가상계좌은행명3	vrActnoBankCd3	30	자치단체에서 설정한 가상계좌 은행명
64	가상계좌번호3	vrActno3	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
65	가상계좌은행명4	vrActnoBankCd4	30	자치단체에서 설정한 가상계좌 은행명
66	가상계좌번호4	vrActno4	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
67	가상계좌은행명5	vrActnoBankCd5	30	자치단체에서 설정한 가상계좌 은행명
68	가상계좌번호5	vrActno5	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
69	가상계좌은행명6	vrActnoBankCd6	30	자치단체에서 설정한 가상계좌 은행명
70	가상계좌번호6	vrActno6	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
71	가상계좌은행명7	vrActnoBankCd7	30	자치단체에서 설정한 가상계좌 은행명
72	가상계좌번호7	vrActno7	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
73	가상계좌은행명8	vrActnoBankCd8	30	자치단체에서 설정한 가상계좌 은행명
74	가상계좌번호8	vrActno8	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
75	가상계좌은행명9	vrActnoBankCd9	30	자치단체에서 설정한 가상계좌 은행명
76	가상계좌번호9	vrActno9	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
77	가상계좌은행명10	vrActnoBankCd10	30	자치단체에서 설정한 가상계좌 은행명
78	가상계좌번호10	vrActno10	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
79	가상계좌은행명11	vrActnoBankCd11	30	자치단체에서 설정한 가상계좌 은행명
80	가상계좌번호11	vrActno11	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
81	가상계좌은행명12	vrActnoBankCd12	30	자치단체에서 설정한 가상계좌 은행명
82	가상계좌번호12	vrActno12	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
83	가상계좌은행명13	vrActnoBankCd13	30	자치단체에서 설정한 가상계좌 은행명
84	가상계좌번호13	vrActno13	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
85	가상계좌은행명14	vrActnoBankCd14	30	자치단체에서 설정한 가상계좌 은행명
86	가상계좌번호14	vrActno14	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
87	가상계좌은행명15	vrActnoBankCd15	30	자치단체에서 설정한 가상계좌 은행명
88	가상계좌번호15	vrActno15	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
89	가상계좌은행명16	vrActnoBankCd16	30	자치단체에서 설정한 가상계좌 은행명
90	가상계좌번호16	vrActno16	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
91	가상계좌은행명17	vrActnoBankCd17	30	자치단체에서 설정한 가상계좌 은행명
92	가상계좌번호17	vrActno17	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
93	가상계좌은행명18	vrActnoBankCd18	30	자치단체에서 설정한 가상계좌 은행명
94	가상계좌번호18	vrActno18	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
95	가상계좌은행명19	vrActnoBankCd19	30	자치단체에서 설정한 가상계좌 은행명
96	가상계좌번호19	vrActno19	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
97	가상계좌은행명20	vrActnoBankCd20	30	자치단체에서 설정한 가상계좌 은행명
98	가상계좌번호20	vrActno20	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
99	예비항목1	rsveItem1	200	예비항목1
100	예비항목2	rsveItem2	200	예비항목2
101	예비항목3	rsveItem3	200	예비항목3
102	예비항목4	rsveItem4	200	예비항목4
103	예비항목5	rsveItem5	200	예비항목5

주정차위반과태료대장 연계 인터페이스 정의

개요

연계목록(2종)

순번	연계목록명	송·수신(호출방향)	주기	신청 기준
1	주정차위반과태료 단속사진 등록 레이아웃1	개별시스템 □ 차세대	수시	B01
2	주정차위반과태료 단속사진 등록 레이아웃2	개별시스템 □ 차세대	수시

주정차위반과태료 단속사진 등록 레이아웃1

기본정보

항목	내용	비고
연계명	주정차위반과태료 단속사진 등록 레이아웃1
인터페이스ID
연계유형	FileToFile
업무처리 설명	단속사진정보를 “데이터파일(1) + 사진파일(4)” 최대 5개의 파일로 구성하여 전송
송신기관	개별시스템
수신기관	차세대세외수입
주기	수시

상세 Layout

순번	한글컬럼	길이 (max)	필수	기본값	설명
1	단속일자시간	14	○	YYYYMMDDHH24MISS
2	차량번호	30	○
3	단속구분코드	2	○		[붙임1] 참조
4	단속장비관리번호	10			원천 시스템에서 관리하는 장비 관리번호. 해당 번호를 주정차위반과태료 단속장비 목록에 등록하여 이용
5	위반내역코드	2	○		[붙임1] 참조
6	위반내역기타내용	60			위반내역코드가 '99' 일때 작성
7	위반법규	60	○
8	단속장소	60	○
9	단속특별구역구분	2			01:어린이 보호구역 02:노인 보호구역 03:소방시설 04:자전거전용도로 05:장애인 보호구역
10	지역구분	1	○	'1'	고양시, 수원시 등 구제시인 경우 각 구를 구별하기 위한 값, 구제시가 아니면 기본값'1' 구제시인 경우 연계 협의 시 설정값 확인 필요 사업소, 출장소를 운영하는 경우도 확인 필요 예: 경기도 안산시인 경우 '1' : 경기도 안산시 본청 '2' : 경기도 안산시 단원구 '3' : 경기도 안산시 상록구 단속자료의 처리 부서를 구분하기 위한 값
11	지역코드	10		'0000000000'	위반장소 법정동 코드, 식별안되는 경우 '0000000000'
12	GPS_X	20
13	GPS_Y	20
14	사진갯수	3			첨부 사진 파일 개수(전송 가능한 경우)

단속파일 연계 설명

구분	내용	파일명예시	비고
단속정보 연계방식	string
연계 파일갯수	1	연계인터페이스ID(30)_파일생성일시(14)@자치단체코드(7)시스템코드(3).ZIP	5개의 파일을 ZIP으로 압축하여 하나의 파일로 연계
전체 파일갯수	5
사진 파일갯수	4
단속정보가 있는 파일확장자	txt
단속정보 구분자	|		버티컬 바
단속정보가 있는 파일구분	0	연계인터페이스ID(30)_파일생성일시(14)_자치단체코드(7)_0.txt
1번 단속 사진 구분	1	연계인터페이스ID(30)_파일생성일시(14)_자치단체코드(7)_1.jpg	파일생성일시는 text파일 기준으로 작성
2번 단속 사진 구분	2	연계인터페이스ID(30)_파일생성일시(14)_자치단체코드(7)_2.jpg
3번 단속 사진 구분	3	연계인터페이스ID(30)_파일생성일시(14)_자치단체코드(7)_3.jpg
4번 단속 사진 구분	4	연계인터페이스ID(30)_파일생성일시(14)_자치단체코드(7)_4.jpg

주정차위반과태료 단속사진 등록 레이아웃2

기본정보

항목	내용	비고
연계명	주정차위반과태료 단속사진 등록 레이아웃2
인터페이스ID
연계유형	FileToFile
업무처리 설명	단속사진파일명에 단속 정보를 기술, 최대 4개의 파일로 구성하여 전송
송신기관	개별시스템
수신기관	차세대세외수입
주기	수시

상세 Layout

순번	한글컬럼	길이 (max)	필수	기본값	설명
1	단속일자시간	14	○	YYYYMMDDHH24MISS
2	차량번호	30	○
3	단속구분코드	2	○		[붙임1] 참조
4	단속장비관리번호	10			원천 시스템에서 관리하는 장비 관리번호. 해당 번호를 주정차위반과태료 단속장비 목록에 등록하여 이용
5	위반내역	2	○		[붙임1] 참조
6	단속장소	60	○
7	단속특별구역구분	2			00:단속특별구역아님 01:어린이 보호구역 02:노인 보호구역 03:소방시설 04:자전거전용도로 05:장애인 보호구역
8	지역구분	1	○	'1'	단속자료의 처리 부서를 구분하기 위한 값 고양시, 수원시 등 구제시인 경우 각 구를 구별하기 위한 값, 구제시가 아니면 기본값'1' 구제시인 경우 연계 협의 시 설정값 확인 필요 사업소, 출장소를 운영하는 경우도 확인 필요 예: 경기도 안산시인 경우 '1' : 경기도 안산시 본청 '2' : 경기도 안산시 단원구 '3' : 경기도 안산시 상록구
9	지역코드	10		'0000000000'	위반장소 법정동 코드, 식별안되는 경우 '0000000000'
10	GPS_X	20		'000'
11	GPS_Y	20		'000'
12	사진구분	1	○
13	확장자	4	○		"." 을 포함한 4자리

단속파일 연계 설명

구분	내용	파일명예시	비고
단속정보 연계방식	string
연계 파일갯수	1	연계인터페이스ID(30)_파일생성일시(14).ZIP	4개의 파일을 ZIP으로 압축하여 하나의 파일로 연계
전체 파일갯수	4
사진 파일갯수	4
단속정보가 있는 파일확장자	jpg
단속정보 구분자	_		언더 바
1번 단속 사진 구분	a	20220228102139_999차0001_01_CCTV1_01_둔포면 석곡리 1482 부근_01_1_0000000000_000_000_1.jpg
2번 단속 사진 구분	b	20220228102139_999차0001_01_CCTV1_01_둔포면 석곡리 1482 부근_01_1_0000000000_000_000_2.jpg
3번 단속 사진 구분	c	20220228102139_999차0001_01_CCTV1_01_둔포면 석곡리 1482 부근_01_1_0000000000_000_000_3.jpg
4번 단속 사진 구분	d	20220228102139_999차0001_01_CCTV1_01_둔포면 석곡리 1482 부근_01_1_0000000000_000_000_4.jpg

전용차로위반과태료대장 연계 인터페이스 정의

개요

연계목록(2종)

순번	연계목록명	송·수신(호출방향)	주기	신청기준
1	전용차로위반과태료 단속사진 등록 레이아웃1	개별시스템 □ 차세대	수시	C01
2	전용차로위반과태료 단속사진 등록 레이아웃2	개별시스템 □ 차세대	수시

전용차로위반과태료 단속사진 등록 레이아웃1

기본정보

항목	내용	비고
연계명	전용차로위반과태료 단속사진 등록 레이아웃1
인터페이스ID
연계유형	FileToFile
업무처리 설명	단속사진정보를 “데이터파일(1) + 사진파일(7)” 최대 8개의 파일로 구성하여 전송
송신기관	개별시스템
수신기관	차세대세외수입
주기	수시

상세 Layout

순번	한글컬럼	길이 (max)	필수	기본값	설명
1	단속일자시간	14	○
2	차량번호	30	○
3	단속구분코드	2	○		[붙임1] 참조
4	단속장비관리번호	10			원천 시스템에서 관리하는 장비 관리번호. 해당 번호를 전용차로위반과태료 단속장비 목록에 등록하여 이용
5	위반내역코드	2	○		01:버스전용차로, 02:다인승전용차로, 03:자전거전용차로 04:간선급행버스(BRT)전용주행로
6	위반법규	60	○
7	단속장소	60	○
8	지역구분	1	○	'1'	고양시, 수원시 등 구제시인 경우 각 구를 구별하기 위한 값, 구제시가 아니면 기본값'1' 구제시인 경우 연계 협의 시 설정값 확인 필요 사업소, 출장소를 운영하는 경우도 확인 필요 예: 경기도 안산시인 경우 '1' : 경기도 안산시 본청 '2' : 경기도 안산시 단원구 '3' : 경기도 안산시 상록구 단속자료의 처리 부서를 구분하기 위한 값
9	지역코드	10		'0000000000'	위반장소 법정동 코드, 식별안되는 경우 '0000000000'
10	GPS_X	20
11	GPS_Y	20
12	자동차등록번호판위치X축	10			모자이크처리를 위한 X좌표
13	자동차등록번호판위치Y축	10			모자이크처리를 위한 Y좌표
14	사진갯수	3			첨부 사진 파일 개수 전송 가능하다면

단속파일 연계 설명

구분	내용	파일명예시	비고
단속정보 연계방식	string
연계 파일갯수	1	연계인터페이스ID(30)_파일생성일시(14)@자치단체코드(7)시스템코드(3).ZIP	8개의 파일을 ZIP으로 압축하여 하나의 파일로 연계
전체 파일갯수	8
사진 파일갯수	7
단속정보가 있는 파일확장자	txt
단속정보 구분자	|		버티컬 바
단속정보가 있는 파일구분	0	연계인터페이스ID(30)_파일생성일시(14)_자치단체코드(7)_0.txt
1번 단속 사진 구분	1	연계인터페이스ID(30)_파일생성일시(14)_자치단체코드(7)_1.jpg	파일생성일시는 text파일 기준으로 작성
2번 단속 사진 구분	2	연계인터페이스ID(30)_파일생성일시(14)_자치단체코드(7)_2.jpg	파일생성일시는 text파일 기준으로 작성
3번 단속 사진 구분	3	연계인터페이스ID(30)_파일생성일시(14)_자치단체코드(7)_3.jpg	파일생성일시는 text파일 기준으로 작성
4번 단속 사진 구분	4	연계인터페이스ID(30)_파일생성일시(14)_자치단체코드(7)_4.jpg	파일생성일시는 text파일 기준으로 작성
5번 단속 사진 구분	5	연계인터페이스ID(30)_파일생성일시(14)_자치단체코드(7)_5.jpg	파일생성일시는 text파일 기준으로 작성
6번 단속 사진 구분	6	연계인터페이스ID(30)_파일생성일시(14)_자치단체코드(7)_6.jpg	파일생성일시는 text파일 기준으로 작성
7번 단속 사진 구분	7	연계인터페이스ID(30)_파일생성일시(14)_자치단체코드(7)_7.jpg	파일생성일시는 text파일 기준으로 작성

전용차로위반과태료 단속사진 등록 레이아웃2

기본정보

항목	내용	비고
연계명	전용차로위반과태료 단속사진 등록 레이아웃2
인터페이스ID
연계유형	FileToFile
업무처리 설명	단속사진파일명에 단속 정보를 기술, 최대 7개의 파일로 구성하여 전송
송신기관	개별시스템
수신기관	차세대세외수입
주기	수시

상세 Layout

순번	한글컬럼	길이 (max)	필수	기본값	설명
1	단속일자시간	14	○
2	차량번호	30	○
3	단속구분코드	2	○		[붙임1] 참조
4	단속장비관리번호	10			원천 시스템에서 관리하는 장비 관리번호. 해당 번호를 전용차로위반과태료 단속장비 목록에 등록하여 이용
5	위반내역	2	○		01:버스전용차로 02:다인승전용차로 03:자전거전용차로 04:간선급행버스(BRT)전용주행로
6	단속장소	60	○
7	지역구분	1	○	'1'	고양시, 수원시 등 구제시인 경우 각 구를 구별하기 위한 값, 구제시가 아니면 기본값'1' 구제시인 경우 연계 협의 시 설정값 확인 필요 사업소, 출장소를 운영하는 경우도 확인 필요 예: 경기도 안산시인 경우 '1' : 경기도 안산시 본청 '2' : 경기도 안산시 단원구 '3' : 경기도 안산시 상록구 단속자료의 처리 부서를 구분하기 위한 값
8	지역코드	10		'0000000000'	위반장소 법정동 코드, 식별안되는 경우 '0000000000'
9	GPS_X	20		'000'
10	GPS_Y	20		'000'
11	사진구분	1
12	확장자	4			"." 을 포함한 4자리

단속연계 파일 설명

구분	내용	파일명예시	비고
단속정보 연계방식	string
연계 파일갯수	1	연계인터페이스ID(30)_파일생성일시(14)@자치단체코드(7)시스템코드(3).ZIP	7개의 파일을 ZIP으로 압축하여 하나의 파일로 연계
전체 파일갯수	7
사진 파일갯수	7
단속정보가 있는 파일확장자	jpg
단속정보 구분자	_		언더 바
1번 단속 사진 구분	1	20220228102139_999차0001_01_CCTV1_01_둔포면 석곡리 1482 부근_1_0000000000_000_000_1.jpg
2번 단속 사진 구분	2	20220228102139_999차0001_01_CCTV1_01_둔포면 석곡리 1482 부근_1_0000000000_000_000_2.jpg
3번 단속 사진 구분	3	20220228102139_999차0001_01_CCTV1_01_둔포면 석곡리 1482 부근_1_0000000000_000_000_3.jpg
4번 단속 사진 구분	4	20220228102139_999차0001_01_CCTV1_01_둔포면 석곡리 1482 부근_1_0000000000_000_000_4.jpg
5번 단속 사진 구분	5	20220228102139_999차0001_01_CCTV1_01_둔포면 석곡리 1482 부근_1_0000000000_000_000_5.jpg
6번 단속 사진 구분	6	20220228102139_999차0001_01_CCTV1_01_둔포면 석곡리 1482 부근_1_0000000000_000_000_6.jpg
7번 단속 사진 구분	7	20220228102139_999차0001_01_CCTV1_01_둔포면 석곡리 1482 부근_1_0000000000_000_000_7.jpg

부과·징수 연계 인터페이스 정의

개요

연계목록(11종)

순번	연계목록명	송·수신(호출방향)	주기	신청기준
1	부과정보연계(실시간)	개별시스템 □ 차세대	수시	D01
2	부과/수납정보(일배치)	개별시스템 □ 차세대	일배치	D02
3	부과결과정보(실시간)	차세대 □ 개별시스템	수시	D03
4	부과취소정보(실시간)	차세대 □ 개별시스템	수시	D04
5	수납정보(실시간)	차세대 □ 개별시스템	수시	D05
6	감액정보(실시간)	차세대 □ 개별시스템	수시	D06
7	부과체납정보(전일자 변동자료)	차세대 □ 개별시스템	일배치	D07
8	수납정보(전일자 변동자료)	차세대 □ 개별시스템	일배치
9	감액정보(전일자 변동자료)	차세대 □ 개별시스템	일배치
10	과오납정보(전일자 변동자료)	차세대 □ 개별시스템	일배치
11	결손정보(전일자 변동자료)	차세대 □ 개별시스템	일배치

부과정보연계(실시간)

기본정보

항목	내용	비고
연계명	부과정보연계(실시간)
인터페이스ID
연계유형	RESTFUL API(Http+Json)
업무처리 설명	개별시스템에서 부과자료 확정 시 세외수입시스템으로 실시간 연계
송신기관	개별시스템
수신기관	차세대세외수입
주기	수시

상세 Layout

순번	한글컬럼	영문컬럼	길이	필수	기본값	설명
<헤더>
연계표준지침 참조 구성
<요청>(개별시스템 → 차세대세외수입)
1	자치단체코드	sgbCd	7	○		행정표준코드관리시스템의 자치단체코드
2	연계대상코드	linkTrgtCd	15	○		세외수입에서 부여한 시스템코드(연계 확정시 코드부여) 연계기관코드(7)+연계시스템코드(3)+연계일련번호(5) 국가보급시스템인 경우 연계기관ID와 자치단체코드가 다를 수 있음
3	연계관리키	linkMngKey	50			연계대상 기관에서 관리하는 유일키 부과연계관리키가 등록된 정보에 대하여 변경정보 제공 - 차세대 부과결과정보연계 - 차세대 부과취소정보연계 - 차세대 실시간 수납정보연계 - 차세대 실시간 감액정보연계
4	부서코드	dptCd	7	○		행정표준코드관리시스템의 부서코드
5	특별회계사업코드	spclFisBizCd	4	○	"0000"	특별회계 세목코드를 사용한 경우 특별회계사업코드 필요(회계구분이 '51','61' 인경우에만 해당)
6	회계연도	fyr	4	○		부과연도
7	회계구분코드	actSeCd	2	○		국세:16, 시도세:31, 시군구세:41. 특별회계시도세:51, 특별회계시군구세:61
8	대표세입과목코드	rprsTxmCd	6	○
9	운영항목코드	operItemCd	3	○	"000"
10	부과일자	lvyYmd	8	○
11	최초본세금액	frstPctAmt	15	○		국세+시도세+시군구세 합계금액
12	최초납기일자	frstPidYmd	8	○
13	부과구분코드	lvySeCd	2		"02"	01:정기분 02:수시분
14	통합구분코드	untySeCd	2		"02"	01:통합 02: 미통합
15	국세분금액	ntntaxAmt	15		0	통합구분이 "01"이면 국세, 시도세, 시군구세, 부가가치세의 금액이 있을 경우 각 부과자료가 생성되며, 각 부과자료를 통합한 통합부과자료가 생성
16	시도세금액	prvtxAmt	15		0
17	시군구세금액	curprcAmt	15		0
18	부가가치세금액	vatAmt	15		0
19	납부자구분코드	pyrSeCd	2	○		01:개인 02:법인 03:단체 05:외국인
20	납부자번호	pyrNo	13	○		- 빼고 숫자만
21	납부자명	pyrNm	200	○		숫자, 특수문자, 기호 등 제외
22	대표납부자번호	rprsPyrNo	24	○		법인의 경우 대표 납부자번호 필수
23	대표납부자명	rprsPyrNm	200	○		법인의 경우 대표 납부자명 필수
24	연락처	cnpc	11			- 빼고 숫자만
25	연락처구분코드	cnpcSeCd	2			01: 전화번호, 02:휴대전화
26	납부자이메일주소	pyrEmlAddr	50
27	납부자상태코드	pyrSttCd	2	○	'10'	[붙임1] 참조
28	지번도로주소구분코드	lotnoRoadAddrSeCd	2	○		01:지번주소, 02:도로명주소
29	우편번호	zip	6	○
30	도로명코드	roadNmCd	12			도로명주소인경우 필수
31	지하여부	addrUdgdYn	1		'N'	Y:지하, N:지상
32	건물본번	bmno	5			도로명주소인경우 필수
33	건물부번	bsno	5			도로명주소인경우 필수
34	법정동코드	stdgCd	10			도로명주소인경우 필수
35	행정동코드	dongCd	10
36	산구분코드	addrMtnYn	2		'01'	01:일반번지, 02:산번지
37	본번	mno	4			번지. 지번주소인 경우 필수
38	부번	sno	4			호
39	특수동	spclAddr	30			상세주소 동
40	특수호	spclDg	15			상세주소 호
41	특수주소	spclHo	450			상세주소
42	도로명주소	roadNmAddr	300			도로명 주소를 텍스트 형태로 관리하는 시스템일 경우
43	도로명상세주소	roadNmDaddr	300			도로명 주소를 텍스트 형태로 관리하는 시스템일 경우
44	도로명전체주소	roadNmAlAddr	750			도로명 주소를 텍스트 형태로 관리하는 시스템일 경우
45	지번주소	lotnoAddr	200			지번주소를 텍스트로 관리하는 시스템일 경우
46	지번상세주소	lotnoDaddr	300			지번주소를 텍스트로 관리하는 시스템일 경우
47	지번전체주소	lotnoAlAddr	500			지번주소를 텍스트로 관리하는 시스템일 경우
48	부과대상구분코드	lvyTrgtSeCd	2			[붙임1] 참조
49	물건지명	glNm	500	○		부과대상구분이 차량인경우 물건지명은 차량번호만 (숫자, 특수문자, 기호 등 제외)
50	물건지지번도로주소구분코드	glLotnoRoadAddrSeCd	2			01:지번주소, 02:도로명주소
51	물건지우편번호	glZip	6
52	물건지도로명코드	glRoadNmCd	12			도로명주소인경우 필수
53	물건지주소지하여부	glAddrUdgdYn	1		'N'	Y:지하, N:지상
54	물건지건물본번	glBmno	5			도로명주소인경우 필수
55	물건지건물부번	glBsno	5			도로명주소인경우 필수
56	물건지법정동코드	glStdgCd	10
57	물건지행정동코드	glDongCd	10
58	물건지산구분코드	glMtnYn	2		'01'	01:일반번지,02:산번지
59	물건지본번	glMno	4			번지
60	물건지부번	glSno	4			호
61	물건지특수동	glSpclAddr	30			상세주소 동
62	물건지특수호	glSpclDg	15			상세주소 호
63	물건지특수주소	glSpclHo	450			상세주소
64	물건지도로명기본주소	glRoadNmAddr	300			도로명 주소를 텍스트 형태로 관리하는 시스템일 경우
65	물건지도로명상세주소	glRoadNmDaddr	300			도로명 주소를 텍스트 형태로 관리하는 시스템일 경우
66	물건지도로명전체주소	glRoadNmAlAddr	750			도로명 주소를 텍스트 형태로 관리하는 시스템일 경우
67	물건지지번기본주소	glLotnoAddr	300			지번주소를 텍스트로 관리하는 시스템일 경우
68	물건지지번상세주소	glLotnoDaddr	300			지번주소를 텍스트로 관리하는 시스템일 경우
69	물건지지번전체주소	glLotnoAlAddr	750			지번주소를 텍스트로 관리하는 시스템일 경우
70	관리1항목	mngItemCn1	200	○		부과처리시 필요한 부과근거 1(법적부과근거)
71	관리2항목	mngItemCn2	200			부과처리시 필요한 부과근거 2
72	관리3항목	mngItemCn3	200			부과처리시 필요한 부과근거 3
73	관리4항목	mngItemCn4	200			부과처리시 필요한 부과근거 4
74	관리5항목	mngItemCn5	200			부과처리시 필요한 부과근거 5
75	관리6항목	mngItemCn6	200			부과처리시 필요한 부과근거 6
76	비고내용	rmCn	4000
77	예비항목1	rsveItem1	200		NULL
78	예비항목2	rsveItem2	200		NULL
79	예비항목3	rsveItem3	200		NULL
80	예비항목4	rsveItem4	200		NULL
81	예비항목5	rsveItem5	200		NULL
<응답>(차세대세외수입 → 개별시스템)
1	자치단체코드	sgbCd	7			행정표준코드관리시스템의 자치단체코드
2	연계대상코드	linkTrgtCd	15
3	연계관리키	linkMngKey	50
4	연계 결과 코드	linkRstCd	30
5	연계 결과 메시지	linkRstMsg	200

부과/수납정보(일배치)

기본정보

항목	내용	비고
연계명	부과/수납정보(일배치)
인터페이스ID
연계유형	FileToFile
업무처리 설명	개별시스템에서 사전(감경)부과자료를 관리하는 경우 수납자료 발생 시 세외수입시스템으로 일배치 연계
송신기관	개별시스템
수신기관	차세대세외수입
주기	일 1회

상세 Layout

순번	한글컬럼	길이	필수	기본값	설명
1	자치단체코드	7	○		행정표준코드관리시스템의 자치단체코드
2	연계대상코드	15	○		세외수입에서 부여한 시스템코드(연계 확정시 코드부여) 연계기관코드(7)+연계시스템코드(3)+연계일련번호(5) 국가보급시스템인 경우 연계기관ID와 자치단체코드가 다를 수 있음
3	연계관리키	50			연계대상 기관에서 관리하는 유일키
4	부서코드	7	○		행정표준코드관리시스템의 부서코드
5	특별회계사업코드	4	○	"0000"	특별회계 세목코드를 사용한 경우 특별회계사업코드 필요(회계구분이 '51','61' 인경우에만 해당)
6	회계연도	4	○		부과연도
7	회계구분코드	2	○		국세:16, 시도세:31, 시군구세:41. 특별회계시도세:51, 특별회계시군구세:61
8	대표세입과목코드	6	○
9	운영항목코드	3	○	"000"
10	부과일자	8	○
11	최초본세금액	15	○		국세+시도세+시군구세 합계금액
12	최초납기일자	8	○
13	부과구분코드	2		"02"	01:정기분 02:수시분
14	통합구분코드	2		"02"	01:통합 02: 미통합
15	국세분금액	15		0	통합구분이 "01"이면 국세, 시도세, 시군구세, 부가가치세의 금액이 있을 경우 각 부과자료가 생성되며, 각 부과자료를 통합한 통합부과자료가 생성
16	시도세금액	15		0
17	시군구세금액	15		0
18	부가가치세금액	15		0
19	납부자구분코드	2	○		01:개인 02:법인 03:단체 05:외국인
20	납부자번호	13	○		- 빼고 숫자만
21	납부자명	200	○		숫자, 특수문자, 기호 등 제외
22	대표납부자번호	24	○		법인의 경우 대표 납부자번호 필수
23	대표납부자명	200	○		법인의 경우 대표 납부자명 필수
24	연락처	11			- 빼고 숫자만
25	연락처구분코드	2			01: 전화번호, 02:휴대전화
26	납부자이메일주소	50
27	납부자상태코드	2	○	'10'	[붙임1] 참조
28	지번도로주소구분코드	2	○		01:지번주소, 02:도로명주소
29	우편번호	6	○
30	도로명코드	12			도로명주소인경우 필수
31	지하여부	1		'N'	Y:지하, N:지상
32	건물본번	5			도로명주소인경우 필수
33	건물부번	5			도로명주소인경우 필수
34	법정동코드	10			도로명주소인경우 필수
35	행정동코드	10
36	산구분코드	2		'01'	01:일반번지, 02:산번지
37	본번	4			번지
38	부번	4			호
39	특수동	30			상세주소 동
40	특수호	15			상세주소 호
41	특수주소	450			상세주소
42	도로명주소	300			도로명 주소를 텍스트 형태로 관리하는 시스템일 경우
43	도로명상세주소	300			도로명 주소를 텍스트 형태로 관리하는 시스템일 경우
44	도로명전체주소	750			도로명 주소를 텍스트 형태로 관리하는 시스템일 경우
45	지번주소	200			지번주소를 텍스트로 관리하는 시스템일 경우
46	지번상세주소	300			지번주소를 텍스트로 관리하는 시스템일 경우
47	지번전체주소	500			지번주소를 텍스트로 관리하는 시스템일 경우
48	부과대상구분코드	2			[붙임1] 참조
49	물건지명	500	○		부과대상구분이 차량인경우 물건지명은 차량번호만 (숫자, 특수문자, 기호 등 제외)
50	물건지지번도로주소구분코드	2			01:지번주소, 02:도로명주소
51	물건지우편번호	6
52	물건지도로명코드	12			도로명주소인경우 필수
53	물건지주소지하여부	1		'N'	Y:지하, N:지상
54	물건지건물본번	5			도로명주소인경우 필수
55	물건지건물부번	5			도로명주소인경우 필수
56	물건지법정동코드	10
57	물건지행정동코드	10
58	물건지산구분코드	2		'01'	01:일반번지,02:산번지
59	물건지본번	4			번지
60	물건지부번	4			호
61	물건지특수동	30			상세주소 동
62	물건지특수호	15			상세주소 호
63	물건지특수주소	450			상세주소
64	물건지도로명기본주소	300			도로명 주소를 텍스트 형태로 관리하는 시스템일 경우
65	물건지도로명상세주소	300			도로명 주소를 텍스트 형태로 관리하는 시스템일 경우
66	물건지도로명전체주소	750			도로명 주소를 텍스트 형태로 관리하는 시스템일 경우
67	물건지지번기본주소	300			지번주소를 텍스트로 관리하는 시스템일 경우
68	물건지지번상세주소	300			지번주소를 텍스트로 관리하는 시스템일 경우
69	물건지지번전체주소	750			지번주소를 텍스트로 관리하는 시스템일 경우
70	관리1항목	200	○		부과처리시 필요한 부과근거 1(법적부과근거)
71	관리2항목	200			부과처리시 필요한 부과근거 2
72	관리3항목	200			부과처리시 필요한 부과근거 3
73	관리4항목	200			부과처리시 필요한 부과근거 4
74	관리5항목	200			부과처리시 필요한 부과근거 5
75	관리6항목	200			부과처리시 필요한 부과근거 6
76	비고내용	4000
77	수납본세금액	15			부과연계자료의 최초본세 금액
78	수납일자	8			부과연계자료의 수납일자
79	회계일자	8			부과연계자료의 회계일자
80	이체일자	8			부과연계자료의 이체일자
81	은행코드	7			수납 처리시 필수값
82	수납유형	2			수납유형 코드 별도 정의
83	예비항목1	200		NULL	예비항목1
84	예비항목2	200		NULL	예비항목2
85	예비항목3	200		NULL	예비항목3
86	예비항목4	200		NULL	예비항목4
87	예비항목5	200		NULL	예비항목5

부과결과정보(실시간)

기본정보

항목	내용	비고
연계명	부과결과정보(실시간)
인터페이스ID
연계유형	RESTFUL API(Http+Json)
업무처리 설명	세외수입시스템으로 부과자료 연계 후 결의처리 시 전자납부번호 및 가상계좌번호 실시간 제공
송신기관	차세대세외수입
수신기관	개별시스템
주기	수시

상세 Layout

순번	한글컬럼	영문컬럼	길이	설명
<헤더>
연계표준지침 참조 구성
<요청>(차세대세외수입 → 개별시스템)
1	자치단체코드	sgbCd	7	행정표준코드관리시스템의 자치단체코드
2	연계관리키	linkMngKey	50	연계대상 기관에서 관리하는 유일키
3	과세번호	taxnNo	31	과세자료의 유일한 번호 개별자료인 경우
4	통합과세번호	untyTaxnNo	31	과세자료(과세번호)의 통합관리번호 통합자료인 경우
5	부서코드	dptCd	7	행정표준코드관리시스템의 부서코드
6	특별회계사업코드	spclFisBizCd	4
7	회계연도	fyr	4	부과연도
8	회계구분코드	actSeCd	2	국세:16, 시도세:31, 시군구세:41. 특별회계시도세:51, 특별회계시군구세:61
9	대표세입과목코드	rprsTxmCd	6
10	운영항목코드	operItemCd	3
11	부과번호	lvyNo	6
12	분납번호	itmNo	2
13	전자납부번호	epayNo	19
14	통합가상계좌은행명1	vtlacBankNm1	100
15	통합가상계좌번호1	vrActno1	20
16	통합가상계좌은행명2	vtlacBankNm2	100
17	통합가상계좌번호2	vrActno2	20
18	통합가상계좌은행명3	vtlacBankNm3	100
19	통합가상계좌번호3	vrActno3	20
20	통합가상계좌은행명4	vtlacBankNm4	100
21	통합가상계좌번호4	vrActno4	20
22	통합가상계좌은행명5	vtlacBankNm5	100
23	통합가상계좌번호5	vrActno5	20
24	통합가상계좌은행명6	vtlacBankNm6	100
25	통합가상계좌번호6	vrActno6	20
26	통합가상계좌은행명7	vtlacBankNm7	100
27	통합가상계좌번호7	vrActno7	20
28	통합가상계좌은행명8	vtlacBankNm8	100
29	통합가상계좌번호8	vrActno8	20
30	통합가상계좌은행명9	vtlacBankNm9	100
31	통합가상계좌번호9	vrActno9	20
32	통합가상계좌은행명10	vtlacBankNm10	100
33	통합가상계좌번호10	vrActno10	20
34	통합가상계좌은행명11	vtlacBankNm11	100
35	통합가상계좌번호11	vrActno11	20
36	통합가상계좌은행명12	vtlacBankNm12	100
37	통합가상계좌번호12	vrActno12	20
38	통합가상계좌은행명13	vtlacBankNm13	100
39	통합가상계좌번호13	vrActno13	20
40	통합가상계좌은행명14	vtlacBankNm14	100
41	통합가상계좌번호14	vrActno14	20
42	통합가상계좌은행명15	vtlacBankNm15	100
43	통합가상계좌번호15	vrActno15	20
44	통합가상계좌은행명16	vtlacBankNm16	100
45	통합가상계좌번호16	vrActno16	20
46	통합가상계좌은행명17	vtlacBankNm17	100
47	통합가상계좌번호17	vrActno17	20
48	통합가상계좌은행명18	vtlacBankNm18	100
49	통합가상계좌번호18	vrActno18	20
50	통합가상계좌은행명19	vtlacBankNm19	100
51	통합가상계좌번호19	vrActno19	20
52	통합가상계좌은행명20	vtlacBankNm20	100
53	통합가상계좌번호20	vrActno20	20
54	예비항목1	rsveItem1	200	예비항목1
55	예비항목2	rsveItem2	200	예비항목2
56	예비항목3	rsveItem3	200	예비항목3
57	예비항목4	rsveItem4	200	예비항목4
58	예비항목5	rsveItem5	200	예비항목5
<응답>(개별시스템 → 차세대세외수입)
1	자치단체코드	sgbCd	7	행정표준코드관리시스템의 자치단체코드
2	연계대상코드	linkTrgtCd	15
3	연계관리키	linkMngKey	50
4	연계 결과 코드	linkRstCd	30
5	연계 결과 메시지	linkRstMsg	200

부과취소정보(실시간)

기본정보

항목	내용	비고
연계명	부과취소정보(실시간)
인터페이스ID
연계유형	RESTFUL API(Http+Json)
업무처리 설명	세외수입시스템으로 부과자료 연계 후 부과자료 삭제 시 삭제정보 실시간 제공(재 부과 연계 시 부과연계관리키는 변경하여 제공)
송신기관	차세대세외수입
수신기관	개별시스템
주기	수시

상세 Layout

순번	한글컬럼	영문컬럼	길이	설명
<헤더>
연계표준지침 참조 구성
<요청>(차세대세외수입 → 개별시스템)
1	자치단체코드	sgbCd	7	행정표준코드관리시스템의 자치단체코드
2	연계관리키	linkMngKey	50	연계대상 기관에서 관리하는 유일키
3	과세번호	taxnNo	31	과세자료의 유일한 번호
4	부과취소일자	lvyRtrcnYmd	8	부과취소일자
5	삭제사유내용	delRsnCn	4000
6	예비항목1	rsveItem1	200	예비항목1
7	예비항목2	rsveItem2	200	예비항목2
8	예비항목3	rsveItem3	200	예비항목3
9	예비항목4	rsveItem4	200	예비항목4
10	예비항목5	rsveItem5	200	예비항목5
<응답>(개별시스템 → 차세대세외수입)
1	자치단체코드	sgbCd	7	행정표준코드관리시스템의 자치단체코드
2	연계대상코드	linkTrgtCd	15
3	연계관리키	linkMngKey	50
4	연계 결과 코드	linkRstCd	30
5	연계 결과 메시지	linkRstMsg	200

수납정보(실시간)

기본정보

항목	내용	비고
연계명	수납정보(실시간)
인터페이스ID
연계유형	RESTFUL API(Http+Json)
업무처리 설명	세외수입시스템으로 부과자료 연계 후 수납처리 시 실시간 제공
송신기관	차세대세외수입
수신기관	개별시스템
주기	수시

상세 Layout

순번	한글컬럼	영문컬럼	길이	설명
<헤더>
연계표준지침 참조 구성
<요청>(차세대세외수입 → 개별시스템)
1	자치단체코드	sgbCd	7	행정표준코드관리시스템의 자치단체코드
2	자치단체명	sgbNm	60	자치단체코드의 명
3	연계관리키	linkMngKey	50	연계대상 기관에서 관리하는 유일키
4	과세번호	taxnNo	31	과세자료의 유일한 번호
5	통합과세번호	untyTaxnNo	31	과세자료(과세번호)의 통합관리번호
6	부서코드	dptCd	7	행정표준코드관리시스템의 부서코드
7	부서명	dptNm	200	행정표준코드관리시스템의 부서코드의 명
8	특별회계사업코드	spclFisBizCd	4
9	특별회계사업명	spclFisBizNm	100
10	회계연도	fyr	4	부과연도
11	회계구분코드	actSeCd	2	국세:16, 시도세:31, 시군구세:41. 특별회계시도세:51, 특별회계시군구세:61
12	회계구분명	actSeNm	100	국세:16, 시도세:31, 시군구세:41. 특별회계시도세:51, 특별회계시군구세:61
13	대표세입과목코드	rprsTxmCd	6	세목자릿수 검토중
14	세입과목명	rprsTxmNm	100	세입과목명
15	운영항목코드	operItemCd	3	세목자릿수 검토중
16	운영항목명	operItemNm	100	세입과목명
17	부과번호	lvyNo	6
18	분납번호	itmNo	2	제도에 따른 부과자료 분납순번 01 ~ 89 일부납부 신청에 따른 부과자료 순번90 ~ 99
19	전자납부번호	epayNo	19	전자납부번호
20	수납번호	rcvmtNo	2	수납순번
21	수납구분코드	rcvmtSeCd	2	01: 완납, 02: 이중수납, 03: 분납, 04: 과납, 05 : 오납, 06: 일부수납
22	수납구분명	rcvmtSeNm	100	수납구분코드명(일부납부, 완납 등)
23	수납일자	rcvmtYmd	8	수납일자
24	회계일자	actYmd	8	회계일자
25	이체일자	tsfYmd	8	이체일자
26	수납본세금액	rcvmtPctAmt	15	수납본세
27	수납가산금액	rcvmtAdtnAmt	15	수납가산금
28	수납이자금액	rcvmtIntrAmt	15	수납이자
29	은행명	bankNm	30
30	수납유형코드	rcvmtTyCd	2	01:OCR수납, 02:수기수납, 03:계좌이체, 04:세입정정, 05:배당 등
31	수납유형	rcvmtTy	300	납부매체정보(계좌이체, 신용카드결제, 가상계좌수납 등)
32	예비항목1	rsveItem1	200	예비항목1
33	예비항목2	rsveItem2	200	예비항목2
34	예비항목3	rsveItem3	200	예비항목3
35	예비항목4	rsveItem4	200	예비항목4
36	예비항목5	rsveItem5	200	예비항목5
<응답>(개별시스템 → 차세대세외수입)
1	자치단체코드	sgbCd	7	행정표준코드관리시스템의 자치단체코드
2	연계대상코드	linkTrgtCd	15
3	연계관리키	linkMngKey	50
4	연계 결과 코드	linkRstCd	30
5	연계 결과 메시지	linkRstMsg	200

감액정보(실시간)

기본정보

항목	내용	비고
연계명	감액정보(실시간)
인터페이스ID
연계유형	RESTFUL API(Http+Json)
업무처리 설명	세외수입시스템으로 부과자료 연계 후 감액자료 발생 시 실시간 제공
송신기관	차세대세외수입
수신기관	개별시스템
주기	수시

상세 Layout

순번	한글컬럼	영문컬럼	길이	설명
<헤더>
연계표준지침 참조 구성
<요청>(차세대세외수입 → 개별시스템)
1	자치단체코드	sgbCd	7	행정표준코드관리시스템의 자치단체코드
2	자치단체명	sgbNm	60	자치단체코드의 명
3	연계관리키	linkMngKey	50	연계대상 기관에서 관리하는 유일키
4	과세번호	taxnNo	31	과세자료의 유일한 번호
5	통합과세번호	untyTaxnNo	31	과세자료(과세번호)의 통합관리번호
6	부서코드	dptCd	7	행정표준코드관리시스템의 부서코드
7	부서명	dptNm	200	행정표준코드관리시스템의 부서코드의 명
8	특별회계사업코드	spclFisBizCd	4
9	특별회계사업명	spclFisBizNm	100
10	회계연도	fyr	4	부과연도
11	회계구분코드	actSeCd	2	국세:16, 시도세:31, 시군구세:41. 특별회계시도세:51, 특별회계시군구세:61
12	회계구분명	actSeNm	100	국세:16, 시도세:31, 시군구세:41. 특별회계시도세:51, 특별회계시군구세:61
13	대표세입과목코드	rprsTxmCd	6	세목자릿수 검토중
14	세입과목명	rprsTxmNm	100	세입과목명
15	운영항목코드	operItemCd	3	세목자릿수 검토중
16	운영항목명	operItemNm	100	세입과목명
17	부과번호	lvyNo	6
18	분납번호	itmNo	2	제도에 따른 부과자료 분납순번 01 ~ 89 일부납부 신청에 따른 부과자료 순번 90 ~ 99
19	감액일자	rdcYmd	8	감액일자
20	감액본세금액	rdcPctAmt	15	감액금액
21	감액가산금액	rdcAdtnAmt	15	감액가산금
22	감액이자금액	rdcIntrAmt	15	감액이자
23	감액금액	rdcAmt	15	감액총금액
24	감액사유내용	rdcRsnCn	255	감액사유내용(세액오류감액, 행정기관착오 등)
25	예비항목1	rsveItem1	200	예비항목1
26	예비항목2	rsveItem2	200	예비항목2
27	예비항목3	rsveItem3	200	예비항목3
28	예비항목4	rsveItem4	200	예비항목4
29	예비항목5	rsveItem5	200	예비항목5
<응답>(개별시스템 → 차세대세외수입)
1	자치단체코드	sgbCd	7	행정표준코드관리시스템의 자치단체코드
2	연계대상코드	linkTrgtCd	15
3	연계관리키	linkMngKey	50
4	연계 결과 코드	linkRstCd	30
5	연계 결과 메시지	linkRstMsg	200

부과체납정보(전일자 변동자료)

기본정보

항목	내용	비고
연계명	부과체납정보(전일자 변동자료)
인터페이스ID
연계유형	FileToFile
업무처리 설명	부과정보연계 시 제공한 연계관리키 기준으로 변경사항(일자, 금액 등)이 발생할 경우 부과체납정보, 수납정보, 감액정보, 과오납정보, 결손정보 전체 제공
송신기관	차세대세외수입
수신기관	개별시스템
자료생성 기준	전일 24시 기준으로 자료 생성
파일생성 기준	매일 04시

상세 Layout

순번	한글컬럼	길이	설명
1	기준일	8	데이터구축 기준일자
2	자치단체코드	7	행정표준코드관리시스템의 자치단체코드
3	자치단체명	60	자치단체코드의 명
4	연계대상코드	15	세외수입에서 부여한 시스템코드(연계 확정시 코드부여) 연계기관코드(7)+연계시스템코드(3)+연계일련번호(5) 국가보급시스템인 경우 연계기관ID와 자치단체코드가 다를 수 있음
5	연계관리키	50	연계대상 기관에서 관리하는 유일키 자치단체코드 + 연계대상코드 + 연계관리키는 unique 해야함
6	과세번호	31	과세자료의 유일한 번호
7	통합과세번호	31	과세자료(과세번호)의 통합관리번호
8	부서코드	7	행정표준코드관리시스템의 부서코드
9	부서명	200	행정표준코드관리시스템의 부서코드의 명
10	특별회계사업코드	4
11	특별회계사업명	100
12	회계연도	4	부과연도
13	회계구분코드	2	국세:16, 시도세:31, 시군구세:41. 특별회계시도세:51, 특별회계시군구세:61
14	회계구분명	100	국세:16, 시도세:31, 시군구세:41. 특별회계시도세:51, 특별회계시군구세:61
15	대표세입과목코드	6	세목자릿수 검토중
16	대표세입과목명	100	세입과목명
17	운영항목코드	3	세목자릿수 검토중
18	운영항목명	100	세입과목명
19	부과번호	6
20	분납순번	2	제도에 따른 부과자료 분납순번 01 ~ 89 일부납부 신청에 따른 부과자료 순번 90 ~ 99
21	납부자구분명	10	개인, 법인, 단체, 외국인
22	납부자번호	13	납부자의 고유식별번호, 주민번호 또는 법인번호, 외국인번호 등
23	납부자명	200	납부자의 성명
24	납부자상태코드	2	[붙임1] 참조
25	납부자상태코드명	20	[붙임1] 참조
26	납부자우편번호	6	납부자우편번호
27	납부자주소	750	납부자주소
28	전화번호	11	납부자 전화번호
29	휴대폰번호	11	납부자 휴대폰번호
30	납부자이메일	50	납부자 이메일주소
31	과세물건(물건명)	750	과세자료의 물건정보
32	물건번호(물건우편번호)	6	과세자료의 물건이 주소인경우 물건지의 우편번호
33	물건지주소	750	과세자료의 물건이 주소인경우 물건지의 주소
34	부과구분명	20	정기분, 수시분
35	통합구분명	20	통합, 미통합, 통합자자료
36	분납구분명	20	분납, 미분납
37	감경구분명	20	감경, 미감경, 감경미수납
38	자동이체여부	25	자동이체대상, 자동이체 미대상
39	부과취소구분명	20	취소, 미취소
40	부과상태구분명	20	부과, 체납
41	수납구분명	20	수납, 미수납, 일부수납
42	압류구분명	20	압류, 미압류로 관리하며 압류->압류해제 시 미압류로 변경
43	결손구분명	20	결손, 미결손으로 관리하며 결손->부활시 미결손으로 변경
44	전자납부번호	19	전자납부번호
45	부과일자	8	과세자료의 부과일자
46	부과고지납기일자	8	과세자료의 납기일자
47	최초부과금액	15	과세자료의 최초부과금액
48	최종부과금액	15	과세자료의 최종부과금액(감액 및 변경된 금액)
49	가산금금액	15	납기후고지가 가능한 세입과목의 가산금 예상금액
50	분납이자금액	15	분납자료인 경우 분납본세의 이자금액
51	납기후일자	15	납기후고지가 가능한 세입과목의 납기후일자
52	납기후금액	15	납기후고지가 가능한 세입과목의 납기후금액
53	관리1항목	200	부과처리시 필요한 부과근거 1(법적부과근거)
54	관리2항목	200	부과처리시 필요한 부과근거 2
55	관리3항목	200	부과처리시 필요한 부과근거 3
56	관리4항목	200	부과처리시 필요한 부과근거 4
57	관리5항목	200	부과처리시 필요한 부과근거 5
58	관리6항목	200	부과처리시 필요한 부과근거 6
59	체납등록일자	8	체납으로 등록된 일자
60	체납본세금액	15	체납본세금액
61	체납가산금금액	15	제도에 따른 체납 본세금액으로 산정된 가산금금액
62	체납분납이자금액	15	체납분납이자금액
63	체납고지납기일자	8	체납고지의 납기일자
64	체납사유코드	2	체납으로 등록된 사유코드
65	체납사유	100	체납으로 등록된 사유명
66	대체압류차량번호	30	물건이 차량인 경우 대체압류로 등록된 차량번호
67	통합가상계좌은행명1	30	자치단체에서 주요 거래은행으로 설정한 가상계좌 은행명
68	통합가상계좌번호1	20	자치단체에서 주요 거래은행으로 설정한 가상계좌 은행의 가상계좌번호
69	통합가상계좌은행명2	30	자치단체에서 설정한 가상계좌 은행명
70	통합가상계좌번호2	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
71	통합가상계좌은행명3	30	자치단체에서 설정한 가상계좌 은행명
72	통합가상계좌번호3	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
73	통합가상계좌은행명4	30	자치단체에서 설정한 가상계좌 은행명
74	통합가상계좌번호4	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
75	통합가상계좌은행명5	30	자치단체에서 설정한 가상계좌 은행명
76	통합가상계좌번호5	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
77	통합가상계좌은행명6	30	자치단체에서 설정한 가상계좌 은행명
78	통합가상계좌번호6	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
79	통합가상계좌은행명7	30	자치단체에서 설정한 가상계좌 은행명
80	통합가상계좌번호7	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
81	통합가상계좌은행명8	30	자치단체에서 설정한 가상계좌 은행명
82	통합가상계좌번호8	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
83	통합가상계좌은행명9	30	자치단체에서 설정한 가상계좌 은행명
84	통합가상계좌번호9	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
85	통합가상계좌은행명10	30	자치단체에서 설정한 가상계좌 은행명
86	통합가상계좌번호10	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
87	통합가상계좌은행명11	30	자치단체에서 설정한 가상계좌 은행명
88	통합가상계좌번호11	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
89	통합가상계좌은행명12	30	자치단체에서 설정한 가상계좌 은행명
90	통합가상계좌번호12	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
91	통합가상계좌은행명13	30	자치단체에서 설정한 가상계좌 은행명
92	통합가상계좌번호13	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
93	통합가상계좌은행명14	30	자치단체에서 설정한 가상계좌 은행명
94	통합가상계좌번호14	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
95	통합가상계좌은행명15	30	자치단체에서 설정한 가상계좌 은행명
96	통합가상계좌번호15	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
97	통합가상계좌은행명16	30	자치단체에서 설정한 가상계좌 은행명
98	통합가상계좌번호16	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
99	통합가상계좌은행명17	30	자치단체에서 설정한 가상계좌 은행명
100	통합가상계좌번호17	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
101	통합가상계좌은행명18	30	자치단체에서 설정한 가상계좌 은행명
102	통합가상계좌번호18	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
103	통합가상계좌은행명19	30	자치단체에서 설정한 가상계좌 은행명
104	통합가상계좌번호19	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
105	통합가상계좌은행명20	30	자치단체에서 설정한 가상계좌 은행명
106	통합가상계좌번호20	20	자치단체에서 설정한 가상계좌 은행의 가상계좌번호
107	예비항목1	200	예비항목1
108	예비항목2	200	예비항목2
109	예비항목3	200	예비항목3
110	예비항목4	200	예비항목4
111	예비항목5	200	예비항목5

수납정보(전일자 변동자료)

기본정보

항목	내용	비고
연계명	수납정보(전일자 변동자료)
인터페이스ID
연계유형	FileToFile
업무처리 설명	부과정보연계 시 제공한 연계관리키 기준으로 변경사항(일자, 금액 등)이 발생할 경우 부과체납정보, 수납정보, 감액정보, 과오납정보, 결손정보 전체 제공
송신기관	차세대세외수입
수신기관	개별시스템
자료생성 기준	전일 24시 기준으로 자료 생성
파일생성 기준	매일 04시

상세 Layout

순번	한글컬럼	길이	설명
1	기준일	8	데이터구축 기준일자
2	자치단체코드	7	행정표준코드관리시스템의 자치단체코드
3	자치단체명	60	자치단체코드의 명
4	연계대상코드	15	세외수입에서 부여한 시스템코드(연계 확정시 코드부여) 연계기관코드(7)+연계시스템코드(3)+연계일련번호(5) 국가보급시스템인 경우 연계기관ID와 자치단체코드가 다를 수 있음
5	연계관리키	50	연계대상 기관에서 관리하는 유일키 자치단체코드 + 연계대상코드 + 연계관리키는 unique 해야함
6	과세번호	31	과세자료의 유일한 번호
7	통합과세번호	31	과세자료(과세번호)의 통합관리번호
8	부서코드	7	행정표준코드관리시스템의 부서코드
9	부서명	200	행정표준코드관리시스템의 부서코드의 명
10	특별회계사업코드	4
11	특별회계사업명	100
12	회계연도	4	부과연도
13	회계구분코드	2	국세:16, 시도세:31, 시군구세:41. 특별회계시도세:51, 특별회계시군구세:61
14	회계구분명	100	국세:16, 시도세:31, 시군구세:41. 특별회계시도세:51, 특별회계시군구세:61
15	대표세입과목코드	6	세목자릿수 검토중
16	대표세입과목명	100	세입과목명
17	운영항목코드	3	세목자릿수 검토중
18	운영항목명	100	세입과목명
19	부과번호	6
20	분납순번	2	제도에 따른 부과자료 분납순번 01 ~ 89 일부납부 신청에 따른 부과자료 순번 90 ~ 99
21	전자납부번호	19	전자납부번호
22	수납순번	2	수납순번
23	수납구분코드	2	01: 완납, 02: 이중수납, 03: 분납, 04: 과납, 05 : 오납, 06: 일부수납
24	수납구분명	100	수납구분코드명(일부납부, 완납 등)
25	수납일자	8	수납일자
26	회계일자	8	회계일자
27	이체일자	8	이체일자
28	수납본세	15	수납본세
29	수납가산금	15	수납가산금
30	수납이자	15	수납이자
31	수납은행	80
32	납부방식	2	01:OCR수납, 02:수기수납, 03:계좌이체, 04:세입정정, 05:배당 등
33	납부방식세부명	300	납부매체정보(계좌이체, 신용카드결제, 가상계좌수납 등)
34	과오납구분명	20	환급, 미환급
35	예비항목1	200	예비항목1
36	예비항목2	200	예비항목2
37	예비항목3	200	예비항목3
38	예비항목4	200	예비항목4
39	예비항목5	200	예비항목5

감액정보(전일자 변동자료)

기본정보

항목	내용	비고
연계명	감액정보(전일자 변동자료)
인터페이스ID
연계유형	FileToFile
업무처리 설명	부과정보연계 시 제공한 연계관리키 기준으로 변경사항(일자, 금액 등)이 발생할 경우 부과체납정보, 수납정보, 감액정보, 과오납정보, 결손정보 전체 제공
송신기관	차세대세외수입
수신기관	개별시스템
자료생성 기준	전일 24시 기준으로 자료 생성
파일생성 기준	매일 04시

상세 Layout

순번	한글컬럼	길이	설명
1	기준일	8	데이터구축 기준일자
2	자치단체코드	7	행정표준코드관리시스템의 자치단체코드
3	자치단체명	60	자치단체코드의 명
4	연계대상코드	15	세외수입에서 부여한 시스템코드(연계 확정시 코드부여)
5	연계관리키	50	연계대상 기관에서 관리하는 유일키
6	과세번호	31	과세자료의 유일한 번호
7	통합과세번호	31	과세자료(과세번호)의 통합관리번호
8	부서코드	7	행정표준코드관리시스템의 부서코드
9	부서명	200	행정표준코드관리시스템의 부서코드의 명
10	특별회계사업코드	4
11	특별회계사업명	100
12	회계연도	4	부과연도
13	회계구분코드	2	국세:16, 시도세:31, 시군구세:41. 특별회계시도세:51, 특별회계시군구세:61
14	회계구분명	100	국세:16, 시도세:31, 시군구세:41. 특별회계시도세:51, 특별회계시군구세:61
15	대표세입과목코드	6	세목자릿수 검토중
16	대표세입과목명	100	세입과목명
17	운영항목코드	3	세목자릿수 검토중
18	운영항목명	100	세입과목명
19	부과번호	6
20	분납순번	2	제도에 따른 부과자료 분납순번 01 ~ 89 일부납부 신청에 따른 부과자료 순번 90 ~ 99
21	감액일자	8	감액일자
22	감액금액	15	감액금액
23	감액가산금	15	감액가산금
24	감액이자	15	감액이자
25	총금액	15	감액총금액
26	감액사유내용	255	감액사유내용(세액오류감액, 행정기관착오 등)
27	예비항목1	200	예비항목1
28	예비항목2	200	예비항목2
29	예비항목3	200	예비항목3
30	예비항목4	200	예비항목4
31	예비항목5	200	예비항목5

과오납정보(전일자 변동자료)

기본정보

항목	내용	비고
연계명	과오납정보(전일자 변동자료)
인터페이스ID
연계유형	FileToFile
업무처리 설명	부과정보연계 시 제공한 연계관리키 기준으로 변경사항(일자, 금액 등)이 발생할 경우 부과체납정보, 수납정보, 감액정보, 과오납정보, 결손정보 전체 제공
송신기관	차세대세외수입
수신기관	개별시스템
자료생성 기준	전일 24시 기준으로 자료 생성
파일생성 기준	매일 04시

상세 Layout

순번	한글컬럼	길이	설명
1	기준일	8	데이터구축 기준일자
2	자치단체코드	7	행정표준코드관리시스템의 자치단체코드
3	자치단체명	60	자치단체코드의 명
4	연계대상코드	15	세외수입에서 부여한 시스템코드(연계 확정시 코드부여) 연계기관코드(7)+연계시스템코드(3)+연계일련번호(5) 국가보급시스템인 경우 연계기관ID와 자치단체코드가 다를 수 있음
5	연계관리키	50	연계대상 기관에서 관리하는 유일키 자치단체코드 + 연계대상코드 + 연계관리키는 unique 해야함
6	과세번호	31	과세자료의 유일한 번호
7	통합과세번호	31	과세자료(과세번호)의 통합관리번호
8	부서코드	7	행정표준코드관리시스템의 부서코드
9	부서명	200	행정표준코드관리시스템의 부서코드의 명
10	특별회계사업코드	4
11	특별회계사업명	100
12	회계연도	4	부과연도
13	회계구분코드	2	국세:16, 시도세:31, 시군구세:41. 특별회계시도세:51, 특별회계시군구세:61
14	회계구분명	100	국세:16, 시도세:31, 시군구세:41. 특별회계시도세:51, 특별회계시군구세:61
15	대표세입과목코드	6	세목자릿수 검토중
16	대표세입과목명	100	세입과목명
17	운영항목코드	3	세목자릿수 검토중
18	운영항목명	100	세입과목명
19	부과번호	6
20	분납순번	2	제도에 따른 부과자료 분납순번 01 ~ 89 일부납부 신청에 따른 부과자료 순번 90 ~ 99
21	부과일자	8	부과일자
22	부과금액	15	부과금액
23	납부금액	15	납부(수납)금액
24	환부구분	2	01:과오납금, 02:환급금
25	과오납사유코드	2	10:행정기관착오, 11:기부과자 부과등 이중부과, 12:과세면적등과세자료 착오 등
26	과오납사유명	300	행정기관착오, 기부과자 부과등 이중부과, 과세면적등과세자료 착오 등
27	과오납환부액	15	과오납환부액
28	과오납신청일	8	과오납신청일
29	처리일자	8	처리일자
30	반환계좌번호	50	반환계좌번호
31	반환은행명	30	반환은행명
32	예비항목1	200	예비항목1
33	예비항목2	200	예비항목2
34	예비항목3	200	예비항목3
35	예비항목4	200	예비항목4
36	예비항목5	200	예비항목5

결손정보(전일자 변동자료)

기본정보

항목	내용	비고
연계명	결손정보(전일자 변동자료)
인터페이스ID
연계유형	FileToFile
업무처리 설명	부과정보연계 시 제공한 연계관리키 기준으로 변경사항(일자, 금액 등)이 발생할 경우 부과체납정보, 수납정보, 감액정보, 과오납정보, 결손정보 전체 제공
송신기관	차세대세외수입
수신기관	개별시스템
자료생성 기준	전일 24시 기준으로 자료 생성
파일생성 기준	매일 04시

상세 Layout

순번	한글컬럼	길이	설명
1	기준일	8	데이터구축 기준일자
2	자치단체코드	7	행정표준코드관리시스템의 자치단체코드
3	자치단체명	60	자치단체코드의 명
4	연계대상코드	15	세외수입에서 부여한 시스템코드(연계 확정시 코드부여) 연계기관코드(7)+연계시스템코드(3)+연계일련번호(5) 국가보급시스템인 경우 연계기관ID와 자치단체코드가 다를 수 있음
5	연계관리키	50	연계대상 기관에서 관리하는 유일키 자치단체코드 + 연계대상코드 + 연계관리키는 unique 해야함
6	과세번호	31	과세자료의 유일한 번호
7	통합과세번호	31	과세자료(과세번호)의 통합관리번호
8	부서코드	7	행정표준코드관리시스템의 부서코드
9	부서명	200	행정표준코드관리시스템의 부서코드의 명
10	특별회계사업코드	4
11	특별회계사업명	100
12	회계연도	4	부과연도
13	회계구분코드	2	국세:16, 시도세:31, 시군구세:41. 특별회계시도세:51, 특별회계시군구세:61
14	회계구분명	100	국세:16, 시도세:31, 시군구세:41. 특별회계시도세:51, 특별회계시군구세:61
15	대표세입과목코드	6	세목자릿수 검토중
16	대표세입과목명	100	세입과목명
17	운영항목코드	3	세목자릿수 검토중
18	운영항목명	100	세입과목명
19	부과번호	6
20	분납순번	2	제도에 따른 부과자료 분납순번 01 ~ 89 일부납부 신청에 따른 부과자료 순번 90 ~ 99
21	결손순번	2
22	결손구분	300
23	결손일자	8
24	본세	15
25	이자	15
26	가산금	15
27	결손사유코드	2
28	결손사유내용	300
29	부활일자	8
30	본세	15
31	이자	15
32	가산금	15
33	부활사유코드	2
34	부활사유내용	300
35	예비항목1	200	예비항목1
36	예비항목2	200	예비항목2
37	예비항목3	200	예비항목3
38	예비항목4	200	예비항목4
39	예비항목5	200	예비항목5

개별시스템 연계 프로그램 개발 지침

개별시스템 연계 구성도

구성도

실시간 연계방식

연계 유형	연계 주기	메시지 형태	설명
		연계 HUB ↔ 자치단체 시스템
RESTFUL (POST)	실시간 (동기)	(JSON)	1. json 방식 차세대 지방세 표준으로 진행 2. header 메시지 항목 존재 3. 연계HUB <-> 개별시스템 구간은 HTTPS 적용 HTTP Request Header 에 IF_ID 항목 설정 후 전달 필요 4. 연계HUB -> 개별시스템 호출을 위한 하나의 URL 제공 필요 ex) http://ip:port/dcp/service

배치 연계방식

연계 유형	연계 주기	메시지 형태		설명
		연계 HUB ↔ 연계 모듈	연계 모듈 ↔ 자치단체 시스템
FileToFile	배치	SFTP	파일 경로 송/수신	1. 연계 모듈에서 → 연계HUB로 SFTP를 통한 파일 get / put 처리 방식 2. 연계 모듈에서 지정된 시간에 -> 연계HUB로 파일 송/수신 처리 3. 연계 모듈 설정에 따라 ..개별시스템의 지정된 송/수신 경로에서 파일 처리 함

공통 인터페이스 ID

인터페이스 ID 구성

기본정보			구분자	시스템 코드			구분자	일련번호(4)
연계구분(1)	연계방식(1)	연계유형(1)		송신시스템(10)	구분자	수신시스템(10)
E (외부연계 : External)	R (실시간 : Real time) B (배치 : Batch)	R (RESTFUL) F (File to File)	_	행정표준코드(7)+ 시스템 코드(3)	_	행정표준코드(7)+ 시스템 코드(3)	_	순번

※ 인터페이스 ID는 차세대 사업단에서 관리하며, 연계업무 또는 연계 유형 추가 시 신규 ID 부여

공통 인터페이스 ID

지방자치단체 시스템과 직접 연계 작업 시 효율적인 인터페이스 관리를 위하여, 공통 인터페이스 ID를 발급하여 사용함. 공통 인터페이스 ID는 인터페이스 체계와 동일하며, 행정표준코드(기관코드) 대신 개별시스템 공통코드를 사용하여 정의함

공통 인터페이스(예시)

EX) 차세대 세외수입시스템 → 자치단체 개별시스템(장애인주정차위반관리시스템)

EBF_1741000NIS_Z000001DCP_0001

지방자치단체 개별시스템 코드 : Z000001

행정안전부 차세대 세외수입시스템 코드 : 1741000NIS

장애인 주정차위반관리시스템 : DCP

연계 방법

[연계 방법]

□ 온라인 연계시 HTTP 프로토콜 Header 항목 설정

EX)            urlConnection.setRequestProperty("IF_ID“,”ERR_Z000001DCP_1741000TAS_0001“);

=> 온라인 인터페이스별 부여된 IF_ID

urlConnection.setRequestProperty("SRC_ORG_CD“,”3820000“);

=> 보내는 자치단체 코드 7자리

urlConnection.setRequestProperty("SRC_SYS_CD“,”DCP“);

=> 보내는 개별 시스템 코드3자리

※ 그외 전문 메시지부 헤더에는 [3.3.3 실시간 연계 전문표준] 참고 후 설정 함

□ 배치 연계 시 위의 target 코드 규칙과 동일함

파일명 생성은 : IF_ID_YYYYMMDDHH24MISSS@수신받을 자치단체코드 7자리+수신시스템코드 3자리로 정의함

Ex) EBF_1741000NIS_1741000DCP_0001_20220714101224@3820000DCP

실시간(RESTFUL API) 연계 개발지침

송/수신시스템에서 조회하고자 하는 인터페이스에 맞게 업무 어플리케이션을 개발 후 각 시스템 어플리케이션의 송/수신 서비스를 연계 HUB가 중개

RESTFUL API(HTTP + JSON) 연계 흐름 : 송신 (차세대 세외수입 → 자치단체 시스템)

① 송신시스템의 업무 어플리케이션에서 연계 HUB로 전문을 전송 (Request)

② 연계HUB는 설정된 정보에 따라 수신시스템의 업무 어플리케이션 서비스를 호출하여 전문을 전송

③ 수신시스템의 업무 어플리케이션에서 전송한 회신 사항을 연계HUB 에서 수신(Response)하여 내부 처리

④ 연계HUB에서 수신 받은 데이터를 송신시스템의 업무 어플리케이션으로 전송

RESTFUL API(HTTP + JSON) 연계 흐름 : 수신 (차세대 세외수입 ← 자치단체 시스템)

① 송신시스템에서 업무 어플리케이션에서 연계 HUB로 전문을 전송 (Request)

② 연계HUB는 설정된 정보에 따라 수신시스템의 업무 어플리케이션 서비스를 호출하여 전문을 전송

③ 수신시스템의 업무 어플리케이션에서 전송한 회신 사항을 연계HUB 에서 수신(Response)하여 내부 처리

④ 연계HUB에서 수신 받은 데이터를 송신시스템의 업무 어플리케이션으로 전송

실시간 연계 전문 표준

메시지 전문구조는 header부 + body부 구성으로 실시간 거래 처리를 지원

header부는 거래에 필요한 기준정보를 정의하며 성능 등을 고려하여 최소화 구성

body부는 실거래에 필요한 업무 데이터를 정의

연계 표준 헤더 (상세)

전문 영역	SUB 영역	항목명 (한글)	항목명 (영문)	유형	크기	요청	응답	설명
표준헤더	전문 헤더	전송일자	ifDate	문자열	14	○		데이터 전송 (생성 ) 일자 [형식 :YYYYMMDDHH24MISS ]
		연계 메시지키	ifMsgKey	문자열	49	○		각 연계 메시지의 식별을 위한 고유 식별키 (이용기관과 제공기관 간 메시지키를 통한 정보조회 시 필요 ) [형식 : 시스템코드 + 년월일시분초 (yyMMddHHmmssSSS )+“-“+자바 UUID (＇-＇제외 )] [시스템코드 : 세무행정 (T), 대국민 (W), 세외수입 (N), 행정지원 (A), 연계 (L), 유관기관 (E ), 개별시스템 (Z) [예시 : T211103155123435-e7def4c1652a478e9c77525ab5b3ebda ]
	거래 정보	인터 페이스ID	ifId	문자열	30	○		연계 항목 고유식별 아이디 예시 ) EBD_1613000001_1741000TAX_0020
		출발지 시스템 코드	source	문자열	10	○		기관코드 (행정표준코드 7 자리 ) + 시스템코드 (3 자리 )
		도착지 시스템 코드	target	문자열	10	○		기관코드 (행정표준코드 7 자리 ) + 시스템코드 (3 자리 )
		데이터 구분	ifType	문자열	1	○	○	데이터 송 /수신 구분 (S:요청 /송신 , R:응답 /수신 )
	데이터 정보	데이터 형식	ifFormat	문자열	1	○	○	연계 데이터 형식 (D : 딜리미터 (‘|’ 등 ), F : Fixed-Length, X : XML, J : JSON)
	처리 결과 (출력부)	연계처리결과명	retName	문자열	150		○	연계처리 결과 내용
		연계처리 결과코드	retCode	문자열	10		○	전송요청시 공백 , 연계 처리후 결과코드 용도 (프레임웍 /연계팀에서 정의한 코드만 기록 됨 , 업무에서 사용 불가 ) 연계팀 => 200 :성공 , 500 : 실패

배치(File to File) 연계 개발지침(연계 모듈 활용)

개별시스템 파일 연계 시 파일명 규칙

파일 명명 규칙

구분	설명	송 /수신	파일명 표준	예제
연계 파일명 규칙	파일 연계 처리 시 사용되는 파일명에 대한 정의	송 /수신	연계인터페이스아이디 (30) + “_” + 파일생성일시 (14) + “_” + SEQ(3)@수신받을 자치단체 코드 7자리 + 수신시스템 코드 3자리	예시) EBF_1741000TAS_1741000ARS_0001_20220714101224@3820000ARS
			•총 길이 : 49 자리 •연계인터페이스아이디 (30 자리 ) •구분자 _ (1 자리 ) •파일생성일시 (14 자리 ): YYYYMMDDHH24MISS •구분자 _ (1 자리 ) : 필요시 사용 •시퀀스 (3 자리 ) : 필요시 사용

FILE 연계 흐름 : 송신 (차세대 세외수입 → 자치단체 시스템)

파일을 송신하기 위해서는 업무에서 정해진 디렉터리에 파일을 저장하면 연계솔루션이 수신시스템의 정해진 디렉터리에 파일 복사

파일을 옮기는 중 간섭을 피하기 위해 송신 업무 진행 중 임시 작업 디렉터리로 이동

① 업무에서 송신파일을 업무별 송신 디렉터리(기관코드/SND)에 저장

② 연계 HUB가 송신파일을 송신 진행 디렉터리 (기관코드/SND/working/reading)로 이동

③ 송신 진행 디렉터리에서 송신파일을 전송

④ 연계 HUB를 통하여 수신시스템으로 전송(Request)

⑤ 연계 HUB가 수신파일을 수신 시스템의 지정된 디렉터리에 저장

⑥ 처리결과, 상태정보 등 응답(Response) 내용으로 연계 HUB에서 처리

⑦ 연계 HUB가 송신 진행 디렉터리(기관코드/SND/working/reading)에서 송신 완료 디렉터리(기관코드/SND/working/backup/2021/06/01)로 이동

※ 디렉터리 규칙은 변경될 수 있음

FILE 연계 흐름 : 수신 (차세대 세외수입 ← 자치단체 시스템)

파일을 수신하기 위해서는 송신시스템에서 파일을 전송하면 연계솔루션이 수신시스템의 정해진 디렉터리에 파일 복사

파일을 옮기는 중 간섭을 피하기위해 수신 진행 중 임시 작업 디렉터리로 이동시켜 작업

① 송신시스템에서 연계 HUB로 수신 파일을 전송

② 연계 HUB가 수신파일을 수신 진행 디렉터리(기관코드/RCV/working/reading)에 저장

③ 연계 HUB가 수신파일 저장 완료 후 업무별 수신 디렉터리(기관코드/RCV)로 이동

④ 처리결과, 상태정보 등 응답(Response) 내용으로 연계 HUB에서 처리

※ 디렉터리 규칙은 변경될 수 있음

배치파일 연계 전문 표준 (데이터 파일 구조)

데이터 파일은 CSV 형식으로 데이터 표현

구분	설명
파일 헤더	{전송일자 }||{연계메시지키 }||{인터페이스 ID }||{송신시스템코드 }||{수신시스템코드 }||{데이터구분 }||{데이터형식 }^||
연계 데이터	{필드값 1}||{필드값 2}||.....{필드값 n}^|| {필드값 a}||{필드값 b}||.....{필드값 z}^||

SUB 영역	항목명 (한글 )	유형	크기	요청	설명
전문 헤더	전송일자	문자열	14	○	데이터 전송 (생성) 일자 [형식 :YYYYMMDDHH24MISS ]
	연계메시지키	문자열	49	○	각 연계 메시지의 식별을 위한 고유 식별키 (이용기관과 제공기관 간 메시지키를 통한 정보조회 시 필요) [형식 : 시스템코드 + 년월일시분초 (yyMMddHHmmssSSS )+“-“+자바 UUID(＇-＇제외)] [시스템코드 : 세무행정 (T), 대국민 (W), 세외수입 (N), 행정지원 (A), 연계 (L), 유관기관 (E) [예시 : T211103155123435-e7def4c1652a478e9c77525ab5b3ebda]
거래 정보	인터페이스 ID	문자열	30	○	연계 항목 고유식별 아이디 예시 ) EBD_1613000001_1741000TAX_0020
	송신시스템 코드	문자열	10	○	기관코드 (행정표준코드 7 자리) + 시스템코드 (3 자리)
	수신시스템 코드	문자열	10	○	기관코드 (행정표준코드 7 자리) + 시스템코드 (3 자리)
	데이터 구분	문자열	1	○	데이터 송 /수신 구분 (S : 요청 /송신 , R : 응답 /수신)
데이터 정보	데이터 형식	문자열	1	○	연계 데이터 형식 (D : 딜리미터 (‘|’ 등), F : Fixed-Length, X : XML, J : JSON)

데이터 파일 구조

CSV 형식 파일 조건

인코딩은 UTF-8이며, 한글은 3byte로 표현한다.

파일 헤더, 연계 데이터의 순서로 기술되고, 파일 헤더는 1개의 행으로 구성되고,
연계 데이터는 1개 이상의 행으로 구성될 수 있다.

필드 구분자로 파이프 2개 (||)를 사용한다.

행 구분자로 꺾쇠+파이프 2개 (^||)+개행문자 를 사용한다.

데이터 내에 개행문자가 존재하는 경우에는 개행문자를 그대로 기술한다.

날짜 형식의 데이터는 ”YYYYMMDDHH24MISS" 형식의 문자열로 변환하여 기술한다.

데이터 파일 구조 (예시 : 파일명 EWD_1613000001_1741000TAX_0020_2021041210302200)

20210412103022||E211103155123435-e7def4c1652a478e9c77525ab5b3ebda||EWD_1741000TAS_1210000HTA_0020||1741000TAS||1210000HTA||S||J^||

EAS_20200630173231452_2578||1||R||G027||DBR||C||RS||테스트 데이터입니다.||20210830183231^||

EAS_20200630173231452_2578||2||R||G027||DBR||C||RS||테스트데이터 입니다.||20210830183231^||

EAS_20200630173231452_2578||3||R||G027||DBR||C||RS||테스트 데이터 입니다.||20210830183231^||

EAS_20200630173231452_2578||4||R||G027||DBR||C||RS||테스트  데 이터

입니다.||20210830183231^||

EAS_20200630173231452_2578||5||R||G027||DBR||C||RS 테스트 데이터 입니다.||20210830183231^||

실시간 방식 참고 사항

개요

RESTFUL 방식을 이용하여 세외수입 정보시스템과 대상 기관 정보시스템 간 연계를 통하여

송/수신 실시간 서비스 제공

업무 처리 흐름도

기본흐름

대상기관

대상시스템

(정보요청)

세외수입정보시스템

연계시스템

(정보제공)

업무별 정의된 전문

응답

수신전문 (대상기관 → 세외수입정보시스템)

대상기관에서 세외수입정보 연계시스템으로 업무별로 정의된 전문을 규격에 맞게 전달하고,

세외수입정보 연계시스템은 전문 수신에 대한 응답 또는 수신된 전문의 조회결과를 응답

송신전문 (세외수입정보시스템→대상기관)

대상기관

대상시스템

(정보요청)

세외수입정보시스템

연계시스템

(정보제공)

업무별 정의된 전문

응답

세외수입정보 연계시스템에서 대상기관으로 업무별로 정의된 전문을 송신하고, 대상기관에서는           전문수신에 대한 응답 또는 수신된 전문의 조회 결과를 수신

통신규격

온라인 전문 프로토콜

RESTFUL (통신프로토콜: + 전문형식:JSON) 통신

전문의 케릭터셋은 UTF-8을 사용하고 영문은 1byte, 한글은 3byte로 처리한다.

접속제어 (Connection Control)

정보요청(Client) 관점

요청 후 30초 이내에 응답을 수신하지 않으면 해당 요청은 실패로 처리한다.

응답 수신 시 Connection을 Close 한다.

정보제공(Server) 관점

Multi-Connection을 지원한다.

이중화 구축 시, 단일 서비스 IP (VIP) 를 제공한다.

정의된 응답 처리가 불가능할 경우, 해당 Connection을 해지한다.

호출 처리 흐름 (Call Flow)

상세 전문 연동 규격

전문 공통

전문구조는 헤더와 데이터부로 구성되며 표준연계를 통해 실시간 거래 처리를 지원한다.

헤더부는 공통의 동일한 규격으로 거래에 필요한 기준정보를 정의한다.

데이터부는 실거래에 필요한 업무 데이터를 정의한다.

전문 헤더 공통 규격

일련 번호	SUB영역	항목명 (한글)	항목명 (영문)	데이터 유형	크기	요청시작성	응답시작성
1	전문헤더정보	전송일자	ifDate	문자열	14	○
2		연계메시지키	ifMsgKey	문자열	49	○
3	전문거래정보	표준연계ID	ifId	문자열	30	○
4		출발지시스템코드	source	문자열	10	○
5		도착지시스템코드	target	문자열	10	○
6		데이터 구분	ifType	문자열	1	○	○
7	데이터정보	데이터 형식	ifFormat	문자열	1	○	○
8	처리결과 (출력부)	연계처리 결과명	retName	문자열	150
9		연계처리 결과코드	retCode	문자열	10

데이터 전송(생성) 일자 [형식 : YYYYMMDDHH24MISS] (14Byte)

각 연계 메시지의 식별을 위한 고유키(이용기관과 제공기관 간 메시지키를 통한 정보조회 시 필요)

형식) “Z (개별시스템 1Byte)” + yy년월일시분초백분초(yyMMddHHmmssSSS) (15Byte) +                  “-(1Byte)“ + 자바UUID('-'제외 32 Byte) (총 49Byte)

예시) Z211103155123435-e7def4c1652a478e9c77525ab5b3ebda

연계 메시지 고유키를 통한 연계 추적 시 사용

연계 항목 고유식별 아이디(IF_ID)

예시) ERR_Z000001DCP_1741000NIS_0001 (차세대 세외수입 연계팀에서 부여 함)

출발지 기관코드(행정표준코드 7자리) + 시스템코드(3자리)

도착지 기관코드(행정표준코드 7자리) + 시스템코드(3자리)

데이터 송/수신 구분 (S:요청/송신, R:응답/수신)

연계 데이터 형식 (D : Delimiter, F : Fixed-Length, X : XML, J : JSON)

연계처리 결과명 (Success : 성공 , 그 외 : 오류 메시지 )

전송요청 시에는 공백, 연계 처리 결과 (200 :성공 , 500 : 실패)

전문 데이터 규격

전문 규격은 JSON으로 전문 내 각 항목은 영문항목명을 요소명으로 가짐.

예) JSON 본문

{

“header”: {

“ifDate”:”20210412103022”,

“ifMsgKey”:”Z211103155123435-e7def4c1652a478e9c77525ab5b3ebda”,

“ifId”:”ERR_Z000001DCP_1741000NIS_0001”,

“source”:”3820000DCP”,

“target”:”1741000NIS”,

“ifType”:”S”,

“ifFormat”:”J”,

“retName”:””,

“retCode”:”200”

},

“body”: {

"lgvCd": "0000000",

"trpNo": "0000000000000",

"startYy": "00000000",

"endYy": "00000000",

"docCode": "0000000000000“

}

}

실시간 전문 호출 Sample

개요

HTTPS 및 JSON을 처리하는 java Class는 전자정부 프레임워크에 포함이 되어 있음.

송신(개별시스템 -> 차세대 세외수입) 전문 호출 Sample

차세대 세입정보시스템 연계 HUB로 호출하는 URL 정보(서버 IP는 개별시스템별 안내)

(포트 정보는 [4.2.3. 지역별 사용 포트] 중 실시간 포트 확인 후 설정 함)

(차세대 세외수입행정 검증) ://검증서버IP:포트/mediate/ltis

(차세대 세외수입행정 운영) ://운영서버IP:포트/mediate/ltis

package test;

import com.fasterxml.jackson.databind.ObjectMapper;

import com.klid.header.CommonHeader;

import org.apache.commons.io.IOUtils;

import javax.net.ssl.*;

import java.io.DataOutputStream;

import java.io.IOException;

import java.io.InputStream;

import java.net.URL;

import java.nio.charset.StandardCharsets;

import java.security.SecureRandom;

import java.security.cert.X509Certificate;

import java.util.LinkedHashMap;

import java.util.Map;

public class SampleClient {

private static final int HTTP_RES_SUCCESS = 200;

private static final int SC_PARTIAL_CONTENT = 206;

private static final int CONNECT_TIMEOUT = 3000;

private static final int READ_TIMEOUT = 30000;

static {

try {

TrustManager[] trustAllCerts = { new X509TrustManager() {

public X509Certificate[] getAcceptedIssuers() {

return null;

}

public void checkClientTrusted(X509Certificate[] certs, String authType) {

}

public void checkServerTrusted(X509Certificate[] certs, String authType) {

}

} };

SSLContext sc = SSLContext.getInstance("SSL");

HostnameVerifier hv = new HostnameVerifier() {

public boolean verify(String hostname, SSLSession session) {

return true;

}

};

sc.init(null, trustAllCerts, new SecureRandom());

URLConnection.setDefaultSSLSocketFactory(sc.getSocketFactory());

URLConnection.setDefaultHostnameVerifier(hv);

} catch (Exception e) {

System.out.println("HttpURLUtil init Error !!!");

}

}

/**

*

* @param url 연계HUB 호출 URL

* @param commonHeader 연계헤더

* @param data 업무데이터

* @return 응답받은 전문

* @throws IOException

*/

public static String sendAndRecv(String url, Object header, Object data) throws IOException {

Map request = new LinkedHashMap();

request.put("header", header);

request.put("body", data);

ObjectMapper objectMapper = new ObjectMapper();

String jsonRequest = objectMapper.writeValueAsString(request);

System.out.println("요청전문 = " + jsonRequest);

URL wsdlLocation = new URL(url);

URLConnection urlConnection = (URLConnection) wsdlLocation.openConnection();

InputStream in = null;

urlConnection.setConnectTimeout(CONNECT_TIMEOUT);

urlConnection.setReadTimeout(READ_TIMEOUT);

urlConnection.setRequestMethod("POST");

urlConnection.setRequestProperty("Accept-Charset", "UTF-8");

urlConnection.setRequestProperty("Content-Type", "application/json;charset=UTF-8");

/* 부여된 인터페이스ID 및 지자체 행정표준코드, 시스템분류코드 셋팅 */

urlConnection.setRequestProperty("IF_ID“,”ERR_Z000001DCP_1741000NIS_0001“);

urlConnection.setRequestProperty("SRC_ORG_CD“,”3820000“);

urlConnection.setRequestProperty("SRC_SYS_CD“,”DCP“);

urlConnection.setDoOutput(true);

DataOutputStream wr = new DataOutputStream(urlConnection.getOutputStream());

wr.write(jsonRequest.getBytes(StandardCharsets.UTF_8));

wr.flush();

wr.close();

int responseCode = urlConnection.getResponseCode();

byte[] resMessage = null;

if (HTTP_RES_SUCCESS > responseCode || SC_PARTIAL_CONTENT < responseCode) {

in = urlConnection.getErrorStream();

resMessage = IOUtils.toByteArray(in);

} else {

in = urlConnection.getInputStream();

resMessage = IOUtils.toByteArray(in);

}

String jsonResponse = new String(resMessage);

return jsonResponse;

}

public static void main(String[] args) {

//연계헤더 생성 및 셋팅

Map commonHeader= new LinkedHashMap();

commonHeader.put("ifDate", "20220806103022");

commonHeader.put("ifMsgKey", "Z211103155123435-e7def4c1652a478e9c77525ab5b3ebda");

commonHeader.put("ifId", "ERR_Z000001DCP_1741000NIS_0001");

commonHeader.put("source", "3820000DCP");

commonHeader.put("target", "1741000NIS");

commonHeader.put("ifType", "S");

commonHeader.put("ifFormat", "J");

commonHeader.put("retCode", "");

commonHeader.put("retName", "");

//업무데이터 생성 및 셋팅

Map body = new LinkedHashMap();

Map empInfo = new LinkedHashMap();

empInfo.put("occrSn", "12341234");

empInfo.put("occrDt", "20210906");

empInfo.put("empId", "testID");

empInfo.put("empName", "테스터");

empInfo.put("age", "20");

empInfo.put("postNo", "123-456");

empInfo.put("roadAddress", "도로명주소");

empInfo.put("detailAddress", "상세주소");

empInfo.put("deptCode", "A99");

body.put("emp_info", empInfo);

try {

String response = sendAndRecv("://서버IP:포트/mediate/ltis", commonHeader, body);

System.out.println("응답전문 = " + response);

} catch (IOException e) {

e.printStackTrace();

}

}

}

개별시스템 수신 (차세대 세외수입 -> 개별시스템)  HTTPS SSL 설정 참고

예시 : OPENSSL 을 이용한 SSL인증서 발급

1. 오픈소스 기반으로 제공되는  oepnssl.org , sourceforge.net에서 다운로드 가능

2. 원도우 기반 openssl.exe 실행 후 C:\ 경로 하위에 설치

3. openssl.exe 실행 후 ..인증서 발급

#key 파일 생성

OpenSSL> genrsa - out server.key 2048

#key 파일을 이용한 csr 파일 생성 (인증서 세부 정보는 상황에 맞게 입력하거나 엔터를 눌러 생략 가능)

OpenSSL> req -new -key server.key -out server.csr

#csr 파일, key 파일을 이용한 crt파일 생성(3650등 .. 인증서 일단위 유효 기간 설정)

OpenSSL> req -new -x509 -days 3650 -in server.csr -key server.key –out server.crt

=> 최종 server , server.csr, server.key 파일 생성 됨

예시 : Apache 서버에 SSL 인증서 적용 (개별 시스템별 환경에 따라 다를 수 있음)

1. httpd.conf 설정 파일에 직접 인증서 경로를 지정

include conf/extra/httpd-ssl.conf 설정 확인

# 인증서 파일 경로 확인, 발급한 인증서 파일을 해당 경로로 이동 시키거나, 인증서가 있는 경로로 해당 경로 수정

SSLCertficateFile "conf/ssl.crt/server.crt"

# 개인키 파일 경로 확인, 발급한 개인키 파일을 해당 경로로 이동 시키거나, 개인키가 있는 경로로 해당 경로 수정

SSLCertficateKeyFile "conf/ssl.key/server.key“

2. Apache 서버 재시작 후 SSL 적용

개별시스템 연계 모듈 설치

연계 환경 구성도

연계 환경 구성

구분		설명
실시간 연계 (동기)	HTTPS	실시간 메시지 전달 방식의 연계 필요 시 사용 하며 개별 시스템에서는 차세대 세외수입 연계HUB와 직접 연계를 위한 HTTPS 방식의 송/수신 연계 방식을 구현
파일 연계 (비동기)	SFTP	- 차세대 세외수입에서 제공된 연계 모듈을 통한 파일을 송/수신 연계 처리

연계모듈 설치

설치 환경 확인

항목	최소사양	설명
OS	Linux, Windows 계열	Java 1.8 설치되는 모든 OS 환경
Java	1.8	Java 1.8 (필수)
Memory	512MB 이상	모듈에 할당 가능한 메모리 용량 (기본 1G 권고)
Disk	1GB 이상	설치 용량 약 70MB * 연계모듈 로그 파일 및 H2 DB 추가 사용

방화벽 확인

환경에 맞는 IP & PORT에 대해 방화벽 Outbound 허용

‘4.5 방화벽 오픈 테스트’ 참고하여 방화벽 허용 확인

환경구분	차세대 세외수입 행정망 NAT-IP	PORT	설명
검증 (테스트)	서버 IP 별도 안내	[4.2.3 지역별사용포트] 참조	검증 서버 IP
운영	서버 IP 별도 안내	[4.2.3 지역별사용포트] 참조	운영 서버 IP

지역별 사용 포트 (검증 / 운영 동일)

광역시도 명	포트	비고
서울시	20251 21251 22251	파일 송/수신 포트 연계모듈 관리 포트 실시간 연계 포트
부산광역시	20261 21261 22261	파일 송/수신 포트 연계모듈 관리 포트 실시간 연계 포트
대구광역시	20271 21271 22271	파일 송/수신 포트 연계모듈 관리 포트 실시간 연계 포트
인천광역시	20281 21281 22281	파일 송/수신 포트 연계모듈 관리 포트 실시간 연계 포트
광주광역시	20291 21291 22291	파일 송/수신 포트 연계모듈 관리 포트 실시간 연계 포트
대전광역시	20301 21301 22301	파일 송/수신 포트 연계모듈 관리 포트 실시간 연계 포트
울산광역시	20311 21311 22311	파일 송/수신 포트 연계모듈 관리 포트 실시간 연계 포트
세종특별자치시	20361 21361 22361	파일 송/수신 포트 연계모듈 관리 포트 실시간 연계 포트
경기도	20411 21411 22411	파일 송/수신 포트 연계모듈 관리 포트 실시간 연계 포트
강원도	20421 21421 22421	파일 송/수신 포트 연계모듈 관리 포트 실시간 연계 포트
충청북도	20431 21431 22431	파일 송/수신 포트 연계모듈 관리 포트 실시간 연계 포트
충청남도	20441 21441 22441	파일 송/수신 포트 연계모듈 관리 포트 실시간 연계 포트
전라북도	20451 21451 22451	파일 송/수신 포트 연계모듈 관리 포트 실시간 연계 포트
전라남도	20461 21461 22461	파일 송/수신 포트 연계모듈 관리 포트 실시간 연계 포트
경상북도	20471 21471 22471	파일 송/수신 포트 연계모듈 관리 포트 실시간 연계 포트
경상남도	20481 21481 22481	파일 송/수신 포트 연계모듈 관리 포트 실시간 연계 포트
제주특별자치도	20501 21501 22501	파일 송/수신 포트 연계모듈 관리 포트 실시간 연계 포트

모듈 설치

Linux 계열

StorkShareAgent.tar 파일을 원하는 경로에 압축 해제한다.

방법	$> tar –xvf StorkShareAgent.tar $> ls -al
결과	drwx------ drwxr-xr-x drwxr-xr-x	11 9 1	user user user	user user user	512 1024 408	2월 14일 2월 14일 2월 14일	17:00 17:00 17:00	./ ../ StorkShareAgent

Windows 계열

StorkShareAgent.zip 파일을 원하는 경로에 압축 해제한다.

설정파일 수정

{모듈설치경로}/config/application.yaml 변경

변경 필요 항목은 주석(설명내용) 참조

server:

port: 20001  // 관리 화면 접속 포트 default 사용시 변경 없음

ssl:

enabled: false

key-alias: Stork

key-store: classpath:Stork.p12

key-store-type: PKCS12

key-store-password: stork!12

http2:

enabled: true

servlet:

session:

timeout: 30m

error:

include-message: always

include-binding-errors: always

include-stacktrace: ON_TRACE_PARAM

include-exception: false

stork:

control:

localOrgCd: "3820000"   // 자치단체 행정표준 코드 입력

localSysCd: "DCP"  // 개별시스템 분류 코드 입력 (추후 안내)

interval: 10

targetUrl: '://10.60.XX.XXX:21411'  // 차세대 세외수입 호출 연계모듈관리 IP:포트

filebatch:

services:

- svcType: "UPLOAD"

username: "uploadz01"

password: "yfxiZ8dfjcMoZJXaaW5HYQ=="

targetAddr: "서버 IP"   // 차세대 세외수입 호출 IP (검증 or 운영) ※ 서버 IP 별도 안내

targetPort: 20411  // 지역별 파일 송수신 사용 포트

localSendPath: "/app/StorkShareAgent/files/SND"  // 개별시스템 로컬 파일 송신경로

localBackupPath: "/app/StorkShareAgent/files/SND/backup"  // 개별시스템 로컬파일 파일 송신후 백업 경로            ./backup/YYYYMMDD 형태로 백업 폴더 생성 후 파일 백업 됨

remoteUploadPath: "/DCP/3820000"   // 차세대 세외수입 리모트 수신 경로

개별시스템분류코드 / 행정표준코드

cronExpression: "0 0,10,20,30,40,50 1-23 * * ?"  // 지역별 파일Upload 설정 확인 후 변경

- svcType: "DOWNLOAD"

username: "downloadz01"

password: "yfxiZ8dfjcMoZJXaaW5HYQ=="

targetAddr: "서버 IP"   // 차세대 세외수입 호출 IP (검증 or 운영) ※ 서버 IP 별도 안내

targetPort: 20411   // 지역별 파일 송수신 사용 포트

localRecvPath: "/app/StorkShareAgent/files/RCV" // 개별시스템 로컬 파일 경로

remoteDownloadPath: "/DCP/3820000"   // 차세대 세외수입 리모트 수신 경로

개별시스템분류코드 / 행정표준코드

cronExpression: "30 0,10,20,30,40,50 1-23 * * ?"  // 지역별 파일Download 설정 확인 후 변경

scheduler:

services:

- name: "DeleteDBMngJob"

use: true

group: "Monitor"

className: "com.megatus.stork.admin.schedule.job.RemoveDBHistoryJob"

cronExpression: "0 0 0/1 * * ?"

isFirstLoadingExecute: true

jobParameters: "remainDays=30"

- name: "DeleteSndFileJob"

use: true

group: "Monitor"

className: "com.megatus.stork.admin.schedule.job.RemoveFileMngJob"

cronExpression: "0 10 0/1 * * ?"

isFirstLoadingExecute: true

jobParameters: "remainDays=30;removePath=/app/StorkShareAgent/files/SND/backup“

// 개별시스템 로컬 파일 백업 경로

- name: "DeleteRcvFileJob"

use: true

group: "Monitor"

className: "com.megatus.stork.admin.schedule.job.RemoveFileMngJob"

cronExpression: "0 20 0/1 * * ?"

isFirstLoadingExecute: true

jobParameters: "remainDays=30;removePath=/app/StorkShareAgent/files/RCV“

// 개별시스템 로컬 파일 수신 경로

- name: "AgentUpdateJob"

use: true

group: "Monitor"

className: "com.megatus.stork.admin.schedule.job.AgentUpdateJob"

cronExpression: "0 0 0/1 * * ?"

isFirstLoadingExecute: true

{모듈설치경로}/config/agent-config.yaml 변경

지역별 파일 Upload, Download 스케줄 설정

광역시도 명	설정 구분	스케줄 설정
서울시	Upload Download	"0 0,10,20,30,40,50 1-23 * * ?" "30 0,10,20,30,40,50 1-23 * * ?"
부산광역시	Upload Download	"1 1,11,21,31,41,51 1-23 * * ?" "31 1,11,21,31,41,51 1-23 * * ?
대구광역시	Upload Download	"11 1,11,21,31,41,51 1-23 * * ?" "41 1,11,21,31,41,51 1-23 * * ?
인천광역시	Upload Download	"2 2,12,22,32,42,52 1-23 * * ?" "32 2,12,22,32,42,52 1-23 * * ?"
광주광역시	Upload Download	"12 2,12,22,32,42,52 1-23 * * ?" "42 2,12,22,32,42,52 1-23 * * ?"
대전광역시	Upload Download	"22 2,12,22,32,42,52 1-23 * * ?" "52 2,12,22,32,42,52 1-23 * * ?"
울산광역시	Upload Download	"3 3,13,23,33,43,53 1-23 * * ?" "33 3,13,23,33,43,53 1-23 * * ?"
세종특별자치시	Upload Download	"13 3,13,23,33,43,53 1-23 * * ?" "43 3,13,23,33,43,53 1-23 * * ?"
경기도	Upload Download	"4 4,14,24,34,44,54 1-23 * * ?" "34 4,14,24,34,44,54 1-23 * * ?"
강원도	Upload Download	"5 5,15,25,35,45,55 1-23 * * ?" "35 5,15,25,35,45,55 1-23 * * ?"
충청북도	Upload Download	"15 5,15,25,35,45,55 1-23 * * ?" "45 5,15,25,35,45,55 1-23 * * ?"
충청남도	Upload Download	"25 5,15,25,35,45,55 1-23 * * ?" "55 5,15,25,35,45,55 1-23 * * ?"
전라북도	Upload Download	"6 6,16,26,36,46,56 1-23 * * ?" "36 6,16,26,36,46,56 1-23 * * ?"
전라남도	Upload Download	"16 6,16,26,36,46,56 1-23 * * ?" "46 6,16,26,36,46,56 1-23 * * ?"
경상북도	Upload Download	"26 6,16,26,36,46,56 1-23 * * ?" "56 6,16,26,36,46,56 1-23 * * ?"
경상남도	Upload Download	"7 7,17,27,37,47,57 1-23 * * ?" "37 7,17,27,37,47,57 1-23 * * ?"
제주특별자치도	Upload Download	"17 7,17,27,37,47,57 1-23 * * ?" "47 7,17,27,37,47,57 1-23 * * ?"

라이선스 파일 경로

{모듈설치경로}/config/license.dat

제공된 라이선스 파일을 해당 경로에 license.dat 파일명으로 복사한다.

모듈 기동과 종료

Linux 계열

- {모듈설치경로} 이동한다.

방법	$> cd {모듈설치경로} $> ls -al
결과	drwx------ drwxr-xr-x drwxr-xr-x drwxr-xr-x drwxr-xr-x drwxr-xr-x drwxr-xr-x -rwxr-xr-x	7 6 2 4 2 2 2 1	user user user user user user user user	user user user user user user user user	512 1024 408 28 75 36 36 2529	2월 14일 2월 14일 2월 14일 2월 14일 2월 14일 2월 14일 2월 14일 2월 14일	17:00 17:00 17:00 17:00 17:00 17:00 17:00 17:00	./ ../ config files h2 lib logs shareAdmin.sh

- 모듈 기동

방법	$> sh shareAdmin.sh start
결과	Starting StorkShareAgent... - Starting... - Created Process ID in ./StorkShareAgent.pid

- 모듈 종료

방법	$> sh shareAdmin.sh stop
결과	Stopping StorkShareAgent... - Shutdown ....

- 모듈 상태 체크

방법	$> sh shareAdmin.sh status
결과	#정상 StorkShareAgent is running #실패 StorkShareAgent is stopped

Window 계열

- 모듈 기동

방법	startAdmin.bat 실행

- 모듈 종료

방법	stopAdmin.bat 실행

파일 송·수신 테스트

파일명 규칙

파일명 표준	비고 (총 60Byte)
인터페이스ID (30) +“_”+ YYYYMMDDHH24MISS(14) “_”+ Seq(3) +“@”+ 지자체행정표준코드(7) + 시스템분류코드(3)	Ex) EBF_Z000001DCP_1741000NIS_0001_20220714101224_001@3820000DCP

파일 송신 테스트

송신전	agent-config.yaml 설정파일 “localSendPath”에 설정한 경로에 송신 파일을 저장
송신완료	agent-config.yaml 설정파일 “localBackupPath”에 설정한 경로에 YYYYMMDD 하위 폴더가 생성되며 송신 파일 이동 저장

파일 수신 테스트

수신완료	agent-config.yaml 설정파일 “localRecvPath”에 설정한 경로에 수신 파일을 저장

관리콘솔

관리콘솔 접속

http://{연계모듈설치서버IP}:{설정파일에 설정한 포트 번호, default:20001}

ex) http://192.168.0.1:20001

관리자계정 ID / PW : admin / admin (로그인후 PW 변경 가능)

모니터링

파일 송/수신 이력 조회 화면

방화벽 오픈 테스트

예시) 의정부시 개별시스템의 경우 경기도 20411, 21411, 22411 포트 연결 확인 필요

Linux 계열

ex) telnet [세외수입 (테스트 & 운영) IP] [지역별 사용 PORT]

방법	$> telnet 10.XX.XX.XX 20411
결과	#성공 Trying.. Connected to 10.XX.XX.XX Escape character is ‘^]’ # 실패 Trying.. telnet: Unable to connect to remote host: Connect timed out

Windows 계열

ex) telnet [세외수입 (테스트 & 운영) IP] [지역별 PORT]

방법	cmd(명령프롬프트창)에서 명령어 실행 $> telnet 10.XX.XX.XX 20411
결과	#성공 연결에 성공되면 위와 같은 빈 화면이 나오며 이스케이프 문자: 'CTRL+]' 누르고 quit 정상 접속 종료 가능 # 실패 포트 연결 오류 메시지 출력

개별시스템 연계 신청서

개요

차세대 세외수입정보시스템과 연계를 위한 대상시스템의 기본정보 및 환경정보를 작성하고 필요 연계목록을 선택하여 신청서를 제출

연계 신청서

■ 연계 대상시스템 설치 기본정보

자치단체명	ex) 경기도 의정부시	(행정 표준) 자치단체 기관코드	ex) 3820000
시스템명	ex) 장애인전용주차구역시스템
네트웍/서버 담당자	ex) 홍일동 차장	네트웍/서버 담당자 연락처	ex) 02-1111-1111
업무 담당자	ex) 홍이동 과장	업무 담당자 연락처	ex) 02-2222-2222
업무 담당자 e-mail	ex) ggg@korea.kr
관리업체 담당자	ex) 업체 홍삼동 과장	관리업체 담당자 연락처	ex) 02-3333-3333

■ 연계 대상시스템 정보(연계모듈 설치 시)

구분	항 목	설명	작성 예시	입력란	비고
연계망	연계구간 망구분	연계구간의 망구분	행정망	행정망	Fixed
IP 정보	대상 서버 공인(행정망) IP	대상서버 IP가 공인(행정망) IP가 아닐 경우 타 시스템과 망 오픈 할 수 있는 VIP 또는 NAT등의 공인(행정망) IP	ex) 10.XX.XX.XX	기입대상	대상기관 인프라 담당자 문의요망
Host 정보	O/S 정보	O/S벤더 및 버전정보	ex) Linux 5.3	기입대상	연계신청서 항목 확인 예시 참조
	Host Name	연계 시스템의 hostid or hostname	ex) edsk-ap	기입대상	연계신청서 항목 확인 예시 참조
JVM	Java Version 정보	Java version 1.8이상의 JRE 또는 JDK 설치필요 (bit 확인 필수)	ex) JRE 1.8 (64bit)	기입대상	연계신청서 항목 확인 예시 참조

※ 비고란의 부가설명을 참조하여 입력란에 기입요망

해당 정보로 연계모듈 라이선스 발급 제공 함

■ 연계 대상시스템 정보(실시간 직접연계 시)

구분	항 목	설명	작성 예시	입력란	비고
연계망	연계구간 망구분	연계구간의 망구분	행정망	행정망	Fixed
도착지 정보	개별시스템 도착지 호출URL정보	차세대 세외수입 HUB -> 지자체 개별시스템 도착지 URL 호출 정보	ex) ://10.60.XX.XX:22222/online	기입대상	개별 시스템 실시간 직접 연계시 방화벽 오픈 대상 정보 도착지 URL
출발지 정보	개별시스템 출발지 IP정보	지자체 개별시스템 -> 차세대 세외수입 HUB 출발지 IP 정보	ex) 10.60.XX.XX	기입대상	개별 시스템 실시간 직접 연계시 방화벽 오픈 대상 정보 출발지 IP

※ 실시간  직접 연계가 있는 경우 작성함

■ 연계정보 신청 항목 선택

업무 구분	신청 기준	신청 연계기준 상세 인터페이스	선택( ■ )
과태료대장	A01	과태료 대장 단속 정보 등록(실시간)	□ 선택
	A02	과태료 대장 등록 자료 일괄 조회(전일자 변동자료)	□ 선택
	A03	과태료 대장 등록 자료 상세 조회(실시간)	□ 선택
주정차위반 과태료대장	B01	주정차위반과태료 단속사진 등록 레이아웃1	□ 선택
		주정차위반과태료 단속사진 등록 레이아웃2
전용차로 위반과태료대장	C01	전용차로위반과태료 단속사진 등록 레이아웃1	□ 선택
		전용차로위반과태료 단속사진 등록 레이아웃2
부과· 징수업무	D01	부과정보연계(실시간)	□ 선택
	D02	부과/수납정보(일배치)	□ 선택
	D03	부과결과정보(실시간)	□ 선택
	D04	부과취소정보(실시간)	□ 선택
	D05	수납정보(실시간)	□ 선택
	D06	감액정보(실시간)	□ 선택
	D07	부과체납정보(전일자 변동자료)	□ 선택
		수납정보(전일자 변동자료)
		감액정보(전일자 변동자료)
		과오납정보(전일자 변동자료)
		결손정보(전일자 변동자료)

※ 신청기준 : “2.업무별 연계인터페이스정의”에 명시된 업무별 신청기준 및 인터페이스 정보 참조하여 작성

연계신청서 항목 확인 예시

작성 예시 (공통정보, 연계모듈 설치시 필요)

HTTPS 실시간 직접 연계시 라이선스 발급은 제외 함

O/S 정보 : O/S 종류, 버전

명령어	사용예시
uname; uname –r;

Host Name : 호스트 명

* Linux 계열

명령어	사용예시
hostid

* Window 계열

명령어	사용예시
hostname

Java Version 정보 : JRE  버전정보, BIT 확인

명령어	사용예시
java –version

붙임1		공통코드 정보

공통코드명	세부코드	세부코드명	비고
시설구분코드	2601	청사	금연구역흡연위반 과태료인 경우 활용
	2602	유치원, 초중고등학교
	2603	대학교
	2604	의료기관, 보건소등
	2605	어린이집
	2606	청소년활동시설
	2607	도서관
	2608	어린이놀이시설
	2609	학원
	2610	교통관련시설
	2611	어린이운송용 승합차
	2612	사무용건축물, 공장 및 복합건축물
	2613	공연장
	2614	대규모점포, 지하상점가
	2615	관광숙박업소
	2616	체육시설
	2617	사회복지시설
	2618	목욕장
	2619	게임제공업소
	2622	만화대여업소
	2623	고속국도 휴게시설 및 부속시설
	2626	공동주택
	2627	실내체육시설
	2628	음식점
	2629	흡연카페
	2630	유치원-어린이집경계10m
	9101	공원
	9103	교육환경 보호구역
	9104	버스정류소
	9105	택시정류소
	9106	해수욕장
	9107	거리
	9108	광장
	9110	지하철역 출입구
	9111	주유소 또는 가스충전소
	9112	횡단보도
	9199	기타
감경사유구분코드	0100	해당없음	일반과태료
	0101	국민기초생활수급자
	0102	한부모가족보호대상자
	0103	장애인(장애의 정도가 심한 장애인)
	0104	국가유공자(상이등급3급이상)
	0105	미성년자
	0199	타법령에의한감경
		해당없음
			금연구역흡연위반과태료
	0300
	0301	국민기초생활수급자
	0302	한부모가족보호대상자
	0303	장애인(장애의 정도가 심한 장애인)
	0304	국가유공자(상이등급3급이상)
	0305	미성년자
	0306	과태료 감면을 위한 금연교육
	0307	과태료 감면을 위한 금연지원 서비스
	0399	타법령에의한감경
납부자상태코드	10	거주자
	11	국외이주신고자
	15	직권조치중
	40	말소자
	41	사망말소
	43	거주불명등록자
	45	현지이민자
	47	국외이주자
	49	국적이탈자
	99	기타
단속구분코드	01	고정형CCTV
	02	주행형CCTV
	03	모바일
	04	민원
	05	타기관이첩
	06	수기보행등록
	07	버스장착형CCTV
	08	생활불편신고
	09	국민신문고
	10	안전신문고
	11	새올민원
	12	홈페이지
	13	PDA	단속정보 연계 시 미활용 항목
	14	경찰서이첩	단속정보 연계 시 미활용 항목
	15	소방서이첩	단속정보 연계 시 미활용 항목
위반내역코드 (주정차위반구분코드)	01	주정차 금지구역
	02	보도(인도)위
	03	어린이 보호구역
	04	주민신고
	05	안전지대
	06	횡단보도
	07	택시.버스정류장
	08	다리위
	09	소화전앞
	10	이중주차 및 대각.직각주차
	11	터널안
	12	공사구역
	13	교차로
	14	건널목
	15	도로모퉁이
	99	기타
서손구분코드	01	번호판독불가
	02	차적불명
	03	착오단속
	04	운전자복귀
	05	차량번호변경
	06	임차인부과
	07	1일다중단속
	08	재판독
	99	기타
부과대상구분코드	00	없음
	01	차량
	02	토지·건물
	03	토지
	04	건물
	05	시설물
	06	하천
	07	도로
	08	공유수면
	09	자원
	10	동·식물(미생물)
	11	선박
	12	증지(수수료)
	13	폐기물
	14	의료
	15	자금
	16	교육
	17	자재
	18	공산품
	19	무형자산
	20	소송명
	91	위반사항
	99	기타