현금영수증 재처리 결과내역 조회 API
재처리 건의 결과내역을 조회하는 API입니다.
주의사항
도메인 주의
이 API는 domain2 (tb-nspay / nspay)를 사용합니다.
NOTE
재처리 결과 조회 시점
재처리 요청 내역은 원거래 발급일자 기준 D+2에 국세청으로 전송된 뒤 결과가 반영됩니다. 국세청 작업 상황에 따라 결과 조회 가능 시간이 지연될 수 있습니다.
마지막 재처리 결과를 보관하세요
동일 거래가 여러 번 재처리되면 응답의 재처리일자와 재처리 승인번호에는 마지막 재처리 거래의 값이 반환됩니다. 취소와 사후 조회에 필요하므로 가맹점 시스템에서 최신 값으로 관리하세요.
- 재처리 결과내역 조회 시 국세청 작업에 따라 조회 결과가 지연될 수 있습니다.
- 자동재처리 가맹점의 경우 재처리 불가 오류코드는 가맹점에서 직접 확인이 필요합니다.
- 재처리 건의 승인번호와 발급일자는 가맹점에서 관리해야 합니다.
API 정보
GET/POST/pgtrans/CashReceiptMultiAction.do?_method=getReceiptReReqList
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=getReceiptReReqList운영
https://nspay.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=getReceiptReReqList요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└midAN(10)영문+숫자, 최대 10byte*상점아이디
상점아이디
└searGbA(1)영문, 최대 1byte*조회구분
조회구분
1: 전체 결과 조회 (재처리 대상, 불가 건 모두) 2: 신규채번된 승인번호로 재처리된 건만 3: 재처리 요청일자 기준 조회*3은 실제 재처리를 요청한 건만 조회되며, 재처리 불가 건은 조회되지 않습니다.
└trDtN(8)숫자, 최대 8byte*조회일자 (yyyyMMdd)
조회일자 (yyyyMMdd)
*searGb 1,2: 원거래 발급일자, searGb 3: 국세청 발송일자(원거래 D+2)
응답 파라미터
응답 데이터는 CSV 형식입니다.
| No | 필드명 | 설명 |
|---|---|---|
| 1 | 원거래 발급일자 | 최초 발급요청한 거래의 발급일자 |
| 2 | 원거래 승인번호 | 최초 발급요청한 거래의 승인번호 |
| 3 | 주문번호 | 가맹점 요청 주문번호 |
| 4 | 등록/취소구분 | 0: 등록, 1: 취소 |
| 5 | 원거래 오류코드 | 국세청 오류코드 |
| 6 | 재처리 결과코드 | 00: 정상, 09: 오류(자동재처리 대상), 99: 오류(자동재처리 미대상) |
| 7 | 재처리결과 상세 코드 | 하단 '재처리 결과 상세코드' 참조 |
| 8 | 재처리일자 | 최종 재처리 발급일자 |
| 9 | 재처리 승인번호 | 최종 재처리 승인번호 |
| 10 | 자진발급여부 | Y: 자진발급번호, N: 아님 |
재처리 결과 상세코드
| 결과코드 | 상세코드 | 설명 |
|---|---|---|
| 00 | 01, 02 | 01: 국세청 발송 전 (재처리 건 취소 요청 시), 02: 국세청 발송 후 |
| 09 | (오류코드) | 국세청 오류코드 참조 |
| 99 | 99 | 재처리 불가 |
요청 예시
https://tb-nspay.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=getReceiptReReqList
&mid=mid_test
&trDt=20180401
&searGb=1
응답 예시
오류
2001
성공
20180401004649,F69214247,test_20180401_1,0,TS1,00,02,20171129004649,F62615388,Y
20180401080321,F69226149,test_20180401_2,0,TS2,00,02,20171129080321,F62615390,Y
20180401082658,F69227439,test_20180401_3,0,TS2,00,02,20171129082658,F62615391,Y
20180401234651,F61174103,test_20180401_4,0,BLO,99,BLO,,,N
20180401233717,F61172881,test_20180401_5,0,BLO,99,BLO,,,N
20180401230629,F61169147,test_20180401_6,0,BLO,99,BLO,,,N
국세청 등록 결과 오류코드
조회 결과에 포함될 수 있는 국세청 오류코드입니다.
전체 오류코드 목록은 국세청 오류코드 페이지를 참조하세요.
