Skip to Content
API v1.7.0 Released - Settlement order number query + partial shipment support
Error CodesBusiness Error Codes

Business Error Codes

Brightmall Vendor API 비즈니스 에러 코드 목록입니다.

Authentication Errors

CodeHTTPDescription
INVALID_API_KEY401API 키가 유효하지 않음
EXPIRED_API_KEY401API 키가 만료됨
VENDOR_SUSPENDED403입점사 계정 정지
VENDOR_INACTIVE403입점사 비활성 상태

Order Errors

CodeHTTPDescription
ORDER_NOT_FOUND404주문을 찾을 수 없음
INVALID_ORDER_STATUS400유효하지 않은 주문 상태 전환
ORDER_ALREADY_SHIPPED409이미 배송된 주문
ORDER_CANCEL_NOT_ALLOWED409취소 불가능한 주문 상태

Shipment Errors

CodeHTTPDescription
INVALID_TRACKING_NUMBER400유효하지 않은 운송장 번호
SHIPMENT_NOT_FOUND404배송 정보를 찾을 수 없음
DUPLICATE_SHIPMENT409이미 등록된 배송 정보

Settlement Errors

CodeHTTPDescription
SETTLEMENT_NOT_FOUND404정산 정보를 찾을 수 없음
SETTLEMENT_PERIOD_INVALID400유효하지 않은 정산 기간

Webhook Errors

CodeHTTPDescription
WEBHOOK_URL_UNREACHABLE400웹훅 URL 접근 불가
WEBHOOK_LIMIT_EXCEEDED429웹훅 등록 한도 초과
INVALID_WEBHOOK_EVENT400유효하지 않은 이벤트 타입

General Errors

CodeHTTPDescription
VALIDATION_ERROR400요청 데이터 유효성 검증 실패
RATE_LIMIT_EXCEEDED429API 요청 한도 초과
INTERNAL_ERROR500서버 내부 오류
SERVICE_UNAVAILABLE503서비스 일시 중단
MAINTENANCE_MODE503시스템 점검 중
Last updated on