> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/store-front-api/goods-api/undefined-5.md).
# 상품상세 배송정보
## 결손처리로 인한 단품옵션 품절처리
> \## 기능설명\
> \* 결손처리로 인한 단품옵션 품절처리를 진행합니다\
> \---\
> \## 상세설명\
> \* 결손등록시 결손사유가 재고부족일때 상품 단품의 판매상태를 품절 처리\
> \* 결손해제시 재고여부에 따라 판매상태를 변경합니다. .
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PrItmInsuffReq":{"type":"object","description":"상품 상세 조회 Request DTO","properties":{"targetOrdDtlStatCd":{"type":"string","description":"결손처리 구분 22:결손해제, 23:결손등록 "},"prItms":{"type":"array","items":{"$ref":"#/components/schemas/PrItm"}}}},"PrItm":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 40:판매종료"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032) 10:발송불가 자동품절처리, 11:재고수량 0 품절처리, 12:관리자 수동품절처리"},"userId":{"type":"string","description":"사용자Id"}}}}},"paths":{"/v1/delivery/updatePrItmStockByInsuff":{"post":{"tags":["상품상세 배송정보"],"summary":"결손처리로 인한 단품옵션 품절처리","description":"## 기능설명\n* 결손처리로 인한 단품옵션 품절처리를 진행합니다\n---\n## 상세설명\n* 결손등록시 결손사유가 재고부족일때 상품 단품의 판매상태를 품절 처리\n* 결손해제시 재고여부에 따라 판매상태를 변경합니다. .\n","operationId":"updatePrItmStockByInsuff","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrItmInsuffReq"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}}}}
```
## 배송정책번호별 배송비 조회
> \## 기능설명\
> \* 협력사+배송비정책번호 기반 배송비정책 기본 API 입니다.\
> \---\
> \## 상세설명\
> \* 협력사+배송비정책번호 배열 값으로 배송정책기본 정보 목록을 조회합니다.\
> \* 배송 정책 기본 사용여부가 Y인 배송 정책에 대해 조회합니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.05\_231204\`\`\` : 거래유형코드(VD002) 추가\
> \
> \`\`\`Release v2.00\_240627\`\`\` : 추가배송비정보 추가
````json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"EtDeliPolcBaseRequest":{"type":"object","description":"배송정책기본 Request","properties":{"langCd":{"type":"string","default":"ko","description":"언어코드(CM009)"},"siteNo":{"type":"string","default":"1","description":"사이트번호"},"entrNo":{"type":"string","default":"10000001","description":"협력사번호"},"deliPolcNo":{"type":"string","default":"10000271","description":"배송정책번호"}}},"EtDeliPolcBaseResponse":{"type":"object","description":"배송정책기본 Response","properties":{"deliPolcNo":{"type":"string","description":"배송정책번호"},"entrNo":{"type":"string","description":"협력사번호"},"dlexTypCd":{"type":"string","description":"배송비유형코드(VD005)"},"dlexTypCdNm":{"type":"string","description":"배송비유형코드명"},"stdAmt":{"type":"integer","format":"int64","description":"기준금액"},"dlexAmt":{"type":"integer","format":"int64","description":"배송비금액"},"wthdRtnAmt":{"type":"integer","format":"int64","description":"회수반품비"},"exchDlex":{"type":"integer","format":"int64","description":"교환배송비"},"addDlexInfoList":{"type":"array","description":"추가배송비","items":{"$ref":"#/components/schemas/EtAddDlexInfoResponse"}},"useYn":{"type":"string","description":"사용여부"},"trdTypCd":{"type":"string","description":"거래유형코드(VD002)"}}},"EtAddDlexInfoResponse":{"type":"object","description":"추가배송비정보 Response","properties":{"deliRegnGrpNo":{"type":"string","description":"배송지역그룹번호"},"deliRegnGrpNm":{"type":"string","description":"배송지역그룹명"},"addDlexAmt":{"type":"integer","format":"int64","description":"추가배송비"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/delivery/deliProcInfo":{"post":{"tags":["상품상세 배송정보"],"summary":"배송정책번호별 배송비 조회","description":"## 기능설명\n* 협력사+배송비정책번호 기반 배송비정책 기본 API 입니다.\n---\n## 상세설명\n* 협력사+배송비정책번호 배열 값으로 배송정책기본 정보 목록을 조회합니다.\n * 배송 정책 기본 사용여부가 Y인 배송 정책에 대해 조회합니다.\n---\n## 수정번호\n```Release v1.05_231204``` : 거래유형코드(VD002) 추가\n\n```Release v2.00_240627``` : 추가배송비정보 추가\n","operationId":"getDeliProcInfo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/EtDeliPolcBaseRequest"}}}},"required":true},"responses":{"200":{"description":"배송비정책 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EtDeliPolcBaseResponse"}}}},"900":{"description":"배송비정책 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````
## 협력사별 배송교환반품 정보 조회
> \## 기능설명\
> \* 반품교환정보를 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 협력사번호 값으로 배송정책기본 정보 목록을 조회합니다.\
> \* 배송 정책 기본 사용여부가 Y인 배송 정책에 대해 조회합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ReturnOrChangeInfo":{"type":"object","description":"반품교환정보","properties":{"langCd":{"type":"string","default":"ko","description":"언어코드(CM009)"},"siteNo":{"type":"string","default":"1","description":"사이트번호"},"goodsNo":{"type":"string","description":"상품번호"},"entrNo":{"type":"string","description":"협력사번호"}}},"ReturnOrChangeInfoResponse":{"type":"object","description":"반품교환정보 Response","properties":{"goodsNo":{"type":"string","description":"상품번호"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008)"},"deliProcTypCdNm":{"type":"string","description":"배송처리유형코드명"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010)"},"deliGoodsGbCdNm":{"type":"string","description":"배송상품구분코드명"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009)"},"deliWayCdBNm":{"type":"string","description":"배송수단코드명"},"deliPsbRgnCd":{"type":"string","description":"배송가능지역코드(PR030)"},"deliPsbRgnCdNm":{"type":"string","description":"배송가능지역코드명"},"deliDday":{"type":"string","description":"배송기일"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"entrNo":{"type":"string","description":"협력사번호"},"bpckPsbYn":{"type":"string","description":"합포가능여부"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"dlexTypCd":{"type":"string","description":"배송비유형코드(VD005)"},"dlexTypCdNm":{"type":"string","description":"배송비유형코드명"},"stdAmt":{"type":"integer","format":"int64","description":"기준금액"},"dlexAmt":{"type":"integer","format":"int64","description":"배송비금액"},"wthdRtnAmt":{"type":"integer","format":"int64","description":"회수반품비"},"exchDlex":{"type":"integer","format":"int64","description":"교환배송비"},"addDlexAmt":{"type":"integer","format":"int64","description":"추가배송비금액"},"useYn":{"type":"string","description":"사용여부"},"etEntrDlvpInfoList":{"type":"array","description":"협력사배송지정보","items":{"$ref":"#/components/schemas/EtEntrDlvpInfo"}}}},"EtEntrDlvpInfo":{"type":"object","description":"협력사배송지정보","properties":{"entrDlvpNo":{"type":"string","description":"협력사배송지번호"},"entrNo":{"type":"string","description":"협력사번호"},"dlvpTypCd":{"type":"string","description":"배송지유형코드(VD007) 10:출고지, 20:반품지"},"dlvpTypCdNm":{"type":"string","description":"배송지유형코드명"},"dlvpNm":{"type":"string","description":"배송지명"},"useYn":{"type":"string","description":"사용여부"},"zipNoSeq":{"type":"string","description":"우편번호순번"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"utakmnNm":{"type":"string","description":"담당자명"},"aempTelRgnNo":{"type":"string","description":"담당자전화지역번호"},"aempTelTxnoNo":{"type":"string","description":"담당자전화국번번호"},"aempTelEndNo":{"type":"string","description":"담당자전화끝번호"},"aempCellSctNo":{"type":"string","description":"담당자휴대폰구분번호"},"aempCellTxnoNo":{"type":"string","description":"담당자휴대폰국번번호"},"aempCellEndNo":{"type":"string","description":"담당자휴대폰끝번호"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/delivery/tr/{entrNo}":{"get":{"tags":["상품상세 배송정보"],"summary":"협력사별 배송교환반품 정보 조회","description":"## 기능설명\n* 반품교환정보를 조회하는 API 입니다.\n---\n## 상세설명\n* 협력사번호 값으로 배송정책기본 정보 목록을 조회합니다.\n * 배송 정책 기본 사용여부가 Y인 배송 정책에 대해 조회합니다.\n","operationId":"getTrReturnOrChangeInfo","parameters":[{"name":"entrNo","in":"path","description":"협력사번호","required":true,"schema":{"type":"string","description":"String"}},{"name":"returnOrChangeInfo","in":"query","required":true,"schema":{"$ref":"#/components/schemas/ReturnOrChangeInfo"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"협력사별 반품교환정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReturnOrChangeInfoResponse"}}}},"900":{"description":"협력사별 반품교환정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 상품별 배송교환반품 정보 조회
> \## 기능설명\
> \* 상품상세 배송/교환/반품 레이어 팝업에서 사용하는 반품교환정보 API 입니다.\
> \---\
> \## 상세설명\
> \* 상품번호 값으로 배송 정책 기본 정보 및 협력사 배송지 정보 목록을 조회합니다.\
> \* 배송 정책 기본 사용여부가 Y인 배송 정책에 대해 조회합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ReturnOrChangeInfo":{"type":"object","description":"반품교환정보","properties":{"langCd":{"type":"string","default":"ko","description":"언어코드(CM009)"},"siteNo":{"type":"string","default":"1","description":"사이트번호"},"goodsNo":{"type":"string","description":"상품번호"},"entrNo":{"type":"string","description":"협력사번호"}}},"ReturnOrChangeInfoResponse":{"type":"object","description":"반품교환정보 Response","properties":{"goodsNo":{"type":"string","description":"상품번호"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008)"},"deliProcTypCdNm":{"type":"string","description":"배송처리유형코드명"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010)"},"deliGoodsGbCdNm":{"type":"string","description":"배송상품구분코드명"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009)"},"deliWayCdBNm":{"type":"string","description":"배송수단코드명"},"deliPsbRgnCd":{"type":"string","description":"배송가능지역코드(PR030)"},"deliPsbRgnCdNm":{"type":"string","description":"배송가능지역코드명"},"deliDday":{"type":"string","description":"배송기일"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"entrNo":{"type":"string","description":"협력사번호"},"bpckPsbYn":{"type":"string","description":"합포가능여부"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"dlexTypCd":{"type":"string","description":"배송비유형코드(VD005)"},"dlexTypCdNm":{"type":"string","description":"배송비유형코드명"},"stdAmt":{"type":"integer","format":"int64","description":"기준금액"},"dlexAmt":{"type":"integer","format":"int64","description":"배송비금액"},"wthdRtnAmt":{"type":"integer","format":"int64","description":"회수반품비"},"exchDlex":{"type":"integer","format":"int64","description":"교환배송비"},"addDlexAmt":{"type":"integer","format":"int64","description":"추가배송비금액"},"useYn":{"type":"string","description":"사용여부"},"etEntrDlvpInfoList":{"type":"array","description":"협력사배송지정보","items":{"$ref":"#/components/schemas/EtEntrDlvpInfo"}}}},"EtEntrDlvpInfo":{"type":"object","description":"협력사배송지정보","properties":{"entrDlvpNo":{"type":"string","description":"협력사배송지번호"},"entrNo":{"type":"string","description":"협력사번호"},"dlvpTypCd":{"type":"string","description":"배송지유형코드(VD007) 10:출고지, 20:반품지"},"dlvpTypCdNm":{"type":"string","description":"배송지유형코드명"},"dlvpNm":{"type":"string","description":"배송지명"},"useYn":{"type":"string","description":"사용여부"},"zipNoSeq":{"type":"string","description":"우편번호순번"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"utakmnNm":{"type":"string","description":"담당자명"},"aempTelRgnNo":{"type":"string","description":"담당자전화지역번호"},"aempTelTxnoNo":{"type":"string","description":"담당자전화국번번호"},"aempTelEndNo":{"type":"string","description":"담당자전화끝번호"},"aempCellSctNo":{"type":"string","description":"담당자휴대폰구분번호"},"aempCellTxnoNo":{"type":"string","description":"담당자휴대폰국번번호"},"aempCellEndNo":{"type":"string","description":"담당자휴대폰끝번호"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/delivery/pd/{goodsNo}":{"get":{"tags":["상품상세 배송정보"],"summary":"상품별 배송교환반품 정보 조회","description":"## 기능설명\n* 상품상세 배송/교환/반품 레이어 팝업에서 사용하는 반품교환정보 API 입니다.\n---\n## 상세설명\n* 상품번호 값으로 배송 정책 기본 정보 및 협력사 배송지 정보 목록을 조회합니다.\n * 배송 정책 기본 사용여부가 Y인 배송 정책에 대해 조회합니다.\n","operationId":"getPdReturnOrChangeInfo","parameters":[{"name":"goodsNo","in":"path","description":"상품번호","required":true,"schema":{"type":"string","description":"String"}},{"name":"returnOrChangeInfo","in":"query","required":true,"schema":{"$ref":"#/components/schemas/ReturnOrChangeInfo"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"상품별 반품교환정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReturnOrChangeInfoResponse"}}}},"900":{"description":"상품별 반품교환정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 상품 배송비 조회
> \## 기능설명\
> \* 상품번호 기반 배송비정책 기본 API 입니다.\
> \---\
> \## 상세설명\
> \* 상품번호 리스트 값으로 배송정책기본 정보 목록을 조회합니다.\
> \* 배송 정책 기본 사용여부가 Y인 배송 정책에 대해 조회합니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.04\_231120\`\`\` : 거래유형코드(VD002) 추가
````json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsDeliPolcRequest":{"type":"object","description":"상품번호목록 Request","properties":{"langCd":{"type":"string","default":"ko","description":"언어코드(CM009)"},"siteNo":{"type":"string","default":"1","description":"사이트번호"},"goodsNos":{"type":"array","default":"1000030,1689483","description":"상품번호목록","items":{"type":"string"}}}},"EtDeliPolcBaseResponse":{"type":"object","description":"배송정책기본 Response","properties":{"deliPolcNo":{"type":"string","description":"배송정책번호"},"entrNo":{"type":"string","description":"협력사번호"},"dlexTypCd":{"type":"string","description":"배송비유형코드(VD005)"},"dlexTypCdNm":{"type":"string","description":"배송비유형코드명"},"stdAmt":{"type":"integer","format":"int64","description":"기준금액"},"dlexAmt":{"type":"integer","format":"int64","description":"배송비금액"},"wthdRtnAmt":{"type":"integer","format":"int64","description":"회수반품비"},"exchDlex":{"type":"integer","format":"int64","description":"교환배송비"},"addDlexInfoList":{"type":"array","description":"추가배송비","items":{"$ref":"#/components/schemas/EtAddDlexInfoResponse"}},"useYn":{"type":"string","description":"사용여부"},"trdTypCd":{"type":"string","description":"거래유형코드(VD002)"}}},"EtAddDlexInfoResponse":{"type":"object","description":"추가배송비정보 Response","properties":{"deliRegnGrpNo":{"type":"string","description":"배송지역그룹번호"},"deliRegnGrpNm":{"type":"string","description":"배송지역그룹명"},"addDlexAmt":{"type":"integer","format":"int64","description":"추가배송비"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/delivery/goodsDeliProc":{"get":{"tags":["상품상세 배송정보"],"summary":"상품 배송비 조회","description":"## 기능설명\n* 상품번호 기반 배송비정책 기본 API 입니다.\n---\n## 상세설명\n* 상품번호 리스트 값으로 배송정책기본 정보 목록을 조회합니다.\n * 배송 정책 기본 사용여부가 Y인 배송 정책에 대해 조회합니다.\n---\n## 수정번호\n```Release v1.04_231120``` : 거래유형코드(VD002) 추가\n","operationId":"getGoodsDeliPolicyInfo","parameters":[{"name":"goodsDeliPolcRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsDeliPolcRequest"}},{"name":"goodsNos","in":"query","description":"상품번호","required":true,"schema":{"type":"string","description":"List"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"상품별 배송비 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EtDeliPolcBaseResponse"}}}},"900":{"description":"상품별 배송비 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````