재고 확인 및 공급가 사전 등록

주문 품목의 재고 상태를 확인하고, 선택적으로 공급가를 사전 등록합니다.

Endpoint


POST /vendor-api/inventory/confirm

요청 파라미터

필드	타입	필수	설명
`confirmations`	array	O	확인 항목 배열 (최대 100건)
`confirmations[].ord_prd_no`	string	O	주문품목번호
`confirmations[].stock_available`	boolean	O	재고 가용 여부 (`true`: 출고 가능, `false`: 출고 불가)
`confirmations[].unavailable_reason`	string	조건부	출고 불가 사유 (`stock_available=false` 시 필수)
`confirmations[].memo`	string	-	메모 (최대 500자)
`confirmations[].supply_price`	object	-	공급가 정보 (공통 스키마 참조)

unavailable_reason 허용값

값	설명
`out_of_stock`	재고 부족 (품절)
`reserved`	다른 주문에 예약됨
`damaged`	상품 파손
`discontinued`	단종
`other`	기타 사유

요청 예시


curl -X POST "https://brightmall-backend.certi.life/vendor-api/inventory/confirm" \
  -H "Content-Type: application/json" \
  -H "X-Vendor-Api-Key: bm_xOpGAqgHbJQBXxBBbUIZ_bAGZk4wK2FdLgF50277PU8" \
  -H "X-Vendor-Id: 01KC51ST1WSTAET481SHPH3PSY" \
  -d '{
    "confirmations": [
      {
        "ord_prd_no": "202601220157_000020196_[1]",
        "stock_available": true,
        "supply_price": {
          "unit_price": 75000,
          "quantity": 2,
          "total_amount": 150000
        }
      },
      {
        "ord_prd_no": "202601220157_000020196_[2]",
        "stock_available": false,
        "unavailable_reason": "out_of_stock",
        "memo": "재입고 예정일: 2026-02-15"
      }
    ]
  }'

응답 예시


{
  "request_id": "req_mkp3inv_abc123",
  "timestamp": "2026-01-29T07:00:00.000Z",
  "success_count": 2,
  "failure_count": 0,
  "available_count": 1,
  "unavailable_count": 1,
  "results": [
    {
      "ord_prd_no": "202601220157_000020196_[1]",
      "success": true,
      "stock_available": true,
      "new_status": "preparing",
      "supply_price_recorded": true,
      "message": "Inventory confirmed and supply price recorded"
    },
    {
      "ord_prd_no": "202601220157_000020196_[2]",
      "success": true,
      "stock_available": false,
      "new_status": "pending",
      "message": "Item marked as unavailable: out_of_stock"
    }
  ]
}

응답 필드 설명

필드	타입	설명
`success_count`	number	처리 성공 건수
`failure_count`	number	처리 실패 건수
`available_count`	number	재고 가용 건수
`unavailable_count`	number	재고 불가 건수
`results[].ord_prd_no`	string	주문품목번호
`results[].success`	boolean	처리 성공 여부
`results[].stock_available`	boolean	재고 가용 여부
`results[].new_status`	string	변경된 품목 상태
`results[].supply_price_recorded`	boolean	공급가 기록 여부 (supply_price 입력 시에만 포함)
`results[].message`	string	처리 결과 메시지

참고사항

이 API는 선택사항이지만, 공급가를 사전에 등록하면 정산이 자동 생성되어 거래명세서를 미리 확인할 수 있습니다.
이미 재고 확인한 품목을 다시 확인할 수 있습니다 (멱등성 지원).
출고 불가로 등록한 품목도 나중에 stock_available: true로 다시 호출하여 출고 가능으로 변경할 수 있습니다.