RESELLER-ERP-DTAX v1.0 Copyright 2009 HANGANG Systems, Inc. All rights reserved
개정이력 버전작성일변경내용작성자승인자 1.0 2012.12.26 최초작성개발팀 Copyright c 2012 HANGANG Systems, Inc. -i-
목 차 1. 개요... 1 2. 리셀러발행연동... 1 3. 회원사업자정보조회 / 등록... 2 3.1 등록가능사업자번호체크... 2 3.2 회원등록... 2 3.3 요청항목표... 3 3.4 응답코드... 4 4. 세금계산서정보전송... 5 4.1 단일건수등록요청... 5 4.2 대량등록요청... 5 4.3 요청항목표... 6 4.4 응답형식... 8 5. 작업창연동... 9 6. 국세청결과연동... 9 Copyright c 2012 HANGANG Systems, Inc. -ii-
1. 개요 회원들은디텍스에로그인하여발행대기함에서승인요청단계를거쳐승인된문서만발행을하거나승인요청단계없이즉시발행이가능합니다. 발행된전자세금계산서는암호화등을거쳐국세청에배치로전송합니다. 전송다음날국세청으로부터처리된결과를수신받습니다. 수신된결과는계정별, 날자별파일을만들어해당디렉토리에생성합니다. ERP 업체는 DTAX( 디텍스 )FTP 서버로로그인하여해당파일을다운로드받아전자세금계산서의결과값을 ERP 에반영합니다. 오류가발생한전자세금계산서는오류를확인하고수정한후새로운문서번호로다시발행합니다. 2. 리셀러발행연동 회원사업자정보체크 / 등록 (3. 회원사업자정보조회 / 등록참조 ) 세금계산서정보전송 (4. 세금계산서정보전송참조 ) 제공하는작업창팝업후회원전자서명 (5. 작업창연동참조 ) 국세청결과코드 ftp 다운후 ERP 시스템반영 (6. 국세청결과적용참조 ) Copyright c 2012 HANGANG Systems, Inc. -1-
3. 회원사업자정보조회 / 등록 3.1 등록가능사업자번호체크 항목 내용 통신규약 TCP/IP HTTP 프로토콜 TEST: https://rsr-test.dtax.co.kr/api/ URL REAL: https://rsr.dtax.co.kr/api/ Method GET/POST 요청 rsrid= 리셀러아이디 &apikey= 발급키 &comm=chk&uid= 회원아이디 ®number= 사업자번호 <?xml version="1.0" encoding="utf-8"?> <response> <rsrid> 리셀러아이디 </rsrid> <command>chk</command> <rescode>200</rescode> 예제 <resdata> <uid> 회원아이디 </uid> <regnumber> 사업자번호 </regnumber> </resdata> </response> -응답코드 200 = 등록가능, 210 = 중복된사업자번호존재 ( 등록불가 ) 3.2 회원등록 항목 내용 통신규약 URL Method 요청예제 TCP/IP HTTP 프로토콜 TEST: https://rsr-test.dtax.co.kr/api/ REAL: https://rsr.dtax.co.kr/api/ GET/POST rsrid= 리셀러아이디 &apikey= 발급키 &comm=reg®number= 사업자번호 &uid= 유저아이디 &c omname= 업체명 &ceoname= 대표자이름 &postzip= 우편번호 &address= 주소 &type= 업태 &classi fication= 종목 &personname= 관리자명 &email= 관리자이메일 &telephone= 관리자전화번호 &mo bilephone= 관리자핸드폰 <?xml version="1.0" encoding="utf-8"?> <response> Copyright c 2012 HANGANG Systems, Inc. -2-
<rsrid> 리셀러아이디 </rsrid> <command>reg</command> <rescode>200</rescode> <resdata> <uid> 회원아이디 </uid> <regnumber> 사업자번호 </regnumber> <authinfo> 회원인증키 </authinfo> </resdata> </response> - 등록성공시받은 authinfo 는작업전용창로그인시인증키역할을하오니따로관리 하셔야합니다. ( 길이 32byte) 3.3 요청항목표 분류 parameter 정의유형길이 Occurs 비고 시스템정보공급자정보 rsrid 리셀러아이디 S 12 1..1 apikey api 인증키 (Dtax 발급 ) S 32 1..1 comm. 작업분류 S 3 1..1 chk, reg encoding 한글인코딩 S 6 0..1 euc-kr, utf-8 uid 공급자회원아이디 S 12 1..1 리셀러회원아이디 regnumber 공급자사업자등록번호 N 10 1..1 nnnnnnnnnn ( - 미포함 ) comname 공급업체사업체명 S 70 1..1 ceoname 공급업체대표자명 S 30 1..1 postzip 공급업체우편번호 S 7 1..1 address 공급업체의주소 S 150 0..1 type 공급업체의업태 S 40 0..1 classification 공급업체의업종 S 40 0..1 department 공급업체담당부서 S 40 0..1 personname 공급업체담당자명 S 30 1..1 telephone 공급업체담당자전화번호 S 20 0..1 mobilephone 핸드폰번호 S 20 0..1 email 공급업체담당자이메일 S 40 1..1 Copyright c 2012 HANGANG Systems, Inc. -3-
3.4 응답코드 rescode 정의 200 성공 210 사업자번호중복 211 아이디중복 504 필수항목누락 505 길이초과 530 리셀러인증실패 541 특수문자오류 555 사업자번호오류 999 Dtax 시스템오류 Copyright c 2012 HANGANG Systems, Inc. -4-
4. 세금계산서정보전송 4.1 단일건수등록요청 항목 내용 통신규약 URL Method Spec. 예제 TCP/IP HTTP 프로토콜 TEST: http://dev.dtax.co.kr/erp/inserttaxdata.php REAL: http://www.dtax.co.kr/erp/inserttaxdata.php POST Param=value rsrid=dtax&etsid=kcntax&etsseq=kcntax_20091102_000001®number=2036765639&co MTYPE=1&TAXREGID=&COMNAME= 한강시스템 &CEONAME= 홍길동 &POSTZIP=123-432&ADDRESS= 서울동작구신대방 &CONDITIONS= 제조 &ITEMS= 소프트웨어 &ADMNAME= 홍길동 &ADMDEPT= 인터넷사업부 &ADMMAIL=emyoo@hangang.com&ADMOTEL=022222222&ADMMTEL=0102222222&AD MFTEL=022222222®DT=20091030&DOCKIND=1&TAXTYPE=1&ISSUETYPE=0&AMENDCO DE=&PAYCASH=&PAYCHECK=&PAYNOTE=&PAYUNCOLLETED=&MEMO=&DOCTEXT=&UNI TITEM[]=10 월분내역 &STANDARD[]=&COUNT[]=&UNITCOST[]=&SUPPLYPRICE[]=10000&TAX PRICE[]=1000&UNITBIGO[]=&SPECITEM[]=VOD&SPECSUPPLY[]=10000&SPECTAX[]=1000 4.2 대량등록요청 항목통신규약 URL Method Spec. 예제 내용 TCP/IP HTTP 프로토콜 TEST: http://dev.dtax.co.kr/erp/insertmasstaxdata.php REAL: http://www.dtax.co.kr/erp/insertmasstaxdata.php POST, File Upload rsrid= 리셀러아이디 &etsid= 회원아이디 &attachfile=etsid_yyyymmdd_nnnn.txt rsrid=dtax&etsid=kcntax&attachfile=kcntax_20091102_0001.txt 항목형식예제 항목구분자 라인구분자 \r\n Copyright c 2012 HANGANG Systems, Inc. -5-
Spec. etsseq REGNUMBER COMTYPE TAXREGID COMNAME CEONAME POSTZIP ADDRESS CONDITIONS ITEMS ADMNAME ADMDEPT ADMMAIL ADMOTEL ADMMTEL ADMFTEL REGDT DOCKIND TAXTYPE ISSUETYPE AMENDCODE PAYCASH PAYCHECK PAYNOTE PAYUNCOLLETED MEMO DOCTEXT UNITITEM1 STANDARD1 COUNT1 UNITCOST1 SUPPLYPRICE1 TAXPRICE1 UNITBIGO1 UNITITEM2 STANDARD2 COUNT2 UNITCOST2 SUPPLYPRICE2 TAXPRICE2 UNITBIGO2 UNITITEM3 STANDARD3 COUNT3 UNITCOST3 SUPPLYPRICE3 TAXPRICE3 UNITBIGO3 UNITITEM4 STANDARD4 COUNT4 UNITCOST4 SUPPLYPRICE4 TAXPRICE4 UNITBIGO4 SPECITEM SPECSUPPLY SPECTAX\r\n kcntax_20091102_000001 1208157465 1 한강시스템 홍길동 123-456 서울동작구신대방 제조 소프트웨어 홍길동 인터넷사업부 emyoo@hangang.com 022222222 01022222222 20091030 1 1 0 0 0 0 0 10 월분내역 10000 1000 \r\n 4.3 요청항목표 parameter 설명 유형 길이 Occurs 비고 rsrid 리셀러아이디 S 10 1..1 리셀러사업자아이디 etsid 리셀러회원아이디 S 10 1..1 리셀러사업자의회원아이디 etsseq 유니크한세금계산서키값세금계산서 S 26 1..1 etsid_yyyymmdd_nnnnnn 관리번호 ex) kcntax_20091102_000001 REGNUMBER 거래처등록번호 N 13 1..1 사업자번호, 주민등록번호 (- 제외 ) COMTYPE 거래처구분 N 1 1..1 1: 사업자, 2: 개인, 3: 외국인 TAXREGID 종사업자코드 N 4 0..1 사업자단위과세제도에따라국세청에서부여한코드 COMNAME 상호 S 50 1..1 Copyright c 2012 HANGANG Systems, Inc. -6-
CEONAME 대표자명 S 30 0..1 POSTZIP 우편번호 S 7 0..1 ex) 139-209 ADDRESS 주소 S 100 0..1 CONDITIONS 업태 S 40 0..1 ITEMS 업종 S 40 0..1 ADMNAME 담당자명 S 30 1..1 담당자가따로존재하지않을시상호입력 ADMDEPT 담당자부서명 S 40 0..1 ADMMAIL 담당자이메일 S 40 0..1 ADMOTEL 담당자전화번호 S 18 0..1 ADMMTEL 담당자휴대폰번호 S 18 0..1 ADMFTEL 담당자팩스번호 S 18 0..1 REGDT 작성일 N 8 1..1 DOCKIND 문서종류 N 1 1..1 1: 세금계산서, 2: 수정세금계산서, 3: 계산서, 4: 수정계산서 TAXTYPE 과세구분 N 1 1..1 1: 일반, 2: 영세 ISSUETYPE 발행구분 N 1 1..1 0: 청구, 1: 영수 AMENDCODE 수정사유코드 N 1 0..1 1 : 기재사항의착오 정정, 2 : 공급가액변동, 3 : 환입, 4 : 계약의해제, 5 : 내국신용장사후개설 PAYCASH 현금결제금액 N 18 0..1 PAYCHECK 수표결제금액 N 18 0..1 PAYNOTE 어음결제금액 N 18 0..1 PAYUNCOLLETED 외상금액 N 18 0..1 MEMO 비고 S 150 0..1 DOCTEXT 매입처알림메세지 S 2000 0..1 매입처담당자에게보내는메시지 (ex. 가상계좌번호..) UNITITEM[] 품목 S 100 1..1 STANDARD[] 규격 S 10 0..1 COUNT[] 수량 N 10 0..1 최소한품목은반드시존재해야하며, UNITCOST[] 단가 N 11 0..1 총 4 개의품목까지허용함 SUPPLYPRICE[] 공급가액 N 11 1..1 TAXPRICE[] 세액 N 10 1..1 UNITBIGO[] 품목비고 S 300 0..1 SPECITEM[] 품목 S 100 0..1 거래명세서추가시입력하며품목수 SPECSUPPLY[] 공급가액 N 11 0..1 만큼반복가능함 SPECTAX[] 세액 N 10 0..1 Copyright c 2012 HANGANG Systems, Inc. -7-
4.4 응답형식 항목형식예제 항목구분자 라인구분자 \r\n trancode\r\n etsseq 에러코드 에러메세지 \r\n etsseq 에러코드 에러메세지 \r\n Spec. etsseq 에러코드 에러메세지 200\r\n kcntax_20091102_000001 1210 세금계산서발급정보누락 \r\n kcntax_20091102_000002 2211 문서종류유효성오류 \r\n kcntax_20091102_000003 2221 공급가액 / 세액오류 trancode 설명 비고 200 정상처리 서버정상처리 201 파일누락 첨부파일누락처리 210 etsid 누락 etsid 누락 211 파라미터누락 개별등록시파라미터누락 501 미등록 etsid dtax 에등록되지않은 etsid 520 txt 형식이아닌파일 txt 형식이아닌파일첨부시 999 서버오류 DB connect 오류등서버처리오류 대분류 설명 중분류 설명 CODE 설명 0 관리정보 1020 etsseq 정보누락 1000 필수값누락 1110 사업자정보누락 100 사업자정보 1120 담당자정보누락세금계산서 1210 세금계산서발급정보누락 200 발급정보 1220 세금계산서품목정보누락 300 거래명세서정보 1310 거래명세서정보누락 0 관리정보 2020 etsseq 유효성오류 2021 etsseq 중복등록 2111 거래처등록번호유효성오류 100 사업자정보 2112 거래처구분유효성오류 2000 유효성오류 2211 문서종류유효성오류 200 세금계산서 2212 과세구분유효성오류발급정보 2213 발행구분유효성오류 2214 수정세금계산서유효성오류 Copyright c 2012 HANGANG Systems, Inc. -8-
2221 공급가액 / 세액오류 300 거래명세서정보 2311 공급가액 / 세액오류 500 금액비교 2501 세금계산서, 거래명세전체금액불일치 5. 작업창연동 http://rsr.dtax.co.kr/login/?rsrid= 리셀러아이디 &uid= 리셀러회원아이디 &authinfo= 회원인증키 &etsseq= 세금계산서키 (etsseq) 6. 국세청결과연동 국세청처리결과를디텍스 FTP 서버에날짜별파일로생성합니다. DTAX( 디텍스 ) FTP 서버로로그인하여국세청처리결과파일을다운로드합니다. 해당문서번호에결과값을반영하면국세청처리결과를 ERP 에서확인할수있습니다. 항목통신규약계정 Method Filename. 예제 내용 FTP 프로토콜 TEST : 테스트에서는국세청으로전송되지않으므로제공되지않습니다. REAL: 추후제공 FTP File Download ftp_rsrid_yyyymmdd_nnnn.txt ftp_kcntax_20091102_0001.txt 항목 형식 예제 항목구분자 라인구분자 \r\n etsseq 국세청전송일시분초 코드값 코드값정의 국세청승인번호 (24 자리 )\r\n Spec etsseq 국세청전송일시분초 코드값 코드값정의 국세청승인번호 (24 자리 )\r\n. etsseq 국세청전송일시분초 코드값 코드값정의 국세청승인번호 (24 자리 ) kcntax_20091102_000001 20110610160303 SUC001 성공 201106144100000400338829 예제 kcntax_20091102_000002 20110610160303 ERR002 공급받는 ( 사업 ) 자사업자번호오류 2011061441 00000400338829 kcntax_20091102_000003 20110610160303 ERR004 전송일시오류 201106144100000400338829 Copyright c 2012 HANGANG Systems, Inc. -9-
Copyright c 2012 HANGANG Systems, Inc. -10-