{"id":37488221,"url":"https://github.com/odinsoft-lab/open.etaxbill","last_synced_at":"2026-01-16T07:34:21.405Z","repository":{"id":44659575,"uuid":"64198504","full_name":"odinsoft-lab/open.etaxbill","owner":"odinsoft-lab","description":"국세청 전자(세금)계산서/전자명세서/현금영수증/휴폐업조회/홈택스연동/계좌조회 오픈소스 프로젝트 (엔진, 스크래핑)","archived":false,"fork":false,"pushed_at":"2025-08-26T16:20:24.000Z","size":1319,"stargazers_count":20,"open_issues_count":0,"forks_count":6,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-08-27T04:00:23.936Z","etag":null,"topics":["c-sharp","dotnet","etax-bill","nts","open","tax"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/odinsoft-lab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2016-07-26T07:08:57.000Z","updated_at":"2025-08-26T16:20:29.000Z","dependencies_parsed_at":"2025-08-27T04:15:24.978Z","dependency_job_id":"ba403133-3916-419f-9342-4c9b26bef356","html_url":"https://github.com/odinsoft-lab/open.etaxbill","commit_stats":null,"previous_names":["odinsoft-lab/open.etaxbill"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/odinsoft-lab/open.etaxbill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odinsoft-lab%2Fopen.etaxbill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odinsoft-lab%2Fopen.etaxbill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odinsoft-lab%2Fopen.etaxbill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odinsoft-lab%2Fopen.etaxbill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/odinsoft-lab","download_url":"https://codeload.github.com/odinsoft-lab/open.etaxbill/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odinsoft-lab%2Fopen.etaxbill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28478047,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T06:30:42.265Z","status":"ssl_error","status_checked_at":"2026-01-16T06:30:16.248Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["c-sharp","dotnet","etax-bill","nts","open","tax"],"created_at":"2026-01-16T07:34:21.310Z","updated_at":"2026-01-16T07:34:21.378Z","avatar_url":"https://github.com/odinsoft-lab.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Open eTaxBill (소스 공개 종료 안내)\n\n본 저장소의 소스 코드는 더 이상 무상 라이선스로 제공되지 않습니다. 기존에 공개되었던 `src/` 하위 소스는 모두 제거되었으며, 오픈소스 이용은 중단되었습니다.\n\n## 사용/도입 문의\n\n서비스 도입, 기능 확장, 유지보수, 기술 지원이 필요하신 경우 아래로 연락해주세요.\n\n- 회사: 오딘소프트 (Odinsoft)\n- 이메일: help@odinsoft.co.kr\n- 웹사이트: https://www.odinsoft.co.kr\n\n요구사항(업무 범위, 기간, 예산, 환경 등)을 이메일로 간단히 남겨주시면 빠르게 안내드리겠습니다.\n\n## 기존 문서 안내\n\n- `docs/` 폴더에는 과거 기술 문서와 로드맵이 남아 있을 수 있으나, 현 정책과 기능은 별도 계약 기준으로 제공됩니다.\n- `LICENSE.md`의 오픈소스 표기는 더 이상 유효하지 않습니다. 본 저장소의 잔여 파일은 안내 용도입니다.\n\n## 법적 고지\n\n본 저장소의 코드 및 문서를 무단으로 복제, 배포, 변경, 상업적 이용하는 행위를 금지합니다. 위반 시 관련 법령에 따라 책임을 물을 수 있습니다.\n\n감사합니다.\n\n\n---\n\n# Open eTaxBill (안내)\n\n국세청 전자세금계산서(ETAX) 연동을 위한 엔진/채널/인증 도구 모음입니다. 엔진은 전자세금계산서의 생성·서명·전송·응답·메일·수신 파이프라인을 담당하고, 채널은 각 엔진을 호출하는 WCF 클라이언트, Certifier는 KISA 전자세금계산서 인증 절차를 도와주는 WinForms 유틸리티입니다.\n\n## 구성요소(Components)\n\n- Engine(6 Services)\n\t- collector: 전자세금계산서 작성 및 DB 저장 (엑셀/ERP 대량 처리)\n\t- signer: 매출자 인증서로 전자세금계산서 서명/암호화\n\t- reporter: 국세청 보고(전송)\n\t- responsor: 국세청 처리결과 수신 및 DB 반영\n\t- mailer: ASP 사업자/매입자 메일 발송\n\t- provider: 타 ASP 수신 메일 파싱 및 매입 분 저장\n\n- Channel: 엔진 호출용 WCF Channel 라이브러리 (`src/channel`)\n- Certifier: 전자세금계산서 인증 보조 툴(WinForms) (`src/certifier`)\n\n## 기술 스택(Tech Stack)\n\n- .NET Framework 4.7.2, C#, WinForms, WCF\n- Database: Microsoft SQL Server\n- NuGet: BouncyCastle, Mono.Security, Npgsql, SharpZipLib, OdinSdk.*\n\n## 프로젝트 구조(Project Structure)\n\n```\nopen.etaxbill/\n├─ open.etaxbill.sln\n├─ INSTALL.md\n├─ LICENSE.md\n├─ README.md\n└─ src/\n\t ├─ certifier/                # 인증 유틸리티(WinForms)\n\t │  ├─ App.config\n\t │  ├─ etax.certifier.csproj\n\t │  ├─ Program.cs, MainForm.*\n\t │  ├─ dialogs/               # eTaxCreator, eTaxSigning 등 UI 폼\n\t │  └─ work-folder/           # certkey, output 샘플 등\n\t ├─ channel/                  # WCF 채널 라이브러리\n\t │  ├─ App.config             # 엔드포인트/바인딩 설정\n\t │  └─ etax.channel.csproj\n\t └─ library/                  # 공통 유틸(Engine Library)\n\t\t\t├─ app.config             # DB 연결 문자열\n\t\t\t└─ etax.library.csproj\n```\n\n솔루션에는 추가로 engine/collector, mailer, provider, reporter, responsor, signer 프로젝트가 포함됩니다. 이들은 ETAX 파이프라인 각각의 역할을 담당하며, 별도의 호스트 또는 인프라에서 운영하도록 설계되어 있습니다.\n\n## 사전 준비(Prerequisites)\n\n- Windows 10/11, Visual Studio 2019 또는 2022 (.NET Framework 4.7.2 개발자 팩)\n- Microsoft SQL Server (Express 이상)\n- 방화벽/포트 공유 설정(운영 환경에서 WCF 엔드포인트 사용 시)\n- 발급된 인증서 및 국세청/진흥원 공개키(필요 시 `src/certifier/work-folder/certkey` 활용)\n\n## 설정(Configuration)\n\n1) 데이터베이스 연결 문자열\n- 파일: `src/library/app.config`\n- 키: `OpenETaxBill.Engine.Library.Properties.Settings.ETAXConnectionString`\n- 예시(값은 환경에 맞게 변경):\n\n```\nData Source=YOUR_SQL_SERVER;Initial Catalog=ETAX;Persist Security Info=True;User ID=YOUR_ID;Password=YOUR_PASSWORD\n```\n\n2) WCF 엔드포인트(클라이언트)\n- 파일: `src/channel/App.config`\n- 각 endpoint의 address를 운영/테스트 환경 IP/도메인/포트에 맞게 수정하십시오. net.tcp 및 http 바인딩 모두 샘플이 포함되어 있습니다.\n\n3) Certifier 설정\n- 파일: `src/certifier/App.config`\n- `WcfCollectorUrl` 등 앱 설정 값을 환경에 맞게 지정하십시오.\n\n4) 포트/방화벽\n- 운영 시 Windows 방화벽 인바운드 규칙에 필요한 포트(예: 8080, 8453, 8461 등)를 오픈해야 할 수 있습니다.\n\n## 빌드(Build)\n\n1) 솔루션 열기: `open.etaxbill.sln`\n2) NuGet 패키지 복원 (Visual Studio 자동 복원 또는 솔루션 우클릭 → Restore)\n3) 구성/플랫폼 선택(예: Release|Any CPU)\n4) 전체 빌드\n\n빌드 후 PostBuild 이벤트가 결과물을 솔루션 하위 `output/.../\u003cConfigurationName\u003e` 경로로 복사합니다.\n\n## 실행(Run)\n\n- Certifier (WinForms): `OpenETaxBill.Certifier`를 시작하여 인증 절차(메뉴 순서)를 진행합니다.\n- Engine/Channel: 실제 운영에서는 각 엔진을 서비스/호스트에 배치하고, 채널 라이브러리로 호출합니다. 엔드포인트/포트, 방화벽, 인증서 등을 환경에 맞게 구성해야 합니다.\n\n## 의존성(Dependencies)\n\n- BouncyCastle, Mono.Security, Npgsql, SharpZipLib, OdinSdk.eTaxBill, OdinSdk.OdinLib, OdinSdk.FormLib 등\n- .NET Framework 4.7.2\n\n## 라이선스(License)\n\n본 프로젝트는 GPL-3.0-or-later로 배포됩니다. 자세한 내용은 `LICENSE.md`를 참고하세요.\n\n## 참고 링크(Links)\n\n- 전자세금계산서 인증(KISA): https://www.taxcerti.or.kr/etax/\n- GNU GPLv3: https://www.gnu.org/licenses/gpl-3.0.html\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fodinsoft-lab%2Fopen.etaxbill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fodinsoft-lab%2Fopen.etaxbill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fodinsoft-lab%2Fopen.etaxbill/lists"}