현금영수증 발행 (개인)
hometax__cash_receipt__issue_individualDestructive
REQUIRES prior hometax__session__login call with same account_link_id. Issue a cash receipt for an individual consumer. IRREVERSIBLE on the next day: the NTS ledger changes immediately and it flows into the consumer's year-end tax deduction records; cancellation is possible on the SAME DAY only. Call without confirm first to get a preview, show it to the user, then retry with confirm=true. Never set confirm=true on your own.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tip | No | Tip amount. Default '0'. Optional. | |
| confirm | No | Set true ONLY after showing the preview to the user and receiving their explicit approval. Omit it on the first call to obtain the preview. | |
| totaTrsAmt | Yes | Total transaction amount (총 거래금액, KRW as string, minimum 1) | |
| cshptUsgClCd | Yes | Usage class code (용도구분코드): 0=소득공제용, 1=지출증빙용 | |
| spstCnfrClCd | Yes | Issue-means class code (발급수단구분코드): 01=주민등록번호, 02=사업자등록번호, 03=휴대전화번호, 04=카드번호 | |
| cshptTrsTypeCd | Yes | Transaction type code (거래유형코드): 01=과세, 02=면세, 03=간이 | |
| account_link_id | No | Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure). | |
| cshptIsnMmoCntn | No | Memo content. Optional. | |
| spstCnfrNoEncCntn | Yes | Issue-means number (발급수단번호) matching the class code, digits only. It is sent to the institution exactly as given - never encrypt or hash it, and never put an approval number here. |