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