# 배송비 조회

## 협력사별 배송비 목록 조회

> \## 기능설명\
> \* 화면에서 선택한 협력사에 따라 배송비 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 선택한 협력사에 따라 배송비 목록을 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204: 배송비 조회 최초 개발\
> \* Release v2.00\_240613: 기간 검색 조건 개선<br>

```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: 기간 검색 조건 개선<br>

```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: 기간 검색 조건 개선<br>

```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"}}}}}}}}}
```


---

# Agent Instructions: 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:

```
GET https://tech.x2bee.com/api/back-office-api/settlement-bo-api/undefined-3.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.