에러코드 : -11001038 “동일한 공급자 관리번호가 등록되어 있습니다."

안녕하세요. 새로운 가치를 연결하는 비지니스 파트너 링크허브 입니다. 

링크허브에서 제공하는 API 상품을 사용중인 시스템에 연동하시면서 자주 발생하는 "동일한 공급자 관리번호가 등록되어 있습니다." 에러메시지의 발생원인을 알아보고 해결방법을 안내드리도록 하겠습니다. 먼저 관리번호에 대해 안내드리고, 해당 오류메시지의 발생원인과 해결방법, 추가로 참고사항을 안내하는 순서로 진행하겠습니다.

▶해결방법 바로가기

▶ 관리번호?

팝빌 전자세금계산서 API를 이용하여 생성한 전자문서는 3개의 관리번호(파트너 관리번호, 팝빌 관리번호, 국세청 승인번호)를 보유하며, 3개의 관리번호를 하나의 체계로 묶어서 관리합니다. 이 중 파트너 관리번호(MgtKey)는 파트너가 전자문서 관리를 위해 임으로 부여하는 키값으로, 팝빌 회원(사업자)별로 중복되지 않도록 생성해야 합니다. 전자세금계산서 API의 경우 발행유형에 따른 관리번호를 생성해야 하며, 자세한 내용은 다음 표를 참고해 주시기 바랍니다.

▶ "동일한 공급자 관리번호가 등록되어 있습니다." 오류메시지 발생원인

공급자 관리번호란 정발행 세금계산서 작성 시 생성하는 관리번호입니다. 관리번호는 팝빌 회원(사업자)별로 중복되지 않게 생성해야 하는데, 이미 생성된 관리번호를 재사용했을때 이와 같은 오류메시지가 발생하게 됩니다. 해당 오류메시지를 확인하기 위해 2건의 세금계산서에 동일한 관리번호를 부여해 발행한 결과를 확인해보도록 하겠습니다.

본 테스트는 PHP SDK를 이용하여 진행하도록 하겠습니다. 세금계산서 즉시발행시 공급자 문서관리번호 항목에 "2018_MGTKEY_TEST"를 기재한 뒤 발행해 보도록 하겠습니다.

  $invoicerMgtKey = '2018_MGTKEY_TEST';

<PHP SDK 즉시발행(RegistIssue)시 공급자 문서관리번호(invoiverMgtKey) 항목 입력값>

사용중인 문서관리번호가 아니기 때문에, 정상적으로 발행된 것을 다음과 같이 확인할 수 있습니다.

동일한 문서관리번호를 기재하여 세금계산서를 재발행하면 다음과 같은 메시지가 확인됩니다.

▶ 해결방법

문서관리번호는 중복사용이 불가하므로, 사용되지 않은 문서관리번호를 생성해주시면 해당 오류메시지를 해결하실 수 있습니다. 세금계산서 발행 전 CheckMgtKeyInUse API를 사용하여 문서관리번호의 사용여부를 체크하신 뒤, 미사용중인 문서관리번호를 생성해 주시면 보다 정확한 처리가 가능합니다.

위의 테스트에서 사용했던 문서관리번호의 사용여부를 CheckMgtKeyInUse API를 이용하여 체크해보겠습니다. 사용여부를 체크할 문서관리번호에는 "2018_MGTKEY_TEST"값을, 발행유형에는 "SELL"을 기재한 후 API를 호출하였습니다.

  // 세금계산서 관리번호
  $mgtKey = '2018_MGTKEY_TEST';

  // 발행유형 (매출/매입/위수탁)
  $mgtKeyType = ENumMgtKeyType::SELL;

해당 관리번호("2018_MGTKEY_TEST")는 이미 사용 했기 때문에, 다음과 같은 결과가 나온것을 확인할 수 있습니다.

▶ 참고사항

전자명세서 API, 현금영수증 API를 이용하여 생성한 전자문서도 3개의 관리번호를 보유합니다. (전자명세서의 경우 국세청 신고대상이 아니므로 파트너 관리번호, 팝빌 관리번호를 보유합니다.) 이 중 문서관리번호가 중복되어 사용될 경우 다음과 같은 메시지가 나옵니다. 이 때, 세금계산서 API와 동일하게 CheckMgtKeyInUse API를 사용하여 사용여부를 체크한 뒤, 미사용중인 문서관리번호를 생성해주시면 됩니다.

<전자명세서 API - 중복된 문서관리번호 사용시 나타나는 메시지>

<현금영수증 API - 중복된 문서관리번호 사용시 나타나는 메시지>

---

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

기술지원센터 / T. 1600-9854 / E. code@linkhub.co.kr