상품관리 공통 팝업

판매상태 일괄변경

post

기능설명

• 상품 또는 단품의 판매상태를 일괄변경합니다.

---

상세설명

• 상품 또는 단품의 판매상태를 일괄적으로 변경합니다.

• 상품 판매상태 일괄 변경을 하는 경우 상품번호만 입력하고 단품번호는 빈 값으로 입력합니다.

  • 상품 판매상태 일괄 변경 시에는 해당 상품의 모든 단품도 일괄적으로 상태를 변경합니다.

  • 판매중 -> 품절로 변경 시 판매중인 단품만 품절로 변경 됩니다.

  • 품절 -> 판매중으로 변경 시 단품 판매상태를 별도로 변경하지 않은 모든 품절 상태의 단품을 판매중으로 변경합니다.

  • 판매중으로 변경 시 재고가 없는 단품은 품절 배치가 작동할 때 자동으로 품절로 변경됩니다.

• 단품 판매상태 일괄 변경을 하는 경우 상품번호와 단품번호를 모두 입력합니다.

  • 단품 판매상태 일괄 변경 시 모든 단품의 판매 상태가 변경되는 경우 상품의 판매상태도 함께 변경됩니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

goodsSaleStateRequeststringOptional

Responses

200

판매상태 일괄변경 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

판매상태 일괄변경 실패

*/*

post

/v2/popup/goodsMgmtPopupApi/modifyGoodsSaleState

HTTPcURLJavaScriptPython

POST /api/bo/v2/popup/goodsMgmtPopupApi/modifyGoodsSaleState HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 223

{
  "goodsSaleStateRequest": "text",
  "goodsSaleStateList": [
    {
      "goodsNo": "text",
      "saleStatCd": "text",
      "soutCausCd": "text",
      "saleStatChgCausCd": "text",
      "itmNo": "text",
      "itmSaleStatCd": "text",
      "soutNotiYn": "text",
      "soutNotiStdQty": "text"
    }
  ]
}

{
  "timestamp": "2026-02-27T20:07:46.408Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

상품 목록 조회

get

기능설명

• 상품 목록을 조회합니다.

---

상세설명

• 검색 조건에 따라 상품 목록을 조회합니다.

• 상품번호를 입력한 경우 상품 등록기간 조건을 무시하고 전체기간 조회합니다.

---

수정번호

Release v1.04_231120

• 묶음상품 상품추가 검증 프로세스 추가

• response에 구매수량제한여부(buyQtyLmtYn), 최소제한수량(minLmtQty), 최대제한수량(maxLmtQty) 추가

Release v1.05_231204

• 검색조건에 정기배송상품여부(rglrDeliGoodsYn) 추가

Release v1.06_250609

• 타임딜 정보 조회 추가

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

상품 목록 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

상품 목록 조회 실패

*/*

get

/v2/popup/goodsMgmtPopupApi/getGoodsList

HTTPcURLJavaScriptPython

GET /api/bo/v2/popup/goodsMgmtPopupApi/getGoodsList?request=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T20:07:46.408Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "totalCount": 1,
    "payloads": [
      {
        "goodsNo": "text",
        "goodsNm": "text",
        "goodsCompCd": "text",
        "goodsTypCd": "text",
        "entrNm": "text",
        "entrNo": "text",
        "brandNm": "text",
        "saleMethCd": "text",
        "saleStatCd": "text",
        "saleStatCdNm": "text",
        "buyTypCd": "text",
        "deliProcTypCd": "text",
        "deliGoodsGbCd": "text",
        "deliWayCd": "text",
        "goodsRegDtm": "2026-02-27T20:07:46.408Z",
        "mdNm": "text",
        "dispYn": "text",
        "deliProcTypCdNm": "text",
        "deliGoodsGbCdNm": "text",
        "salePrc": 1,
        "dispDlexAmt": "text",
        "stdCtgHierarchy": "text",
        "buyrAgeLmtCd": "text",
        "buyQtyLmtYn": "text",
        "minLmtQty": 1,
        "maxLmtQty": 1,
        "stkQty": 1,
        "mileagePayYn": "text",
        "timeDealYn": "text",
        "tmdlHistStrDtm": "2026-02-27T20:07:46.408Z",
        "tmdlHistEndDtm": "2026-02-27T20:07:46.408Z",
        "tmdlSalePrc": 1,
        "rsvStrtDtm": "text",
        "rsvEndDtm": "text",
        "rglrDeliGoodsYn": "text",
        "frgnDirPurGoodsYn": "text"
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}