현금영수증 필수입력항목

2017.07.28

안녕하세요. 고객사와 함께 성장하는 비즈니스 파트너 링크허브 입니다.

고객사에서 링크허브에서 제공하는 현금영수증 API를 통해 임시저장 시 필수입력항목에 대해 안내해 드리도록 하겠습니다. 현금영수증 정보 기재시 주의 할 점은 거래유형(tradeUsage)에 따라 거래처 식별번호(identityNum) 항목에 유효한 값을 입력해야 합니다. 유효하지 않은 거래처 식별번호를 기재하는 경우 국세청 신고시 실패할 수 있으니 주의하시기 바랍니다.

현금영수증 정보

현금영수증 정보 입력항목은 아래와 같습니다. 모든 값은 문자열(String) 타입입니다. 필수 여부와 비고란의 설명을 참조하여 올바른 값을 입력하여 주시기 바랍니다.

항목명 변수명 타입 필수 비고
문서관리번호 mgtKey String

– 파트너가 부여하는 문서관리번호

– 최대 24자리 영문, 숫자 ‘-‘, ‘_’로 구성

[참고 : 전자문서 관리번호 체계]

거래유형 tradeUsage String

‘소득공제용’, ‘지출증빙용’ 중 기재
현금영수증 형태 tradeType String

‘승인거래’, ‘취소거래’ 중 기재
과세형태 taxationType String

‘과세’, ‘비과세’ 중 기재
공급가액 supplyCost String

숫자만 가능
세액 tax String

숫자만 가능
봉사료 serviceFee String

숫자만 가능
거래금액 totalAmount String

숫자만 가능

발행자(가맹점) 정보

발행자(가맹점) 정보 입력항목은 아래와 같습니다. 모든 값은 문자열(String) 타입입니다. 필수 여부와 비고란의 설명을 참조하여 올바른 값을 입력하여 주시기 바랍니다.

항목명 변수명 타입 필수 비고
발행자 사업자번호 franchiseCorpNum String

‘-‘제외, 10자리
발행자 상호명 franchiseCorpName String
발행자 대표자성명 franchiseCorpName String
가맹점 주소 framchoseAddr String
가맹점 전화번호 franchiseTEL String

거래처 정보

거래처 정보 입력항목은 아래와 같습니다. 모든 값은 문자열(String) 타입입니다. 거래처 식별번호를 잘못 입력하는 경우 국세청 신고가 실패할 수 있습니다. 설명을 참조하여 거래유형별 거래처 식별번호를 정확하게 입력하여 주시기 바랍니다.

항목명 변수명 타입 필수 비고
거래처 식별번호 identityNum String

* 거래유형(tradeUsage)이 ‘소득공제용’인 경우

– (주민등록/휴대폰/카드)번호 기재

* 거래유형(tradeUsage)이 ‘지출증빙용’인 경우

– (주민등록/휴대폰/카드/사업자)번호 기재

고객명 customerName String
상품명 itemName String
가맹점주문번호 orderNumber String
이메일 email String
휴대폰 hp String

부가정보

부가정보 입력항목은 아래와 같습니다. 발행시 SMS 안내문자 전송 기능입니다.

항목명 변수명 타입 필수 비고
SMS 전송여부 smssendYN String

“false” 또는 “true”중 기재, 미기재시 “false”

지금까지 현금영수증 필수입력항목에 대해 안내해 드렸습니다. 현금영수증 API에 대한 자세한 사항은 [링크허브 자료실 > 현금영수증 API 연동매뉴얼] 참조하시기 바랍니다.

고객님들의 편의를 위하여 이메일, 전화 등 다양한 채널을 열어놓고 있으니 언제든지 연락주시기 바랍니다.

링크허브 개발팀 정요한 과장 / T.1600-9854 / D. 070-4304-2991/ E. code@linkhub.co.kr