전자문서 관리번호 운영체계 안내

2017.07.28

팝빌에서 제공하는 전자세금계산서, 전자명세서, 현금영수증 API를 이용하여 생성한 전자문서 한 장당 3개의 관리번호(파트너 관리번호, 팝빌 관리번호, 국세청 승인번호)를 보유하며, 3개의 관리번호를 하나의 체계로 묶어서 관리합니다. 전자문서 관리번호는 모두 팝빌에 관리하며, 전자세금계산서와 현금영수증을 국세청으로 암호화되어 함께 전송됩니다. (단, 전자명세서는 국세청 신고대상이 아닙니다.)

팝빌의 전자문서 관리번호는 다음과 같이 구성됩니다.

파트너 관리번호 (MgtKey)
파트너가 연동 데이터 관리를 위해 임으로 부여(중복사용 불가) 하며, 팝빌로 데이터를 전송하기 전에 생성하여 전송합니다.
※ 파트너란, 링크허브에서 제공하는 API 상품을 시스템에 연동하고, 최종 고객에게 시스템을 공급하는 기업이나 개인을 지칭합니다.
파트너에 대한 자세한 소개는 링크허브 홈페이지 [파트너 > 파트너 소개] 참조하기 바랍니다.
팝빌 관리번호 (ItemKey)
팝빌에서 문서관리를 위해 임의로 부여(중복사용 불가) 되며, 파트너가 팝빌에 전자문서를 전송하여 등록되는 동시에 생성됩니다.
국세청 승인번호 (NTSConfirmNum)
국세청 신고를 위해 표준시스템사업자 팝빌(표준인증번호: 제41000029호)에서 부여하는 고유값으로 전자문서 발행과 동시에 생성됩니다.

파트너 관리번호 구성 예시

파트너 관리번호는 시스템을 연동하는 파트너가 전자문서 관리를 목적으로 임으로 부여하는 키값으로 1~24 자리로 구성하며, 영문(대/소문자 구분없음), 숫자, ‘-‘, ‘_’ 를 조합하여 사용자별(사업자번호로 구분)로 중복되지 않도록 생성해야 합니다.

바른 예 틀린 예
1234560001 (숫자 사용) 12345670001특 (한글 사용불가)
123456-0001 (숫자, ‘-‘ 사용) %1234567/0001 (‘-‘, ‘_’ 이외 특수문자 사용불가)
A123456-0001 (숫자, 영문, ‘-‘로 사용) 123\4567&0001# (‘-‘, ‘_’ 이외 특수문자 사용불가)
A-123456_0001 (숫자, 영문, ‘-‘, ‘_’ 사용) 123  4567  0001 (‘ ‘ 공백 사용불가)

지금까지 전자문서 관리번호에 대해 안내해드렸습니다. 전자문서 API에 대한 자세한 정보가 필요한 경우 링크허브 홈페이지 [ 링크허브 홈페이지 > 연동자료실 ]에서 해당하는 개발언어의 연동매뉴얼을 참조하시기 바랍니다.

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

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