Odoo용 한국 4대보험 EDI
국민연금(NPS) · 건강보험/장기요양(NHIS) 월별 신고 파일을 대행 제출용으로 생성
Odoo에서 직접 국민건강보험공단(NHIS)과 국민연금공단(NPS)에 제출할 월별 4대보험 EDI 신고 파일을 생성합니다. 본 모듈은 가입 직원별 국민연금, 건강보험, 장기요양보험료를 현행 법정 요율로 산정한 뒤, 구조화된 EDI 신고 파일과 검토 대장을 만들어 줍니다. 생성된 파일은 사업장의 대행기관 또는 4대사회보험(4insure) 채널을 통해 직접 업로드하며, 본 모듈은 형식 생성기로서 데이터를 외부로 전송하지 않습니다. Odoo 18 및 Odoo 19(커뮤니티/엔터프라이즈)와 호환되며, 인사관리(HR) 앱 위에서 동작하므로 엔터프라이즈 급여 모듈이 필요하지 않습니다.
국민연금 (NPS)
기준소득월액을 바탕으로 국민연금 보험료를 산정하며, 근로자와 사용자가 50:50으로 부담합니다. 법정 상한·하한과 대행기관 방식의 10원 절사가 적용됩니다. 모든 요율과 소득 구간은 편집 가능한 항목이므로, 매년 고시 변경에 맞춰 직접 조정할 수 있고 값이 코드에 고정되어 있지 않습니다.
건강보험 + 장기요양 (NHIS)
보수월액을 기준으로 건강보험료를, 그 보험료의 일정 비율로 장기요양보험료를 산정하며, 각각 50:50으로 분담하고 NHIS 고시 방식대로 원 단위로 반올림합니다. 직원별로 각 보험 가입 여부를 개별 설정할 수 있습니다.
두 가지 EDI 파일 형식
신고 파일을 헤더/명세/트레일러 구조와 대사용 합계를 갖춘 구분자(파이프) 텍스트 파일로 생성하거나, 자릿수 패딩이 필요한 EDI 클라이언트를 위한 고정 길이 위치 기반 파일로 생성할 수 있습니다. 두 형식 모두 사업장 사업자등록번호, 사업장관리번호, 기관 코드, 신고 월을 포함합니다.
식별자 검증
사업장 사업자등록번호는 국세청 검증 알고리즘으로 확인하고, 각 직원의 주민등록번호는 유효성을 검증한 뒤 검토 대장에서 마스킹합니다. 따라서 형식이 잘못된 식별자가 제출 파일에 들어가는 일이 없습니다.
제공 기능
| 기능 | 상세 |
|---|---|
| 국민연금 보험료 | 기준소득월액의 9.5%, 50:50, 상한 6,370,000원 / 하한 400,000원(편집 가능) |
| 건강보험료 | 보수월액의 7.19%, 50:50(요율 편집 가능) |
| 장기요양보험료 | 건강보험료의 13.14%, 50:50(요율 편집 가능) |
| 고용보험 | 실업급여 1.8% 항목을 월별 요약에서 대사 |
| EDI 파일 | 대사용 트레일러 합계를 갖춘 구분자 및 고정 길이 신고 형식 |
| 검토 대장 | 주민등록번호가 마스킹된 CSV |
| 월별 요약 | 당월 국민연금·건강보험을 합산하고, 클릭 한 번으로 두 신고 초안을 생성하는 마법사 |
| 식별자 검증 | 사업자등록번호·주민등록번호 검증, 주민번호 마스킹 |
사용 방법
- 회사에 사업장 사업자등록번호, 관리번호, (필요 시) 보험료 요율을 설정합니다.
- KR 사회보험 탭에서 직원별 주민등록번호, 월 보수, 보험 가입 정보를 입력합니다.
- 국민연금 또는 건강보험 월별 신고를 생성하고, 가입 직원을 불러와 보험료를 산정합니다.
- EDI 파일과 마스킹된 검토 대장을 생성한 뒤, 사업장의 NHIS / NPS / 4대보험 채널로 직접 업로드합니다.
범위 및 고지
본 모듈은 사회보험 신고 파일 형식을 생성하며, NHIS나 NPS에 직접 연결되지 않고 공인 EDI 게이트웨이가 아닙니다. 생성된 파일은 사업장의 대행 자격으로 직접 제출합니다. 직원 데이터는 Odoo 데이터베이스를 벗어나지 않습니다. 보험료 요율, 국민연금 소득 구간, 절사 규칙은 현행 법정 기본값을 완전 편집 가능한 매개변수로 제공하므로, 실제 신고 전 최신 NHIS / NPS 공식 안내와 대조하여 확인하시기 바랍니다.
English summary
Korea Social-Insurance EDI for Odoo. Generate the monthly NHIS & NPS report files (4-Major-Insurance / 4대보험) straight from Odoo for agency submission. The module computes each insured employee's National Pension, Health Insurance and Long-Term Care contributions on the current statutory rates (NPS 9.5%, NHIS health 7.19%, Long-Term Care 13.14% of the health premium, all 50/50 and editable), then builds a structured EDI report file and a review register. Output is available as a delimited (pipe-separated) or fixed-width positional file with reconciling trailer totals. The Business Registration Number is check-digit validated and the Resident Registration Number is validated and masked on the register. You upload the file through your own agency / 4insure channel — the module is a format generator and never transmits your data. Built on the Human Resources app; no Enterprise payroll required. Compatible with Odoo 18 and 19, Community and Enterprise.
Screenshots
Edi Reports
Monthly Summary
Update date: 2026-07-02