> 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 기능으로 사용자가 원하는 시점에 세금계산서 이메일전송
```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: 증빙서류(현금영수증) 조회 추가
```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 통해 조회 후 반환
```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: 증빙서류(현금영수증) 조회 추가
```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"}}}}}}}}}
```
---
# 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/back-office-api/order-bo-api/undefined-1.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.