보험료 완납증명서 발급
nhis_edi__certificates__payment_completion__issueDestructive
REQUIRES prior nhis_edi__session__login call with same account_link_id. Issue an NHIS payment-completion (완납증명서) or payment (납부확인서) certificate. IRREVERSIBLE: the certificate is issued at 건강보험공단 and an issue number is assigned; there is no cancel action. 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. 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
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Target year YYYY (payment_certificate only). Defaults to the current year. | |
| 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. | |
| issue_gubun | No | 발급구분 00/01/02 (payment_certificate only). Default '00'. | |
| issue_usage | No | 발급용도 code. payment: 11/12/13, completion: 51/52. Default '11'. | |
| 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 | No | payment_certificate(납부확인서) or completion_certificate(완납증명서). Default payment_certificate. |