> 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/api-en/store-front-api-reference/order-api/supporting-documents.md).

# Supporting Documents

## Send Tax Invoice Email via Popbill Integration

> \## Function Description\
> \* Popbill's email resend feature, using the Popbill document number, order number, and email\
> \---\
> \## Detailed Description\
> \* Leverages Popbill's email resend feature to send the tax invoice email at a time chosen by the user<br>

```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/popbill/invoice/sendEmail":{"post":{"tags":["Supporting Documents"],"summary":"Send Tax Invoice Email via Popbill Integration","description":"## Function Description\n* Popbill's email resend feature, using the Popbill document number, order number, and email\n---\n## Detailed Description\n* Leverages Popbill's email resend feature to send the tax invoice email at a time chosen by the user\n","operationId":"sendEmail","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaxInvoiceEmailRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"TaxInvoiceEmailRequest":{"type":"object","properties":{"ordNo":{"type":"string"},"mgrNo":{"type":"string"},"email":{"type":"string"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","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"}},"description":"validation error list"}}}}
```

## Tax Invoice Popbill Webhook Integration

> \## Function Description\
> \* Processes events sent as webhooks by Popbill\
> \---\
> \## Detailed Description\
> \* Processes Issue, CancelIssue, CLOSEDOWN, NTS, OPEN, Request, CancelRequest, and Refuse events.\
> \---\
> \## Notes\
> \* This is not an API called internally within the system, but an API called by the Popbill webhook.\
> \* Since the Popbill webhook spec cannot accept the common response wrapper, @DisableResponseBodyAdvice was added<br>

```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/popbill/invoice/connect":{"post":{"tags":["Supporting Documents"],"summary":"Tax Invoice Popbill Webhook Integration","description":"## Function Description\n* Processes events sent as webhooks by Popbill\n---\n## Detailed Description\n* Processes Issue, CancelIssue, CLOSEDOWN, NTS, OPEN, Request, CancelRequest, and Refuse events.\n---\n## Notes\n* This is not an API called internally within the system, but an API called by the Popbill webhook.\n* Since the Popbill webhook spec cannot accept the common response wrapper, @DisableResponseBodyAdvice was added\n","operationId":"invoiceConnect","parameters":[{"name":"taxInvoiceConnectRequest","in":"query","required":true,"schema":{"type":"string","description":"TaxInvoiceConnectRequest"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaxInvoiceConnectRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/TaxInvoiceConnectResponse"}}}}}}}},"components":{"schemas":{"TaxInvoiceConnectRequest":{"required":["corpNum","eventDT","eventType","itemKey","ntsconfirmNum"],"type":"object","properties":{"corpNum":{"type":"string","description":"Issuer's Business Registration No. by E-Tax Invoice Issuance Type"},"itemKey":{"type":"string","description":"Identification Number Assigned by Popbill for Tax Invoice Management Purposes"},"ntsconfirmNum":{"type":"string","description":"National Tax Service Approval No."},"ntssendDT":{"type":"string","description":"National Tax Service Transmission Date/Time"},"ntsresultDT":{"type":"string","description":"National Tax Service Result Reception Date/Time"},"ntssendErrCode":{"type":"string","description":"Result Code"},"stateCode":{"type":"integer","description":"Status Code","format":"int64"},"stateDT":{"type":"string","description":"Status Change Date/Time"},"issueDT":{"type":"string","description":"Issuance Date/Time"},"invoicerMgtKey":{"type":"string","description":"Supplier Document No."},"invoiceeMgtKey":{"type":"string","description":"Recipient Document No."},"trusteeMgtKey":{"type":"string","description":"Trustee Document No."},"eventDT":{"type":"string","description":"Event Execution Date/Time"},"eventType":{"type":"string","description":"Event Type"},"closeDownState":{"type":"integer","description":"Recipient's Business Closure Status","format":"int32"},"closeDownStateDate":{"type":"string","description":"Recipient's Business Closure Date"},"interOPYN":{"type":"boolean"},"stateMemo":{"type":"string"}},"description":"Popbill Tax Invoice Webhook Response"},"TaxInvoiceConnectResponse":{"type":"object","properties":{"result":{"type":"string","description":"Result Value"}},"description":"Tax Invoice Webhook Integration Response"}}}}
```

## Inicis Cash Receipt Reconciliation Integration

> \## Function Description\
> \* Inicis cash receipt reconciliation integration\
> \---\
> \## Detailed Description\
> \* Updates the issuance status of supporting documents obtained via the integrated reconciliation information to the DB.<br>

```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/inicis/receipt/connect":{"post":{"tags":["Supporting Documents"],"summary":"Inicis Cash Receipt Reconciliation Integration","description":"## Function Description\n* Inicis cash receipt reconciliation integration\n---\n## Detailed Description\n* Updates the issuance status of supporting documents obtained via the integrated reconciliation information to the DB.\n","operationId":"connect","parameters":[{"name":"taxInvoiceConnectRequest","in":"query","required":true,"schema":{"type":"string","description":"TaxInvoiceConnectRequest"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DocumentIssueRequest"}}}},"required":true},"responses":{"200":{"description":"Success"}}}}},"components":{"schemas":{"DocumentIssueRequest":{"type":"object","properties":{"docSeq":{"type":"string"},"proofType":{"type":"string"},"pgGbCd":{"type":"string"},"termlId":{"type":"string"},"ordNo":{"type":"string"},"mgrNo":{"type":"string"}}}}}}
```

## Supporting Document Issuance Batch

> \## Function Description\
> \* A batch that requests issuance for supporting documents stuck in issuance-pending status due to issuance failure\
> \---\
> \## Detailed Description\
> \* Requests reissuance from the batch for the list of data in issuance-pending status\
> \---\
> \## Revision History\
> \* Release v2.01\_251020 : Added Inicis cash receipt issuance<br>

```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/document/reissue":{"post":{"tags":["Supporting Documents"],"summary":"Supporting Document Issuance Batch","description":"## Function Description\n* A batch that requests issuance for supporting documents stuck in issuance-pending status due to issuance failure\n---\n## Detailed Description\n* Requests reissuance from the batch for the list of data in issuance-pending status\n---\n## Revision History\n* Release v2.01_251020 : Added Inicis cash receipt issuance\n","operationId":"reissue","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DocumentIssueRequest"}}}},"required":true},"responses":{"200":{"description":"Success"}}}}},"components":{"schemas":{"DocumentIssueRequest":{"type":"object","properties":{"docSeq":{"type":"string"},"proofType":{"type":"string"},"pgGbCd":{"type":"string"},"termlId":{"type":"string"},"ordNo":{"type":"string"},"mgrNo":{"type":"string"}}}}}}
```

## Retrieve Order Verification Document List

> \## Function Description\
> \* Receives request parameters including the order number (ordNo) and looks up the supporting document list for that order.\
> \---\
> \## Detailed Description\
> \* Receives request parameters including the order number (ordNo) and looks up the supporting document list for that order.\
> \* ordNo: Order No. (required)\
> \* Sorted in ascending order of registration date.<br>

```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/document/getOrderEvidDocInfo":{"post":{"tags":["Supporting Documents"],"summary":"Retrieve Order Verification Document List","description":"## Function Description\n* Receives request parameters including the order number (ordNo) and looks up the supporting document list for that order.\n---\n## Detailed Description\n* Receives request parameters including the order number (ordNo) and looks up the supporting document list for that order.\n* ordNo: Order No. (required)\n* Sorted in ascending order of registration date.\n","operationId":"getOrderEvidDocInfo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderEvidDocInfoRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderEvidDocInfoResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"OrderEvidDocInfoRequest":{"type":"object","properties":{"langCd":{"type":"string"},"ordNo":{"type":"string"},"mbrNo":{"type":"string"},"searchCondition":{"type":"string"},"startDt":{"type":"string"},"endDt":{"type":"string"},"documentType":{"type":"string"}}},"OrderEvidDocInfoResponse":{"type":"object","properties":{"totCnt":{"type":"integer","description":"Supporting Document Count","format":"int32"},"rowsPerPage":{"type":"integer","description":"Display Quantity per Screen","format":"int32"},"pageIdx":{"type":"integer","description":"Page No.","format":"int32"},"documentList":{"type":"array","description":"Verification Document Count List","items":{"$ref":"#/components/schemas/OrderEvidDocInfo"}}}},"OrderEvidDocInfo":{"type":"object","properties":{"ordNo":{"type":"string"},"entrNm":{"type":"string"},"ordSupPrc":{"type":"number"},"ordTaxPrc":{"type":"number"},"ordTotAmt":{"type":"number"},"ppblIsuStatCdNm":{"type":"string"},"ppblIsuStatCd":{"type":"string"},"ppblDocMgrNo":{"type":"string"},"docTypCd":{"type":"string"},"docTypCdNm":{"type":"string"},"sgtDt":{"type":"string"},"ordGbCd":{"type":"string"},"payWayCd":{"type":"string"},"pgGbCd":{"type":"string"}},"description":"Verification Document Count List"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","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"}},"description":"validation error list"}}}}
```

## Apply for Order Supporting Document

> \## Function Description\
> \* Processes an application for a supporting document (tax invoice, etc.) for an order.\
> \---\
> \## Detailed Description\
> \* Processes an application for a supporting document, including required information such as order number and member number.\
> \---\
> \## Revision History\
> \* Release v2.01\_251020 : Added Inicis cash receipt issuance\
> \* Release v2.02\_260202 : Added taxable/tax-exempt amount processing logic<br>

```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/document/applyOrderEvidence":{"post":{"tags":["Supporting Documents"],"summary":"Apply for Order Supporting Document","description":"## Function Description\n* Processes an application for a supporting document (tax invoice, etc.) for an order.\n---\n## Detailed Description\n* Processes an application for a supporting document, including required information such as order number and member number.\n---\n## Revision History\n* Release v2.01_251020 : Added Inicis cash receipt issuance\n* Release v2.02_260202 : Added taxable/tax-exempt amount processing logic\n","operationId":"applyOrderEvidence","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}},"required":true},"responses":{"200":{"description":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","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"}},"description":"validation error list"}}}}
```

## Retrieve Popbill-Integrated Tax Invoice Popup URL

> \## Function Description\
> \* Retrieves the popup URL provided by Popbill using the Popbill document number, order number, and popup type\
> \---\
> \## Detailed Description\
> \* Retrieves and returns the popup URL for viewing, printing, or PDF download<br>

```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/popbill/invoice/getPopupUrl":{"get":{"tags":["Supporting Documents"],"summary":"Retrieve Popbill-Integrated Tax Invoice Popup URL","description":"## Function Description\n* Retrieves the popup URL provided by Popbill using the Popbill document number, order number, and popup type\n---\n## Detailed Description\n* Retrieves and returns the popup URL for viewing, printing, or PDF download\n","operationId":"getPopupUrl","parameters":[{"name":"taxInvoicePopupRequest","in":"query","required":true,"schema":{"type":"string","description":"TaxInvoicePopupRequest"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"string"}}}}}}}}}
```

## Search Order Payment Allocation Info

> \## Function Description\
> \* Accepts request parameters including the order number (ordNo) and retrieves the payment allocation information list for the order.\
> \---\
> \## Detailed Description\
> \* Accepts request parameters including the order number (ordNo) and retrieves the payment allocation information list for the order.\
> \* ordNo: Order No. (required)<br>

```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/document/getPayDivInfoByOrder":{"get":{"tags":["Supporting Documents"],"summary":"Search Order Payment Allocation Info","description":"## Function Description\n* Accepts request parameters including the order number (ordNo) and retrieves the payment allocation information list for the order.\n---\n## Detailed Description\n* Accepts request parameters including the order number (ordNo) and retrieves the payment allocation information list for the order.\n* ordNo: Order No. (required)\n","operationId":"getPayDivInfoByOrder","parameters":[{"name":"ordNo","in":"query","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PayDivInfo"}}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"PayDivInfo":{"type":"object","properties":{"entrNo":{"type":"string","description":"Merchant No."},"transferAmount":{"type":"integer","description":"Account Transfer Allocation Amount (Real-Time Account Transfer + Virtual Account)","format":"int64"},"goodsCount":{"type":"integer","description":"Product Count","format":"int32"},"goodsNm":{"type":"string","description":"Product Name"},"taxGbCd":{"type":"string","description":"Tax Type (PR007)"}},"description":"Order Payment Allocation Info DTO"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","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"}},"description":"validation error list"}}}}
```