> 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/back-office-api/settlement-bo-api/undefined-3.md).
# 배송비 조회
## 협력사별 배송비 목록 조회
> \## 기능설명\
> \* 화면에서 선택한 협력사에 따라 배송비 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 선택한 협력사에 따라 배송비 목록을 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204: 배송비 조회 최초 개발\
> \* Release v2.00\_240613: 기간 검색 조건 개선
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"AcDeliveryAmountRequest":{"type":"object","description":"배송비 조회 Request","properties":{"salesStrDt":{"type":"string","format":"date","description":"매출시작일자"},"salesEndDt":{"type":"string","format":"date","description":"매출종료일자"},"entrNo":{"type":"string","description":"협력사번호"},"ordNo":{"type":"string","description":"주문번호"},"deliTypCd":{"type":"string","description":"배송유형(LO002)"},"deliProcTypCd":{"type":"string","description":"배송처리유형(PR008)"},"ordCostGbCd":{"type":"string","description":"비용구분코드(OM043)"},"adtnOcurGbCd":{"type":"string","description":"발생구분코드(OM017)"}}},"RealGridListResponseAcDeliveryAmountDetailResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/AcDeliveryAmountDetailResponse"}}}},"AcDeliveryAmountDetailResponse":{"type":"object","description":"배송비 조회 Response","properties":{"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"adjStdDt":{"type":"string","description":"매출일자"},"ordNo":{"type":"string","description":"주문번호"},"claimNo":{"type":"string","description":"클레임번호"},"deliTypNm":{"type":"string","description":"배송유형(LO002)"},"ordCostGbCd":{"type":"string","description":"비용구분코드(OM043)"},"ordCostGbNm":{"type":"string","description":"비용구분명"},"adtnOcurGbCd":{"type":"string","description":"발생구분코드(OM017)"},"adtnOcurGbNm":{"type":"string","description":"발생구분명"},"deliProcTypNm":{"type":"string","description":"배송처리유형(PR008)"},"deliAmt":{"type":"integer","format":"int64","description":"배송비"},"entrFreeDlexAmt":{"type":"integer","format":"int64","description":"협력사부담금액(무료배송비쿠폰)"},"ourFreeDlexAmt":{"type":"integer","format":"int64","description":"당사부담금액(무료배송비쿠폰)"},"entrFreeRtnDlexAmt":{"type":"integer","format":"int64","description":"협력사부담금액(무료반품비쿠폰)"},"ourFreeRtnDlexAmt":{"type":"integer","format":"int64","description":"당사부담금액(무료반품비쿠폰)"},"sumCal":{"type":"integer","format":"int64","description":"계"},"siteNo":{"type":"string","description":"사이트번호"},"siteNm":{"type":"string","description":"사이트명"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/adjust/acDeliveryAmount/getAcDeliveryAmountDetailList":{"get":{"tags":["배송비 조회"],"summary":"협력사별 배송비 목록 조회","description":"## 기능설명\n* 화면에서 선택한 협력사에 따라 배송비 목록을 조회합니다.\n---\n## 상세설명\n* 화면에서 선택한 협력사에 따라 배송비 목록을 조회합니다.\n---\n## 수정번호\n* Release v1.05_231204: 배송비 조회 최초 개발\n* Release v2.00_240613: 기간 검색 조건 개선\n","operationId":"getAcDeliveryAmountDetailList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/AcDeliveryAmountRequest"}},{"name":"salesStrDt","in":"query","description":"매출시작일자","schema":{"type":"string"}},{"name":"salesEndDt","in":"query","description":"매출종료일자","schema":{"type":"string"}},{"name":"entrNo","in":"query","description":"협력사번호","schema":{"type":"string"}},{"name":"ordNo","in":"query","description":"주문번호","schema":{"type":"string"}},{"name":"deliTypCd","in":"query","description":"배송유형(LO002)","schema":{"type":"string"}},{"name":"deliProcTypCd","in":"query","description":"배송처리유형(PR008)","schema":{"type":"string"}},{"name":"ordCostGbCd","in":"query","description":"비용구분코드(OM043)","schema":{"type":"string"}},{"name":"adtnOcurGbCd","in":"query","description":"발생구분코드(OM017)","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseAcDeliveryAmountDetailResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 협력사별 배송비 요약 목록 조회
> \## 기능설명\
> \* 화면에서 선택한 조건에 따라 협력사별 배송비 요약 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 선택한 조건에 따라 협력사별 배송비 요약 목록을 조회합니다.\
> \* PO 유입 시 Request로 넘어온 협력사 번호와 사용자의 협력사 번호를 검증해 타 협력사 조회를 제한합니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204: 배송비 조회 최초 개발\
> \* Release v2.00\_240613: 기간 검색 조건 개선
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"AcDeliveryAmountSummaryRequest":{"type":"object","properties":{"salesStrDt":{"type":"string","format":"date","description":"매출시작일자"},"salesEndDt":{"type":"string","format":"date","description":"매출종료일자"},"entrNo":{"type":"string","description":"협력사번호"},"ordNo":{"type":"string","description":"주문번호"},"deliTypCd":{"type":"string","description":"배송유형(LO002)"},"deliProcTypCd":{"type":"string","description":"배송처리유형(PR008)"},"ordCostGbCd":{"type":"string","description":"비용구분코드(OM043)"},"adtnOcurGbCd":{"type":"string","description":"발생구분코드(OM017)"},"userGbCd":{"type":"string","description":"사용자구분코드(UR001)"},"userEntrNo":{"type":"string","description":"사용자 협력사번호"}}},"AcDeliveryAmountSummaryResponse":{"type":"object","description":"배송비 요약 조회 Response","properties":{"adjStdDt":{"type":"string","description":"매출일자"},"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"deliCnt":{"type":"integer","format":"int32","description":"건수"},"deliAmt":{"type":"integer","format":"int64","description":"배송비"},"freeDlexAmt":{"type":"integer","format":"int64","description":"무료배송비"},"freeRtnDlexAmt":{"type":"integer","format":"int64","description":"무료반품비"},"sumCal":{"type":"integer","format":"int64","description":"합계"},"siteNm":{"type":"string","description":"사이트명"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/adjust/acDeliveryAmount/getAcDeliveryAmountSummaryList":{"get":{"tags":["배송비 조회"],"summary":"협력사별 배송비 요약 목록 조회","description":"## 기능설명\n* 화면에서 선택한 조건에 따라 협력사별 배송비 요약 목록을 조회합니다.\n---\n## 상세설명\n* 화면에서 선택한 조건에 따라 협력사별 배송비 요약 목록을 조회합니다.\n* PO 유입 시 Request로 넘어온 협력사 번호와 사용자의 협력사 번호를 검증해 타 협력사 조회를 제한합니다.\n---\n## 수정번호\n* Release v1.05_231204: 배송비 조회 최초 개발\n* Release v2.00_240613: 기간 검색 조건 개선\n","operationId":"getAcDeliveryAmountSummaryList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/AcDeliveryAmountSummaryRequest"}},{"name":"salesStrDt","in":"query","description":"매출시작일자","schema":{"type":"string"}},{"name":"salesEndDt","in":"query","description":"매출종료일자","schema":{"type":"string"}},{"name":"entrNo","in":"query","description":"협력사번호","schema":{"type":"string"}},{"name":"ordNo","in":"query","description":"주문번호","schema":{"type":"string"}},{"name":"deliTypCd","in":"query","description":"배송유형(LO002)","schema":{"type":"string"}},{"name":"deliProcTypCd","in":"query","description":"배송처리유형(PR008)","schema":{"type":"string"}},{"name":"ordCostGbCd","in":"query","description":"비용구분코드(OM043)","schema":{"type":"string"}},{"name":"adtnOcurGbCd","in":"query","description":"발생구분코드(OM017)","schema":{"type":"string"}},{"name":"userGbCd","in":"query","description":"사용자구분코드(UR001)","schema":{"type":"string"}},{"name":"userEntrNo","in":"query","description":"사용자 협력사번호","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AcDeliveryAmountSummaryResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 협력사별 배송비 목록 엑셀 다운로드
> \## 기능설명\
> \* 화면에서 선택 되어있는 협력사별 배송비 목록을 엑셀 다운로드합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 선택 되어있는 협력사별 배송비 목록을 페이징 처리가 안된 데이터로 엑셀 다운로드합니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204: 배송비 조회 최초 개발\
> \* Release v2.00\_240613: 기간 검색 조건 개선
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"AcDeliveryAmountRequest":{"type":"object","description":"배송비 조회 Request","properties":{"salesStrDt":{"type":"string","format":"date","description":"매출시작일자"},"salesEndDt":{"type":"string","format":"date","description":"매출종료일자"},"entrNo":{"type":"string","description":"협력사번호"},"ordNo":{"type":"string","description":"주문번호"},"deliTypCd":{"type":"string","description":"배송유형(LO002)"},"deliProcTypCd":{"type":"string","description":"배송처리유형(PR008)"},"ordCostGbCd":{"type":"string","description":"비용구분코드(OM043)"},"adtnOcurGbCd":{"type":"string","description":"발생구분코드(OM017)"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/adjust/acDeliveryAmount/downloadAcDeliveryAmountExcel":{"get":{"tags":["배송비 조회"],"summary":"협력사별 배송비 목록 엑셀 다운로드","description":"## 기능설명\n* 화면에서 선택 되어있는 협력사별 배송비 목록을 엑셀 다운로드합니다.\n---\n## 상세설명\n* 화면에서 선택 되어있는 협력사별 배송비 목록을 페이징 처리가 안된 데이터로 엑셀 다운로드합니다.\n---\n## 수정번호\n* Release v1.05_231204: 배송비 조회 최초 개발\n* Release v2.00_240613: 기간 검색 조건 개선\n","operationId":"downloadAcDeliveryAmountExcel","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/AcDeliveryAmountRequest"}},{"name":"salesStrDt","in":"query","description":"매출시작일자","schema":{"type":"string"}},{"name":"salesEndDt","in":"query","description":"매출종료일자","schema":{"type":"string"}},{"name":"entrNo","in":"query","description":"협력사번호","schema":{"type":"string"}},{"name":"ordNo","in":"query","description":"주문번호","schema":{"type":"string"}},{"name":"deliTypCd","in":"query","description":"배송유형(LO002)","schema":{"type":"string"}},{"name":"deliProcTypCd","in":"query","description":"배송처리유형(PR008)","schema":{"type":"string"}},{"name":"ordCostGbCd","in":"query","description":"비용구분코드(OM043)","schema":{"type":"string"}},{"name":"adtnOcurGbCd","in":"query","description":"발생구분코드(OM017)","schema":{"type":"string"}}],"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```