바로빌 API 오류코드

이 문서에서는 바로빌 오류코드에 대해 설명합니다.


오류코드 구성

바로빌 API 의 오류코드는 음수로 된 숫자 5자리 의 형식을 갖습니다.

오류코드는 추가되거나 삭제될 수 있습니다.


오류코드 내용확인 API


GetErrString

오류코드 테이블 에 해당하는 내용을 조회하는 API입니다.

예) ErrCode 의 값에 -10002 입력 시 "해당 인증키를 찾을 수 없습니다." 가 반환됩니다.

Parameter
No 변수명 타입 길이 필수 설명
1 CERTKEY string 50 O 연동인증키
2 ErrCode int O 오류코드
Return

반환타입 : string
반환값

  • 숫자형식이 아닌 문자열 (성공. 오류코드의 설명이 반환됩니다.)
  • 음수 값 형식의 문자열 (호출실패. 오류코드 보기)

오류코드 테이블


공통


기본 오류코드

오류코드 내용
-10000 알 수 없는 오류 발생.
API 호출 중 서버오류가 발생한 경우입니다. 바로빌로 문의바랍니다.
-10003 연동서비스가 점검 중입니다.
-10004 해당 기능은 더 이상 사용되지 않습니다.
-10007 해당 기능을 사용할 수 없습니다.
-10005 최대 100건까지만 사용하실 수 있습니다.
-10006 최대 1000건까지만 사용하실 수 있습니다.
-10008 날짜형식이 잘못되었습니다.
-10148 조회 기간이 잘못되었습니다.
-40001 파일을 찾을 수 없습니다.
-40002 빈 파일입니다(0byte).

연동정보 관련

오류코드 내용
-10002 해당 인증키를 찾을 수 없습니다.
-10001 해당 인증키와 연결된 연계사가 아닙니다.
-24005 사업자번호와 아이디가 맞지 않습니다.

회원정보 관련

오류코드 내용
-32000 이미 가입된 연계사업자 입니다.
-32001 사업자번호가 유효하지 않습니다.
-32002 회사명이 유효하지 않습니다.
-32003 대표자명이 유효하지 않습니다.
-32004 업태가 유효하지 않습니다.
-32005 업종이 유효하지 않습니다.
-32006 주소가 유효하지 않습니다.
-32008 담당자명이 유효하지 않습니다.
-32010 아이디가 유효하지 않습니다.
-32015 해당 아이디는 이미 사용중입니다.
-32011 패스워드가 유효하지 않습니다.
-32012 연락처가 유효하지 않습니다.
-32013 이메일이 유효하지 않습니다.
-32016 해당 아이디를 찾을 수 없습니다.
-32017 탈퇴한 아이디입니다.

과금 관련

오류코드 내용
-26014 과금코드를 찾을 수 없습니다.
-26004 과금에 실패하였습니다.
-26006 충전잔액이 부족합니다.
-26011 연동사의 충전잔액이 부족합니다.
-26015 공급받는자의 충전잔액이 부족합니다.

문서서비스 관련


문서서비스 공통

오류코드 내용
-24011 문서 DB입력에 실패하였습니다.
-24012 문서 품목정보 DB입력에 실패하였습니다.
-24013 문서 속성정보 DB입력에 실패하였습니다.
-34021 문서 DB수정에 실패하였습니다.
-34022 문서 품목정보 DB수정에 실패하였습니다.
-34023 문서 속성정보 DB수정에 실패하였습니다.
-25102 관리번호(MgtKey)가 잘못되었습니다.
-11013 관리번호(MgtKey)가 중복되었습니다.
-11011 공급자 부여 관리번호(MgtKey)가 잘못되었습니다.
-11012 공급받는자 부여 관리번호(MgtKey)가 잘못되었습니다.
-11018 수탁자 부여 관리번호(MgtKey)가 잘못되었습니다.
-21002 해당 문서 정보가 없습니다.
-21003 해당 문서는 삭제 가능한 상태가 아닙니다.
-21005 해당 문서는 임시저장상태가 아닙니다.
-21006 해당 문서는 임시저장상태입니다.
-26000 해당 문서는 이미 발행되었거나, 임시저장상태가 아니므로 발행이 불가능합니다.
-21007 해당 문서는 취소 가능한 상태가 아닙니다.
-30000 지원되지 않는 처리요청입니다. (ProcType)
-30001 해당 처리요청은 현재 상태에는 처리할 수 없습니다.
-25101 문서형태가 올바르지 않습니다.
-26009 처리에 실패하였습니다.
-33000 첨부할 파일을 찾을 수 없습니다.
-33001 첨부파일 개수가 제한을 초과하였습니다.
-33002 일괄인쇄기능은 50건까지만 가능합니다.

세금계산서 관련

오류코드 내용
-11009 문서 형태가 잘못되었습니다. (TaxInvoiceType)
-11019 계산서 형태가 맞지 않습니다. (TaxInvoiceType, TaxType)
-11010 과세형태가 잘못되었습니다. (TaxType)
-11007 영수/청구 구분이 잘못되었습니다. (PurposeType)
-11005 발행방향이 잘못되었습니다. (IssueDirection)
-24006 발행시점이 잘못되었습니다. (IssueTiming)
-11110 공급자와 공급받는자의 사업자번호가 같습니다.
-11002 공급자 정보가 없습니다. (InvoicerParty)
-11101 공급자 사업자번호가 잘못되었습니다. (InvoicerParty.CorpNum)
-11109 공급자의 종사업자 번호는 숫자 4자리로 입력해야 합니다. (InvoicerParty.TaxRegID)
-11102 공급자 상호가 잘못되었습니다. (InvoicerParty.CorpName)
-11103 공급자 대표자명이 잘못되었습니다. (InvoicerParty.CEOName)
-11104 공급자 주소가 잘못되었습니다. (InvoicerParty.Addr)
-11105 공급자 업종이 잘못되었습니다. (InvoicerParty.BizType)
-11106 공급자 업태가 잘못되었습니다. (InvoicerParty.BizClass)
-11001 공급자 아이디가 잘못되었습니다. (InvoicerParty.ContactID)
-11107 공급자 담당자명이 잘못되었습니다. (InvoicerParty.ContactName)
-11108 공급자 이메일이 잘못되었습니다. (InvoicerParty.Email)
-11003 공급받는자 정보가 없습니다. (InvoiceeParty)
-11201 공급받는자 사업자번호가 잘못되었습니다. (InvoiceeParty.CorpNum)
-11209 공급받는자의 종사업자 번호는 숫자 4자리로 입력해야 합니다. (InvoiceeParty.TaxRegID)
-11202 공급받는자 상호가 잘못되었습니다. (InvoiceeParty.CorpName)
-11203 공급받는자 대표자명이 잘못되었습니다. (InvoiceeParty.CEOName)
-11204 공급받는자 주소가 잘못되었습니다. (InvoiceeParty.Addr)
-11205 공급받는자 업종이 잘못되었습니다. (InvoiceeParty.BizType)
-11206 공급받는자 업태가 잘못되었습니다. (InvoiceeParty.BizClass)
-11017 공급받는자 아이디가 잘못되었습니다. (InvoiceeParty.ContactID)
-11207 공급받는자 담당자명이 잘못되었습니다. (InvoiceeParty.ContactName)
-11208 공급받는자 이메일이 잘못되었습니다. (InvoiceeParty.Email)
-11004 위탁자 정보가 없습니다. (BrokerParty)
-25003 위탁자 사업자번호가 잘못되었습니다 (BrokerParty.CorpNum).
-11210 위탁자의 종사업자 번호는 숫자 4자리로 입력해야 합니다. (BrokerParty.TaxRegID)
-11301 수탁자 사업자번호가 잘못되었습니다. (BrokerParty.CorpNum)
-11302 수탁자 상호가 잘못되었습니다. (BrokerParty.CorpName)
-11303 수탁자 대표자명이 잘못되었습니다. (BrokerParty.CEOName)
-11304 수탁자 주소가 잘못되었습니다. (BrokerParty.Addr)
-11014 수탁자 아이디가 잘못되었습니다. (BrokerParty.ContactID)
-11307 수탁자 담당자명이 잘못되었습니다. (BrokerParty.ContactName)
-11308 수탁자 이메일이 잘못되었습니다. (BrokerParty.Email)
-11021 공급받는자가 외국인인 경우 비고에 추가정보를 기재하여야 합니다. (Remark1)
-11022 작성일자의 형식(YYYYMMDD)이 잘못되었습니다. (WriteDate)
-11020 작성일자를 미래일자로 발행하실 수 없습니다. (WriteDate)
-11801 권 항목이 잘못되었습니다. 숫자만 가능합니다. (Kwon)
-11802 호 항목이 잘못되었습니다. 숫자만 가능합니다. (Ho)
-11006 공급가액이 잘못되었습니다. (AmountTotal)
-11016 세액이 잘못되었습니다. (TaxTotal)
-11015 합계금액이 잘못되었습니다. (TotalAmount)
-11310 영세,면세 세금계산서는 세금이 0원이어야 합니다.
-11311 과세는 세금이 0원 이상이어야 합니다.
-11803 현금 항목이 잘못되었습니다. (Cash)
-11804 수표 항목이 잘못되었습니다. (ChkBill)
-11805 어음 항목이 잘못되었습니다. (Note)
-11806 외상미수금 항목이 잘못되었습니다. (Credit)
-11811 현금, 수표, 어음, 외상미수금의 합계가 세금계산서의 합계금액과 맞지 않습니다.
-11309 품목정보는 99개까지만 입력할 수 있습니다. (TaxInvoiceTradeLineItems)
-11023 품목정보의 공급일자 형식(YYYYMMDD)이 잘못되었습니다. (TaxInvoiceTradeLineItem.PurchaseExpiry)
-11814 품목정보의 공급일자의 월은 작성일자의 월과 같아야 합니다. (TaxInvoiceTradeLineItem.PurchaseExpiry)
-11808 품목정보의 수량이 유효하지 않습니다. (TaxInvoiceTradeLineItem.ChargeableUnit)
-11809 품목정보의 단가가 유효하지 않습니다. (TaxInvoiceTradeLineItem.UnitPrice)
-11807 품목정보의 공급가액이 유효하지 않습니다. (TaxInvoiceTradeLineItem.Amount)
-11810 품목정보의 세액이 유효하지 않습니다. (TaxInvoiceTradeLineItem.Tax)
-11812 품목정보의 공급가액, 세액이 유효하지 않습니다.
-11813 영세,면세 세금계산서는 품목정보의 세금이 0원이어야 합니다.
-11321 해당 함수는 일반세금계산서를 등록하실 수 없습니다.
-11322 당초 국세청승인번호가 입력되지 않았습니다.
-11323 당초 국세청승인번호는 바로빌을 통해 등록된 세금계산서의 승인번호만 가능합니다.
-11324 공급자의 당초 국세청승인번호가 아닙니다.
-11330 일반세금계산서를 수정세금계산서로 수정하실 수 없습니다.
-11331 수정세금계산서를 일반세금계산서로 수정하실 수 없습니다.
-11332 "과세,영세" 와 "면세" 간에 수정세금계산서를 작성하실 수 없습니다.
-11341 환입 또는 계약의해지 시 공급가액과 세액은 (-)이어야 합니다.
-26012 해당 세금계산서에 대해 가산세가 예상됩니다.
-26013 해당 세금계산서에 대해 과세기간이 종료하였거나, 발행대상이 아닙니다.
-26005 해당 세금계산서의 전자서명 과정 중 XML생성에 실패하였습니다.
-31002 해당 세금계산서는 국세청 전송이 불가한 상태입니다.
-31004 국세청 신고 과정이 진행 중이거나, 완료되었습니다.
-31007 해당 세금계산서의 전자서명 정보를 찾을 수 없습니다.
-31008 국세청 신고요청 중 알수 없는 오류가 발생하였습니다.
-31009 역발행으로 저장된 건이 아닙니다.

세금계산서 국세청 전송설정 관련

오류코드 내용
-31015 "과세" 국세청 전송설정을 잘못 설정하였습니다.
-31016 "과세" 지연발행 허용 여부를 잘못 설정하였습니다.
-31017 "면세" 국세청 전송설정을 잘못 설정하였습니다.
-31018 "면세" 지연발행 허용 여부를 잘못 설정하였습니다.

공동인증서 관련

오류코드 내용
-31100 등록된 공동인증서가 없습니다.
-26001 발행에 필요한 공동인증서가 등록되어 있지 않습니다.
-26002 등록된 공동인증서가 만료일이 지났거나, 전송일 기준 유효하지 않습니다.
-26003 등록된 공동인증서의 검증에 실패하였습니다. 재등록하여 주시기 바랍니다.

현금영수증 관련

오류코드 내용
-11701 거래일자가 잘못되었습니다. (TradeDate)
-11702 가맹점 사업자번호가 잘못되었습니다. (FranchiseCorpNum)
-11703 가맹점 아이디가 잘못되었습니다. (FranchiseMemberID)
-11704 가맹점 상호가 잘못되었습니다. (FranchiseCorpName)
-11705 가맹점 대표자명이 잘못되었습니다. (FranchiseCEOName)
-11706 가맹점 주소가 잘못되었습니다. (FranchiseAddr)
-11707 가맹점 전화번호가 잘못되었습니다. (FranchiseTel)
-11708 신분확인번호가 잘못되었습니다. (IdentityNum)
-11709 거래구분이 잘못되었습니다. (TradeType)
-11710 거래용도가 잘못되었습니다. (TradeUsage)
-11711 거래방법이 잘못되었습니다. (TradeMethod)
-11712 취소사유가 잘못되었습니다. (CancelType)
-11713 취소대상 승인번호가 잘못되었습니다. (CancelNTSConfirmNum)
-11714 취소대상 거래일자가 잘못되었습니다. (CancelNTSConfirmDate)
-11715 공급가액이 잘못되었습니다. (Amount)
-11716 부가세가 잘못되었습니다. (Tax)
-11717 봉사료가 잘못되었습니다. (ServiceCharge)
-11718 취소중 알 수 없는 오류가 발생하였습니다.
-11719 승인번호 채번에 실패하였습니다.
-11720 공급가액이 취소 가능한 금액보다 큽니다. (CancelAmount)
-11721 부가세가 취소 가능한 금액보다 큽니다. (CancelTax)
-11722 봉사료가 취소 가능한 금액보다 큽니다. (CancelServiceCharge)
-11723 추가공제가 잘못되었습니다. (TradeDeductionType)
-11724 거래용도(TradeUsage)와 신분확인번호(IdentityNum)이 일치하지 않습니다.
-21008 거래일자가 과거/미래인 경우에는 발행하실 수 없습니다.
-31114 국세청으로 전송되기 전에는 취소발행하실 수 없습니다.
-31111 이메일 전송이 불가능한 상태입니다.
-31112 SMS 전송이 불가능한 상태입니다.
-31113 FAX 전송이 불가능한 상태입니다.

전자문서 관련

오류코드 내용
-11601 전자문서 양식 코드가 유효하지 않습니다. (FormKey)
-24014 해당 문서에서 사용할 수 없는 속성입니다.
-31102 아이디가 잘못되었습니다. (UserID)
-31213 Fax 기능을 지원하지 않는 문서양식입니다.

이메일 관련

오류코드 내용
-31104 이메일 전송에 필요한 정보가 부족합니다.
-31105 거부된 건은 이메일 재전송이 불가능합니다.

스크래핑 서비스 관련


월정액 서비스 관련

오류코드 내용
-51001 서비스가 신청되지 않았습니다.
-51002 이미 신청되어 있습니다.
-51003 이미 해지되었습니다.
-51004 해지 상태가 아닙니다.
-51005 해지 당월에만 해지 취소할 수 있습니다.
-51006 해지 당월에는 재신청 할 수 없습니다. 해지 취소로 진행해주세요.

홈택스 매입매출조회 관련

오류코드 내용
-50401 홈택스 로그인 방법이 잘못 입력되었습니다.
-50402 홈택스 아이디가 입력되지 않았습니다.
-50403 홈택스 비밀번호가 입력되지 않았습니다.
-50404 홈택스 로그인에 실패하였습니다. 아이디, 비밀번호를 확인해 주시기 바랍니다.
-50405 바로빌에 등록된 공동인증서가 홈택스에 등록된 공동인증서가 아닙니다.
-50406 홈택스 전자세금계산서 전용 부서사용자 아이디가 아닙니다.
-50407 홈택스 현금영수증자료조회용 부서사용자 아이디가 아닙니다.
-50408 다른 사업자의 홈택스 계정입니다.
-50409 홈택스 로그인에 실패하였습니다. 잠시 후 다시 시도해 주시기 바랍니다.

사업자등록 상태조회 관련

오류코드 내용
-50301 일시적으로 휴폐업조회에 실패하였습니다. (홈택스 점검 등의 사유)

카드조회 관련

오류코드 내용
-50101 카드를 찾을 수 없습니다.
-50102 카드를 조회할 권한이 없습니다.
-50111 카드사 코드가 잘못 입력되었습니다.
-50112 카드유형이 잘못 입력되었습니다.
-50113 카드번호가 잘못 입력되었습니다.
-50114 카드사 홈페이지 아이디가 잘못 입력되었습니다.
-50115 카드사 홈페이지 비밀번호가 잘못 입력되었습니다.
-50116 카드사 홈페이지 로그인에 실패하였습니다. 카드 정보를 확인해 주시기 바랍니다.
-50117 카드사 홈페이지 로그인에 실패하였습니다. 잠시 후 다시 시도해 주시기 바랍니다.
-50118 이미 등록된 카드번호입니다.
-50119 테스트베드는 최대 2개까지만 등록할 수 있습니다.

계좌조회 관련

오류코드 내용
-50001 계좌를 찾을 수 없습니다.
-50002 계좌를 조회할 권한이 없습니다.
-50004 일일 즉시조회 횟수(10회)를 초과하였습니다.

메시징 서비스 관련


문자전송 관련

오류코드 내용
-10100 발송예약시간 계산오류
-10101 해당 발송정보가 없습니다.
-31101 SMS 전송에 필요한 정보가 부족합니다.
-31103 LMS 제목은 40자까지만 입력가능합니다.
-10123 MMS 전송에 필요한 제목이 없습니다.
-10124 MMS 전송에 필요한 이미지 파일정보가 없습니다.
-10125 MMS 전송 가능한 이미지 파일크기를 초과하였습니다.
-10126 MMS 전송 가능한 이미지의 크기를 초과하였습니다.
-10127 MMS 전송 가능한 이미지 타입은 JPG입니다.
-10128 MMS 전송에 필요한 이미지 파일명이 입력되지 않았습니다.
-10170 080 수신거부 되었습니다.
-10190 이미 등록된 발신번호입니다.
-10191 번호의 형식이 올바르지 않습니다.
-10192 사전등록되지 않은 발신번호로 문자를 전송할 수 없습니다.

문자전송 실패코드

오류코드 내용
-10104 음영지역
-10106 메시지 저장 개수 초과
-10107 잘못된 전화번호
-10116 이통사에서 SPAM처리됨
-10131 MMS 미 지원 단말
-10132 중복전송에러
-10158 발송 미허용 시간 때 발송 실패 처리
-10185 웹문자 발신 차단번호
-10186 기타오류

팩스전송 관련

오류코드 내용
-31204 FAX 전송에 필요한 정보가 부족합니다.
-31205 취소/거부된 문서는 FAX 전송이 불가능합니다.
-31207 역발행 문서는 FAX 기능을 지원하지 않습니다.
-10146 파일은 최대 10개까지 전송하실 수 있습니다.
-31210 팩스전송을 위한 파일생성에 실패하였습니다.
-31211 팩스전송을 위한 파일을 찾을 수 없습니다.
-31214 90일이 경과된 건은 재전송하실 수 없습니다.
-31215 파일명이 입력되지 않았습니다.