Supporting Documents
Access Token
Success
result time
result code
result message
process check
payload
is error
POST /api/order/v1/popbill/invoice/sendEmail HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 46
{
"ordNo": "text",
"mgrNo": "text",
"email": "text"
}Success
{
"timestamp": "2026-01-01T00:00:00.000Z",
"code": "text",
"message": "text",
"isProcess": true,
"payload": {},
"error": true,
"errors": [
{
"field": "text",
"message": "text"
}
]
}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
TaxInvoiceConnectRequest
Access Token
Popbill Tax Invoice Webhook Response
Issuer's Business Registration No. by E-Tax Invoice Issuance Type
Identification Number Assigned by Popbill for Tax Invoice Management Purposes
National Tax Service Approval No.
National Tax Service Transmission Date/Time
National Tax Service Result Reception Date/Time
Result Code
Status Code
Status Change Date/Time
Issuance Date/Time
Supplier Document No.
Recipient Document No.
Trustee Document No.
Event Execution Date/Time
Event Type
Recipient's Business Closure Status
Recipient's Business Closure Date
Success
Tax Invoice Webhook Integration Response
Result Value
POST /api/order/v1/popbill/invoice/connect?taxInvoiceConnectRequest=text HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 360
{
"corpNum": "text",
"itemKey": "text",
"ntsconfirmNum": "text",
"ntssendDT": "text",
"ntsresultDT": "text",
"ntssendErrCode": "text",
"stateCode": 1,
"stateDT": "text",
"issueDT": "text",
"invoicerMgtKey": "text",
"invoiceeMgtKey": "text",
"trusteeMgtKey": "text",
"eventDT": "text",
"eventType": "text",
"closeDownState": 1,
"closeDownStateDate": "text",
"interOPYN": true,
"stateMemo": "text"
}Success
{
"result": "text"
}TaxInvoiceConnectRequest
Access Token
Success
No content
POST /api/order/v1/inicis/receipt/connect?taxInvoiceConnectRequest=text HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 101
[
{
"docSeq": "text",
"proofType": "text",
"pgGbCd": "text",
"termlId": "text",
"ordNo": "text",
"mgrNo": "text"
}
]Success
No content
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
Access Token
Success
No content
POST /api/order/v1/document/reissue HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 101
[
{
"docSeq": "text",
"proofType": "text",
"pgGbCd": "text",
"termlId": "text",
"ordNo": "text",
"mgrNo": "text"
}
]Success
No content
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.
Access Token
Success
Supporting Document Count
10Display Quantity per Screen
10Page No.
1Business processing error details
POST /api/order/v1/document/getOrderEvidDocInfo HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 126
{
"langCd": "text",
"ordNo": "text",
"mbrNo": "text",
"searchCondition": "text",
"startDt": "text",
"endDt": "text",
"documentType": "text"
}{
"totCnt": 10,
"rowsPerPage": 10,
"pageIdx": 1,
"documentList": [
{
"ordNo": "text",
"entrNm": "text",
"ordSupPrc": 1,
"ordTaxPrc": 1,
"ordTotAmt": 1,
"ppblIsuStatCdNm": "text",
"ppblIsuStatCd": "text",
"ppblDocMgrNo": "text",
"docTypCd": "text",
"docTypCdNm": "text",
"sgtDt": "text",
"ordGbCd": "text",
"payWayCd": "text",
"pgGbCd": "text"
}
]
}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
Access Token
Success
No content
Business processing error details
POST /api/order/v1/document/applyOrderEvidence HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 30
{
"ANY_ADDITIONAL_PROPERTY": {}
}No content
TaxInvoicePopupRequest
Access Token
Success
GET /api/order/v1/popbill/invoice/getPopupUrl?taxInvoicePopupRequest=text HTTP/1.1
Host: api-order.x2bee.com/
Accept: */*
Success
textFunction 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)
Access Token
Success
Order Payment Allocation Info DTO
Merchant No.
1000000Account Transfer Allocation Amount (Real-Time Account Transfer + Virtual Account)
8000Product Count
3Product Name
상품명Tax Type (PR007)
01Business processing error details
GET /api/order/v1/document/getPayDivInfoByOrder?ordNo=text HTTP/1.1
Host: api-order.x2bee.com/
Accept: */*
[
{
"entrNo": "1000000",
"transferAmount": 8000,
"goodsCount": 3,
"goodsNm": "상품명",
"taxGbCd": "01"
}
]Last updated