SmartBill Open API Service REST API Reference - javascript - [ Digital Tax Invoice ] ( 주 ) 비즈니스온커뮤니케이션연구소개발팀 1

Transcription

1 SmartBill Open API Service REST API Reference - javascript - [ Digital Tax Invoice ] ( 주 ) 비즈니스온커뮤니케이션연구소개발팀 1

2 개정이력 날짜 내용 수신업체 SystemID 입력파라미터추가 (DTI_SAVE, ARISSUE, DETAILARISSUE) 삼성전자 Rvalue 관련주의사항추가 (ARISSUE, DETAILARISSUE, RARISSUE) 거래명세서관련주석소스수정 플랫폼코드입력파라미터추가 (ARISSUE, DETAILARISSUE) 허브사업자를분류하기위한코드 플랫폼코드설명수정 (B2B도입모델 ) 인증서등록정보조회기능추가 원본 (XML) 조회기능추가 건별상세조회 (DTI_STATUS) 함수에조회항목추가 수정세금계산서여부, 수탁자회사명, 수탁자사업자번호, 위수탁여부, 공급받는자회사명, 공급받는자 사업자번호, 공급받는자유형 ( 회원 / 비회원 / 개인 ), 공급자회사명, 공급자사업자번호, 정 / 역구분, 세 금계산서유형 ( 과세 / 면세 ), 거래명세서포함여부, 매출 / 매입여부, 영수 / 청구구분, 공급자이메일, 공 급받는자이메일, 수탁자이메일 미리보기양식조회에거래명세서추가 ( 과세, 면세, 위수탁과세, 위수탁면세 ) 2

3 목차 1. RequestModel 정의및설명 RequestModel 프로세스별예시 세금계산서발행 세금계산서저장 세금계산서역발행요청 세금계산서역발행 거래명세서발행 거래명세서역발행요청 거래명세서역발행 세금계산서상태변경 메일재전송 국세청전송요청 세금계산서상태조회 부가정보조회 메일수신결과조회 미리보기양식조회 보관함조회 미처리함조회 건별상세조회 건별상세이력조회 회원가입결과조회 세금계산서발행결과조회 인증토큰발급 공인인증서등록정보조회 원본 (XML) 조회

4 1. RequestModel 정의및설명 1.1 RequestModel Param Name Param ID Description 메시지ID MessageId GUID( 전역고유식별자 ) 생성값 요청시그널 Signal 처리할작업에대한구분값 요청시간 RequestTime 처리할작업의요청시간 ( 포맷 : YYYYMMDDHH24MISS) 송신사업자번호 SendComRegno 요청하는사업장의사업자번호 수신사업자번호 ReceiveComRegno 요청받는사업장의사업자번호 인증토큰 AuthToken 스마트빌의 API를이용하기위한스마트빌에서인증받은코드 서비스코드 ServiceCode 스마트빌의서비스구분값 시스템타입 SystemType 스마트빌의인터페이스시스템구분값 참조번호 ConversationId 스마트빌의전자세금계산서의개별 Id SMTP이메일 SMTP 유통용이메일주소 ( 옵션 ) RValue RValue 인증서의신원확인값 인증서비밀번호 CertPassword 인증서의비밀번호 서명원본 XML SignedXML 인증서의서명정보가있는세금계산서원본 xml 미서명원본 XML UnSignedXML 세금계산서원본 xml(xml형식은 [4. KEC 표준전자세금계산서 v3.0 항목표.xls] 참조 ) 인증코드 AuthCode 인증토큰발급에필요한사전코드 스마트빌아이디 SbId 스마트빌포탈에서사용되는아이디 유효기간설정코드 ExpirationDateCode 인증토큰의유효기간설정을위한코드 인증토큰만료일 ExpirationDate 인증토큰의유효기간만료일 검색시작일자 SearchFromDate 검색할시작일자 검색종료일자 SearchToDate 검색할종료일자 검색사업자번호 SearchComRegno 검색할사업자번호 이메일 이메일주소 ( 문자열배열 ) 조회타입코드 SearchTypeCode 조회를위한구분코드 보관함종류코드 RepoTypeCode 보관함구분코드 미처리함종류코드 ListTypeCode 미처리함구분코드 상태시그널 StatusSignal 세금계산서상태별구분값 상태변경사유 StatusReason 세금계산서상태변경에대한사유 휴대전화번호 Phone 휴대전화번호 승인번호 IssueId 24자리의승인번호 ( 문자열배열 ) 프로세스코드 ProcessCode 프로세스에필요한코드 ( 타ASP XML업로드시등록 : 0, 삭제 : 1) 수신시스템ID SystemId 수신자의시스템구분값 (ex. 삼성전자 ) 플랫폼코드 PlatformCode B2B 모델일경우 허브업체사업자번호 (OpenAPI 도입모델설명서참고 ) 4

5 2. 프로세스별예시 2.1 세금계산서발행 매출세금계산서를발행한다. 요청시그널 / 서비스코드 / 시스템타입은고정값을사용한다 Request 메시지ID MessageId String 트랜잭션식별자 요청시그널 Signal String(30) 고정값 : ARISSUE 요청시간 RequestTime String(14) YYYYMMDDHH24MISS 송신사업자번호 SendComRegno String (13) 공급자사업자번호 수신사업자번호 ReceiveComRegno String (13) 공급받는자사업자번호 인증토큰 AuthToken String(40) 서비스코드 ServiceCode String(10) 고정값 : DTI 시스템타입 SystemType String(10) 고정값 : OAPI 참조번호 ConversationId String[] 스마트빌식별자 (35자리) SMTP이메일 SMTP String(20) 유통용이메일주소 ( 옵션 ) RValue RValue String 신원확인값 ( 서명모듈이용해서발행할경우에만필요 ) 인증서비밀번호 CertPassword String 암호화된인증서의비밀번호 서명원본 XML SignedXML String 서명정보가있는세금계산서원본 xml (xml형식은 [4. KEC 표준전자세금계산서 v3.0 항목표.xls] 참조 ) 수신시스템ID SystemId String 수신업체의 SystemID 입력 (ex. 삼성전자 ) 플랫폼코드 PlatformCode String 허브업체의사업자번호 (B2B모델일경우에만필요 ) 5

6 2.1.2 Request Sample var arrconvid = new Array(); arrconvid[0] = ' '; var request = JSON.stringify({ 'MessageId': '3267cab1-3ea6-4aa6-b988-7d27d6d5ac89', 'Signal': 'ARISSUE', 'RequestTime': ' ', 'SendComRegno': ' ', 'ReceiveComRegno': ' ', 'AuthToken': 'dxvcce96zvlxvhbpeklgcithqlercmroyjheedfxyi8rvxjmvmzpqk1ltt0k', 'ServiceCode': 'DTI', 'SystemType': 'OAPI', 'ConversationId': arrconvid, 'SMTP ': '', 'RValue': 'lsh2winygvm7lhfusp6ptczlbty=', // 서명모듈이용해서발행할경우에만필요 'CertPassword': ' Ygvm7lhfuSp6p', // 암호화된인증서의비밀번호 'SystemId': '', 'PlatformCode': '', 'SignedXML': ''// 서명정보가있는세금계산서 xml); $.support.cors = true; $.ajax({ type: "POST", datatype: "json", crossdomain: true, contenttype: "application/json", url: " data: request, success: function (data) { fngetdata(data); //data 처리 ( 하단의 Response Sample 참조 ), error: function (error) { //error 처리 ); 6

7 2.1.3 Response 메시지ID MessageId String 요청한트랜잭션식별자 요청시그널 Signal String(30) 고정값 : ARISSUE 참조번호 ConversationId String(35) 요청한스마트빌식별자 응답시간 ResponseTime String(14) YYYYMMDDHH24MISS 처리코드 ResultCode String(5) 처리결과코드 처리메시지 ResultMessage String(2000) 처리결과상세내역 Response Sample function fngetdata(data){ if ("30000"!= data.resultcode) { alert(data.resultmessage); alert(" 정상적으로처리되었습니다."); 7

8 2.2 세금계산서저장 발행예정인매출세금계산서를요청한다. 요청시그널 / 서비스코드 / 시스템타입은고정값을사용한다 Request 메시지ID MessageId String 트랜잭션식별자 요청시그널 Signal String(30) 고정값 : DTI_SAVE 요청시간 RequestTime String(14) YYYYMMDDHH24MISS 송신사업자번호 SendComRegno String (13) 공급자사업자번호 수신사업자번호 ReceiveComRegno String (13) 공급받는자사업자번호 인증토큰 AuthToken String(40) 서비스코드 ServiceCode String(10) 고정값 : DTI 시스템타입 SystemType String(10) 고정값 : OAPI 참조번호 ConversationId String[] 스마트빌식별자 (35자리) 미서명원본 XML UnSignedXML String 서명정보가없는세금계산서원본 xml (xml형식은 [4. KEC 표준전자세금계산서 v3.0 항목표.xls] 참조 ) 수신시스템ID SystemId String 수신업체의 SystemID 입력 (ex. 삼성전자 ) Request Sample var arrconvid = new Array(); arrconvid[0] = ' '; var request = JSON.stringify({ 'MessageId': '3267cab1-3ea6-4aa6-b988-7d27d6d5ac89', 'Signal': 'DTI_SAVE', 'RequestTime': ' ', 'SendComRegno': ' ', 'ReceiveComRegno': ' ', 'AuthToken': 'dxvcce96zvlxvhbpeklgcithqlercmroyjheedfxyi8rvxjmvmzpqk1ltt0k', 'ServiceCode': 'DTI', 'SystemType': 'OAPI', 'ConversationId': arrconvid, 'SystemId': '', 'UnSignedXML': ''// 서명정보가없는세금계산서 xml ); $.support.cors = true; $.ajax({ type: "POST", datatype: "json", crossdomain: true, contenttype: "application/json", url: " data: request, success: function (data) { fngetdata(data); //data 처리 ( 하단의 Response Sample 참조 ), error: function (error) { //error 처리 ); 8

9 2.2.3 Response 메시지ID MessageId String 요청한트랜잭션식별자 요청시그널 Signal String(30) 고정값 : DTI_SAVE 참조번호 ConversationId String(35) 요청한스마트빌식별자 응답시간 ResponseTime String(14) YYYYMMDDHH24MISS 처리코드 ResultCode String(5) 처리결과코드 처리메시지 ResultMessage String(2000) 처리결과상세내역 Response Sample function fngetdata(data){ if ("30000"!= data.resultcode) { alert(data.resultmessage); alert(" 정상적으로처리되었습니다."); 9

10 2.3 세금계산서역발행요청 매입세금계산서를요청한다. 요청시그널 / 서비스코드 / 시스템타입은고정값을사용한다 Request 메시지ID MessageId String 트랜잭션식별자 요청시그널 Signal String(30) 고정값 : RARREQUEST 요청시간 RequestTime String(14) YYYYMMDDHH24MISS 송신사업자번호 SendComRegno String (13) 공급받는자사업자번호 수신사업자번호 ReceiveComRegno String (13) 공급자사업자번호 인증토큰 AuthToken String(40) 서비스코드 ServiceCode String(10) 고정값 : DTI 시스템타입 SystemType String(10) 고정값 : OAPI 참조번호 ConversationId String[] 스마트빌식별자 (35자리) 미서명원본 XML UnSignedXML String 서명정보가없는세금계산서원본 xml (xml형식은 [4. KEC 표준전자세금계산서 v3.0 항목표.xls] 참조 ) Request Sample var arrconvid = new Array(); arrconvid[0] = ' '; var request = JSON.stringify({ 'MessageId': '3267cab1-3ea6-4aa6-b988-7d27d6d5ac89', 'Signal': 'RARREQUEST', 'RequestTime': ' ', 'SendComRegno': ' ', 'ReceiveComRegno': ' ', 'AuthToken': 'dxvcce96zvlxvhbpeklgcithqlercmroyjheedfxyi8rvxjmvmzpqk1ltt0k', 'ServiceCode': 'DTI', 'SystemType': 'OAPI', 'ConversationId': arrconvid, 'UnSignedXML': ''// 서명정보가없는세금계산서 xml ); $.support.cors = true; $.ajax({ type: "POST", datatype: "json", crossdomain: true, contenttype: "application/json", url: " data: request, success: function (data) { fngetdata(data); //data 처리 ( 하단의 Response Sample 참조 ), error: function (error) { //error 처리 ); 10

11 2.3.3 Response 메시지ID MessageId String 요청한트랜잭션식별자 요청시그널 Signal String(30) 고정값 : RARREQUEST 참조번호 ConversationId String(35) 요청한스마트빌식별자 응답시간 ResponseTime String(14) YYYYMMDDHH24MISS 처리코드 ResultCode String(5) 처리결과코드 처리메시지 ResultMessage String(2000) 처리결과상세내역 Response Sample function fngetdata(data){ if ("30000"!= data.resultcode) { alert(data.resultmessage); alert(" 정상적으로처리되었습니다."); 11

12 2.4 세금계산서역발행 발행요청된매출세금계산서를발행한다. 요청시그널 / 서비스코드 / 시스템타입은고정값을사용한다 Request 메시지 ID MessageId String 트랜잭션식별자 요청시그널 Signal String(30) 고정값 : RARISSUE 요청시간 RequestTime String(14) YYYYMMDDHH24MISS 송신사업자번호 SendComRegno String (13) 공급자사업자번호 수신사업자번호 ReceiveComRegno String (13) 공급받는자사업자번호 인증토큰 AuthToken String(40) 서비스코드 ServiceCode String(10) 고정값 : DTI 시스템타입 SystemType String(10) 고정값 : OAPI 참조번호 ConversationId String[] 스마트빌식별자 (35 자리 ) SMTP 이메일 SMTP String(20) 유통용이메일주소 ( 옵션 ) RValue RValue String 신원확인값 ( 서명모듈이용해서발행할경우에만필요 ) 인증서비밀번호 CertPassword String 암호화된인증서의비밀번호 서명원본 XML SignedXML String 서명정보가있는세금계산서원본 xml Request Sample (xml 형식은 [4. KEC 표준전자세금계산서 v3.0 항목표.xls] 참조 ) var arrconvid = new Array(); arrconvid[0] = ' '; var request = JSON.stringify({ 'MessageId': '3267cab1-3ea6-4aa6-b988-7d27d6d5ac89', 'Signal': 'RARISSUE', 'RequestTime': ' ', 'SendComRegno': ' ', 'ReceiveComRegno': ' ', 'AuthToken': 'dxvcce96zvlxvhbpeklgcithqlercmroyjheedfxyi8rvxjmvmzpqk1ltt0k', 'ServiceCode': 'DTI', 'SystemType': 'OAPI', 'ConversationId': arrconvid, 'SMTP ': '', 'RValue': 'lsh2winygvm7lhfusp6ptczlbty=', // 서명모듈이용해서발행할경우에만필요 'CertPassword': sdfsd345fsdf55faadfs, // 암호화된인증서의비밀번호 'SignedXML': ''// 서명정보가있는세금계산서 xml ); $.support.cors = true; $.ajax({ type: "POST", datatype: "json", crossdomain: true, contenttype: "application/json", url: " data: request, success: function (data) { fngetdata(data); //data 처리 ( 하단의 Response Sample 참조 ), error: function (error) { //error 처리 12

13 2.4.3 Response 메시지ID MessageId String 요청한트랜잭션식별자 요청시그널 Signal String(30) 고정값 : RARISSUE 참조번호 ConversationId String(35) 요청한스마트빌식별자 응답시간 ResponseTime String(14) YYYYMMDDHH24MISS 처리코드 ResultCode String(5) 처리결과코드 처리메시지 ResultMessage String(2000) 처리결과상세내역 Response Sample function fngetdata(data){ if ("30000"!= data.resultcode) { alert(data.resultmessage); alert(" 정상적으로처리되었습니다."); 13

14 2.5 거래명세서발행 매출거래명세서 ( 세금계산서 + 거래명세서 ) 를발행한다. 요청시그널 / 서비스코드 / 시스템타입은고정값을사용한다 Request 메시지ID MessageId String 트랜잭션식별자 요청시그널 Signal String(30) 고정값 : DETAILARISSUE 요청시간 RequestTime String(14) YYYYMMDDHH24MISS 송신사업자번호 SendComRegno String (13) 공급자사업자번호 수신사업자번호 ReceiveComRegno String (13) 공급받는자사업자번호 인증토큰 AuthToken String(40) 서비스코드 ServiceCode String(10) 고정값 : DTI 시스템타입 SystemType String(10) 고정값 : OAPI 참조번호 ConversationId String[] 스마트빌식별자 (35자리) SMTP이메일 SMTP String(20) 유통용이메일주소 ( 옵션 ) RValue RValue String 신원확인값 ( 서명모듈이용해서발행할경우에만필요 ) 인증서비밀번호 CertPassword String 암호화된인증서의비밀번호 서명원본 XML SignedXML String 서명정보가있는세금계산서원본 xml 미서명원본 XML UnSignedXML String 서명정보가없는거래명세서원본 xml 수신시스템ID SystemId String 수신업체의 SystemID 입력 (ex. 삼성전자 ) 플랫폼코드 PlatformCode String 허브업체의사업자번호 (B2B모델일경우에만필요 ) 14

15 2.5.2 Request Sample var arrconvid = new Array(); arrconvid[0] = ' '; var request = JSON.stringify({ 'MessageId': '3267cab1-3ea6-4aa6-b988-7d27d6d5ac89', 'Signal': 'DETAILARISSUE', 'RequestTime': ' ', 'SendComRegno': ' ', 'ReceiveComRegno': ' ', 'AuthToken': 'dxvcce96zvlxvhbpeklgcithqlercmroyjheedfxyi8rvxjmvmzpqk1ltt0k', 'ServiceCode': 'DTI', 'SystemType': 'OAPI', 'ConversationId': arrconvid, 'SMTP ': '', 'RValue': 'lsh2winygvm7lhfusp6ptczlbty=', // 서명모듈이용해서발행할경우에만필요 'CertPassword': 'sdfsd345fsdf55faadfs', // 암호화된인증서의비밀번호 'SystemId': '', 'PlatformCode': '', 'SignedXML': ''// 서명정보가있는세금계산서 xml 'UnSignedXML': ''// 서명정보가없는거래명세서 xml); $.support.cors = true; $.ajax({ type: "POST", datatype: "json", crossdomain: true, contenttype: "application/json", url: " data: request, success: function (data) { fngetdata(data); //data 처리 ( 하단의 Response Sample 참조 ), error: function (error) { //error 처리 ); 15

16 2.5.3 Response 메시지ID MessageId String 요청한트랜잭션식별자 요청시그널 Signal String(30) 고정값 : DETAILARISSUE 참조번호 ConversationId String(35) 요청한스마트빌식별자 응답시간 ResponseTime String(14) YYYYMMDDHH24MISS 처리코드 ResultCode String(5) 처리결과코드 처리메시지 ResultMessage String(2000) 처리결과상세내역 Response Sample function fngetdata(data){ if ("30000"!= data.resultcode) { alert(data.resultmessage); alert(" 정상적으로처리되었습니다."); 16

17 2.6 거래명세서역발행요청 매입거래명세서 ( 세금계산서 + 거래명세서 ) 를요청한다. 요청시그널 / 서비스코드 / 시스템타입은고정값을사용한다 Request 메시지ID MessageId String 트랜잭션식별자 요청시그널 Signal String(30) 고정값 : RDETAILREQUEST 요청시간 RequestTime String(14) YYYYMMDDHH24MISS 송신사업자번호 SendComRegno String (13) 공급받는자사업자번호 수신사업자번호 ReceiveComRegno String (13) 공급자사업자번호 인증토큰 AuthToken String(40) 서비스코드 ServiceCode String(10) 고정값 : DTI 시스템타입 SystemType String(10) 고정값 : OAPI 참조번호 ConversationId String[] 스마트빌식별자 (35자리) 서명원본 XML SignedXML String 서명정보가없는세금계산서원본 xml 미서명원본 XML UnSignedXML String 서명정보가없는거래명세서원본 xml Request Sample var arrconvid = new Array(); arrconvid[0] = ' '; var request = JSON.stringify({ 'MessageId': '3267cab1-3ea6-4aa6-b988-7d27d6d5ac89', 'Signal': 'RDETAILREQUEST', 'RequestTime': ' ', 'SendComRegno': ' ', 'ReceiveComRegno': ' ', 'AuthToken': 'dxvcce96zvlxvhbpeklgcithqlercmroyjheedfxyi8rvxjmvmzpqk1ltt0k', 'ServiceCode': 'DTI', 'SystemType': 'OAPI', 'ConversationId': arrconvid, 'SignedXML': ''// 서명정보가있는세금계산서 xml 'UnSignedXML': ''// 서명정보가없는거래명세세서 xml); $.support.cors = true; $.ajax({ type: "POST", datatype: "json", crossdomain: true, contenttype: "application/json", url: " data: request, success: function (data) { fngetdata(data); //data 처리 ( 하단의 Response Sample 참조 ), error: function (error) { //error 처리 ); 17

18 2.6.3 Response 메시지ID MessageId String 요청한트랜잭션식별자 요청시그널 Signal String(30) 고정값 : RDETAILREQUEST 참조번호 ConversationId String(35) 요청한스마트빌식별자 응답시간 ResponseTime String(14) YYYYMMDDHH24MISS 처리코드 ResultCode String(5) 처리결과코드 처리메시지 ResultMessage String(2000) 처리결과상세내역 Response Sample function fngetdata(data){ if ("30000"!= data.resultcode) { alert(data.resultmessage); alert(" 정상적으로처리되었습니다."); 18

19 2.7 거래명세서역발행 발행요청된매출거래명세서 ( 세금계산서 + 거래명세서 ) 를발행한다. 요청시그널 / 서비스코드 / 시스템타입은고정값을사용한다 Request 메시지 ID MessageId String 트랜잭션식별자 요청시그널 Signal String(30) 고정값 : RDETAILISSUE 요청시간 RequestTime String(14) YYYYMMDDHH24MISS 송신사업자번호 SendComRegno String (13) 공급자사업자번호 수신사업자번호 ReceiveComRegno String (13) 공급받는자사업자번호 인증토큰 AuthToken String(40) 서비스코드 ServiceCode String(10) 고정값 : DTI 시스템타입 SystemType String(10) 고정값 : OAPI 참조번호 ConversationId String[] 스마트빌식별자 (35 자리 ) SMTP 이메일 SMTP String(20) 유통용이메일주소 ( 옵션 ) RValue RValue String 신원확인값 ( 서명모듈이용해서발행할경우에만필요 ) 인증서비밀번호 CertPassword String 암호화된인증서의비밀번호 서명원본 XML SignedXML String 서명정보가있는세금계산서원본 xml Request Sample (xml 형식은 [4. KEC 표준전자세금계산서 v3.0 항목표.xls] 참조 ) var arrconvid = new Array(); arrconvid[0] = ' '; var request = JSON.stringify({ 'MessageId': '3267cab1-3ea6-4aa6-b988-7d27d6d5ac89', 'Signal': 'RDETAILISSUE', 'RequestTime': ' ', 'SendComRegno': ' ', 'ReceiveComRegno': ' ', 'AuthToken': 'dxvcce96zvlxvhbpeklgcithqlercmroyjheedfxyi8rvxjmvmzpqk1ltt0k', 'ServiceCode': 'DTI', 'SystemType': 'OAPI', 'ConversationId': arrconvid, 'SMTP ': '', 'RValue': 'lsh2winygvm7lhfusp6ptczlbty=', // 서명모듈이용해서발행할경우에만필요 'CertPassword': 'sdfsd345fsdf55faadfs', // 암호화된인증서의비밀번호 'SignedXML': ''// 서명정보가있는세금계산서 xml); $.support.cors = true; $.ajax({ type: "POST", datatype: "json", crossdomain: true, contenttype: "application/json", url: " data: request, success: function (data) { fngetdata(data); //data 처리 ( 하단의 Response Sample 참조 ), error: function (error) { //error 처리 ); 19

20 2.7.3 Response 0메시지ID MessageId String 요청한트랜잭션식별자 요청시그널 Signal String(30) 고정값 : RDETAILISSUE 참조번호 ConversationId String(35) 요청한스마트빌식별자 응답시간 ResponseTime String(14) YYYYMMDDHH24MISS 처리코드 ResultCode String(5) 처리결과코드 처리메시지 ResultMessage String(2000) 처리결과상세내역 Response Sample function fngetdata(data){ if ("30000"!= data.resultcode) { alert(data.resultmessage); alert(" 정상적으로처리되었습니다."); 20

21 2.8 세금계산서상태변경 세금계산서의상태를변경한다. 요청시그널 / 서비스코드 / 시스템타입은고정값을사용한다 Request 메시지ID MessageId String 트랜잭션식별자 요청시그널 Signal String(30) 고정값 : CHGSTATUS 요청시간 RequestTime String(14) YYYYMMDDHH24MISS 송신사업자번호 SendComRegno String (13) 공급자사업자번호 수신사업자번호 ReceiveComRegno String (13) 공급받는자사업자번호 인증토큰 AuthToken String(40) 서비스코드 ServiceCode String(10) 고정값 : DTI 시스템타입 SystemType String(10) 고정값 : OAPI 참조번호 ConversationId String[] 스마트빌식별자 (35자리) 상태시그널 StatusSignal String 변경할상태의시그널값 ( 하단의상태시그널참조 ) 상태변경사유 StatusReason String 취소, 거부사유 Request Sample var arrconvid = new Array(); arrconvid[0] = ' '; var request = JSON.stringify({ 'MessageId': '3267cab1-3ea6-4aa6-b988-7d27d6d5ac89', 'Signal': 'CHGSTATUS', 'RequestTime': ' ', 'SendComRegno': ' ', 'ReceiveComRegno': ' ', 'AuthToken': 'dxvcce96zvlxvhbpeklgcithqlercmroyjheedfxyi8rvxjmvmzpqk1ltt0k', 'ServiceCode': 'DTI', 'SystemType': 'OAPI', 'ConversationId': arrconvid, 'StatusSignal': 'REJECT', 'StatusReason': ' 공급가액상이. 확인요망 ' ); $.support.cors = true; $.ajax({ type: "POST", datatype: "json", crossdomain: true, contenttype: "application/json", url: " data: request, success: function (data) { fngetdata(data); //data 처리 ( 하단의 Response Sample 참조 ), error: function (error) { //error 처리 ); 21

22 2.8.3 Response 메시지ID MessageId String 요청한트랜잭션식별자 요청시그널 Signal String(30) 고정값 : CHGSTATUS 참조번호 ConversationId String(35) 요청한스마트빌식별자 응답시간 ResponseTime String(14) YYYYMMDDHH24MISS 처리코드 ResultCode String(5) 처리결과코드 처리메시지 ResultMessage String(2000) 처리결과상세내역 Response Sample function fngetdata(data){ if ("30000"!= data.resultcode) { alert(data.resultmessage); alert(" 정상적으로처리되었습니다."); 상태시그널표 상태 Signal 취소 / 거부사유필요여부 변경전상태 수신승인 APPROVE 수신미승인 수신거부 REJECT 필요 수신미승인 역발행요청취소 CANCELRREQUEST 필요 역발행요청 역발행요청거부 RIREJECT 필요 역발행요청 발행취소 CANCELALL 필요 수신미승인 발행예정승인 WAPPROVE 발행예정요청 발행예정거부 WREJECT 필요 발행예정요청 발행예정취소 WCANCELALL 필요 발행예정요청 22

23 2.9 메일재전송 메일을재전송한다. 요청시그널 / 서비스코드 / 시스템타입은고정값을사용한다 Request 메시지ID MessageId String 트랜잭션식별자 요청시그널 Signal String(30) 고정값 : SENDMAIL 요청시간 RequestTime String(14) YYYYMMDDHH24MISS 송신사업자번호 SendComRegno String (13) 공급자사업자번호 인증토큰 AuthToken String(40) 서비스코드 ServiceCode String(10) 고정값 : DTI 시스템타입 SystemType String(10) 고정값 : OAPI 참조번호 ConversationId String[] 스마트빌식별자 (35자리) 상태시그널 StatusSignal String 재전송할상태의시그널값 ( 하단의상태시그널참조 ) 이메일 String[] 재전송할이메일주소 ( 이메일주소가공백일경우, 최초요청시저장된수신메일로전송됨 ) Request Sample var arrconvid = new Array(); arrconvid[0] = ' '; var arr = new Array(); arr [0] = 'test@test.com'; var request = JSON.stringify({ 'MessageId': '3267cab1-3ea6-4aa6-b988-7d27d6d5ac89', 'Signal': 'SENDMAIL', 'RequestTime': ' ', 'SendComRegno': ' ', 'AuthToken': 'dxvcce96zvlxvhbpeklgcithqlercmroyjheedfxyi8rvxjmvmzpqk1ltt0k', 'ServiceCode': 'DTI', 'SystemType': 'OAPI', 'ConversationId': arrconvid, 'StatusSignal': 'ARISSUE', ' ': arr ); $.support.cors = true; $.ajax({ type: "POST", datatype: "json", crossdomain: true, contenttype: "application/json", url: " data: request, success: function (data) { fngetdata(data); //data 처리 ( 하단의 Response Sample 참조 ), error: function (error) { //error 처리 ); 23

24 2.9.3 Response 메시지ID MessageId String 요청한트랜잭션식별자 요청시그널 Signal String(30) 고정값 : SENDMAIL 참조번호 ConversationId String(35) 요청한스마트빌식별자 응답시간 ResponseTime String(14) YYYYMMDDHH24MISS 처리코드 ResultCode String(5) 처리결과코드 처리메시지 ResultMessage String(2000) 처리결과상세내역 Response Sample function fngetdata(data){ if ("30000"!= data.resultcode) { alert(data.resultmessage); alert(" 정상적으로처리되었습니다."); 상태시그널표 상태정발행역발행요청역발행 Signal ARISSUE RARREQUEST RARISSUE 24

25 2.10 국세청전송요청 세금계산서를즉시국세청에전송하도록요청한다. 요청시그널 / 서비스코드 / 시스템타입은고정값을사용한다 Request 메시지ID MessageId String 트랜잭션식별자 요청시그널 Signal String(30) 고정값 : NTS_REQUEST 요청시간 RequestTime String(14) YYYYMMDDHH24MISS 송신사업자번호 SendComRegno String (13) 공급자사업자번호 인증토큰 AuthToken String(40) 서비스코드 ServiceCode String(10) 고정값 : DTI 시스템타입 SystemType String(10) 고정값 : OAPI 참조번호 ConversationId String[] 스마트빌식별자 (35자리, 다중건가능 ) Request Sample var arrconvid = new Array(); arrconvid[0] = ' '; arrconvid[1] = ' '; var request = JSON.stringify({ 'MessageId': '3267cab1-3ea6-4aa6-b988-7d27d6d5ac89', 'Signal': 'NTS_REQUEST', 'RequestTime': ' ', 'SendComRegno': ' ', 'AuthToken': 'dxvcce96zvlxvhbpeklgcithqlercmroyjheedfxyi8rvxjmvmzpqk1ltt0k', 'ServiceCode': 'DTI', 'SystemType': 'OAPI', 'ConversationId': arrconvid ); $.support.cors = true; $.ajax({ type: "POST", datatype: "json", crossdomain: true, contenttype: "application/json", url: " data: request, success: function (data) { fngetdata(data); //data 처리 ( 하단의 Response Sample 참조 ), error: function (error) { //error 처리 ); 25

26 Response 메시지ID MessageId String 요청한트랜잭션식별자 요청시그널 Signal String(30) 고정값 : NTS_REQUEST 참조번호 ConversationId String(35) 요청한스마트빌식별자 응답시간 ResponseTime String(14) YYYYMMDDHH24MISS 처리코드 ResultCode String(5) 처리결과코드 처리메시지 ResultMessage String(2000) 처리결과상세내역 Response Sample function fngetdata(data){ if ("30000"!= data.resultcode) { alert(data.resultmessage); alert(" 정상적으로처리되었습니다."); 26

27 2.11 세금계산서상태조회 세금계산서의상태조회를요청한다. 요청시그널 / 서비스코드는고정값을사용한다. 성능이슈와네트워크트래픽관리목적상, 동일한검색조건의함수호출을 1 회 / 1 분으로제한합니다 Request 메시지ID MessageId String 트랜잭션식별자 요청시그널 Signal String(30) 고정값 : DTI_STATUS_LIST 요청시간 RequestTime String(14) YYYYMMDDHH24MISS 송신사업자번호 SendComRegno String (13) 송신자사업자번호 인증토큰 AuthToken String(40) 서비스코드 ServiceCode String(10) 고정값 : DTI 검색시작일자 SearchFromDate String(10) YYYY-MM-DD 검색종료일자 SearchToDate String(10) YYYY-MM-DD( 최대 1주일간의데이터조회가능 ) 검색사업자번호 SearchComRegno String(13) 검색할사업자번호입력매출건조회일경우매입자의사업자번호매입건조회일경우매출자의사업자번호 매출매입구분 RepoTypeCode String(2) 매출 (AR) 매입 (AP) 선택입력 Request Sample var request = JSON.stringify({ 'MessageId': '3267cab1-3ea6-4aa6-b988-7d27d6d5ac89', 'Signal': 'DTI_STATUS_LIST', 'RequestTime': ' ', 'SendComRegno': ' ', 'AuthToken': 'dxvcce96zvlxvhbpeklgcithqlercmroyjheedfxyi8rvxjmvmzpqk1ltt0k', 'ServiceCode': 'DTI', 'SearchFromDate': ' ', 'SearchToDate': ' ', 'SearchComRegno': ' ' 'RepoTypeCode': 'AR' ); $.support.cors = true; $.ajax({ type: "POST", datatype: "json", crossdomain: true, contenttype: "application/json", url: " data: request, success: function (data) { fngetdata(data); //data 처리 ( 하단의 Response Sample 참조 ), error: function (error) { //error 처리 ); 27

28 Response 메시지ID MessageId String 요청한트랜잭션식별자 요청시그널 Signal String(30) 고정값 : DTI_STATUS_LIST 응답시간 ResponseTime String(14) YYYYMMDDHH24MISS 처리코드 ResultCode String(5) 처리결과코드 처리메시지 ResultMessage String(2000) 처리결과상세내역 처리결과 ResultDataSet DataSet Response Sample var totalcount; function fngetdata(data){ if ("30000"!= data.resultcode) { alert(data.resultmessage); alert(" 정상적으로처리되었습니다."); totalcount = data.resultdataset.table.length; if(0 < totalcount){ for(var i = 0 ; i < totalcount ; i++){ data.resultdataset.table[i].dti_status; // 세금계산서상태값 data.resultdataset.table[i].etc_pcs_no; // 세금계산서참조번호 data.resultdataset.table[i].nts_result_code; // 세금계산서국세청전송결과 data.resultdataset.table[i].nts_send_date; // 세금계산서국세청전송일자 data.resultdataset.table[i].nts_send_status; // 세금계산서국세청전송상태 data.resultdataset.table[i].sup_ ; // 담당자이메일 ( 매출조회일경우 ) data.resultdataset.table[i].byr_ ; // 담당자이메일 ( 매입조회일경우 ) alert(" 데이터가존재하지않습니다."); 28

29 2.12 부가정보조회 스마트빌을사용하기위한부가정보를조회한다. 요청시그널 / 서비스코드는고정값을사용한다 Request 메시지ID MessageId String 트랜잭션식별자 요청시그널 Signal String(30) 고정값 : ADD_INFO 요청시간 RequestTime String(14) YYYYMMDDHH24MISS 송신사업자번호 SendComRegno String (13) 송신사업자번호 인증토큰 AuthToken String(40) 서비스코드 ServiceCode String(10) 고정값 : DTI 검색사업자번호 SearchComRegno String(10) 검색할사업자번호입력 담당자이메일 String[] 담당자이메일입력 조회타입코드 SearchTypeCode String 하단의조회타입코드참조 Request Sample var arr = new Array(); arr [0] = 'test@test.com'; var request = JSON.stringify({ 'MessageId': '3267cab1-3ea6-4aa6-b988-7d27d6d5ac89', 'Signal': 'ADD_INFO', 'RequestTime': ' ', 'SendComRegno': ' ', 'AuthToken': 'dxvcce96zvlxvhbpeklgcithqlercmroyjheedfxyi8rvxjmvmzpqk1ltt0k', 'ServiceCode': 'DTI', 'SearchComRegno': ' ', ' ': arr , 'SearchTypeCode': 'NOTICE' ); $.support.cors = true; $.ajax({ type: "POST", datatype: "json", crossdomain: true, contenttype: "application/json", url: " data: request, success: function (data) { fngetdata(data); //data 처리 ( 하단의 Response Sample 참조 ), error: function (error) { //error 처리 조회타입코드 조회타입코드조회타입종류사용예필수입력파라미터 NOTICE 공지사항스마트빌사이트에서공지된사항을알고자할때 BIZPLACE 종사업장코드거래처의종사업장코드를알고자할때검색사업자번호 (SearchComRegno) AUTH 담당자권한거래처의담당자의스마트빌권한을알고자할때검색사업자번호 (SearchComRegno) 29 담당자이메일 ( ) CLOSE 휴폐업여부거래처의휴폐업여부를알고자할때검색사업자번호 (SearchComRegno) COMPANY 회사정보조회거래처의사업장정보를알고자할때검색사업자번호 (SearchComRegno)

30 Response 메시지ID MessageId String 요청한트랜잭션식별자 요청시그널 Signal String(30) 고정값 : ADD_INFO 응답시간 ResponseTime String(14) YYYYMMDDHH24MISS 처리코드 ResultCode String(5) 처리결과코드 처리메시지 ResultMessage String(2000) 처리결과상세내역 처리결과 ResultDataSet DataSet Response Sample var totalcount; var searchtypecode = eval('(' + request + ')').SearchTypeCode; // 조회타입코드 function fngetdata(data){ if ("30000"!= data.resultcode) { alert(data.resultmessage); alert(" 정상적으로처리되었습니다."); totalcount = data.resultdataset.table.length; if(0 < totalcount){ if("notice" == searchtypecode){ // 공지사항 for(var i = 0 ; i < totalcount ; i++){ data.resultdataset.table[i].cdate; // 공지사항등록일 data.resultdataset.table[i].notice_contents; // 공지사항내용 data.resultdataset.table[i].notice_no; // 공지사항번호 data.resultdataset.table[i].notice_title; // 공지사항제목 else if("bizplace" == searchtypecode){ // 종사업장코드 for(var i = 0 ; i < totalcount ; i++){ data.resultdataset.table[i].bizplace_address; // 종사업장주소 data.resultdataset.table[i].bizplace_code; // 종사업장코드 data.resultdataset.table[i].bizplace_name; // 종사업장명 else if("auth" == searchtypecode){ // 담당자권한 for(var i = 0 ; i < totalcount ; i++){ data.resultdataset.table[i].issue_yn; // 세금계산서발행권한 data.resultdataset.table[i].rcv_yn; // 세금계산서수신권한 data.resultdataset.table[i].request_yn; // 세금계산서역발행요청권한 else if("close" == searchtypecode){ // 휴폐업여부 for(var i = 0 ; i < totalcount ; i++){ data.resultdataset.table[i].type_code; // 휴폐업코드 data.resultdataset.table[i].type_desc; // 휴폐업코드상세 else if("company" == searchtypecode){ // 회사정보조회 for(var i = 0 ; i < totalcount ; i++){ data.resultdataset.table[i].com_address; // 주소 data.resultdataset.table[i].com_name; // 회사명 data.resultdataset.table[i].com_bizstatus; // 업태 data.resultdataset.table[i].com_bizclass; // 업종 data.resultdataset.table[i].com_president; // 대표자명 alert(" 데이터가존재하지않습니다."); 30

31 2.13 메일수신결과조회 세금계산서와관련하여발송된메일의담당자수신여부를조회한다. 요청시그널 / 서비스코드는고정값을사용한다 Request 메시지ID MessageId String 트랜잭션식별자 요청시그널 Signal String(30) 고정값 : MAIL_RESULT 요청시간 RequestTime String(14) YYYYMMDDHH24MISS 송신사업자번호 SendComRegno String (13) 송신사업자번호 인증토큰 AuthToken String(40) 서비스코드 ServiceCode String(10) 고정값 : DTI 참조번호 ConversationId String[] 스마트빌식별자 (35자리) Request Sample var arrconvid = new Array(); arrconvid[0] = ' '; var request = JSON.stringify({ 'MessageId': '3267cab1-3ea6-4aa6-b988-7d27d6d5ac89', 'Signal': 'MAIL_RESULT', 'RequestTime': ' ', 'SendComRegno': ' ', 'AuthToken': 'dxvcce96zvlxvhbpeklgcithqlercmroyjheedfxyi8rvxjmvmzpqk1ltt0k', 'ServiceCode': 'DTI', 'ConversationId': arrconvid ); $.support.cors = true; $.ajax({ type: "POST", datatype: "json", crossdomain: true, contenttype: "application/json", url: " data: request, success: function (data) { fngetdata(data); //data 처리 ( 하단의 Response Sample 참조 ), error: function (error) { //error 처리 ); 31

32 Response 메시지ID MessageId String 요청한트랜잭션식별자 요청시그널 Signal String(30) 고정값 : MAIL_RESULT 응답시간 ResponseTime String(14) YYYYMMDDHH24MISS 처리코드 ResultCode String(5) 처리결과코드 처리메시지 ResultMessage String(2000) 처리결과상세내역 처리결과 ResultDataSet DataSet Response Sample var totalcount; function fngetdata(data){ if ("30000"!= data.resultcode) { alert(data.resultmessage); alert(" 정상적으로처리되었습니다."); totalcount = data.resultdataset.table.length; if(0 < totalcount){ for(var i = 0 ; i < totalcount ; i++){ data.resultdataset.table[i].open_date; // 메일열람일자 data.resultdataset.table[i].open_yn; // 메일열람여부 data.resultdataset.table[i].success_yn; // 메일전송여부 alert(" 데이터가존재하지않습니다."); 32

33 2.14 미리보기양식조회 세금계산서를보이기위한 UI 템플릿을요청한다. 요청시그널 / 서비스코드는고정값을사용한다 Request 메시지ID MessageId String 트랜잭션식별자 요청시그널 Signal String(30) 고정값 : PREVIEW_FORM 요청시간 RequestTime String(14) YYYYMMDDHH24MISS 송신사업자번호 SendComRegno String (13) 송신사업자번호 인증토큰 AuthToken String(40) 서비스코드 ServiceCode String(10) 고정값 : DTI Request Sample var request = JSON.stringify({ 'MessageId': '3267cab1-3ea6-4aa6-b988-7d27d6d5ac89', 'Signal': 'PREVIEW_FORM', 'RequestTime': ' ', 'SendComRegno': ' ', 'AuthToken': 'dxvcce96zvlxvhbpeklgcithqlercmroyjheedfxyi8rvxjmvmzpqk1ltt0k', 'ServiceCode': 'DTI' ); $.support.cors = true; $.ajax({ type: "POST", datatype: "json", crossdomain: true, contenttype: "application/json", url: " data: request, success: function (data) { fngetdata(data); //data 처리 ( 하단의 Response Sample 참조 ), error: function (error) { //error 처리 ); 33

34 Response 메시지ID MessageId String 요청한트랜잭션식별자 요청시그널 Signal String(30) 고정값 : PREVIEW_FORM 응답시간 ResponseTime String(14) YYYYMMDDHH24MISS 처리코드 ResultCode String(5) 처리결과코드 처리메시지 ResultMessage String(2000) 처리결과상세내역 처리결과 ResultDataSet DataSet Response Sample var totalcount; function fngetdata(data){ if ("30000"!= data.resultcode) { alert(data.resultmessage); alert(" 정상적으로처리되었습니다."); totalcount = data.resultdataset.table1.length; if(0 < totalcount){ data.resultdataset.table1[0].content; // 공급받는자용매입세금계산서 data.resultdataset.table1[1].content; // 공급받는자용매입계산서 data.resultdataset.table1[2].content; // 공급받는자용위수탁매입세금계산서 data.resultdataset.table1[3].content; // 공급받는자용위수탁매입계산서 data.resultdataset.table1[4].content; // 공급자용매출세금계산서 data.resultdataset.table1[5].content; // 공급자용매출계산서 data.resultdataset.table1[6].content; // 공급자용위수탁매출세금계산서 data.resultdataset.table1[7].content; // 공급자용위수탁매출계산서 data.resultdataset.table1[8].content; // 거래명세서 ( 과세 ) data.resultdataset.table1[9].content; // 거래명세서 ( 면세 ) data.resultdataset.table1[10].content; // 위수탁거래명세서 ( 과세 ) data.resultdataset.table1[11].content; // 위수탁거래명세서 ( 면세 ) alert(" 데이터가존재하지않습니다."); 34

35 2.15 보관함조회 보관함조회를요청한다. 요청시그널 / 서비스코드는고정값을사용한다. 성능이슈와네트워크트래픽관리목적상, 동일한검색조건의함수호출을 1 회 / 1 분으로제한합니다 Request 메시지ID MessageId String 트랜잭션식별자 요청시그널 Signal String(30) 고정값 : ARAP_REPO 요청시간 RequestTime String(14) YYYYMMDDHH24MISS 송신사업자번호 SendComRegno String (13) 송신사업자번호 인증토큰 AuthToken String(40) 서비스코드 ServiceCode String(10) 고정값 : DTI 검색시작일자 SearchFromDate String(10) YYYY-MM-DD 검색종료일자 SearchToDate String(10) YYYY-MM-DD( 최대 1개월간의데이터조회가능 ) 검색사업자번호 SearchComRegno String(13) 검색할사업자번호입력 ( 매출보관함일경우검색할매입자의사업자번호, 매입보관함일경우검색할매출자의사업자번호 보관함종류코드 RepoTypeCode String 매출 (AR), 매입 (AP) 를선택해서입력 Request Sample var request = JSON.stringify({ 'MessageId': '3267cab1-3ea6-4aa6-b988-7d27d6d5ac89', 'Signal': 'ARAP_REPO', 'RequestTime': ' ', 'SendComRegno': ' ', 'AuthToken': 'dxvcce96zvlxvhbpeklgcithqlercmroyjheedfxyi8rvxjmvmzpqk1ltt0k', 'ServiceCode': 'DTI', 'SearchFromDate': ' ', 'SearchToDate': ' ', 'SearchComRegno': ' ', 'RepoTypeCode': 'AR' ); $.support.cors = true; $.ajax({ type: "POST", datatype: "json", crossdomain: true, contenttype: "application/json", url: " data: request, success: function (data) { fngetdata(data); //data 처리 ( 하단의 Response Sample 참조 ), error: function (error) { //error 처리 ); 35

36 Response 메시지ID MessageId String 요청한트랜잭션식별자 요청시그널 Signal String(30) 고정값 : ARAP_REPO 응답시간 ResponseTime String(14) YYYYMMDDHH24MISS 처리코드 ResultCode String(5) 처리결과코드 처리메시지 ResultMessage String(2000) 처리결과상세내역 처리결과 ResultDataSet DataSet Response Sample var totalcount; var repotypecode = eval('(' + request + ')').RepoTypeCode; // 조회타입코드 function fngetdata(data){ if ("30000"!= data.resultcode) { alert(data.resultmessage); alert(" 정상적으로처리되었습니다."); totalcount = data.resultdataset.table.length; if(0 < totalcount){ if("ar" == repotypecode){ // 매출보관함 for(var i = 0 ; i < totalcount ; i++){ data.resultdataset.table[i].byr_com_name; // 공급받는자회사명 data.resultdataset.table[i].byr_com_regno; // 공급받는자사업자번호 data.resultdataset.table[i].direction; // 세금계산서정 / 역구분 data.resultdataset.table[i].dti_status; // 세금계산서상태 data.resultdataset.table[i].dti_type; // 세금계산서종류 data.resultdataset.table[i].dti_wday; // 세금계산서작성일자 data.resultdataset.table[i].etc_pcs_no; // 세금계산서참조번호 data.resultdataset.table[i].issue_id; // 세금계산서승인번호 data.resultdataset.table[i].nts_send_status; // 세금계산서국세청전송상태 data.resultdataset.table[i].sup_amt; // 세금계산서공급가액 data.resultdataset.table[i].sup_ ; // 담당자이메일 else if("ap" == repotypecode){ // 매입보관함 for(var i = 0 ; i < totalcount ; i++){ data.resultdataset.table[i].direction; // 세금계산서정 / 역구분 data.resultdataset.table[i].dti_status; // 세금계산서상태 data.resultdataset.table[i].dti_type; // 세금계산서종류 data.resultdataset.table[i].dti_wday; // 세금계산서작성일자 data.resultdataset.table[i].etc_pcs_no; // 세금계산서참조번호 data.resultdataset.table[i].issue_id; // 세금계산서승인번호 data.resultdataset.table[i].nts_send_status; // 세금계산서국세청전송상태 data.resultdataset.table[i].sup_amt; // 세금계산서공급가액 data.resultdataset.table[i].sup_com_name; // 공급자회사명 data.resultdataset.table[i].sup_com_regno; // 공급자사업자번호 data.resultdataset.table[i].byr_ ; // 담당자이메일 alert(" 데이터가존재하지않습니다."); 36

37 2.16 미처리함조회 미처리함내역을요청한다. 요청시그널 / 서비스코드는고정값을사용한다. 성능이슈와네트워크트래픽관리목적상, 동일한검색조건의함수호출을 1 회 / 1 분으로제한합니다 Request 메시지ID MessageId String 트랜잭션식별자 요청시그널 Signal String(30) 고정값 : MY_LIST 요청시간 RequestTime String(14) YYYYMMDDHH24MISS 송신사업자번호 SendComRegno String (13) 송신사업자번호 인증토큰 AuthToken String(40) 서비스코드 ServiceCode String(10) 고정값 : DTI 검색시작일자 SearchFromDate String(10) YYYY-MM-DD 검색종료일자 SearchToDate String(10) YYYY-MM-DD( 최대 1주일간의데이터조회가능 ) 미처리함종류코드 ListTypeCode String 회사미처리함 (C), 거래처미처리함 (T) 를선택해서입력 Request Sample var request = JSON.stringify({ 'MessageId': '3267cab1-3ea6-4aa6-b988-7d27d6d5ac89', 'Signal': 'MY_LIST', 'RequestTime': ' ', 'SendComRegno': ' ', 'AuthToken': 'dxvcce96zvlxvhbpeklgcithqlercmroyjheedfxyi8rvxjmvmzpqk1ltt0k', 'ServiceCode': 'DTI', 'SearchFromDate': ' ', 'SearchToDate': ' ', 'ListTypeCode': 'C' ); $.support.cors = true; $.ajax({ type: "POST", datatype: "json", crossdomain: true, contenttype: "application/json", url: " data: request, success: function (data) { fngetdata(data); //data 처리 ( 하단의 Response Sample 참조 ), error: function (error) { //error 처리 ); 37

38 Response 메시지ID MessageId String 요청한트랜잭션식별자 요청시그널 Signal String(30) 고정값 : MY_LIST 응답시간 ResponseTime String(14) YYYYMMDDHH24MISS 처리코드 ResultCode String(5) 처리결과코드 처리메시지 ResultMessage String(2000) 처리결과상세내역 처리결과 ResultDataSet DataSet Response Sample var totalcount; var listtypecode = eval('(' + request + ')').ListTypeCode; // 조회타입코드 function fngetdata(data){ if ("30000"!= data.resultcode) { alert(data.resultmessage); alert(" 정상적으로처리되었습니다."); totalcount = data.resultdataset.table.length; if(0 < totalcount){ if("c" == listtypecode){ // 회사미처리함 for(var i = 0 ; i < totalcount ; i++){ data.resultdataset.table[i].amend_code; // 수정코드 data.resultdataset.table[i].amend_dti_yn; // 수정세금계산서여부 data.resultdataset.table[i].brk_com_name; // 수탁자회사명 data.resultdataset.table[i].brk_com_regno; // 수탁자사업자번호 data.resultdataset.table[i].brk_dti_yn; // 위수탁세금계산서여부 data.resultdataset.table[i].byr_com_name; // 공급받는자회사명 data.resultdataset.table[i].byr_com_regno; // 공급받는자사업자번호 data.resultdataset.table[i].byr_type; // 공급받는자타입 ( 개인 / 회사 ) data.resultdataset.table[i].customer_com_name; // 거래처회사명 data.resultdataset.table[i].customer_com_regno; // 거래처사업자번호 data.resultdataset.table[i].direction; // 세금계산서정 / 역구분 data.resultdataset.table[i].dti_status; // 세금계산서상태 data.resultdataset.table[i].dti_type; // 세금계산서종류 data.resultdataset.table[i].dti_wday; // 세금계산서작성일자 data.resultdataset.table[i].dtt_link_type; // 거래명세서첨부여부 data.resultdataset.table[i].etc_pcs_no; // 세금계산서참조번호 data.resultdataset.table[i].is_arap; // 매출매입구분 data.resultdataset.table[i].seq_no; // 관리번호 data.resultdataset.table[i].sup_amt; // 세금계산서공급가액 data.resultdataset.table[i].sup_com_name; // 공급자회사명 data.resultdataset.table[i].sup_com_regno; // 공급자사업자번호 data.resultdataset.table[i].tax_demand; // 영수청구구분 data.resultdataset.table[i]. ; // 담당자이메일 data.resultdataset.table[i].dataxml; // 원본XML else if("t" == listtypecode){ // 거래처미처리함 38

39 else if("t" == listtypecode){ // 거래처미처리함 for(var i = 0 ; i < totalcount ; i++){ data.resultdataset.table[i].amend_dti_yn; // 수정세금계산서여부 data.resultdataset.table[i].brk_com_name; // 수탁자회사명 data.resultdataset.table[i].brk_com_regno; // 수탁자사업자번호 data.resultdataset.table[i].brk_dti_yn; // 위수탁세금계산서여부 data.resultdataset.table[i].byr_type; // 공급받는자타입 ( 개인 / 회사 ) data.resultdataset.table[i].customer_com_name; // 거래처회사명 data.resultdataset.table[i].customer_com_regno; // 거래처사업자번호 data.resultdataset.table[i].direction; // 세금계산서정 / 역구분 data.resultdataset.table[i].dti_status; // 세금계산서상태 data.resultdataset.table[i].dti_type; // 세금계산서종류 data.resultdataset.table[i].dti_wday; // 세금계산서작성일자 data.resultdataset.table[i].dtt_link_type; // 거래명세서첨부여부 data.resultdataset.table[i].etc_pcs_no; // 세금계산서참조번호 data.resultdataset.table[i].is_arap; // 매출매입구분 data.resultdataset.table[i].send_status; // 국세청전송상태 data.resultdataset.table[i].seq_no; // data.resultdataset.table[i].sup_amt; // 세금계산서공급가액 data.resultdataset.table[i].sup_com_name; // 공급자회사명 data.resultdataset.table[i].sup_com_regno; // 공급자사업자번호 data.resultdataset.table[i].tax_demand; // 영수청구구분 data.resultdataset.table[i].view_cnt; // 열람횟수 alert(" 데이터가존재하지않습니다."); 39

40 2.17 건별상세조회 세금계산서의상세내역을조회한다. 요청시그널 / 서비스코드는고정값을사용한다. 성능이슈와네트워크트래픽관리목적상, 동일한검색조건의함수호출을 1 회 / 1 분으로제한합니다 Request 메시지ID MessageId String 트랜잭션식별자 요청시그널 Signal String(30) 고정값 : DTI_STATUS 요청시간 RequestTime String(14) YYYYMMDDHH24MISS 송신사업자번호 SendComRegno String (13) 송신사업자번호 인증토큰 AuthToken String(40) 서비스코드 ServiceCode String(10) 고정값 : DTI 참조번호 ConversationId Request Sample var arrconvid = new Array(); arrconvid[0] = ' '; var request = JSON.stringify({ 'MessageId': '3267cab1-3ea6-4aa6-b988-7d27d6d5ac89', 'Signal': 'DTI_STATUS', 'RequestTime': ' ', 'SendComRegno': ' ', 'AuthToken': 'dxvcce96zvlxvhbpeklgcithqlercmroyjheedfxyi8rvxjmvmzpqk1ltt0k', 'ServiceCode': 'DTI', 'ConversationId': arrconvid ); $.support.cors = true; $.ajax({ type: "POST", datatype: "json", crossdomain: true, contenttype: "application/json", url: " data: request, success: function (data) { fngetdata(data); //data 처리 ( 하단의 Response Sample 참조 ), error: function (error) { //error 처리 ); 40

41 Response 메시지ID MessageId String 요청한트랜잭션식별자 요청시그널 Signal String(30) 고정값 : DTI_STATUS 응답시간 ResponseTime String(14) YYYYMMDDHH24MISS 처리코드 ResultCode String(5) 처리결과코드 처리메시지 ResultMessage String(2000) 처리결과상세내역 처리결과 ResultDataSet DataSet Response Sample var totalcount; function fngetdata(data){ if ("30000"!= data.resultcode) { alert(data.resultmessage); alert(" 정상적으로처리되었습니다."); totalcount = data.resultdataset.table.length; if(0 < totalcount){ data.resultdataset.table[0].amend_code; // 수정코드 data.resultdataset.table[0].dti_issuedate; // 세금계산서발행일자 data.resultdataset.table[0].dti_status; // 세금계산서상태 data.resultdataset.table[0].dti_wday; // 세금계산서작성일자 data.resultdataset.table[0].etc_pcs_no; // 세금계산서참조번호 data.resultdataset.table[0].issue_id; // 세금계산서승인번호 data.resultdataset.table[0].nts_result_code; // 세금계산서국세청전송결과 data.resultdataset.table[0].nts_send_date; // 세금계산서국세청전송일자 data.resultdataset.table[0].nts_send_status; // 세금계산서국세청전송상태 data.resultdataset.table[0].ori_issue_id; // 원본세금계산서승인번호 data.resultdataset.table[0].sup_amt; // 세금계산서공급가액 data.resultdataset.table[0].tax_amt; // 세금계산서세액 data.resultdataset.table[0].tot_amt; // 세금계산서합계금액 data.resultdataset.table[0].is_arap; // 매출, 매입구분 data.resultdataset.table[0].dti_type; // 세금계산서유형 data.resultdataset.table[0].dtt_link_type; // 거래명세서포함여부 data.resultdataset.table[0].direction; // 정, 역구분 data.resultdataset.table[0].byr_type; // 공급받는자회원구분 data.resultdataset.table[0].tax_demand; // 영수, 청구구분 data.resultdataset.table[0].sup_com_name; // 공급자회사명 data.resultdataset.table[0].sup_com_regno; // 공급자사업자번호 data.resultdataset.table[0].byr_com_name; // 공급받는자회사명 data.resultdataset.table[0].byr_com_regno; // 공급받는자사업자번호 data.resultdataset.table[0].brk_com_name; // 수탁자회사명 data.resultdataset.table[0].brk_com_regno; // 수탁자사업자번호 data.resultdataset.table[0].brk_dti_yn; // 위수탁여부 data.resultdataset.table[0].amend_dti_yn; // 수정세금계산서여부 data.resultdataset.table[0].sup_ ; // 공급자이메일 data.resultdataset.table[0].byr_ ; // 공급받는자이메일 data.resultdataset.table[0].brk_ ; // 수탁자이메일 alert(" 데이터가존재하지않습니다."); 41

42 2.18 건별상세이력조회 세금계산서의상세이력을조회한다. 요청시그널 / 서비스코드는고정값을사용한다. 성능이슈와네트워크트래픽관리목적상, 동일한검색조건의함수호출을 1 회 / 1 분으로제한합니다 Request 메시지ID MessageId String 트랜잭션식별자 요청시그널 Signal String(30) 고정값 : DTI_HISTORY 요청시간 RequestTime String(14) YYYYMMDDHH24MISS 송신사업자번호 SendComRegno String (13) 송신사업자번호 인증토큰 AuthToken String(40) 서비스코드 ServiceCode String(10) 고정값 : DTI 참조번호 ConversationId Request Sample var arrconvid = new Array(); arrconvid[0] = ' '; var request = JSON.stringify({ 'MessageId': '3267cab1-3ea6-4aa6-b988-7d27d6d5ac89', 'Signal': 'DTI_HISTORY', 'RequestTime': ' ', 'SendComRegno': ' ', 'AuthToken': 'dxvcce96zvlxvhbpeklgcithqlercmroyjheedfxyi8rvxjmvmzpqk1ltt0k', 'ServiceCode': 'DTI', 'ConversationId': arrconvid ); $.support.cors = true; $.ajax({ type: "POST", datatype: "json", crossdomain: true, contenttype: "application/json", url: " data: request, success: function (data) { fngetdata(data); //data 처리 ( 하단의 Response Sample 참조 ), error: function (error) { //error 처리 ); 42

43 Response 메시지ID MessageId String 요청한트랜잭션식별자 요청시그널 Signal String(30) 고정값 : DTI_HISTORY 응답시간 ResponseTime String(14) YYYYMMDDHH24MISS 처리코드 ResultCode String(5) 처리결과코드 처리메시지 ResultMessage String(2000) 처리결과상세내역 처리결과 ResultDataSet DataSet Response Sample var totalcount; function fngetdata(data){ if ("30000"!= data.resultcode) { alert(data.resultmessage); alert(" 정상적으로처리되었습니다."); totalcount = data.resultdataset.table.length; if(0 < totalcount){ for(var i = 0 ; i < totalcount ; i++){ data.resultdataset.table[i].cdate; // 생성일자 data.resultdataset.table[i].com_name; // 회사명 data.resultdataset.table[i].dti_status; // 세금계산서상태 data.resultdataset.table[i].dti_wday; // 세금계산서작성일자 data.resultdataset.table[i].mem_name; // 담당자명 data.resultdataset.table[i].reason; // 사유 data.resultdataset.table[i].seq_num; // alert(" 데이터가존재하지않습니다."); 43

44 2.19 회원가입결과조회 이메일을이용해서, 스마트빌의회원아이디를조회한다 Request 메시지ID MessageId String 트랜잭션식별자 요청시그널 Signal String(30) 고정값 : GET_MEMBERINFO 요청시간 RequestTime String(14) YYYYMMDDHH24MISS 송신사업자번호 SendComRegno String (13) 송신사업자번호 인증코드 AuthCode String(40) 스마트빌에서부여받은인증코드 이메일 String[] 조회할사용자의이메일주소 Request Sample var arr = new Array(); arr [0] = 'test@test.co.kr'; arr [1] = 'rockpia19@test.com'; var request = JSON.stringify({ 'MessageId': '3267cab1-3ea6-4aa6-b988-7d27d6d5ac89', 'Signal': ' GET_MEMBERINFO', 'RequestTime': ' ', 'SendComRegno': ' ', 'AuthCode': 'B861CF E39EDD44A6A91CCCCD', ' ': arr ); $.support.cors = true; $.ajax({ type: "POST", datatype: "json", crossdomain: true, contenttype: "application/json", url: " data: request, success: function (data) { fngetdata(data); //data 처리 ( 하단의 Response Sample 참조 ), error: function (error) { //error 처리 ); 44

45 Response 메시지ID MessageId String 요청한트랜잭션식별자 요청시그널 Signal String(30) 고정값 : GET_ MEMBERINFO 응답시간 ResponseTime String(14) YYYYMMDDHH24MISS 처리코드 ResultCode String(5) 처리결과코드 처리메시지 ResultMessage String(2000) 처리결과상세내역 처리결과 ResultDataSet DataSet Response Sample var totalcount; function fngetdata(data){ if ("30000"!= data.resultcode) { alert(data.resultmessage); alert(" 정상적으로처리되었습니다."); totalcount = data.resultdataset.table.length; if(0 < totalcount){ for(var i = 0 ; i < totalcount ; i++){ data.resultdataset.table[i].com_regno;// 사업자번호 data.resultdataset.table[i]. ;// 이메일 data.resultdataset.table[i].sbid; // 스마트빌아이디 ( 공백인경우, 회원가입이되어있지않은상태 ) alert(" 데이터가존재하지않습니다."); 45

46 2.20 세금계산서발행결과조회 참조번호를이용해서, 세금계산서의상태를조회한다. 성능이슈와네트워크트래픽관리목적상, 동일한검색조건의함수호출을 1 회 / 1 분으로제한합니다 Request 메시지ID MessageId String 트랜잭션식별자 요청시그널 Signal String(30) 고정값 : DTI_ISSUE_RESULT 요청시간 RequestTime String(14) YYYYMMDDHH24MISS 송신사업자번호 SendComRegno String (13) 송신사업자번호 인증토큰 AuthToken String(40) 서비스코드 SERVICE_CODE String(10) 고정값 : DTI 참조번호 ConversationId String[] 상태조회할참조번호 Request Sample var arrconvid = new Array(); arrconvid[0] = ' '; arrconvid[1] = ' '; var request = JSON.stringify({ 'MessageId': '3267cab1-3ea6-4aa6-b988-7d27d6d5ac89', 'Signal': 'DTI_ISSUE_RESULT', 'RequestTime': ' ', 'SendComRegno': ' ', 'AuthToken': 'dxvcce96zvlxvhbpeklgcithqlercmroyjheedfxyi8rvxjmvmzpqk1ltt0k', 'ServiceCode': 'DTI', 'ConversationId': arrconvid ); $.support.cors = true; $.ajax({ type: "POST", datatype: "json", crossdomain: true, contenttype: "application/json", url: " data: request, success: function (data) { fngetdata(data); //data 처리 ( 하단의 Response Sample 참조 ), error: function (error) { //error 처리 ); 46

47 Response 메시지ID MessageId String 요청한트랜잭션식별자 요청시그널 Signal String(30) 고정값 : DTI_ISSUE_RESULT 응답시간 ResponseTime String(14) YYYYMMDDHH24MISS 처리코드 ResultCode String(5) 처리결과코드 처리메시지 ResultMessage String(2000) 처리결과상세내역 처리결과 ResultDataSet DataSet Response Sample var totalcount; function fngetdata(data){ if ("30000"!= data.resultcode) { alert(data.resultmessage); alert(" 정상적으로처리되었습니다."); totalcount = data.resultdataset.table.length; if(0 < totalcount){ for(var i = 0 ; i < totalcount ; i++){ data.resultdataset.table[i].etc_pcs_no; // 참조번호 data.resultdataset.table[i].issue_id; // 승인번호 data.resultdataset.table[i].dti_status; // 세금계산서상태 data.resultdataset.table[i].nts_send_status; // 국세청전송상태 data.resultdataset.table[i].nts_result_code; // 국세청전송결과 data.resultdataset.table[i].nts_send_date; // 국세청전송일시 data.resultdataset.table[i].tot_amt; // 합계금액 data.resultdataset.table[i].sup_amt; // 공급가액 data.resultdataset.table[i].tax_amt; // 세액 data.resultdataset.table[i].dti_wday; // 작성일자 data.resultdataset.table[i].dti_issuedate; // 발행일시 data.resultdataset.table[i].amend_code; // 수정코드 data.resultdataset.table[i].ori_issue_id; // 당초승인번호 alert(" 데이터가존재하지않습니다."); 47

48 2.21 인증토큰발급 통신용인증토큰발급을요청한다. 요청시그널은고정값을사용한다 Request 메시지ID MessageId String 트랜잭션식별자 요청시그널 Signal String(30) 고정값 : GET_TOKEN 요청시간 RequestTime String(14) YYYYMMDDHH24MISS 송신사업자번호 SendComRegno String (13) 공급자사업자번호 인증코드 AuthCode String(40) 스마트빌에서부여받은인증코드 스마트빌아이디 SbId String(10) 스마트빌의사용자아이디 유효기간설정코드 ExpirationDateCode String(10) 하단의유효기간설정코드참조 인증토큰만료일 ExpirationDate String[] 사용자가지정하는만료일입력 Request Sample var request = JSON.stringify({ 'MessageId': '3267cab1-3ea6-4aa6-b988-7d27d6d5ac89', 'Signal': 'GET_TOKEN', 'RequestTime': ' ', 'SendComRegno': ' ', 'AuthCode': 'B861CF E39EDD44A6A91CCCCD', 'SbId': 'lsh31147', 'ExpirationDateCode': 'D', 'ExpirationDate': '' ); $.support.cors = true; $.ajax({ type: "POST", datatype: "json", crossdomain: true, contenttype: "application/json", url: " data: request, success: function (data) { fngetdata(data); //data 처리 ( 하단의 Response Sample 참조 ), error: function (error) { //error 처리 ); 48

49 Response 메시지ID MessageId String 요청한트랜잭션식별자 요청시그널 Signal String(30) 고정값 : GET_TOKEN 응답시간 ResponseTime String(14) YYYYMMDDHH24MISS 처리코드 ResultCode String(5) 처리결과코드 처리메시지 ResultMessage String(2000) 처리결과상세내역 처리결과 ResultDataSet DataSet Response Sample var authtoken; function fngetdata(data){ if ("30000"!= data.resultcode) { alert(data.resultmessage); alert(" 정상적으로처리되었습니다."); authtoken = data.resultdataset.table1[0].auth_token; // 인증토큰추출 유효기간설정코드 유효기간코드유효기간비고 D W H M Q R Y Z 1 일 7 일 15 일 30 일 90 일 180 일 365 일영구사용 C 사용자지정 ExpirationDate 에지정할만료일입력 49

50 2.22 공인인증서등록정보조회 스마트빌에등록된공인인증서의등록정보를조회한다 Request 메시지ID MessageId String 트랜잭션식별자 요청시그널 Signal String(30) 고정값 : GET_CERT_INFO 요청시간 RequestTime String(14) YYYYMMDDHH24MISS 송신사업자번호 SendComRegno String (13) 조회할인증서사업자번호 서비스코드 ServiceCode String(40) 고정값 : DTI Request Sample var request = JSON.stringify({ 'MessageId': '3267cab1-3ea6-4aa6-b988-7d27d6d5ac89', 'Signal': 'GET_CERT_INFO', 'RequestTime': ' ', 'SendComRegno': ' ', 'ServiceCode': 'DTI' ); $.support.cors = true; $.ajax({ type: "POST", datatype: "json", crossdomain: true, contenttype: "application/json", url: " data: request, success: function (data) { fngetdata(data); //data 처리 ( 하단의 Response Sample 참조 ), error: function (error) { //error 처리 ); 50

51 Response 메시지ID MessageId String 요청한트랜잭션식별자 요청시그널 Signal String(30) 고정값 : GET_CERT_INFO 응답시간 ResponseTime String(14) YYYYMMDDHH24MISS 처리코드 ResultCode String(5) 처리결과코드 처리메시지 ResultMessage String(2000) 처리결과상세내역 처리결과 ResultDataSet DataSet Response Sample var authtoken; function fngetdata(data){ if ("30000"!= data.resultcode) { alert(data.resultmessage); alert(" 정상적으로처리되었습니다."); authtoken = data.resultdataset.table1[0].expireday; // 인증서만료일 51