납부확인서 발급
si4n__payment_confirmation__issueREQUIRES prior si4n__session__login call with same account_link_id. This writes to the institution. The first call is not executed: it returns a preview of exactly what will be sent and a one-time confirmation_token (error WRITE_CONFIRMATION_REQUIRED). Show that preview to the user as it is. Only after the user agrees, call again with the same arguments plus that confirmation_token. Never add the token without the user's agreement. Changing any argument makes the token invalid; call without the token to get a new preview. Pick one insurance or combined for all four, then the certificate kind and period. The institution sets the password on the returned document. Files: the document the institution issued, unchanged, as PDF, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. 호출마다 토큰 1소진
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | Year the certificate covers. | |
| usage | No | Optional. Stated purpose code. | |
| year_to | No | Optional. End year for a multi-year certificate. | |
| language | Yes | Document language code. | |
| month_to | No | Optional. Last month. | |
| insu_type | No | Optional. Institution subtype code. | |
| insurance | Yes | combined issues one certificate covering all four insurances. | |
| month_from | No | Optional. First month. | |
| english_name | No | Optional. Representative name in English. | |
| month_sum_item | No | Optional. Monthly summary variant. | |
| 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). | |
| certificate_kind | Yes | Institution code for the certificate kind. | |
| firm_english_name | No | Optional. Company name in English for an English document. | |
| confirmation_token | No | One-time confirmation token returned by the first call (error WRITE_CONFIRMATION_REQUIRED). Send it back unchanged with the same arguments to execute; it expires in 10 minutes and works once. |