Business Error Codes
Brightmall Vendor API 비즈니스 에러 코드 목록입니다.
Authentication Errors
| Code | HTTP | Description |
|---|---|---|
INVALID_API_KEY | 401 | API 키가 유효하지 않음 |
EXPIRED_API_KEY | 401 | API 키가 만료됨 |
VENDOR_SUSPENDED | 403 | 입점사 계정 정지 |
VENDOR_INACTIVE | 403 | 입점사 비활성 상태 |
Order Errors
| Code | HTTP | Description |
|---|---|---|
ORDER_NOT_FOUND | 404 | 주문을 찾을 수 없음 |
INVALID_ORDER_STATUS | 400 | 유효하지 않은 주문 상태 전환 |
ORDER_ALREADY_SHIPPED | 409 | 이미 배송된 주문 |
ORDER_CANCEL_NOT_ALLOWED | 409 | 취소 불가능한 주문 상태 |
Item Errors (일괄 API의 results[].error_code)
실패한 항목은 처리되지 않습니다(그 품목은 바뀌지 않음). 고쳐서 그 항목을 다시 보내 주세요.
| Code | Description |
|---|---|
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_PRICE | total_amount ≠ unit_price x quantity 등. 수량이 몰 주문 수량과 다른 것은 오류 아님 (v1.9.0) |
SUB_ITEM_CONFLICT | (v1.9.0) 같은 품목의 세트 구성품끼리 값(재고 여부·송장·상태)이 다름 — 그 품목은 처리 안 됨 |
Shipment Errors
| Code | HTTP | Description |
|---|---|---|
INVALID_TRACKING_NUMBER | 400 | 유효하지 않은 운송장 번호 |
SHIPMENT_NOT_FOUND | 404 | 배송 정보를 찾을 수 없음 |
DUPLICATE_SHIPMENT | 409 | 이미 등록된 배송 정보 |
Settlement Errors
| Code | HTTP | Description |
|---|---|---|
SETTLEMENT_NOT_FOUND | 404 | 정산 정보를 찾을 수 없음 |
SETTLEMENT_PERIOD_INVALID | 400 | 유효하지 않은 정산 기간 |
Webhook Errors
| Code | HTTP | Description |
|---|---|---|
WEBHOOK_URL_UNREACHABLE | 400 | 웹훅 URL 접근 불가 |
WEBHOOK_LIMIT_EXCEEDED | 429 | 웹훅 등록 한도 초과 |
INVALID_WEBHOOK_EVENT | 400 | 유효하지 않은 이벤트 타입 |
General Errors
| Code | HTTP | Description |
|---|---|---|
VALIDATION_ERROR | 400 | 요청 데이터 유효성 검증 실패 |
RATE_LIMIT_EXCEEDED | 429 | API 요청 한도 초과 |
INTERNAL_ERROR | 500 | 서버 내부 오류 |
SERVICE_UNAVAILABLE | 503 | 서비스 일시 중단 |
MAINTENANCE_MODE | 503 | 시스템 점검 중 |
Last updated on