๋ด๋ณด๋ด๊ธฐ ๋ฐ ์ ์ถ
๊ฒ์ฆ์ ๋ง์น ๊ณต๊ธ๋ด์ญ ๋ฐ์ดํฐ๋ฅผ KPIS์ ์ ์ถํ๋ ๋ ๊ฐ์ง ๋ฐฉ๋ฒ(์๋๋ณด๊ณ /์๋๋ณด๊ณ )๊ณผ ๋ฐ์ก ์ฒ๋ฆฌ ์ ์ฐจ๋ฅผ ์๋ดํฉ๋๋ค.
์๋๋ณด๊ณ : ์์ ๋ด๋ณด๋ด๊ธฐ
KPIS ํฌํธ์ ์ง์ ์ ๋ก๋ํ๋ ค๋ ๊ฒฝ์ฐ, ๊ฐ๊ณต๋ ๋ฐ์ดํฐ๋ฅผ ์์ ํ์ผ๋ก ๋ด๋ณด๋ ๋๋ค.
๋ด๋ณด๋ด๊ธฐ ์ ์ฐจ
- ๋ฐ์ดํฐ ํธ์ง ํ๋ฉด์์ ๋ด๋ณด๋ด๊ธฐ ๋ฒํผ์ ํด๋ฆญํฉ๋๋ค.
- ๋ด๋ณด๋ด๊ธฐ ๋ฒ์๋ฅผ ์ ํํฉ๋๋ค.
- ํ์ฌ ํญ๋ง: ์ ํํ ๊ณต๊ธ๊ตฌ๋ถ(์ถ๊ณ /๋ฐํ/ํ๊ธฐ/์ ์ /์ทจ์)์ ๋ฐ์ดํฐ๋ง ๋ด๋ณด๋ด๊ธฐ
- ์ ์ฒด: ๋ชจ๋ ๊ณต๊ธ๊ตฌ๋ถ์ ๋ฐ์ดํฐ๋ฅผ ํ ํ์ผ์ ๋ด๋ณด๋ด๊ธฐ
- ๊ฐ์ง์ ์์ง๊ฐ ๊ฐ๊ฐ ๋ณ๋ ์ํธ ๋๋ ๋ณ๋ ํ์ผ๋ก ์์ฑ๋ฉ๋๋ค.
- ๋ธ๋ผ์ฐ์ ์ ๋ค์ด๋ก๋ ํด๋์
.xlsxํ์ผ์ด ์ ์ฅ๋ฉ๋๋ค.
๋ด๋ณด๋ด๊ธฐ ํ์ผ ๊ตฌ์ฑ
| ํญ๋ชฉ | ์ค๋ช |
|---|---|
| ํ์ผ ํ์ | .xlsx (Excel 2007 ์ด์) |
| ๊ฐ์ง | 21์ด, ํค๋ ์์ โ KPIS ์ ๋ก๋ ์์๊ณผ ๋์ผ |
| ์์ง | 3์ด, ํค๋ ์์ โ ๊ฐ์ง ์ฐ๋ฒ๊ณผ ๋งค์นญ |
๋ด๋ณด๋ด๊ธฐ๋ ์์ ์ฝ๊ธฐ ์์ ์ ๋๋ค. DB์ ์ ์ฅ๋ ๋ฐ์ดํฐ์ ์ํฅ์ ์ฃผ์ง ์์ต๋๋ค.
KPIS ํฌํธ ์ ๋ก๋
๋ด๋ณด๋ธ ์์ ํ์ผ์ KPIS ํฌํธ(https://www.kpis.or.kr)์ย ์ง์ ์ ๋ก๋ํ๋ ์ ์ฐจ์ ๋๋ค.
- KPIS ํฌํธ์ ๊ณต๋์ธ์ฆ์๋ก ๋ก๊ทธ์ธํฉ๋๋ค.
- ๊ณต๊ธ๋ด์ญ ๋ณด๊ณ ๋ฉ๋ด์์ ์์ ์ ๋ก๋๋ฅผ ์ ํํฉ๋๋ค.
- ๊ฐ์ง ํ์ผ๊ณผ ์์ง ํ์ผ์ ๊ฐ๊ฐ ์ ๋ก๋ํฉ๋๋ค.
- ์ ์ถ ํ ๊ฒฐ๊ณผ๋ฅผ ํ์ธํฉ๋๋ค.
์๋๋ณด๊ณ : MA111 API ์ ์ถ
์์คํ ์์ KPIS API๋ฅผ ํตํด ์ง์ ์ ์ถํ๋ ๋ฐฉ์์ ๋๋ค. ์๋ ์ ๋ก๋ ์์ด ๋ฒํผ ํด๋ฆญ์ผ๋ก ์๋ฃ๋ฉ๋๋ค.
์ฌ์ ์กฐ๊ฑด
์๋๋ณด๊ณ ๋ฅผ ์ฌ์ฉํ๋ ค๋ฉด ๋ค์์ด ์ค์ ๋์ด ์์ด์ผ ํฉ๋๋ค.
| ์กฐ๊ฑด | ์ค๋ช | ์ค์ ์์น |
|---|---|---|
| API ์ค์ | ์ฌ์ ์๋ฑ๋ก๋ฒํธ, API KEY ๋ฑ๋ก | ๊ด๋ฆฌ์ > API ์ค์ |
| ๊ณต๋์ธ์ฆ์ | ์ ํจํ .pfx ์ธ์ฆ์ ์
๋ก๋ | ๊ด๋ฆฌ์ > ์ธ์ฆ์ ๊ด๋ฆฌ |
| ์ ํจ์ฑ ๊ฒ์ฆ ํต๊ณผ | ์ค๋ฅ 0๊ฑด | ๋ฐ์ดํฐ ํธ์ง ํ๋ฉด |
| ์ฌ์ฉ์ ์น์ธ | ๊ด๋ฆฌ์๊ฐ ์น์ธํ ๊ณ์ | ๊ด๋ฆฌ์ > ์ฌ์ฉ์ ๊ด๋ฆฌ |
๊ณต๋์ธ์ฆ์๊ฐ ๋ง๋ฃ๋์๊ฑฐ๋ ๋ฏธ๋ฑ๋ก์ด๋ฉด ์ ์ก ๋ฒํผ์ด ๋นํ์ฑํ๋ฉ๋๋ค.
์ ์ถ ์ ์ฐจ
- ๋ฐ์ดํฐ ํธ์ง ํ๋ฉด์์ ์ ํจ์ฑ ๊ฒ์ฆ์ด ํต๊ณผ๋์๋์ง ํ์ธํฉ๋๋ค (์ค๋ฅ 0๊ฑด).
- API ์ ์ถ ๋ฒํผ์ ํด๋ฆญํฉ๋๋ค.
- ์์คํ
์ด MA111(๊ณต๊ธ๋ด์ญ ์ ๋ณด ์ง์ ๋ฑ๋ก) API๋ฅผ ํธ์ถํฉ๋๋ค.
- ์๋ฒ๊ฐ DB์์ ๊ณต๋์ธ์ฆ์๋ฅผ ๋ก๋ํ๊ณ ๋ณตํธํํฉ๋๋ค.
- SOAP XML์ ์์ฑํ๊ณ WS-Security ์ ์์๋ช ์ ์ํํฉ๋๋ค.
- KPIS ์ด์ ์๋ฒ์ ๋ฐ์ดํฐ๋ฅผ ์ ์กํฉ๋๋ค.
- ์ ์๊ฐ ์๋ฃ๋๋ฉด ๊ฐ ํ์ ์ ์๋ฒํธ(
rcptNo)๊ฐ ๋ถ์ฌ๋ฉ๋๋ค.
MA112 ๊ฒฐ๊ณผ ํ์ธ
MA111๋ก ์ ์ถํ ๋ฐ์ดํฐ์ ์ฒ๋ฆฌ ๊ฒฐ๊ณผ๋ฅผ ํ์ธํฉ๋๋ค.
- ์ ์ถ ์๋ฃ ํ ๊ฒฐ๊ณผ ํ์ธ ๋ฒํผ์ ํด๋ฆญํฉ๋๋ค.
- ์์คํ ์ด MA112(๊ณต๊ธ๋ด์ญ ๋ฑ๋ก ๊ฒฐ๊ณผ ์กฐํ) API๋ฅผ ํธ์ถํฉ๋๋ค.
- ๊ฐ ๊ฑด๋ณ๋ก ์ฒ๋ฆฌ ์ํ๊ฐ ์ ๋ฐ์ดํธ๋ฉ๋๋ค.
| ์ํ | ์๋ฏธ | ํ์ |
|---|---|---|
submitted | ์ ์ ์๋ฃ, ์ฒ๋ฆฌ ๋๊ธฐ | ํ๋์ |
registered | ๋ฑ๋ก ์๋ฃ | ์ด๋ก์ |
returned | ๋ฐ์ก โ ์์ ํ์ | ๋นจ๊ฐ์ |
KPIS ์๋ฒ์ ์ฒ๋ฆฌ ์๊ฐ์ ๋ฐ๋ผ ๊ฒฐ๊ณผ ์กฐํ๊น์ง ์๊ฐ์ด ์์๋ ์ ์์ต๋๋ค. ์ ์ ์งํ์๋
submitted์ํ์ด๋ฉฐ, ์ผ์ ์๊ฐ ํregistered๋๋returned๋ก ๋ณ๊ฒฝ๋ฉ๋๋ค.
๋ฐ์ก ์ฒ๋ฆฌ
MA112 ๊ฒฐ๊ณผ์์ ๋ฐ์ก(returned)๋ ๊ฑด์ ์์ธ์ ํ์ธํ๊ณ ์์ ํ ํ ๋ค์ ์ ์ถํด์ผ ํฉ๋๋ค.
๋ฐ์ก์ฝ๋ (DC001~DC007)
| ์ฝ๋ | ์ฌ์ | ์์ธ | ๋์ ๋ฐฉ๋ฒ |
|---|---|---|---|
| DC001 | ํ์ค์ฝ๋ ๋ถ์ผ์น | ์กด์ฌํ์ง ์๊ฑฐ๋ ๋ง๋ฃ๋ ํ์ค์ฝ๋ | MA101๋ก ์ ํํ ํ์ค์ฝ๋ ์ฌ๊ฒ์ฆ ํ ์์ |
| DC002 | ๋ฏธ๋ฑ๋ก ๊ฑฐ๋์ฒ | KPIS์ ๋ฑ๋ก๋์ง ์์ ๊ฑฐ๋์ฒ | MA102๋ก ๊ฑฐ๋์ฒ ๋ฑ๋ก์ฌ๋ถ ํ์ธ ํ ์ฌ์ ์๋ฒํธ ์์ |
| DC003 | ๋ณด๊ณ ๊ธฐ๊ฐ ์ธ ๊ณต๊ธ์ผ์ | ํด๋น ๋ถ๊ธฐ ๋ณด๊ณ ๊ธฐ๊ฐ์ ๋ง์ง ์๋ ๋ ์ง | MA116์ผ๋ก ๋ถ๊ธฐ ๋ณด๊ณ ๊ธฐ๊ฐ ํ์ธ ํ ๊ณต๊ธ์ผ์ ์์ |
| DC004 | ์ค๋ณต๋ณด๊ณ | ๋์ผ ๋ฐ์ดํฐ๊ฐ ์ด๋ฏธ ๋ฑ๋ก๋จ | MA112๋ก ๊ธฐ๋ฑ๋ก ์ ์๋ฒํธ ํ์ธ ํ ์ ์ (4) ๋๋ ์ทจ์(5) ์ฒ๋ฆฌ |
| DC005 | ์๋/๊ธ์ก ์ค๋ฅ | ๋จ๊ฐ x ์๋ โ ๊ธ์ก | ๋จ๊ฐ, ์๋, ๊ธ์ก ์ ํฉ์ฑ ํ์ธ ํ ์์ |
| DC006 | ์์ง ๋๋ฝ | ์ผ๋ จ๋ฒํธ๊ตฌ๋ถ=0์ธ๋ฐ ์์ง ๋ฐ์ดํฐ ์์ | ์์ง ํ์ผ ์ฌ์ ๋ก๋ ๋๋ ์ผ๋ จ๋ฒํธ๊ตฌ๋ถ ๋ณ๊ฒฝ |
| DC007 | ์์๊ธฐ๊ด๊ธฐํธ ์ค๋ฅ | ๊ณต๊ธํํ=9(์์๊ธฐ๊ด)์ธ๋ฐ ๊ธฐ๊ด๊ธฐํธ ๋๋ฝ/์ค๋ฅ | 8์๋ฆฌ ์์๊ธฐ๊ด๊ธฐํธ ํ์ธ ํ ์์ |
์ค๋ฅ์ฝ๋์ ๋ฐ์ก์ฝ๋์ ์ฐจ์ด
| ๊ตฌ๋ถ | ์ค๋ฅ์ฝ๋ | ๋ฐ์ก์ฝ๋ |
|---|---|---|
| ๋ฐ์ ์์ | API ํธ์ถ ์์ฒด ์คํจ | ์ ์๋ ๋์ง๋ง ๊ฒ์ฆ ์คํจ |
| ์์ธ | ๋คํธ์ํฌ, ์ธ์ฆ, ์์ฒญ ํ์ | ๋ฐ์ดํฐ ๋ด์ฉ ๋ฌธ์ |
| ๋์ | ์ธ์ฆ์/๋คํธ์ํฌ ํ์ธ | ๋ฐ์ดํฐ ์์ ํ ์ฌ์ ์ถ |
MA113 ์ฌ์ ์ฒญ ์ ์ฐจ
๋ฐ์ก๋ ๊ฑด์ ์์ ํ ํ ์ฌ์ ์ถํ๋ ์ ์ฐจ์ ๋๋ค.
- MA112 ๊ฒฐ๊ณผ์์ ๋ฐ์ก(
returned) ๊ฑด์ ํ์ธํฉ๋๋ค. - ๋ฐ์ก์ฝ๋(DC์ฝ๋)๋ฅผ ํ์ธํ๊ณ ํด๋น ๋ฐ์ดํฐ๋ฅผ ์์ ํฉ๋๋ค.
- ๋ฐ์ก์ ์ฒญ ๋ฒํผ์ ํด๋ฆญํฉ๋๋ค.
- ์์คํ ์ด MA113(๋ฐ์ก์ ์ฒญ ์ง์ ๋ฑ๋ก) API๋ฅผ ํธ์ถํฉ๋๋ค.
- ์ ์ ์๋ฃ ํ MA114(๋ฐ์ก์์ฒญ ๋ฑ๋ก ๊ฒฐ๊ณผ ์กฐํ)๋ก ๊ฒฐ๊ณผ๋ฅผ ํ์ธํฉ๋๋ค.
์ฌ์ ์ฒญ ์ ์ฃผ์์ฌํญ
- ๋ฐ์ก์ ์ฒญ์ ๋ฐ๋์ ์๋ ์ ์๋ฒํธ๋ฅผ ํฌํจํด์ผ ํฉ๋๋ค.
- ๋ฐ์ก ์ฌ์ ์ ๋ง๋ ํ๋๋ง ์์ ํฉ๋๋ค. ๋ถํ์ํ ํ๋ ๋ณ๊ฒฝ์ ์ถ๊ฐ ๋ฐ์ก์ ์์ธ์ด ๋ฉ๋๋ค.
- DC004(์ค๋ณต๋ณด๊ณ )์ ๊ฒฝ์ฐ ์ฌ์ ์ฒญ์ด ์๋ ์ ์ (์ฝ๋ 4) ๋๋ ์ทจ์(์ฝ๋ 5)๋ก ์ฒ๋ฆฌํด์ผ ํฉ๋๋ค.
์ ์ถ ์ํ ์์ฝ
์ ์ฒด ๋ฐ์ดํฐ์ ์ ์ถ ํํฉ์ ์ฌ์ด๋๋ฐ์ ๋ฌ๋ ฅ์์ ๋ ์ง๋ณ๋ก ํ์ธํ ์ ์์ต๋๋ค.
| ๋ฌ๋ ฅ ์ํ | ์๋ฏธ |
|---|---|
done (์ด๋ก์) | ํด๋น ๋ ์ง์ ๋ชจ๋ ๊ฑด์ด ๋ฑ๋ก ์๋ฃ |
partial (๋
ธ๋์) | ์ผ๋ถ ๋ฏธ์ ์ถ ๋๋ ๋ฐ์ก ๊ฑด ์กด์ฌ |
missing (๋นจ๊ฐ์) | ๋ฐ์ดํฐ ์์ (๋ฏธ๋ณด๊ณ ) |
ignored (ํ์) | ๋ฏธ๋ณด๊ณ ๋ฌด์ ์ฒ๋ฆฌ๋จ |
๋ค์ ๋จ๊ณ
- ๊ณต๊ธ๋ด์ญ ๋ณด๊ณ ์ โ ์ ๋ก๋, ์๋ ์ฒ๋ฆฌ, ๊ฒ์ฆ ์ ์ฐจ
- API ๋ ํผ๋ฐ์ค โ KPIS API ์์ธ ์คํ (๊ด๋ฆฌ์์ฉ)