증빙서류

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

post

기능설명

• 팝빌 문서번호, 주문번호, 이메일로 팝빌에서 제공하는 이메일 재전송 기능

---

상세설명

• 팝빌에 있는 이메일 재전송 기능을 활용해 사용자가 원하는 때에 세금계산서 이메일 전송

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

ordNostringOptional

mgrNostringOptional

emailstringOptional

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadobjectOptional

payload

errorbooleanOptional

is error

post

/v1/popbill/invoice/sendEmail

HTTPcURLJavaScriptPython

POST /api/order/v1/popbill/invoice/sendEmail HTTP/1.1
Host: localhost:8092/
Content-Type: application/json
Accept: */*
Content-Length: 46

{
  "ordNo": "text",
  "mgrNo": "text",
  "email": "text"
}

200

성공

{
  "timestamp": "2026-02-27T18:08:29.775Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {},
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

세금 계산서 팝빌 웹훅 연동

post

기능설명

• 팝빌에서 웹훅으로 보내주는 이벤트 처리

---

상세설명

• Issue, CancelIssue, CLOSEDOWN, NTS, OPEN, Request, CancelRequest, Refuse 이벤트를 처리한다.

---

특이사항

• 시스템 내부에서 호출되는 api가 아닌 popbill webhook에서 호출하는 API입니다.

• popbill webhook 스펙에서 공통으로 감싸주는 response 형태를 수용하지 못함으로 @DisableResponseBodyAdvice 추가

Query parameters

taxInvoiceConnectRequeststringRequired

TaxInvoiceConnectRequest

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

팝빌 세금 계산서 webhook response

corpNumstringRequired

전자세금계산서 발행 유형별 작성자 사업자번호

itemKeystringRequired

팝빌에서 세금계산서 관리 목적으로 할당한 식별번호

ntsconfirmNumstringRequired

국세청승인번호

ntssendDTstringOptional

국세청 전송일시

ntsresultDTstringOptional

국세청 결과 수신일시

ntssendErrCodestringOptional

결과코드

stateCodeinteger · int64Optional

상태코드

stateDTstringOptional

상태 변경일시

issueDTstringOptional

발행일시

invoicerMgtKeystringOptional

공급자 문서번호

invoiceeMgtKeystringOptional

공급받는자 문서번호

trusteeMgtKeystringOptional

수탁자 문서번호

eventDTstringRequired

이벤트 실행일시

eventTypestringRequired

이벤트 유형

closeDownStateinteger · int32Optional

공급받는자 휴폐업상태

closeDownStateDatestringOptional

공급받는자 휴폐업일자

interOPYNbooleanOptional

stateMemostringOptional

Responses

200

성공

*/*

세금 계산서 웹훅 연동 response

resultstringOptional

결과값

post

/v1/popbill/invoice/connect

HTTPcURLJavaScriptPython

POST /api/order/v1/popbill/invoice/connect?taxInvoiceConnectRequest=text HTTP/1.1
Host: localhost:8092/
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"
}

200

성공

{
  "result": "text"
}

이니시스 현금영수증 대사 연동

post

기능설명

• 이니시스 현금영수증 대사 연동

---

상세설명

• 연동된 대사 정보를 통해 얻은 증빙서류의 발행상태를 DB에 업데이트한다.

Query parameters

taxInvoiceConnectRequeststringRequired

TaxInvoiceConnectRequest

Header parameters

AuthorizationanyOptional

Access Token

Bodyobject[]

application/json

docSeqstringOptional

proofTypestringOptional

pgGbCdstringOptional

termlIdstringOptional

ordNostringOptional

mgrNostringOptional

Responses

200

성공

No content

post

/v1/inicis/receipt/connect

HTTPcURLJavaScriptPython

POST /api/order/v1/inicis/receipt/connect?taxInvoiceConnectRequest=text HTTP/1.1
Host: localhost:8092/
Content-Type: application/json
Accept: */*
Content-Length: 101

[
  {
    "docSeq": "text",
    "proofType": "text",
    "pgGbCd": "text",
    "termlId": "text",
    "ordNo": "text",
    "mgrNo": "text"
  }
]

200

성공

No content

증빙서류 발행배치

post

기능설명

• 발행실패로 발행대기 상태로 되어 있는 증빙서류를 발행요청하는 배치

---

상세설명

• 배치에서 발행대기 상태에 데이터 리스트로 재발행요청

---

수정 번호

• Release v2.01_251020 : 이니시스 현금영수증 발행 추가

Header parameters

AuthorizationanyOptional

Access Token

Bodyobject[]

application/json

docSeqstringOptional

proofTypestringOptional

pgGbCdstringOptional

termlIdstringOptional

ordNostringOptional

mgrNostringOptional

Responses

200

성공

No content

post

/v1/document/reissue

HTTPcURLJavaScriptPython

POST /api/order/v1/document/reissue HTTP/1.1
Host: localhost:8092/
Content-Type: application/json
Accept: */*
Content-Length: 101

[
  {
    "docSeq": "text",
    "proofType": "text",
    "pgGbCd": "text",
    "termlId": "text",
    "ordNo": "text",
    "mgrNo": "text"
  }
]

200

성공

No content

주문 증빙서류 목록 조회

post

기능설명

• 주문번호(ordNo)를 포함한 요청 파라미터를 받아 해당 주문의 증빙서류 목록을 조회합니다.

---

상세설명

• 주문번호(ordNo)를 포함한 요청 파라미터를 받아 해당 주문의 증빙서류 목록을 조회합니다.

• ordNo: 주문번호 (필수)

• 등록일 오름차순으로 정렬합니다.

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

langCdstringOptional

ordNostringOptional

mbrNostringOptional

searchConditionstringOptional

startDtstringOptional

endDtstringOptional

documentTypestringOptional

Responses

200

성공

*/*

totCntinteger · int32Optional

증빙서류건수

Example: 10

rowsPerPageinteger · int32Optional

화면당노출수량

Example: 10

pageIdxinteger · int32Optional

페이지번호

Example: 1

900

업무처리 오류 내용

*/*

post

/v1/document/getOrderEvidDocInfo

HTTPcURLJavaScriptPython

POST /api/order/v1/document/getOrderEvidDocInfo HTTP/1.1
Host: localhost:8092/
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"
    }
  ]
}

주문 증빙서류 신청

post

기능설명

• 주문에 대한 증빙서류(세금계산서 등) 신청을 처리합니다.

---

상세설명

• 주문번호, 회원번호 등 필수 정보를 포함한 증빙서류 신청을 처리합니다.

---

수정 번호

• Release v2.01_251020 : 이니시스 현금영수증 발행 추가

• Release v2.02_260202 : 과면세 금액 처리 로직추가

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

Other propertiesobjectOptional

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

post

/v1/document/applyOrderEvidence

HTTPcURLJavaScriptPython

POST /api/order/v1/document/applyOrderEvidence HTTP/1.1
Host: localhost:8092/
Content-Type: application/json
Accept: */*
Content-Length: 30

{
  "ANY_ADDITIONAL_PROPERTY": {}
}

No content

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

get

기능설명

• 팝빌 문서번호, 주문번호, 팝업타입으로 팝빌에서 제공하는 팝업 Url 조회

---

상세설명

• 조회, 출력, PDF 다운로드 팝업 URL 조회 후 반환

Query parameters

taxInvoicePopupRequeststringRequired

TaxInvoicePopupRequest

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

성공

*/*

stringOptional

get

/v1/popbill/invoice/getPopupUrl

HTTPcURLJavaScriptPython

GET /api/order/v1/popbill/invoice/getPopupUrl?taxInvoicePopupRequest=text HTTP/1.1
Host: localhost:8092/
Accept: */*

200

성공

text

주문 결제 배분 정보 조회

get

기능설명

• 주문번호(ordNo)를 포함한 요청 파라미터를 받아 해당 주문의 주문 결제 배분 정보 목록을 조회합니다.

---

상세설명

• 주문번호(ordNo)를 포함한 요청 파라미터를 받아 해당 주문 결제 배분 정보 목록을 조회합니다.

• ordNo: 주문번호 (필수)

Query parameters

ordNostringRequired

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

성공

*/*

주문 결제 배분 정보 DTO

entrNostringOptional

입점사번호

Example: 1000000

transferAmountinteger · int64Optional

계좌이체배분금액(실시간계좌이체+가상계좌)

Example: 8000

goodsCountinteger · int32Optional

상품수

Example: 3

goodsNmstringOptional

상품명

Example: 상품명

taxGbCdstringOptional

세금구분타입(PR007)

Example: 01

900

업무처리 오류 내용

*/*

get

/v1/document/getPayDivInfoByOrder

HTTPcURLJavaScriptPython

GET /api/order/v1/document/getPayDivInfoByOrder?ordNo=text HTTP/1.1
Host: localhost:8092/
Accept: */*

[
  {
    "entrNo": "1000000",
    "transferAmount": 8000,
    "goodsCount": 3,
    "goodsNm": "상품명",
    "taxGbCd": "01"
  }
]