안녕하세요. 고객사와 함께 성장하는 비즈니스 파트너 링크허브 입니다.
고객사에서 링크허브에서 제공하는 현금영수증 API를 통해 임시저장 시 필수입력항목에 대해 안내해 드리도록 하겠습니다. 현금영수증 정보 기재시 주의 할 점은 거래구분(tradeUsage)에 따라 거래처 식별번호(identityNum) 항목에 유효한 값을 입력해야 합니다. 유효하지 않은 거래처 식별번호를 기재하는 경우 국세청 신고시 실패할 수 있으니 주의하시기 바랍니다.
현금영수증 정보
현금영수증 정보 입력항목은 아래와 같습니다. 모든 값은 문자열(String) 타입입니다. 필수 여부와 비고란의 설명을 참조하여 올바른 값을 입력하여 주시기 바랍니다.
| 항목명 | 변수명 | 타입 | 필수 | 비고 |
|---|---|---|---|---|
| 문서관리번호 | mgtKey | String |
○ |
– 파트너가 부여하는 문서관리번호 – 최대 24자리 영문, 숫자 ‘-‘, ‘_’로 구성 |
| 문서형태 | tradeType | String |
○ |
‘승인거래’, ‘취소거래’ 중 기재 |
| 거래구분 | tradeUsage | String |
○ |
‘소득공제용’, ‘지출증빙용’ 중 기재 |
| 거래유형 | tradeOpt | 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 | – | |
| 이메일 | String | – | ||
| 휴대폰 | hp | String | – |
부가정보
부가정보 입력항목은 아래와 같습니다. 발행시 SMS 안내문자 전송 기능입니다.
| 항목명 | 변수명 | 타입 | 필수 | 비고 |
|---|---|---|---|---|
| SMS 전송여부 | smssendYN | String |
○ |
“false” 또는 “true”중 기재, 미기재시 “false” |
지금까지 현금영수증 필수입력항목에 대해 안내해 드렸습니다. 현금영수증 API에 대한 자세한 사항은 [링크허브 자료실 > 현금영수증 API 연동매뉴얼] 참조하시기 바랍니다.
고객님들의 편의를 위하여 이메일, 전화 등 다양한 채널을 열어놓고 있으니 언제든지 연락주시기 바랍니다.
링크허브 개발팀 정요한 과장 / T.1600-9854 / D. 070-4304-2991/ E. code@linkhub.co.kr