INVOICES

증빙 입력·발행

수기 증빙 입력과 실제 국세청 발행 API를 구분해요. 발행 요청은 멱등 키와 필수값 기준.

← API 개요 전체 문서

수기 증빙 입력과 실제 발행

수기 입력 API는 외부 시스템 기준 증빙 내역을 그랜터에 남겨요. 실제 국세청 발행은 issue 계열 기능 사용.

POST/api/public-docs/tax-invoices
국세청 발행 없이 외부 시스템 기준의 수기 세금계산서 내역을 생성해요.
POST/api/public-docs/cash-receipts
수기 현금영수증 내역을 생성해요.
POST/api/public-docs/tax-invoices/issue
세금계산서를 즉시발행, 예약발행, 반복발행 형태로 생성해요.
POST/api/public-docs/tax-invoices/modify-issue
공식 문서에 허용된 사유로 세금계산서를 수정발행해요.
POST/api/public-docs/tax-invoices/cancel-issue
그랜터에서 발행된 세금계산서를 취소발행해요.
POST/api/public-docs/cash-receipts/issue
활성 홈택스 자산을 기준으로 현금영수증을 발행해요.
POST/api/public-docs/cash-receipts/cancel-issue
발행된 현금영수증을 전체 또는 부분 취소해요.

핵심 요청 규칙

파라미터	타입	필수	설명
Idempotency-Key	string	optional	쓰기 요청 재시도 안전성이 필요할 때 같은 payload에만 재사용.
supplier / contractor	object	required	registrationNumber, companyName, ceoName 포함.
supplyValue / taxAmount / totalAmount	integer	required	금액은 소수점 없는 정수 기준.
homeTaxAccountId	number	required	현금영수증 발행 전 assets에서 HOME_TAX_ACCOUNT 자산 확인.

POST /api/public-docs/tax-invoices/issue

$ curl -X POST https://app.granter.biz/api/public-docs/tax-invoices/issue \

-H "Content-Type: application/json" \

-H "Authorization: Basic <BASE64(API_KEY:)>" \

-H "Idempotency-Key: tax-invoice-issue-20260409-001" \

-d '{"issueType":"정발행","supplyValue":100000,"taxAmount":10000}'

{ "status": "SUCCESS" }

예시를 복사해
첫 요청을 보내세요

API 키는 Basic 인증으로 넣어요. 필요한 필드와 응답은 문서에서 확인.

API 키 발급 전체 문서 →