제공하는 API
모든 API는 JSON으로 주고받고, X-API-Key 헤더로 인증합니다. 발행 응답으로 받은 키로 상태 조회와 취소를 처리합니다.
세금계산서 API
주문·정산 시스템에서 바로 전자세금계산서를 발행하고, 발행 상태 조회와 취소까지 처리합니다.
- POST/
api/ v1/ invoices발행 - GET/
api/ v1/ invoices/ {invoice_key}상태 조회 - DELETE/
api/ v1/ invoices/ {invoice_key}취소 - GET/
api/ v1/ invoices목록 조회
현금영수증 API
결제 완료와 동시에 휴대전화번호(소득공제) 또는 사업자등록번호(지출증빙)로 현금영수증을 발행하고, 당일 발급분을 취소합니다.
- POST/
api/ v1/ cash-receipts발행 - GET/
api/ v1/ cash-receipts/ {receipt_key}상태 조회 - DELETE/
api/ v1/ cash-receipts/ {receipt_key}당일 취소 - GET/
api/ v1/ cash-receipts목록 조회
역발행 API
매입자가 세금계산서를 작성해 공급자에게 발행을 요청합니다. 공급자가 이메일 승인 링크에서 공동인증서로 서명하면 발행됩니다.
- POST/
api/ v1/ reverse-invoices요청 생성 - GET/
api/ v1/ reverse-invoices/ {reverse_key}상태 조회 - DELETE/
api/ v1/ reverse-invoices/ {reverse_key}요청 취소 - GET/
api/ v1/ reverse-invoices목록 조회
이 밖에 사업자 정보 조회(GET /api/v1/business)와 거래처 검색(GET /api/v1/partners) API를 제공합니다.
요청 한 번으로 세금계산서 발행
공급받는자 사업자번호, 작성일자, 금액과 품목을 보내면 세금계산서가 발행되고 승인번호를 바로 응답합니다. 응답의 invoice_key로 상태를 조회하거나 취소할 수 있습니다.
- 발행 결과(승인번호) 즉시 응답
- 발행 건은 대시보드에서도 함께 조회
- 품목 여러 건을 한 번에 입력
POST /api/v1/invoices
X-API-Key: dk_xxxx...
Content-Type: application/json
{
"buyer_bizno": "9876543210",
"buyer_name": "구매회사",
"issue_date": "2026-06-01",
"supply_amount": 1000000,
"tax_amount": 100000,
"items": [
{ "name": "소프트웨어 개발", "quantity": 1,
"unit_price": 1000000, "amount": 1000000 }
]
}
# 응답
{
"success": true,
"invoice_key": "…",
"invoice_no": "20260601-12345678-12345678"
}API 연동 시작하기
- 01
PRO 요금제 구독
가입 후 사업자를 등록하고 PRO 요금제를 구독합니다.
- 02
공동인증서 등록 (최초 1회)
홈택스 연동을 위해 공동인증서를 한 번 등록합니다. 금융인증서는 지원하지 않습니다.
- 03
API 키 발급 후 연동
대시보드의 'Developer API' 메뉴에서 키를 발급하고, 같은 화면의 문서를 보며 연동합니다.
API 연동 자주 묻는 질문 (FAQ)
세금계산서 발행 API는 어떤 요금제에서 사용할 수 있나요?
세금계산서·현금영수증·역발행 API는 모두 PRO 요금제(유료 구독)에서 제공됩니다. 무료 요금제에서는 대시보드 화면에서 세금계산서와 현금영수증을 발행할 수 있습니다.
API를 사용하려면 무엇이 필요한가요?
PRO 요금제 구독, 공동인증서(구 공인인증서) 등록, API 키 발급이 필요합니다. API 키는 대시보드의 'Developer API' 메뉴에서 발급하며, 요청 헤더(X-API-Key)에 넣어 인증합니다. 금융인증서는 지원하지 않으며, 인증서가 없거나 만료되면 발행 요청이 거절됩니다.
API로 세금계산서 예약 발행이나 정기 발행도 할 수 있나요?
세금계산서 발행 API는 호출하면 바로 발행합니다. 지정한 날짜에 자동으로 발행하는 예약 발행과 매월 반복하는 정기 발행은 대시보드에서 설정합니다.
같은 요청이 두 번 들어가면 중복 발행되나요?
현금영수증 발행은 idempotency_key, 역발행 요청은 request_id를 함께 보내면 같은 값으로 다시 요청해도 새로 발행하지 않고 처음 결과를 돌려줍니다.
호출 횟수 제한이 있나요?
현금영수증 발행은 API 키당 분당 300건, 역발행 요청 생성은 분당 500건까지 처리합니다. 한도를 넘으면 429 응답을 받으며 잠시 후 다시 요청하면 됩니다.
API 문서는 어디에서 볼 수 있나요?
로그인 후 대시보드의 'Developer API' 메뉴에서 모든 엔드포인트의 요청·응답 예시를 확인할 수 있습니다. 연동 관련 문의는 개발 문의 페이지로 남겨 주세요.
연동 관련 문의는 개발 문의로 남겨 주세요.