Generate Korean payslip Excel files with the XBOSS payroll API

급여 확정 후 누락과 중복, 공제 차이를 먼저 확인하세요. XBOSS 급여대장 엑셀을 별도 마감표와 대사해 수정할 행을 보여 주고, 검증을 통과한 승인 자료만 직원별 급여명세서 검토본 ZIP으로 만듭니다. 가상 예제는 API 키 없이 실행할 수 있습니다.

작동 방식

1. 예제 실행은 가상 직원 2명이 담긴 실제 XBOSS 형식의 급여대장 XLSX와 독립 마감표를 불러옵니다. 파일과 기준값이 한 묶음인지 확인한 뒤 엑셀의 직원 행을 읽습니다. 실제 운영 자료를 외부 API에 전송하는 단계는 없습니다.
2. 직원 번호 중복, 같은 이름과 생년월일의 중복, 여섯 공제 항목의 합과 실지급액을 검사합니다. 원본 행을 합산한 인원, 총지급, 총공제, 실지급을 별도로 확정한 마감표와 대사하므로 누락이나 합계 차이가 있는 행을 검토할 수 있습니다.
3. 검증 결과 엑셀에는 합계 대사와 수정할 항목을 출력합니다. 빈 입력, 중복 또는 금액 차이가 있거나 담당자 마감 승인이 없으면 직원별 검토본 생성을 멈춥니다. 오류가 없는 것과 승인된 것은 각각 확인합니다.
4. 검증을 통과하고 승인된 자료만 직원별로 분리해 급여명세서 검토본 XLSX와 ZIP 묶음으로 만듭니다. 파일명에는 직원 이름과 생년월일을 넣지 않습니다. 이 파일은 내부 검토용이며 회사 서식을 확인하기 전 실제 배부하지 않습니다.
5. 실무에서는 상위 워크플로의 Execute Sub-workflow로 급여대장 원본 binary.data와 독립 기준 json.expected, 승인 여부 json.approved를 전달할 수 있습니다. 실제 직원에게 메일을 보내거나 급여를 이체하지 않으며, 세금 계산과 기관 신고도 수행하지 않습니다.

설정 방법

1. 제출 JSON을 새 워크플로로 가져오고 가상 자료를 바꾸지 않은 상태에서 예제 실행을 누릅니다. 이 예제에는 가상 급여대장 파일이 포함되어 있어 XBOSS API 키나 외부 서비스 자격증명이 필요하지 않습니다. 검증 결과 엑셀과 직원 검토본 ZIP 노드의 Binary에서 결과를 내려받습니다.
2. 독립 마감표 예제의 인원이나 합계를 바꿔 불일치 결과를 확인합니다. 직원 행에서 기준 합계를 다시 만들면 원본 누락을 감지할 수 없으므로 별도 확정한 마감표를 사용합니다. 회사 한 곳과 귀속월 한 달씩 처리하고, 원본의 열 구조가 다르면 검증 결과를 먼저 확인합니다.
3. 실무 하위 호출은 내 워크플로에서 급여대장 받기 트리거를 활성화해 게시하거나, JSON을 상위 Execute Sub-workflow의 Define Below에 넣어 연결합니다. binary.data에 XLSX, json.expected에 period, headcount, gross, deduction, net을 전달합니다. 금액과 인원은 정수, 귀속월은 YYYYMM 문자열로 지정하며 담당자가 확인한 뒤에만 json.approved를 true로 설정합니다.

요구 사항

n8n 2.46.6 Docker에서 제출 JSON을 가져와 정상, 중복 및 금액 불일치, 빈 입력, 미승인과 상위 워크플로 호출을 검증했습니다. 기본 n8n 노드만 사용하며 커뮤니티 노드나 별도 API 인증은 필요하지 않습니다. 실무에는 XBOSS 형식 급여대장 XLSX와 독립 마감표가 필요합니다. 실제 원본을 XBOSS API로 새로 생성하는 연동은 이 템플릿에 포함되지 않습니다.

사용자 정의

기본 예제의 결과를 확인한 뒤 사내 승인된 급여대장 입력과 접근이 제한된 보관처를 연결할 수 있습니다. 원본 양식이 바뀌면 열 대응과 검증 결과를 다시 확인하세요. 자동 배부, 다른 기관 자료 조회나 후속 API 호출은 별도로 구성하고 검증해야 합니다.

추가 정보

한국어 캔버스 안내와 가상 직원 예제를 제공합니다. 급여대장 원본과 독립 마감표를 비교해 수정할 행을 찾고, 검증과 승인이 모두 끝난 자료만 직원별 검토본으로 만듭니다. 결과는 내부 검토용이며 법정 세액 계산, 실제 지급과 배부를 대신하지 않습니다.

XBOSS 급여대장 상품과 이용 조건: https://xboss.biz/service-products/register-xlsx?utm_source=n8n&utm_medium=workflow&utm_campaign=n8n_templates&utm_content=payroll-close
공식 서비스 안내: https://xboss.biz/?utm_source=n8n&utm_medium=workflow&utm_campaign=n8n_templates&utm_content=payroll-close

이 워크플로는 외부 API 인증이나 호출 없이 급여대장 파일을 처리합니다. 실제 원본을 생성하는 상품의 계정과 이용 조건은 별도입니다. 내려받은 직원 파일은 접근 권한이 제한된 저장소에 보관하세요.