수기 증빙 입력과 실제 발행
수기 입력 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-Keyoptional
- string
- 쓰기 요청 재시도 안전성이 필요할 때 같은 payload에만 재사용.
- supplier / contractorrequired
- object
- registrationNumber, companyName, ceoName 포함.
- supplyValue / taxAmount / totalAmountrequired
- integer
- 금액은 소수점 없는 정수 기준.
- homeTaxAccountIdrequired
- number
- 현금영수증 발행 전 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" }