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

POST /vendor-api/inventory/confirm

curl -X POST "https://brightmall-backend.certi.life/vendor-api/inventory/confirm" \
  -H "Content-Type: application/json" \
  -H "X-Vendor-Api-Key: <발급받은 API 키>" \
  -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,
      "previous_status": "pending",
      "new_status": "preparing",
      "supply_price_recorded": true,
      "message": "재고 확인 및 공급가 등록 완료"
    },
    {
      "ord_prd_no": "202601220157_000020196_[2]",
      "success": true,
      "stock_available": false,
      "previous_status": "pending",
      "new_status": "cancel_requested",
      "supply_price_recorded": false,
      "message": "재고 부족 확인 (취소 요청 접수)"
    }
  ]
}

PUT /vendor-api/inventory/confirm

curl -X PUT "https://brightmall-backend.certi.life/vendor-api/inventory/confirm" \
  -H "Content-Type: application/json" \
  -H "X-Vendor-Api-Key: $API_KEY" \
  -H "X-Vendor-Id: $VENDOR_ID" \
  -d '{
    "ord_no": "202610301742_000028212",
    "confirmations": [
      { "ord_prd_no": "202610301742_000028212_[1]^s1", "stock_available": true,
        "supply_price": { "unit_price": 1100, "quantity": 12, "total_amount": 13200 } },
      { "ord_prd_no": "202610301742_000028212_[1]^s2", "stock_available": true,
        "supply_price": { "unit_price": 1100, "quantity": 12, "total_amount": 13200 } },
      { "ord_prd_no": "202610301742_000028212_[2]", "stock_available": true,
        "supply_price": { "unit_price": 7000, "quantity": 3, "total_amount": 21000 } }
    ]
  }'

{
  "request_id": "req_put_abc123",
  "timestamp": "2026-10-30T10:00:00.000Z",
  "success_count": 3,
  "failure_count": 0,
  "available_count": 3,
  "unavailable_count": 0,
  "results": [
    {
      "ord_prd_no": "202610301742_000028212_[1]^s1",
      "base_ord_prd_no": "202610301742_000028212_[1]",
      "success": true,
      "stock_available": true,
      "previous_status": "pending",
      "new_status": "preparing",
      "supply_price_recorded": false,
      "message": "재고 확인 완료 (세트 구성품 2건을 주문품목 202610301742_000028212_[1] 한 줄로 처리 — 구성품 공급가는 검토용으로만 기록, 몰 공급가 유지)"
    },
    {
      "ord_prd_no": "202610301742_000028212_[1]^s2",
      "base_ord_prd_no": "202610301742_000028212_[1]",
      "success": true,
      "stock_available": true,
      "previous_status": "pending",
      "new_status": "preparing",
      "supply_price_recorded": false,
      "message": "재고 확인 완료 (세트 구성품 2건을 주문품목 202610301742_000028212_[1] 한 줄로 처리 — 구성품 공급가는 검토용으로만 기록, 몰 공급가 유지)"
    },
    {
      "ord_prd_no": "202610301742_000028212_[2]",
      "success": true,
      "stock_available": true,
      "previous_status": "pending",
      "new_status": "preparing",
      "supply_price_recorded": true,
      "message": "재고 확인 및 공급가 등록 완료"
    }
  ],
  "omitted_count": 1,
  "omitted_and_cancelled": [
    {
      "ord_prd_no": "202610301742_000028212_[3]",
      "previous_status": "pending",
      "new_status": "pending",
      "message": "Item omitted from PUT confirmations (status kept, marked confirm_excluded_at; include it in a later PUT/POST confirm when stock arrives)"
    }
  ]
}

{
  "success_count": 0,
  "failure_count": 1,
  "results": [
    {
      "ord_prd_no": "202610301742_000028212_[1]-3",
      "success": false,
      "stock_available": true,
      "message": "Invalid ord_prd_no format: 202610301742_000028212_[1]-3 (expected {ord_no}_[n], or {ord_no}_[n]^s{m} for a set sub-item)",
      "error_code": "INVALID_ORD_PRD_NO"
    }
  ],
  "omitted_count": 0,
  "omitted_and_cancelled": [],
  "omission_skipped_reason": "Omitted lines were NOT marked because some items could not be matched to this vendor's lines on order 202610301742_000028212: 202610301742_000028212_[1]-3(INVALID_ORD_PRD_NO). Fix those items and resend the PUT. ..."
}