> 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"}}}}}}}}}
````
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://tech.x2bee.com/api/store-front-api/goods-api/undefined-5.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.