v1 Version Policy

Versioning Strategy

Brightmall Vendor API는 Semantic Versioning (SemVer) 을 따릅니다.


MAJOR.MINOR.PATCH

Type	When	Example
MAJOR	Breaking changes	1.x → 2.0
MINOR	New features (backward-compatible)	1.6 → 1.7
PATCH	Bug fixes	1.7.0 → 1.7.1

v1.9.1 (2026-11-09)

API 동작 변경 없음 — 문서 안내·정정만.

주문 처리 플로우(간소화): 부분출하에 거래명세서를 동봉할 때는 명세서 요청 전에 이번에 나가는 품목만 넣어 재고 확정 PUT — 안내 추가
주문 처리 플로우 부분출하 시나리오 예시: 회차마다 그 회차에 나가는 품목만 재고 확인 → 명세서 → 배송 등록 흐름으로 다시 씀
거래명세서 포함·제외 라인(주문 처리 플로우·PDF·JSON·플레이그라운드 안내): 재고 확인을 보낸 주문은 재고 있음으로 확인한 라인만 포함, PUT에서 빠진 라인은 null로 돌아가지 않고 입고 대기로 제외 — 현재 동작으로 정정
주문 처리 플로우 Step 2: 재고 확인 단계의 공급가는 저장만, 정산은 배송 등록 시 생성 — 문구 정정

세트 구성품 번호 {주문품목번호}^s{n} — 재고 확인(POST·PUT)·배송 등록·배송 수정·상태 변경. 같은 품목의 구성품은 한 품목으로 처리, 결과에 base_ord_prd_no
supply_price.quantity = 몰 주문 수량(몰 판매단위), unit_price = 몰 판매단위 1개당. 수량이 달라도 거절하지 않고 기록(quantity_mismatch)
재고 확정 PUT: 읽을 수 없는 번호는 INVALID_ORD_PRD_NO, 주문 품목으로 찾지 못한 항목이 있으면 빠진 품목 표시 안 함(omission_skipped_reason). 빠진 품목은 취소가 아니라 상태 유지 + 입고 대기 표시