For the complete documentation index, see llms.txt. This page is also available as Markdown.

단품 정보 관리

단품 품절 처리

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

post/v1/goods/goodsItemMgmtApi/soldOutGoodsItemList

단품관리 목록 저장

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

post/v1/goods/goodsItemMgmtApi/saveGoodsItemList

재고수량 일괄 변경

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

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
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
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
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