납부확인서 발급
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.
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. |