고객사에서 (세금)계산서 임시저장(Register) API를 통해 (세금)계산서 등록하는 경우 필수로 입력해야하는 항목에 대해 안내해 드리도록 하겠습니다. 먼저 발행형태와 관계없이 ‘(세금)계산서 정보’, ‘공급자 정보’, ‘공급받는자 정보’ 관련된 항목은 필수입력항목이며, 발행형태가 위수탁(세금)계산서인 경우에는 ‘수탁자 정보’, 수정(세금)계산서인 경우에는 ‘수정(세금)계산서 정보’ 가 필수입력항목입니다.
세금계산서 정보
발행형태에 관계없이 필수로 입력해야 하는 (세금)계산서 항목은 아래와 같습니다. 비고란의 항목별 유의사항을 참조하시기 바랍니다.
| 항목명 | 변수명 | 타입 | 비고 |
|---|---|---|---|
| 발행형태 | issueType | String | ‘정발행’, ‘역발행’, ‘위수탁’ 중 기재 |
| 과세형태 | taxType | String | ‘과세’, ‘영세’, ‘면세’ 중 기재 |
| 발행시점 | issueTiming | String | ‘직접발행’, ‘승인시자동발행’ 중 기재 |
| 과금방향 | chargeDirection | String | ‘정과금(공급자 과금)’, ‘역과금(공급받는자 과금)’ 중 기재 단, 역과금은 역발행시에만 가능. |
| 작성일자 | writeDate | String | 작성형식 : yyyyMMdd, 예) 20150302 |
| 영수/청구 | purposeType | String | ‘영수’, ‘청구’ 중 기재 |
| 공급가액 합계 | supplyCostTotal | String | 숫자만 가능 |
| 세액 합계 | taxTotal | String | 숫자만 가능 |
| 합계금액 | totalAmount | String | 숫자만 가능 (=공급가액합계+세액합계) |
공급자 정보
공급자 정보에 대한 필수입력항목은 아래와 같습니다. 발행형태가 정발행인 경우 공급자 문서관리번호(invoicerMgtKey) 항목은 필수입력 항목입니다.
| 항목명 | 변수명 | 타입 | 비고 |
|---|---|---|---|
| 공급자 문서관리번호 | invoicerMgtKey | String |
– 파트너가 부여하는 공급자 관리번호 – 최대 24자리 영문, 숫자 ‘-‘, ‘_’로 구성 |
| 공급자 사업자번호 | invoicerCorpNum | String | 숫자만 기재(‘-‘ 제외, 10자리) |
| 공급자 상호명 | invoicerCorpName | String | |
| 대표자 성명 | invoicerCEOName | String | |
| 담당자명 | invoicerContactName | String |
공급받는자 정보
공급자받는자 정보에 대한 필수입력 항목은 아래와 같습니다. 발행형태가 역발행인 경우 공급받는자 문서관리번호(invoiceeMgtKey) 항목은 필수입력 항목입니다.
| 항목명 | 변수명 | 타입 | 비고 |
|---|---|---|---|
| 공급받는자 문서관리번호 | invoiceeMgtKey | String |
– 파트너가 부여하는 공급받는자 문서관리번호 – 최대 24자리 영문, 숫자 ‘-‘, ‘_’로 구성 |
| 공급받는자 구분 | invoiceeType | String | ‘사업자’, ‘개인’, ‘외국인’ 중 기재 |
| 사업자 번호 | invoiceeCorpNum | String | 숫자만 기재 (‘-‘ 제외, 10자리) |
| 상호 | invoiceeCorpName | String | |
| 대표자 성명 | invoiceeCEOName | String | |
| 담당자명 | invoiceeContactName1 | String |
수탁자 정보 – 위수탁 세금계산서 발행시 필수
수탁자 정보는 (세금)계산서 정보의 발행형태(issueType) 항목이 ‘위수탁’ 인 경우 필수입력항목입니다. 수탁자 문서관리번호(trusteeMgtKey) 항목은 필수입력 항목입니다.
| 항목명 | 변수명 | 타입 | 비고 |
|---|---|---|---|
| 수탁자 문서관리번호 | trusteeMgtKey | String |
– 파트너가 부여하는 수탁자 문서관리번호 – 최대 24자리 영문, 숫자 ‘-‘, ‘_’로 구성 |
| 수탁자 사업자번호 | trusteeCorpNum | String | 숫자만 기재 (‘-‘ 제외, 10자리) |
| 상호 | trusteeCorpName | String | |
| 대표자 성명 | trusteeCEOName | String | |
| 담당자명 | trusteeContactName | String |
수정세금계산서 정보 – 수정세금계산서 발행시 필수
수정(세금)계산서 정보는 수정(세금)계산서 발행시 필수입력항목입니다. 수정사유코드는 정수(Integer) 타입이며, 원본 팝빌 관리번호는 원본 문서관리번호를 사용하여 상태/요약정보 조회(GetInfo/GetInfos) API 응답전문에서 itemKey 값을 통해 확인할 수 있습니다.
| 항목명 | 변수명 | 타입 | 비고 |
|---|---|---|---|
| 수정 사유코드 | modifyCode | Integer |
1 : 기재사항 착오정정 2 : 공급가액 변동 3 : 환입 4 : 계약의 해지 5 : 내국신용장 사후개설 6 : 착오에 의한 이중발행 |
| 원본 팝빌 관리번호 | originalTaxinvoiceKey | String |
– 원본 (세금)계산서의 ItemKey 값 기재 – GetInfo(문서정보조회) API의 응답전문 확인 |
지금까지 전자세금계산서 API의 임시저장 시 필수입력항목에 대해 안내해 드렸습니다. 전자세금계산서 API에 대한 자세한 사항은 [ 링크허브 자료실 > 전자세금계산서 API 연동매뉴얼 ] 참조하시기 바랍니다.
고객님들의 편의를 위하여 이메일, 전화 등 다양한 채널을 열어놓고 있으니 언제든지 연락주시기 바랍니다.
링크허브 개발팀 정요한 과장 / T.1600-9854 / D. 070-4304-2991/ E. code@linkhub.co.kr