2. 현금영수증 정보확인

2.1. GetInfo - 상태 확인

현금영수증 1건의 상태 및 요약정보를 확인합니다.
리턴값 TCashbillInfo 의 변수 'stateCode'를 통해 현금영수증의 상태코드를 확인합니다.

function GetInfo(CorpNum : String; MgtKey : String) : TCashbillInfo;

Parameters

순번	변수명	타입	길이	필수	설명
	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
	MgtKey	String	24	Y	파트너가 할당한 문서번호

Return

TCashbillInfo

Throws

EPopbillException

2.2. GetInfos - 다수건 상태 확인

다수건의 현금영수증 상태 및 요약 정보를 확인합니다. (1회 호출 시 최대 1,000건 확인 가능)
리턴값 TCashbillInfo 의 변수 'stateCode'를 통해 현금영수증의 상태코드를 확인합니다.

function GetInfos(CorpNum : String; MgtKeyList : Array Of String) : TCashbillInfoList;

문서번호를 통해 현금영수증 목록을 구현하는 경우 활용합니다.

Parameters

순번	변수명	타입	길이	필수	설명
	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
	MgtKeyList	Array Of String		Y	조회할 현금영수증 문서번호 최대 : 1,000건

Return

Array of TCashbillInfo

Throws

EPopbillException

2.3. GetDetailInfo - 상세정보 확인

현금영수증 1건의 상세정보를 확인합니다.

function GetDetailInfo(CorpNum : String; MgtKey : String) : TCashbill;

Parameters

순번	변수명	타입	길이	필수	설명
	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
	MgtKey	String	24	Y	파트너가 할당한 문서번호

Return

TCashbill

Throws

EPopbillException

2.4. CheckMgtKeyInUse - 문서번호 사용 여부 확인

파트너가 현금영수증 관리 목적으로 할당하는 문서번호 사용여부를 확인합니다.
이미 사용 중인 문서번호는 중복 사용이 불가하고, 현금영수증이 삭제된 경우에만 문서번호의 재사용이 가능합니다.

function CheckMgtKeyInUse(CorpNum : String; MgtKey : String) : boolean;

Parameters

순번	변수명	타입	길이	필수	설명
	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
	MgtKey	String	24	Y	확인할 문서번호

Return

boolean - true : (사용중) / false : (미사용중)

Throws

EPopbillException

2.5. Search - 목록 조회

검색조건에 해당하는 현금영수증을 조회합니다. (최대 조회기간 : 6개월)

function Search(CorpNum : String; DType : String; SDate : String; EDate : String; State : Array Of String; TradeType : Array Of String; TradeUsage : Array Of String; TaxationType : Array Of String; QString : String; Page : Integer; PerPage : Integer; Order : String; TradeOpt : Array of String; FranchiseTaxRegID : String) : TCashbillSearchList;

페이지 관련 항목(Page, PerPage, Order)을 활용하여 현금영수증 목록 페이지 기능을 구현할 수 있습니다.

Parameters

변수명	타입	길이	필수	설명
CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
DType	String	1	Y	조회 기준일자 유형 (택 1) R등록일자 T거래일자 I발행일시
SDate	String	8	Y	조회 기간의 시작일자 형식 : yyyyMMdd
EDate	String	8	Y	조회 기간의 종료일자 형식 : yyyyMMdd
State	Array Of String		Y	현금영수증 상태코드 2, 3번째 자리에 와일드카드() 사용가능. 예) "3*" [참고] 팝빌 상태코드 기본값 : 전체조회
TradeType	Array Of String		Y	현금영수증 문서형태 (다중 선택 가능) N승인 현금영수증 C취소 현금영수증 기본값 : 전체조회
TradeUsage	Array Of String		Y	거래구분 (다중 선택 가능) P소득공제용 C지출증빙용 기본값 : 전체조회
TaxationType	Array Of String		Y	과세형태 (다중 선택 가능) T과세 N비과세
QString	String	-	Y	조회 검색어(식별번호) 기본값 : 전체조회
Page	Integer	-	N	목록 페이지번호 기본값 : 1
PerPage	Integer	-	N	페이지당 표시할 목록 건수 최대 : 1,000건 기본값 : 500건
Order	String	1	Y	조회 기준일자 유형을 기준으로 하는 목록 정렬 방향 D내림차순 : 기본값 A오름차순
TradeOpt	Array Of String		Y	거래유형 (다중 선택 가능) N일반 B도서공연 T대중교통 기본값 : 전체조회
FranchiseTaxRegID	String	-	Y	가맹점 종사업장번호 다수건 검색시 콤마(',')로 구분. 예) 1234,1000 기본값 : 전체조회

Return

TCashbillSearchList

Throws

EPopbillException

2.6. GetURL - 팝빌 현금영수증 문서함 관련 URL

로그인 상태로 팝빌 사이트의 현금영수증 문서함 메뉴에 접근할 수 있는 페이지의 팝업 URL을 반환합니다.
반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.

function GetURL(CorpNum : String; UserID : String; TOGO : String) : String;

Parameters

변수명	타입	길이	필수	설명
CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
UserID	String	50	N	팝빌회원 아이디
TOGO	String	-	Y	접근 메뉴 (택 1) TBOX임시 문서함 PBOX발행 문서함 WRITE현금영수증 작성

Return

String - 요청에 대한 응답 URL

Throws

EPopbillException