| 1. etax-java 세금계산서 국세청 연동 모듈은? |
| 2010년 1월 국세청 전자세금계산서 시행에 맞춰 전자세금계산서 업무를 처리할 수 있는 자바 서비스 애플리케이션 입니다. etax-java는 세금계산서 생성 / 전자서명 등의 작업을 클라이언트로부터 위임 받아 수행합니다. 단독 자바 애플리케이션으로 수행하여, 네트웍을 통해 받은 작업요청을 수행하고 결과를 클라이언트에 응답합니다. etax-java는 etax-java측에서 네트웍을 통하여 노출한 작업을 표준적인 방법을 이용하여 호출/응답을 수령하는 인터페이스를 제공하여, 애플리케이션 개발에 자바를 적용/이용하지않더라도 해당 환경(PHP, ASP...)만을 이용하여 전자세금계산서 업무를 처리할 수 있습니다. |
| 2. etax-java 전자세금계산서 업무구성 |
| 1) 세금계산서 XML을 데이터에 기반하여 생성 2) 세금계산서를 발행자의 인증서로 signing |
| 3. 연동방식 |
| 1) 접근방식은 HTTP/POST을 이용하여 요청 요청주소: http://${server-name}:${server-port}/invoke/ 요청주소 예제: http://127.0.0.1:18080/invoke/ 어떤 작업(method)을 어떤 인자(params)로 요청하는지 HTTP/POST 인자로서 전달 2) 내용표현방식: 작업요청시 인자(params) 및 작업결과값은 JSON으로 전달 POST form-field "params"으로 JSON으로 인코딩한 인자값을 전달 HTTP요청의 응답으로 자바 서버측에서 되돌린 HTTP Response Message Body Text은 JSON으로 인코딩한 결과값 3. PHP 연동 테스트 1) PHP에서는 HTTPClient Class를 이용하여 etax-java와 HTTP/POST 통신을 한다. 2) 내용표현방식을 위하여, PHP에 내장된 JSON(PHP 5.2 이상)을 사용하여 처리한다. |
| 4. etax-java 샘플 설명 및 테스트 하기 |
|
1) 파일 구성도 index.htm : etax-java 설명 step1.php : 세금계산서 XML 파일 생성 step2.php : 클라이언트 R Value 및 서명된 데이터 추출 step3.php : 서명된 XML 파일 생성 및 R value 파일 생성 file_download.php : 파일 다운로드 getSignedInfo.php : step2.php 와 연동되서 공인인증서 1024 와 2048 을 구분해서 서명값 추출 variables.htm : 세금계산서 입력 변수 설명 inc : 환경변수 및 함수 파일 디렉토리 HttpClient.class.php : HTTP(POST/GET) 통신 클래스 ServerCalls.php : 전자세금계산서 관련 함수 init.php : 환경 설정 변수 ToolKit : 인증서 툴킷 디렉토리 TSToolkitConfig.js : 인증서 툴킷 환경설정 JS TSToolkitObject.js : 인증서 툴킷 Object 지정 JS download : 인증서 툴킷 설치 파일 디렉토리 TSToolkit.cab : Object에서 지정한 Cabinet 파일 TSToolkit.exe : 인증서 클라이언트 수동 설치 파일 xmlFiles : 생성된 파일 저장 디렉토리. - XML, 서명된 XML, 패킹, 암호화, soap 메세지 등. 2) 샐픔 테스트 inc/init.php 파일을 에디터로 열어서, etax-java 셋팅에 맞춰서 환경변수 설정을 한다. step1.php 파일을 에디터로 열어서, variables.htm 세금계산서 입력 변수 설명을 참조하여 테스트할 세금계산서 정보를 입력한다. - 단위테스트 및 상호운용성 테스트를 위하여 적어도 세금계산서, 수정세금계산서 두개는 꼭 포함되어야 한다.(공급자는 동일한 업체로 처리) 위의 설정을 모두 처리하였다면, 테스트를 진행한다. step1.php을 실행하면, 위의 설정데로 세금계산서 XML 파일이 생성이 되고, 공급자의 사업자등록번호를 입력하고 하단의 [서명하기] 버튼을 클릭하면 step2.php 로 넘어간다. step2.php에서는 인증서 창이 뜨며, step1.php에서 입력한 사업자의 인증서로 인증을 하면, 클라이언트 R Value 및 서명된 데이터를 추출해 준다. 정상적으로 값이 추출이 되면, 하단의 [서명된 XML 만들기] 버튼을 클릭하면 step3.php로 넘어간다. step3.php에서는 이전에 넘겨받은 값으로 각각의 서명된 XML 파일, R value 파일, *****.tar.gz 생성이 되고, 여기에서 파일을 다운로드 받을 수 있으며 받은파일로 인증기관에서 검증받을 수 있다. ** 샘플 테스트 관련 프로그램할 내용은 각각의 파일 내부에 설명 및 주석으로 처리 되어 있으니, 프로그램 개발시 참조하면 된다. ** 위의 처리만으로 해당 서버의 인증을 처리할 수 있으니 설정을 잘 맞춰서 인증 먼저 받으셔도 됩니다. 3) etax-java 환경 설정 변수 수정 방법 ps -ef |grep etax 확인 후 kill 모듈 PID 로 etax-java 모듈을 종료한다 위와 같이 etax-java를 종료한 후 아래의 환경변수를 수정한다. 기본 경로 "etax-java/bin/com/popbill/etax/" etax-funcs.properties 파일 내용은 서명된 XML, Soap 통신에 사용된 임시 파일들의 저장 경로가 지정되어 있으며, 내용 샘플은 아래와 같다. -------------------------------------------------------------------- send-tax.generate.tmp1-filefmt=/usr/local/etax-java/tmp/soap-msg1-%s.xml send-tax.generate.tmp2-filefmt=/usr/local/etax-java/tmp/soap-msg2-%s.xml send-tax.send-request-result.tmp1-filefmt=/usr/local/etax-java/tmp/soap-msg-req-result1-%s.xml send-tax.send-request-result.tmp2-filefmt=/usr/local/etax-java/tmp/soap-msg-req-result2-%s.xml tax-invoice-package.sign-doc.tmp1-filefmt=/usr/local/etax-java/tmp/tax-invoice-signed-%s.xml tax-invoice-xml.set-signature.tmp1-filefmt=/usr/local/etax-java/tmp/tax-invoice-xml--set-signature-%s.xml -------------------------------------------------------------------- 파일명은 수정하지 말고, 경로만 수정한다.(예) /usr/local/etax-java/tmp/ => /temp/) |
| 4. 테스트하기 |
|
위의 설정 및 세금계산서 정보를 수정하였다면, 정보통신산업진흥원 표준전자세금계산서 인증 시스템에 접속하여, "단위기능별 검증", "상호운영성 검증"을 진행하면서 테스트를 진행하여 검증을 한다. |
| 5. 참조 |
|
1. 전자세금계산서 관련 표준 자료(정보통신산업진흥원 표준전자세금계산서 인증 시스템 > 게시판 > 자료실에서 다운로드) 위의 자료 중 개발지침서를 프로그램 개발시 꼭 참조한다. |