단품 정보 관리

단품 품절 처리

post

기능설명

단품을 품절 처리합니다.

상세설명

단품 목록을 품절 처리합니다.
배송 모듈의 결품 관리에서 결품 처리를 위해 호출됩니다.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Bodyobject · PrItmBase[]

단품기본

goodsNostringOptional

상품번호

itmNostringOptional

단품번호

optnCatNm1stringOptional

옵션분류명_1

optnNm1stringOptional

옵션명_1

optnCatNm2stringOptional

옵션분류명_2

optnNm2stringOptional

옵션명_2

optnCatNm3stringOptional

옵션분류명_3

optnNm3stringOptional

옵션명_3

optnCatNm4stringOptional

옵션분류명_4

optnNm4stringOptional

옵션명_4

optnCatNm5stringOptional

옵션분류명_5

optnNm5stringOptional

옵션명_5

lgcItmNostringOptional

자체단품번호

itmSaleStatCdstringOptional

단품판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 40:판매종료

itmSaleStatCdNmstringOptional

단품판매상태코드명

saleStatChgCausCdstringOptional

판매상태변경사유코드(PR058) 41:판매종료(정상) 42:판매종료(삭제)

repItmYnstringOptional

대표단품여부

dispSeqinteger · int32Optional

전시순서

addSupPcostnumberOptional

추가공급원가

addSalePrcnumberOptional

추가판매가

soutCausCdstringOptional

품절사유코드(PR032) 10:발송불가 자동품절처리, 11:재고수량 0 품절처리, 12:관리자 수동품절처리, 13:익일배송지연 자동품절처리, 14:모든단품품절로 상품 품절처리, 15:예약상품 품절처리, 16:묶음상품 품절로 인한 품절

limtQtyinteger · int32Optional

예약한정수량

stkQtyinteger · int32Optional

재고수량

safeStkNotiYnstringOptional

안전재고 알림여부

safeStkQtyinteger · int32Optional

안전재고수량

optnCatNo1stringOptional

옵션분류번호_1

optnNo1stringOptional

옵션번호_1

optnCatNo2stringOptional

옵션분류번호_2

optnNo2stringOptional

옵션번호_2

optnCatNo3stringOptional

옵션분류번호_3

optnNo3stringOptional

옵션번호_3

optnCatNo4stringOptional

옵션분류번호_4

optnNo4stringOptional

옵션번호_4

optnCatNo5stringOptional

옵션분류번호_5

optnNo5stringOptional

옵션번호_5

giftRegistDefaultValuestringWrite-onlyOptional

addSupPcostByMargnnumberWrite-onlyOptional

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/goodsItemMgmtApi/soldOutGoodsItemList

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

[
  {
    "goodsNo": "text",
    "itmNo": "text",
    "optnCatNm1": "text",
    "optnNm1": "text",
    "optnCatNm2": "text",
    "optnNm2": "text",
    "optnCatNm3": "text",
    "optnNm3": "text",
    "optnCatNm4": "text",
    "optnNm4": "text",
    "optnCatNm5": "text",
    "optnNm5": "text",
    "lgcItmNo": "text",
    "itmSaleStatCd": "text",
    "itmSaleStatCdNm": "text",
    "saleStatChgCausCd": "text",
    "repItmYn": "text",
    "dispSeq": 1,
    "addSupPcost": 1,
    "addSalePrc": 1,
    "soutCausCd": "text",
    "limtQty": 1,
    "stkQty": 1,
    "safeStkNotiYn": "text",
    "safeStkQty": 1,
    "optnCatNo1": "text",
    "optnNo1": "text",
    "optnCatNo2": "text",
    "optnNo2": "text",
    "optnCatNo3": "text",
    "optnNo3": "text",
    "optnCatNo4": "text",
    "optnNo4": "text",
    "optnCatNo5": "text",
    "optnNo5": "text",
    "giftRegistDefaultValue": "text",
    "addSupPcostByMargn": 1
  }
]

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

단품관리 목록 저장

post

기능설명

단품관리 목록을 저장합니다.

상세설명

단품관리 목록에서 재고수량, 안전재고 기준수량, 안전재고 알림 여부 등의 정보를 수정 및 저장합니다.
필수값이 입력되지 않은 경우 오류를 반환합니다.
- 필수값: 상품번호, 단품번호

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

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/goodsItemMgmtApi/saveGoodsItemList

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

{
  "all": [
    {
      "goodsNo": "text",
      "itmNo": "text",
      "optnCatNm1": "text",
      "optnNm1": "text",
      "optnCatNm2": "text",
      "optnNm2": "text",
      "optnCatNm3": "text",
      "optnNm3": "text",
      "optnCatNm4": "text",
      "optnNm4": "text",
      "optnCatNm5": "text",
      "optnNm5": "text",
      "lgcItmNo": "text",
      "itmSaleStatCd": "text",
      "itmSaleStatCdNm": "text",
      "saleStatChgCausCd": "text",
      "repItmYn": "text",
      "dispSeq": 1,
      "addSupPcost": 1,
      "addSalePrc": 1,
      "soutCausCd": "text",
      "limtQty": 1,
      "stkQty": 1,
      "safeStkNotiYn": "text",
      "safeStkQty": 1,
      "optnCatNo1": "text",
      "optnNo1": "text",
      "optnCatNo2": "text",
      "optnNo2": "text",
      "optnCatNo3": "text",
      "optnNo3": "text",
      "optnCatNo4": "text",
      "optnNo4": "text",
      "optnCatNo5": "text",
      "optnNo5": "text",
      "giftRegistDefaultValue": "text",
      "addSupPcostByMargn": 1
    }
  ],
  "create": [
    {
      "goodsNo": "text",
      "itmNo": "text",
      "optnCatNm1": "text",
      "optnNm1": "text",
      "optnCatNm2": "text",
      "optnNm2": "text",
      "optnCatNm3": "text",
      "optnNm3": "text",
      "optnCatNm4": "text",
      "optnNm4": "text",
      "optnCatNm5": "text",
      "optnNm5": "text",
      "lgcItmNo": "text",
      "itmSaleStatCd": "text",
      "itmSaleStatCdNm": "text",
      "saleStatChgCausCd": "text",
      "repItmYn": "text",
      "dispSeq": 1,
      "addSupPcost": 1,
      "addSalePrc": 1,
      "soutCausCd": "text",
      "limtQty": 1,
      "stkQty": 1,
      "safeStkNotiYn": "text",
      "safeStkQty": 1,
      "optnCatNo1": "text",
      "optnNo1": "text",
      "optnCatNo2": "text",
      "optnNo2": "text",
      "optnCatNo3": "text",
      "optnNo3": "text",
      "optnCatNo4": "text",
      "optnNo4": "text",
      "optnCatNo5": "text",
      "optnNo5": "text",
      "giftRegistDefaultValue": "text",
      "addSupPcostByMargn": 1
    }
  ],
  "update": [
    {
      "goodsNo": "text",
      "itmNo": "text",
      "optnCatNm1": "text",
      "optnNm1": "text",
      "optnCatNm2": "text",
      "optnNm2": "text",
      "optnCatNm3": "text",
      "optnNm3": "text",
      "optnCatNm4": "text",
      "optnNm4": "text",
      "optnCatNm5": "text",
      "optnNm5": "text",
      "lgcItmNo": "text",
      "itmSaleStatCd": "text",
      "itmSaleStatCdNm": "text",
      "saleStatChgCausCd": "text",
      "repItmYn": "text",
      "dispSeq": 1,
      "addSupPcost": 1,
      "addSalePrc": 1,
      "soutCausCd": "text",
      "limtQty": 1,
      "stkQty": 1,
      "safeStkNotiYn": "text",
      "safeStkQty": 1,
      "optnCatNo1": "text",
      "optnNo1": "text",
      "optnCatNo2": "text",
      "optnNo2": "text",
      "optnCatNo3": "text",
      "optnNo3": "text",
      "optnCatNo4": "text",
      "optnNo4": "text",
      "optnCatNo5": "text",
      "optnNo5": "text",
      "giftRegistDefaultValue": "text",
      "addSupPcostByMargn": 1
    }
  ],
  "delete": [
    {
      "goodsNo": "text",
      "itmNo": "text",
      "optnCatNm1": "text",
      "optnNm1": "text",
      "optnCatNm2": "text",
      "optnNm2": "text",
      "optnCatNm3": "text",
      "optnNm3": "text",
      "optnCatNm4": "text",
      "optnNm4": "text",
      "optnCatNm5": "text",
      "optnNm5": "text",
      "lgcItmNo": "text",
      "itmSaleStatCd": "text",
      "itmSaleStatCdNm": "text",
      "saleStatChgCausCd": "text",
      "repItmYn": "text",
      "dispSeq": 1,
      "addSupPcost": 1,
      "addSalePrc": 1,
      "soutCausCd": "text",
      "limtQty": 1,
      "stkQty": 1,
      "safeStkNotiYn": "text",
      "safeStkQty": 1,
      "optnCatNo1": "text",
      "optnNo1": "text",
      "optnCatNo2": "text",
      "optnNo2": "text",
      "optnCatNo3": "text",
      "optnNo3": "text",
      "optnCatNo4": "text",
      "optnNo4": "text",
      "optnCatNo5": "text",
      "optnNo5": "text",
      "giftRegistDefaultValue": "text",
      "addSupPcostByMargn": 1
    }
  ]
}

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

재고수량 일괄 변경

post

기준수량

단품의 재고수량을 일괄 변경합니다.

상세설명

선택한 단품들의 재고수량을 일괄 변경합니다.
재고관리 여부가 'Y'일 경우에만 변경되며, 'N'일 경우 요청이 반영되지 않습니다.
필수값 미입력 시 오류를 반환합니다.
- 필수값: 상품번호, 단품번호, 재고수량

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

단품 재고수량 변경 DTO

goodsItemStockQuantityRequeststringOptional

단품 재고수량 변경 DTO

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/goodsItemMgmtApi/modifyGoodsItemStockQuantity

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

{
  "goodsItemStockQuantityRequest": "text",
  "goodsItemStockQuantityList": [
    {
      "goodsNo": "text",
      "itmNo": "text",
      "stkQty": 1
    }
  ]
}

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

안전재고 알림 기준 수량 일괄 변경

post

기능설명

단품의 안전재고 알림 기준수량을 일괄 변경합니다.

상세설명

선택한 단품들의 안전재고 알림 기준수량을 일괄 변경합니다.
안전재고 알림 여부가 'Y'일 경우에만 변경되며, 'N'일 경우 반영되지 않습니다.
안전재고알림여부가 'N'인 경우, 안전재고알림기준수량이 초기화됩니다.
필수값 미입력 시 오류를 반환합니다.
- 필수값: 상품번호, 단품번호, 안전재고알림 기준수량

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

단품관리 API Request DTO

goodsRegStartDtmstring · date-timeOptional

상품등록 시작일자

goodsRegEndDtmstring · date-timeOptional

상품등록 종료일자

mdIdstringOptional

담당 MD 아이디

stdCtgNostringOptional

표준분류카테고리번호

saleStatCdstringOptional

판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 30:판매종료", example = "10"

entrNostringOptional

협력사번호

deliProcTypCdstringOptional

배송처리유형

itmSaleStatCdstringOptional

단품판매상태

safeStkNotiYnstringOptional

안전재고 알림여부

lowStkYnstringOptional

재고부족 여부

regDtAllstringOptional

전체기간 검색여부

modUserIdstringOptional

수정자 아이디

stkMgrYnstringOptional

재고수량관리여부

brandNostringOptional

브랜드번호

lgcItmNostringOptional

업체단품번호

goodsNmstringOptional

상품명

goodsNostringOptional

상품번호

goodsNoOptstringOptional

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

goodsNoListstringOptional

상품번호목록

goodsNoArrstring[]Optional

상품번호배열

goodsNoFromstringOptional

상품번호시작

goodsNoTostringOptional

상품번호끝

soutCausCdstringOptional

품절사유코드(PR032)

soutNotiStdQtystringOptional

품절알림기준수량

stkQtystringOptional

재고수량

goodsSaleStateRequeststringOptional

상품 판매상태 요청 DTO

goodsItemStockQuantityRequeststringOptional

상품 재고관리 요청 DTO

goodsItemSoldOutNotificationRequeststringOptional

상품 품절알림 요청 DTO

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/goodsItemMgmtApi/modifyGoodsItemSoldOutNotificationYn

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

{
  "goodsRegStartDtm": "2026-01-01T00:00:00.000Z",
  "goodsRegEndDtm": "2026-01-01T00:00:00.000Z",
  "mdId": "text",
  "stdCtgNo": "text",
  "saleStatCd": "text",
  "entrNo": "text",
  "deliProcTypCd": "text",
  "itmSaleStatCd": "text",
  "safeStkNotiYn": "text",
  "lowStkYn": "text",
  "regDtAll": "text",
  "modUserId": "text",
  "stkMgrYn": "text",
  "brandNo": "text",
  "lgcItmNo": "text",
  "goodsNm": "text",
  "goodsNo": "text",
  "goodsNoOpt": "text",
  "goodsNoList": "text",
  "goodsNoArr": [
    "text"
  ],
  "goodsNoFrom": "text",
  "goodsNoTo": "text",
  "soutCausCd": "text",
  "soutNotiStdQty": "text",
  "stkQty": "text",
  "goodsSaleStateRequest": "text",
  "goodsSaleStateList": [
    {
      "goodsNo": "text",
      "saleStatCd": "text",
      "soutCausCd": "text",
      "saleStatChgCausCd": "text",
      "itmNo": "text",
      "itmSaleStatCd": "text",
      "soutNotiYn": "text",
      "soutNotiStdQty": "text"
    }
  ],
  "goodsItemStockQuantityRequest": "text",
  "goodsItemStockQuantityList": [
    {
      "goodsNo": "text",
      "itmNo": "text",
      "stkQty": 1
    }
  ],
  "goodsItemSoldOutNotificationRequest": "text",
  "goodsItemSoldOutNotificationList": [
    {
      "goodsNo": 100000001,
      "itmNo": "text",
      "safeStkNotiYn": "text",
      "safeStkQty": 10
    }
  ]
}

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

단품 정보 조회

get

기능설명

특정 상품의 단품 정보를 조회합니다.

상세설명

단품 기본 조회, 단품 옵션정보를 조회합니다.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

goodsNostringRequired

langCdstringRequired

Responses

200

단품 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

단품 조회 실패

*/*

get/v1/goods/goodsItemMgmtApi/getItemOptionInfo

GET /api/bo/v1/goods/goodsItemMgmtApi/getItemOptionInfo?goodsNo=text&langCd=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "prGoodsBase": {
      "goodsNo": "text",
      "goodsNm": "text",
      "modlNm": "text",
      "homeNm": "text",
      "mfcoNm": "text",
      "incomNm": "text",
      "salemnNm": "text",
      "manufYm": "text",
      "schKwdNm": "text",
      "seoTitleNm": "text",
      "seoDesc": "text",
      "seoKwdNm": "text",
      "lgcGoodsNo": "text",
      "entrNo": "text",
      "stdCtgNo": "text",
      "goodsCompCd": "text",
      "goodsTypCd": "text",
      "saleMethCd": "text",
      "brandNo": "text",
      "safeCertiTgtYn": "text",
      "buyrAgeLmtCd": "text",
      "dispYn": "text",
      "saleStatCd": "text",
      "aprvReqDt": "text",
      "saleStatChgCausCd": "text",
      "soutCausCd": "text",
      "goodsRegDtm": "2026-01-01T00:00:00.000Z",
      "saleStrDtm": "2026-01-01T00:00:00.000Z",
      "saleEndDtm": "2026-01-01T00:00:00.000Z",
      "buyTypCd": "text",
      "taxGbCd": "text",
      "stkMgrYn": "text",
      "buyQtyLmtYn": "text",
      "minLmtQty": 1,
      "maxLmtQty": 1,
      "deliProcTypCd": "text",
      "deliGoodsGbCd": "text",
      "deliWayCd": "text",
      "deliDday": 1,
      "itmSoutNotiYn": "text",
      "deliPolcNo": "text",
      "deliPsbRgnCd": "text",
      "rtnPsbYn": "text",
      "exchPsbYn": "text",
      "prcCompaExpYn": "text",
      "pkgGoodsPrioRnkCd": "text",
      "bpckPsbYn": "text",
      "hsCd": "text",
      "safeStkNotiYn": "text",
      "rglrDeliGoodsYn": "text",
      "regInfPathCd": "text",
      "aprvDt": "text",
      "retnCausCd": "text",
      "retnCausCdNm": "text",
      "retnCaus": "text",
      "retnDt": "text",
      "schPsbYn": "text",
      "optnYn": "text",
      "optnCDYn": "text",
      "goodsNoArray": [
        "text"
      ],
      "szGdeUseYn": "text",
      "szGdeRegMethodCd": "text",
      "szGdeCd": "text",
      "szGdeConts": "text",
      "gftWthdYn": "text",
      "milgRsrvPsbYn": "text",
      "gvgfPsbYn": "text",
      "frgnDirPurGoodsYn": "text",
      "entrGoodsNo": "text",
      "ordCnclPsbYn": "text",
      "wthdYn": "text",
      "ecpnAplyTermGbCd": "text",
      "ecpnIssuDdStdUseDds": 1,
      "ecpnUsePsbStrDt": "2026-01-01",
      "ecpnUsePsbEndDt": "2026-01-01",
      "entrNm": "text",
      "brandNm": "text",
      "stdCtgHierarchy": "text",
      "mdId": "text",
      "mdNm": "text",
      "goodsNotiLisartCd": "text",
      "safeCertiNeedYn": "text",
      "trdTypCd": "text",
      "mrgnRateGbCd": "text",
      "mrgnRate1": 1,
      "mrgnRate2": 1
    },
    "prGoodsCurrentPrce": {
      "goodsNo": "text",
      "histStrDtm": "2026-01-01T00:00:00.000Z",
      "histEndDtm": "2026-01-01T00:00:00.000Z",
      "supPcost": 1,
      "norPrc": 1,
      "salePrc": 1,
      "eventPrc": 1,
      "mrgnRate": 1,
      "goodsPrceTypCd": "text",
      "prcChgCausCd": "text",
      "prcChgCausCdNm": "text",
      "timeDealYn": "text"
    },
    "prRsvSaleHistList": [
      {
        "goodsNo": "text",
        "rsvStrtDtm": "2026-01-01T00:00:00.000Z",
        "rsvEndDtm": "2026-01-01T00:00:00.000Z",
        "rsvEndAfProcMethCd": "text",
        "rsvStopYn": "text",
        "rsvStopCausCd": "text",
        "rsvStopDtm": "2026-01-01T00:00:00.000Z",
        "fwdidcPrarDy": "text"
      }
    ],
    "prGoodsItemInfoList": [
      {
        "goodsNo": "text",
        "goodsNotiLisartCd": "text",
        "goodsNotiItemCd": "text",
        "notiItemCmt": "text"
      }
    ],
    "prGoodsSafeCertiHistList": [
      {
        "goodsNo": "text",
        "safeCertiGbCd": "text",
        "safeCertiNo": "text",
        "aplyStrDt": "text",
        "aplyEndDt": "text",
        "safeCertiOrnNm": "text"
      }
    ],
    "prGoodsAttInfoList": [
      {
        "langCd": "text",
        "goodsNo": "text",
        "attCd": "text",
        "attVal": "text",
        "stdCtgNo": "text"
      }
    ],
    "prGoodsPayMeanInfoList": [
      {
        "goodsNo": "text",
        "payWayCd": "text",
        "useYn": "text"
      }
    ],
    "prItmOptnInfoList": [
      {
        "goodsNo": "text",
        "optnCatNo": "text",
        "optnCatNm": "text",
        "optnNo": "text",
        "optnNm": "text",
        "optnCatSortSeq": "text",
        "optnCatRegGbCd": "text",
        "optnCatRegGbNm": "text",
        "optnCatTypCd": "text",
        "optnCatTypCdNm": "text",
        "optnList": [
          {
            "langCd": "text",
            "goodsNo": "text",
            "optnCatNo": "text",
            "optnNo": "text",
            "optnCatNm": "text",
            "optnNm": "text",
            "optnCatSortSeq": 1,
            "optnSortSeq": 1
          }
        ],
        "imgPathNm": "text",
        "imgFileNm": "text",
        "rgbVal": "text"
      }
    ],
    "prItmBaseList": [
      {
        "goodsNo": "text",
        "itmNo": "text",
        "optnCatNm1": "text",
        "optnNm1": "text",
        "optnCatNm2": "text",
        "optnNm2": "text",
        "optnCatNm3": "text",
        "optnNm3": "text",
        "optnCatNm4": "text",
        "optnNm4": "text",
        "optnCatNm5": "text",
        "optnNm5": "text",
        "lgcItmNo": "text",
        "itmSaleStatCd": "text",
        "itmSaleStatCdNm": "text",
        "saleStatChgCausCd": "text",
        "repItmYn": "text",
        "dispSeq": 1,
        "addSupPcost": 1,
        "addSalePrc": 1,
        "soutCausCd": "text",
        "limtQty": 1,
        "stkQty": 1,
        "safeStkNotiYn": "text",
        "safeStkQty": 1,
        "optnCatNo1": "text",
        "optnNo1": "text",
        "optnCatNo2": "text",
        "optnNo2": "text",
        "optnCatNo3": "text",
        "optnNo3": "text",
        "optnCatNo4": "text",
        "optnNo4": "text",
        "optnCatNo5": "text",
        "optnNo5": "text"
      }
    ],
    "prGoodsContInfoList": [
      {
        "goodsNo": "text",
        "contTypCd": "text",
        "contSn": "text",
        "goodsDtlDesc": "text",
        "imgGbCd": "text",
        "dispSeq": 1,
        "contFilePathNm": "text",
        "contFileNm": "text",
        "trnfTextCont": "text",
        "useYn": "text"
      }
    ],
    "prStdCtgDispInfoList": [
      {
        "siteNo": 1,
        "stdCtgNo": "HT01010000",
        "dispCtgNo": 212,
        "repCtgYn": "N",
        "useYn": "N",
        "dispCtgNm": "잡화>쥬얼리",
        "dpmlNo": 10001,
        "siteNm": "플래티어 닷컷",
        "dpmlNm": "통합몰",
        "dispCtgHierarchy": "text"
      }
    ],
    "prAssocGoodsInfoList": [
      {
        "goodsNo": "text",
        "asctGoodsNo": "text",
        "asctGbCd": "text",
        "sortSeq": 1,
        "asctGoodsNm": "text",
        "saleStatCdNm": "text"
      }
    ],
    "prAdveWrdHistList": [
      {
        "goodsNo": "text",
        "aplyStrDtm": "2026-01-01T00:00:00.000Z",
        "aplyEndDtm": "2026-01-01T00:00:00.000Z",
        "adveWrd": "text",
        "useYn": "text"
      }
    ],
    "prPrestHistList": [
      {
        "goodsNo": "text",
        "prestNm": "text",
        "useYn": "text",
        "aplyStrDtm": "2026-01-01T00:00:00.000Z",
        "aplyEndDtm": "2026-01-01T00:00:00.000Z"
      }
    ],
    "prGoodsIconInfoList": [
      {
        "siteNo": "text",
        "goodsNo": "text",
        "dispIconNo": "text",
        "siteNm": "text",
        "iconNm": "text",
        "dispMediaCdNm": "text",
        "iconTypCdNm": "text",
        "aplyStrDtm": "2026-01-01T00:00:00.000Z",
        "aplyEndDtm": "2026-01-01T00:00:00.000Z",
        "iconPathNm": "text",
        "delYn": "N"
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

단품목록 조회

get

기능설명

단품목록을 조회합니다.

상세설명

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

코드정리

전체기간 검색여부: 'on' : 전체기간 검색 재고부족 여부 : 'on' : 기준 수량 이하 단품 조회, 'off' : 기준 수량 이상 단품 조회

Authorizations

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/goodsItemMgmtApi/getGoodsItemList

GET /api/bo/v1/goods/goodsItemMgmtApi/getGoodsItemList?request=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "totalCount": 1,
    "payloads": [
      {
        "goodsNo": "text",
        "goodsNm": "text",
        "saleStatCd": 10,
        "brandNm": "text",
        "lowrBrandNm": "text",
        "entrNm": "text",
        "stdCtgHierarchy": "text",
        "deliProcTypCd": "text",
        "mdId": "text",
        "itmNo": "text",
        "optnNm1": "text",
        "optnNm2": "text",
        "optnNm3": "text",
        "optnNm4": "text",
        "optnNm5": "text",
        "optionVal": "text",
        "modlNm": "text",
        "lgcItmNo": "text",
        "buyQtyLmtYn": "text",
        "minLmtQty": 1,
        "maxLmtQty": 1,
        "repItmYn": "text",
        "dispSeq": 1,
        "stkQty": 1,
        "stkMgrYn": "text",
        "safeStkQty": 1,
        "safeStkNotiYn": "text",
        "totIssuQty": 1,
        "soutNotiYn": "text",
        "soutNotiStdQty": 1,
        "itmSaleStatCd": 10,
        "soutCausCdNm": "text",
        "supPcost": 1,
        "norPrc": 1,
        "salePrc": 1,
        "rsvSaleGoodsYn": "text"
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

이전상품Qn A 정보 관리

다음일자별상품순위제외대상

마지막 업데이트 7일 전