헥토파이낸셜 개발자센터

현금영수증 발급오류내역 조회 API

국세청 발급 오류내역을 조회합니다. 등록요청일자 기준 익일 13시 이후부터 조회 가능합니다.

주의사항

도메인 주의

이 API는 domain2 (tb-nspay / nspay)를 사용합니다.
NOTE

오류내역 조회

오류내역은 등록요청일자 기준 익일부터 조회할 수 있으며, 조회 가능 시간은 13시 이후입니다. 국세청 작업으로 결과 수신이 늦어지면 조회 결과 확인도 지연되며, 조회할 수 없는 동안에는 2001 오류코드가 반환됩니다. 이 API에서는 재처리 건의 오류내역을 조회할 수 없습니다. 재처리 건은 현금영수증 재처리 결과내역 조회 API를 이용하세요.

TSN은 정상 발급 건입니다

오류코드가 TSN인 거래는 문화비 대상 사업자 미등록으로 인해 거래유형이 일반 소득공제로 변경되어 국세청에 정상 발급된 건입니다. 실패 건으로 재처리하지 말고 국세청 오류코드 안내에서 상세 사유를 확인하세요.

API 정보

GET/POST/pgtrans/CashReceiptMultiAction.do?_method=getReceiptErrList
Content-Type
요청application/x-www-form-urlencoded;charset=UTF-8
응답text/plain;charset=UTF-8
테스트https://tb-nspay.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=getReceiptErrList
운영https://nspay.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=getReceiptErrList

요청 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└midAN(10)영문+숫자, 최대 10byte*
상점아이디
*헥토파이낸셜에서 발급받은 가맹점 ID
└trDtGbA(1)영문, 최대 1byte*
거래일자 조회구분
1: 등록 시 요청한 trDt 기준 (취소 시 API 요청일자) 2: 국세청 전송일자 기준
*1: 등록은 요청한 trDt, 취소는 취소 API 요청일자를 기준으로 조회
2: 국세청 전송일자를 기준으로 조회
국세청 전송일자는 API 요청일의 익일이며 국세청 작업에 따라 변동될 수 있음
└trDt1N(8)숫자, 최대 8byte*
조회시작일자 (yyyyMMdd)
*조회할 기간의 시작일자를 yyyyMMdd 형식으로 입력
└trDt2N(8)숫자, 최대 8byte
조회종료일자 (yyyyMMdd)
*기간 조회 시 종료일자를 yyyyMMdd 형식으로 입력
조회기간은 최대 7일
일일 데이터만 조회할 때는 빈 값으로 요청하며 trDt1 날짜를 기준으로 조회
└ordNoAN(40)영문+숫자, 최대 40byte
주문번호
*특정 거래만 조회할 때 등록/취소 API 요청의 transNo 값을 입력
└authNoAN(9)영문+숫자, 최대 9byte
승인번호
*특정 거래만 조회할 때 등록/취소 API 응답의 authNo 값을 입력

응답 파라미터

응답 데이터는 CSV 형식입니다.

No필드명설명
1거래일시등록/취소 API 응답의 trTime 값
2주문번호등록/취소 API 요청의 transNo 값
3등록/취소구분0: 승인, 1: 취소
4승인번호현금영수증 승인번호
5오류코드국세청 등록 결과 오류코드

요청 예시

https://tb-nspay.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=getReceiptErrList
&mid=mid_test
&trDtGb=1
&trDt1=20180301

응답 예시

오류

조회 오류 시에는 다른 필드 없이 오류코드만 반환됩니다. 아래 예시의 2001은 국세청 결과를 아직 수신하지 못한 상태이므로 잠시 후 다시 조회해야 합니다.

2001

성공

20171207001336,test1234,0,F61839890,BLO
20171207003238,test1235,0,F61840946,BLO
20171207004750,test1236,0,F61841883,BLO
20171207011728,test1237,0,F61843540,TS2
20171207025839,test1238,0,F61847416,BLO

조회결과 오류코드

코드설명
1000상점아이디 오류
1001상점정보 없음
1003거래일자 오류
2000오류 거래 없음
2001국세청 결과 미수신, 잠시 후 다시 조회 요망
9999시스템 오류

국세청 등록 결과 오류코드

조회 결과에 포함될 수 있는 국세청 오류코드입니다.

오류 원인, 자동재처리 가능 여부 및 처리 방법은 국세청 등록 결과 오류코드 페이지를 참조하세요.

❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?