> 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/order-bo-api/undefined-1.md).

# 증빙서류

## 팝빌연동 세금계산서 메일전송

> \## 기능설명\
> \* 팝빌 문서번호, 주문번호, 이메일계정으로 팝빌에서 제공하는 이메일 재전송 기능\
> \---\
> \## 상세설명\
> \* 팝빌에서 제공하는 이메일 재전송 기능을 활용한 api-order 기능으로 사용자가 원하는 시점에 세금계산서 이메일전송<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":{"OrderEvidSendEmailRequest":{"type":"object","description":"세금계산서 이메일전송요청 DTO","properties":{"ordNo":{"type":"string","description":"주문번호"},"mgrNo":{"type":"string","description":"팝빌관리 문서번호"},"email":{"type":"string","description":"이메일"}}},"OrderEvidSendEmailResponse":{"type":"object","properties":{"code":{"type":"integer","format":"int64"},"message":{"type":"string"}}}}},"paths":{"/v1/order/orderEvidDoc/sendEmail":{"post":{"tags":["증빙서류"],"summary":"팝빌연동 세금계산서 메일전송","description":"## 기능설명\n* 팝빌 문서번호, 주문번호, 이메일계정으로 팝빌에서 제공하는 이메일 재전송 기능\n---\n## 상세설명\n* 팝빌에서 제공하는 이메일 재전송 기능을 활용한 api-order 기능으로 사용자가 원하는 시점에 세금계산서 이메일전송\n","operationId":"sendEmail","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderEvidSendEmailRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderEvidSendEmailResponse"}}}}}}}}}
```

## 증빙서류 목록 조회

> \## 기능설명\
> \* 증빙서류 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 증빙서류 목록을 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_250714: 증빙서류(세금계산서) 조회 추가\
> \* Release v2.00\_251020: 증빙서류(현금영수증) 조회 추가<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":{"OrderEvidDocSearchRequest":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordAccpType":{"type":"string","description":"조회기간"},"dateSelect":{"type":"string"},"statOrdAccpDtm":{"type":"string","format":"date"},"endOrdAccpDtm":{"type":"string","format":"date"},"ordererInfo":{"type":"string","description":"주문자"},"ordSrcCnd":{"type":"string"},"entrNo":{"type":"string","description":"입점사"},"entrNm":{"type":"string"},"appGbTyp":{"type":"string","description":"신청구분"},"payStat":{"type":"string","description":"결제상태"},"payStatCd":{"type":"string","description":"결제상태코드(OM014)"},"ppblIsuStat":{"type":"array","description":"처리상태","items":{"type":"string"}},"settleAccount":{"type":"string","description":"정산상태"},"payWay":{"type":"array","description":"결제수단","items":{"type":"string"}},"evidDocTyp":{"type":"array","description":"증빙종류","items":{"type":"string"}},"evidDocTypRefPairs":{"type":"array","description":"증빙종류 참조값 쌍","items":{"type":"object","additionalProperties":{"type":"string"}}},"payTyp":{"type":"array","description":"결제분류","items":{"type":"string"}},"ordTyp":{"type":"array","description":"주문유형","items":{"type":"string"}}}},"RealGridListResponseOrderEvidDocListResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/OrderEvidDocListResponse"}}}},"OrderEvidDocListResponse":{"type":"object","properties":{"siteNm":{"type":"string","description":"사이트명"},"ordNo":{"type":"string","description":"주문번호"},"mbrNm":{"type":"string","description":"주문자명"},"ordLoginId":{"type":"string","description":"회원ID"},"payStatCd":{"type":"string","description":"결제상태코드(OM014)"},"payStat":{"type":"string","description":"결제상태"},"payCat":{"type":"string","description":"결제분류"},"ordWay":{"type":"string","description":"주문유형"},"payWay":{"type":"string","description":"결제수단"},"ordAccpDtm":{"type":"string","description":"주문일시"},"payRfdFnshDtm":{"type":"string","description":"결제일시"},"settleAccount":{"type":"string","description":"정산상태"},"ordStat":{"type":"string","description":"주문상태"},"ordDtlStatCdList":{"type":"array","items":{"type":"string"}},"goodsNoList":{"type":"array","items":{"type":"string"}},"entrNm":{"type":"string","description":"입점사명"},"evidDocTyp":{"type":"string","description":"증빙자료"},"evidDocTypCd":{"type":"string"},"evidPayAmt":{"type":"integer","format":"int64","description":"증빙금액"},"ordTotAmt":{"type":"string","description":"주문총금액"},"ordSupPrc":{"type":"string","description":"주문공급가"},"ordTaxPrc":{"type":"string","description":"주문과면세가"},"adminIsuYn":{"type":"string","description":"관리자 발행(수기 발행) 여부"},"appStartDtm":{"type":"string","description":"신청일"},"isuDt":{"type":"string","description":"발행일자"},"ppblIsuStat":{"type":"string","description":"처리상태"},"cancelCd":{"type":"string","description":"환불코드"},"payGbCd":{"type":"string","description":"결제구분코드"},"noProofType":{"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/order/orderEvidDoc/getOrderEvidDocList":{"get":{"tags":["증빙서류"],"summary":"증빙서류 목록 조회","description":"## 기능설명\n* 증빙서류 목록을 조회합니다.\n---\n## 상세설명\n* 증빙서류 목록을 조회합니다.\n---\n## 수정번호\n* Release v2.00_250714: 증빙서류(세금계산서) 조회 추가\n* Release v2.00_251020: 증빙서류(현금영수증) 조회 추가\n","operationId":"getOrderEvidDocList","parameters":[{"name":"orderEvidDocSearchRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/OrderEvidDocSearchRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseOrderEvidDocListResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 팝빌연동 세금계산서 팝업 URL 조회

> \## 기능설명\
> \* 팝빌 문서번호, 주문번호, 팝업타입으로 팝빌에서 제공하는 팝업 Url 조회\
> \---\
> \## 상세설명\
> \* 조회, 출력, PDF 다운로드 팝업 URL을 api-order 통해 조회 후 반환<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"}}},"paths":{"/v1/order/orderEvidDoc/getEvidPopupUrl":{"get":{"tags":["증빙서류"],"summary":"팝빌연동 세금계산서 팝업 URL 조회","description":"## 기능설명\n* 팝빌 문서번호, 주문번호, 팝업타입으로 팝빌에서 제공하는 팝업 Url 조회\n---\n## 상세설명\n* 조회, 출력, PDF 다운로드 팝업 URL을 api-order 통해 조회 후 반환\n","operationId":"getEvidPopupUrl","parameters":[{"name":"orderEvidPopupRequest","in":"query","required":true,"schema":{"type":"string","description":"OrderEvidPopupRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}}}}}}}
```

## 주문 증빙서류 목록 조회

> \## 기능설명\
> \* 주문번호(ordNo)를 포함한 요청 파라미터를 받아 해당 주문의 증빙서류 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 주문번호(ordNo)를 포함한 요청 파라미터를 받아 해당 주문의 증빙서류 목록을 조회합니다.\
> \* ordNo: 주문번호 (필수)\
> \---\
> \## 수정번호\
> \* Release v2.00\_250714: 증빙서류(세금계산서) 조회 추가\
> \* Release v2.00\_251020: 증빙서류(현금영수증) 조회 추가<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":{"OrderEvidDocSearchRequest":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordAccpType":{"type":"string","description":"조회기간"},"dateSelect":{"type":"string"},"statOrdAccpDtm":{"type":"string","format":"date"},"endOrdAccpDtm":{"type":"string","format":"date"},"ordererInfo":{"type":"string","description":"주문자"},"ordSrcCnd":{"type":"string"},"entrNo":{"type":"string","description":"입점사"},"entrNm":{"type":"string"},"appGbTyp":{"type":"string","description":"신청구분"},"payStat":{"type":"string","description":"결제상태"},"payStatCd":{"type":"string","description":"결제상태코드(OM014)"},"ppblIsuStat":{"type":"array","description":"처리상태","items":{"type":"string"}},"settleAccount":{"type":"string","description":"정산상태"},"payWay":{"type":"array","description":"결제수단","items":{"type":"string"}},"evidDocTyp":{"type":"array","description":"증빙종류","items":{"type":"string"}},"evidDocTypRefPairs":{"type":"array","description":"증빙종류 참조값 쌍","items":{"type":"object","additionalProperties":{"type":"string"}}},"payTyp":{"type":"array","description":"결제분류","items":{"type":"string"}},"ordTyp":{"type":"array","description":"주문유형","items":{"type":"string"}}}},"RealGridListResponseOrderEvidDocInfoResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/OrderEvidDocInfoResponse"}}}},"OrderEvidDocInfoResponse":{"type":"object","properties":{"ordNo":{"type":"string"},"entrNm":{"type":"string"},"ordSupPrc":{"type":"string"},"ordTaxPrc":{"type":"string"},"ordTotAmt":{"type":"string"},"evidDocTyp":{"type":"string"},"ppblIsuStat":{"type":"string"},"entrNo":{"type":"string"},"mgrNo":{"type":"string"},"seq":{"type":"string"},"bmanNo":{"type":"string"},"evidDocTypCd":{"type":"string"},"ordManNm":{"type":"string"},"ppblIsuStatCd":{"type":"string"},"pgGbCd":{"type":"string"},"payGbCd":{"type":"string"}}},"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/order/orderEvidDoc/getEvidDocInfo":{"get":{"tags":["증빙서류"],"summary":"주문 증빙서류 목록 조회","description":"## 기능설명\n* 주문번호(ordNo)를 포함한 요청 파라미터를 받아 해당 주문의 증빙서류 목록을 조회합니다.\n---\n## 상세설명\n* 주문번호(ordNo)를 포함한 요청 파라미터를 받아 해당 주문의 증빙서류 목록을 조회합니다.\n* ordNo: 주문번호 (필수)\n---\n## 수정번호\n* Release v2.00_250714: 증빙서류(세금계산서) 조회 추가\n* Release v2.00_251020: 증빙서류(현금영수증) 조회 추가\n","operationId":"getEvidDocInfo","parameters":[{"name":"orderEvidDocSearchRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/OrderEvidDocSearchRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseOrderEvidDocInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```