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취소 불가능한 주문 상태

Item Errors (일괄 API의 results[].error_code)

실패한 항목은 처리되지 않습니다(그 품목은 바뀌지 않음). 고쳐서 그 항목을 다시 보내 주세요.

CodeDescription
INVALID_ORD_PRD_NO주문품목번호를 읽을 수 없음 ({주문번호}_[{인덱스}] 또는 세트 구성품 {주문번호}_[{인덱스}]^s{n})
LINE_ITEM_NOT_FOUND주문에 없는 주문품목번호
UNAUTHORIZED다른 입점사 품목
ORD_PRD_NO_MISMATCH재고 확정 PUT: ord_no 와 다른 주문의 품목번호
ORDER_NOT_FOUND_OR_NO_VENDOR_ITEMS재고 확정 PUT: 이 주문에 처리 전 내 품목이 없음 (HTTP 404)
INVALID_SUPPLY_PRICEtotal_amount ≠ unit_price x quantity 등. 수량이 몰 주문 수량과 다른 것은 오류 아님 (v1.9.0)
SUB_ITEM_CONFLICT(v1.9.0) 같은 품목의 세트 구성품끼리 값(재고 여부·송장·상태)이 다름 — 그 품목은 처리 안 됨

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