예약상품 관리

예약상품 일괄등록/해제

post

기능설명

• 예약상품 일괄등록/해제 API 입니다.

---

상세설명

• 상품번호 목록 기준으로 예약상품을 일괄등록/해제합니다.

• 예약상품 해제 시 예약 중단 사유 코드가 즉시 일반판매 전환인 경우

  • 상품 판매방식이 판매중으로 변경됩니다. 이외의 경우, 품절 처리됩니다.

  • 단품 품절 사유는 초기화 됩니다. 이외의 경우, 단품 판매 상태코드 '품절', 품절 사유코드 '예약상품 품절처리'가 적용됩니다.

---

검증내용

• 저장 시 예약상품 일괄등록/해제 정보 유효성을 검증합니다.

  • 필수 입력: 상품번호, 변경할 판매방식

  • 등록 필수 입력: 예약 주문 시작일시, 예약 주문 종료일시, 예약종료 후 판매방식

  • 해제 필수 입력: 예약 중단 사유

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

예약상품 일괄등록/해제 Request

goodsNoListstring[]Optional

상품번호 목록

Default: 10001020,10001021,10001022

itmNoListstring[]Optional

단품번호 목록

Default: 001,002,003

saleMethCdstringOptional

판매방식코드(PR003) 10:일반판매, 20:예약상품

Default: 10

rsvStrtDtmstring · date-timeOptional

예약시작일자

Default: 2023-01-01T00:00:00.000Z

rsvEndDtmstring · date-timeOptional

예약종료일자

Default: 2023-12-31T23:59:59.000Z

rsvEndAfProcMethCdstringOptional

예약종료후판매방식(PR011) 01:일반판매로 전환, 02:품절로 변경

Default: 01

rsvStopCausCdstringOptional

예약중단사유코드(PR034) 10:입고취소, 11:즉시일반판매전환, 12:판매자 사정에 의한 예약판매취소

Default: 10

fwdidcPrarDystringOptional

출고지시예정일자

Default: 20231231

Responses

200

예약상품 일괄등록/해제 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

예약상품 일괄등록/해제 실패

*/*

post

/v1/goods/reservationGoodsMgmtApi/modifyGoodsSaleMethod

HTTPcURLJavaScriptPython

POST /api/bo/v1/goods/reservationGoodsMgmtApi/modifyGoodsSaleMethod HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 240

{
  "goodsNoList": "10001020,10001021,10001022",
  "itmNoList": "001,002,003",
  "saleMethCd": "10",
  "rsvStrtDtm": "2023-01-01T00:00:00.000Z",
  "rsvEndDtm": "2023-12-31T23:59:59.000Z",
  "rsvEndAfProcMethCd": "01",
  "rsvStopCausCd": "10",
  "fwdidcPrarDy": "20231231"
}

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

예약상품 목록 조회

get

기능설명

• 예약상품 목록 조회 API 입니다.

---

상세설명

• 예약상품 정보 목록을 조회합니다.

  • 판매방식이 오름차순인 경우 상품번호 오름차순으로 정렬됩니다.

  • 판매방식이 예약상품인 경우 예약판매 시작일자 내림차순, 상품번호 오름차순으로 정렬됩니다.

• 예약판매 시작일자, 예약판매 종료일자, 예약 종료 후 판매방식, 출고지시예시정일자는 판매방식이 예약상품인 경우에만 조회됩니다.

---

코드정리

• 상품번호 검색옵션 : st:시작, in:포함, eq:같음, mt:멀티, rg:범위

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

/v1/goods/reservationGoodsMgmtApi/getReservationGoodsList

HTTPcURLJavaScriptPython

GET /api/bo/v1/goods/reservationGoodsMgmtApi/getReservationGoodsList?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",
        "color": "text",
        "size": "text",
        "lgcItmNo": "text",
        "modlNm": "text",
        "brandNm": "text",
        "goodsTypCd": "text",
        "goodsTypNm": "text",
        "saleStatCd": "text",
        "saleStatNm": "text",
        "saleMethCd": "text",
        "saleMethNm": "text",
        "entrNm": "text",
        "mdNm": "text",
        "strCtg": "text",
        "dispYn": "text",
        "buyTypNm": "text",
        "taxGbNm": "text",
        "norPrc": 1,
        "mrgnRate": 1,
        "salePrc": 1,
        "goodsRegDtm": "2026-02-27T20:07:46.408Z",
        "rsvStrtDtm": "2026-02-27T20:07:46.408Z",
        "rsvEndDtm": "2026-02-27T20:07:46.408Z",
        "fwdidcPrarDy": "text",
        "rsvEndAfProcMethCd": "text",
        "rsvEndAfProcMethNm": "text",
        "itmNo": "text",
        "rsvSaleGoodsYn": "text",
        "rsvStopYn": "text",
        "rsvStopDtm": "2026-02-27T20:07:46.408Z",
        "rsvStopCausCd": "text",
        "rsvStopCausNm": "text",
        "rsvLimtQty": 1,
        "prestYn": "text",
        "stkMgrYn": "text",
        "safeStkNotiYn": "text",
        "buyQtyLmtYn": "text",
        "deliGoodsGbNm": "text",
        "deliProcTypNm": "text",
        "supPcost": 1,
        "isSelected": true,
        "totalCount": 1
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

예약상품이력 팝업 호출

get

기능설명

• 예약상품이력 팝업 호출 API 입니다.

---

상세설명

• 상품 번호 기준으로 예약상품이력 팝업 호출 시 노출하는 상품 정보를 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

langCdstringOptional

언어코드

goodsNostringRequired

상품번호

Responses

200

예약상품이력 팝업 호출 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

예약상품이력 팝업 호출 실패

*/*

get

/v1/goods/reservationGoodsMgmtApi/getReservationGoodsInfo

HTTPcURLJavaScriptPython

GET /api/bo/v1/goods/reservationGoodsMgmtApi/getReservationGoodsInfo?goodsNo=text 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": {
    "goodsNo": "text",
    "goodsNm": "text",
    "color": "text",
    "size": "text",
    "lgcItmNo": "text",
    "modlNm": "text",
    "brandNm": "text",
    "goodsTypCd": "text",
    "goodsTypNm": "text",
    "saleStatCd": "text",
    "saleStatNm": "text",
    "saleMethCd": "text",
    "saleMethNm": "text",
    "entrNm": "text",
    "mdNm": "text",
    "strCtg": "text",
    "dispYn": "text",
    "buyTypNm": "text",
    "taxGbNm": "text",
    "norPrc": 1,
    "mrgnRate": 1,
    "salePrc": 1,
    "goodsRegDtm": "2026-02-27T20:07:46.408Z",
    "rsvStrtDtm": "2026-02-27T20:07:46.408Z",
    "rsvEndDtm": "2026-02-27T20:07:46.408Z",
    "fwdidcPrarDy": "text",
    "rsvEndAfProcMethCd": "text",
    "rsvEndAfProcMethNm": "text",
    "itmNo": "text",
    "rsvSaleGoodsYn": "text",
    "rsvStopYn": "text",
    "rsvStopDtm": "2026-02-27T20:07:46.408Z",
    "rsvStopCausCd": "text",
    "rsvStopCausNm": "text",
    "rsvLimtQty": 1,
    "prestYn": "text",
    "stkMgrYn": "text",
    "safeStkNotiYn": "text",
    "buyQtyLmtYn": "text",
    "deliGoodsGbNm": "text",
    "deliProcTypNm": "text",
    "supPcost": 1,
    "isSelected": true,
    "totalCount": 1
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

예약상품이력 조회

get

기능설명

• 예약상품 이력 조회 API 입니다.

---

상세설명

• 상품번호 기준으로 예약상품 이력 목록을 조회합니다.

  • 예약중단여부 오름차순, 수정일시 내림차순으로 정렬됩니다. (예약중단여부 N 우선 노출)

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

langCdstringOptional

언어코드

goodsNostringRequired

상품번호

Responses

200

예약상품이력 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

예약상품이력 조회 실패

*/*

get

/v1/goods/reservationGoodsMgmtApi/getReservationGoodsHistory

HTTPcURLJavaScriptPython

GET /api/bo/v1/goods/reservationGoodsMgmtApi/getReservationGoodsHistory?goodsNo=text 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",
        "color": "text",
        "size": "text",
        "lgcItmNo": "text",
        "modlNm": "text",
        "brandNm": "text",
        "goodsTypCd": "text",
        "goodsTypNm": "text",
        "saleStatCd": "text",
        "saleStatNm": "text",
        "saleMethCd": "text",
        "saleMethNm": "text",
        "entrNm": "text",
        "mdNm": "text",
        "strCtg": "text",
        "dispYn": "text",
        "buyTypNm": "text",
        "taxGbNm": "text",
        "norPrc": 1,
        "mrgnRate": 1,
        "salePrc": 1,
        "goodsRegDtm": "2026-02-27T20:07:46.408Z",
        "rsvStrtDtm": "2026-02-27T20:07:46.408Z",
        "rsvEndDtm": "2026-02-27T20:07:46.408Z",
        "fwdidcPrarDy": "text",
        "rsvEndAfProcMethCd": "text",
        "rsvEndAfProcMethNm": "text",
        "itmNo": "text",
        "rsvSaleGoodsYn": "text",
        "rsvStopYn": "text",
        "rsvStopDtm": "2026-02-27T20:07:46.408Z",
        "rsvStopCausCd": "text",
        "rsvStopCausNm": "text",
        "rsvLimtQty": 1,
        "prestYn": "text",
        "stkMgrYn": "text",
        "safeStkNotiYn": "text",
        "buyQtyLmtYn": "text",
        "deliGoodsGbNm": "text",
        "deliProcTypNm": "text",
        "supPcost": 1,
        "isSelected": true,
        "totalCount": 1
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}