바로빌 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 | 파일명이 입력되지 않았습니다. |