단품 정보 관리

단품 품절 처리

post

기능설명

  • 단품을 품절 처리합니다.


상세설명

  • 단품 목록을 품절 처리합니다.

  • 배송 모듈의 결품 관리에서 결품 처리를 위해 호출됩니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Bodyobject[]

단품기본

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
chevron-right
200

단품 품절 처리 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post
/v1/goods/goodsItemMgmtApi/soldOutGoodsItemList

단품관리 목록 저장

post

기능설명

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


상세설명

  • 단품관리 목록에서 재고수량, 안전재고 기준수량, 안전재고 알림 여부 등의 정보를 수정 및 저장합니다.

  • 필수값이 입력되지 않은 경우 오류를 반환합니다.

    • 필수값: 상품번호, 단품번호

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
Responses
chevron-right
200

단품관리 목록 저장 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post
/v1/goods/goodsItemMgmtApi/saveGoodsItemList

재고수량 일괄 변경

post

기준수량

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


상세설명

  • 선택한 단품들의 재고수량을 일괄 변경합니다.

  • 재고관리 여부가 'Y'일 경우에만 변경되며, 'N'일 경우 요청이 반영되지 않습니다.

  • 필수값 미입력 시 오류를 반환합니다.

    • 필수값: 상품번호, 단품번호, 재고수량

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body

단품 재고수량 변경 DTO

goodsItemStockQuantityRequeststringOptional

단품 재고수량 변경 DTO

Responses
chevron-right
200

재고수량 일괄 변경 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post
/v1/goods/goodsItemMgmtApi/modifyGoodsItemStockQuantity

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

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
chevron-right
200

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

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post
/v1/goods/goodsItemMgmtApi/modifyGoodsItemSoldOutNotificationYn

단품 정보 조회

get

기능설명

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


상세설명

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

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
goodsNostringRequired
langCdstringRequired
Responses
chevron-right
200

단품 조회 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get
/v1/goods/goodsItemMgmtApi/getItemOptionInfo

단품목록 조회

get

기능설명

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


상세설명

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


코드정리

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

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
Responses
chevron-right
200

단품목록 조회 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get
/v1/goods/goodsItemMgmtApi/getGoodsItemList

Last updated