Excel2ZUGFeRD

Excel 데이터 기반 송장 생성

Excel 파일에서 송장 데이터를 읽어 PDF 송장을 생성합니다. Excel 파일의 구조는 정해져 있으며, 템플릿으로 ‘TestRechnung.xlsx’ 파일을 제공합니다.

기존 PDF에 ZUGFeRD 데이터 첨부

사용자가 만든 PDF 파일에 ZUGFeRD XML 데이터를 첨부할 수 있습니다. 이 경우 원본 PDF 파일 이름에 ‘_ZuGFeRD’가 추가된 새 PDF 파일이 생성됩니다.

단위 지원

Excel의 ‘Typ’ 열에서 사용할 수 있는 단위는 시간(h), 분(min), 일(Tag(e)), 월(Monat(e)), 년(Jahr(e)), 리터(l, Liter), 킬로그램(kg), 톤(t), 미터(m), 제곱미터(m²), 세제곱미터(m³), 개(1, Stk.), 킬로와트시(kWh) 등입니다. 기본값은 ‘개’이며, 지원되지 않는 단위는 ‘C62’로 대체되고 설명에 기록됩니다.

자동화 지원

명령줄 인터페이스를 통해 GUI 없이도 사용할 수 있습니다. 예를 들어, excel2zugferd.exe -BlattNr Pfad_zur_Exceldatei.xlsx 형태로 실행합니다. BlattNr은 0부터 시작하는 시트 번호입니다.

설치 및 시작

설치 방법은 두 가지가 있습니다. 첫째, GitHub 릴리스에서 ‘setup_excel2zugferd_x6432_VERSION.msi’ 파일을 다운로드하여 관리자 권한으로 실행합니다. 둘째, 관리자 CMD 창에서 winget install excel2zugferd 명령을 사용합니다. 설치 후 바탕 화면에 ‘excel2zugferd.exe’ 바로 가기가 생성됩니다.

프로그램을 처음 실행하면 설정 파일(config.ini)이 없으므로, GUI를 통해 송장 발행자의 기본 정보를 입력해야 합니다. 설정 파일은 ‘C:Users사용자명AppDataRoamingexcel2zugferd’에 저장됩니다.

사용 방법

GUI를 사용하는 경우, 프로그램을 실행하고 Excel 파일을 선택한 후 시트를 선택하면 데이터를 읽어 PDF를 생성합니다. 생성된 PDF는 Excel 파일이 있는 폴더에 ‘시트이름.pdf’로 저장됩니다.

명령줄을 사용하는 경우, excel2zugferd.exe -BlattNr Pfad_zur_Exceldatei.xlsx 또는 excel2zugferd.exe -BlattNr Pfad_zur_eigenen_PDF.pdf Pfad_zur_Exceldatei.xlsx 형태로 실행합니다. 실행 결과는 Windows 이벤트 뷰어의 ‘Windows 로그’ > ‘응용 프로그램’에 기록됩니다.

지원 환경

Windows 운영 체제에서 사용할 수 있으며, x64 아키텍처를 지원합니다. 설치 프로그램은 MSI 형식입니다.

버전 및 업데이트

최신 버전은 0.24.8.0이며, 2025년 4월 23일에 릴리스되었습니다. 업데이트는 설치와 동일한 방법으로 수행하거나, 관리자 CMD에서 winget update excel2zugferd 명령을 사용할 수 있습니다.

라이선스 및 확인 사항

이 프로그램은 Apache License 2.0으로 배포됩니다. 사용자는 라이선스 조건을 준수해야 합니다.

또한, 사용자가 만든 PDF에 ZUGFeRD 데이터를 첨부하는 경우, PDF 내용과 XML 데이터의 일치 여부는 확인되지 않으므로 사용자가 직접 검증해야 합니다.