Skip to content

Settlement with insurers

Claims for visits funded by an insurer, grouped into billing batches and sent as an XLSX file with a PDF bundle. NFZ reporting through OptiMED is a separate path, available to hospital facilities only.

Required permissions:
Clinic AdminReceptionist
Reviewed: 2026-08-24

When an insurer pays for a visit instead of the patient, a claim is created. You collect claims through the billing period and then group them into a billing batch — one XLSX file and one PDF bundle sent to the insurer.

The path has three fixed points: Settings → Insurers (who, and in what column order), Billing → Claims (individual visits), Billing → Billing Batches (the parcels to send).

Open Claims

How to do it

01

Add an insurer

Settings → Insurers → Add insurer. The dialog has three tabs:

  • DetailsInsurer name, Code, Tax ID (NIP), Address, Bank account (IBAN), Billing contact email.
  • Template — the XLSX Column Layout: you drag the columns into the order the insurer expects and switch off the ones you do not need. Among those available are Policy No., PESEL, Visit Date, Service, Amount, Auth Code, Copay, plus custom columns.
  • Billing — the Billing cycle: weekly, bi-weekly or monthly.

The Copy from preset button creates an insurer from a ready-made configuration.

02

Attach a policy to a patient

On the patient record, on the Insurances tab, click Add insurance. You give the Insurer, Policy number, Member number, Coverage level and the Valid from and Valid until dates. The Set as primary insurance field decides which policy is offered by default.

03

Create a claim from a visit

At visit settlement, use Bill to insurance. You choose the policy and fill in the Authorization code, Referral number, Referral date, Visit code, Amount claimed and the Patient copay. Heltio acknowledges with Claim created.

You can view claims two ways — as a List or as a Kanban with the statuses Draft, Ready, Batched, Submitted, Paid, Partially paid, Denied, Disputed, Voided.

04

Gather claims into a batch

Billing → Billing Batches → New batch walks through four steps: Insurer, Period, Select Claims, Review & Generate. The claims step shows how many entries are ready in the period and how many of them are selected.

The warning about missing visit codes matters — it says outright that "The XLSX may be rejected by the insurer". Fill the codes in before you generate the batch.

Generate batch creates the files; you then download the XLSX and the PDF bundle.

05

Follow what happens to the batch

The batch details carry a Status Timeline: DraftExportedSubmittedSettled. After sending, use Mark as submitted, and once the money arrives, Mark as settled.

A claim the insurer denied can be moved onto the patient with the Convert to patient invoice action — a draft invoice is created and the claim stays denied.

When something does not work

Warning

Cannot settle batch: some claims are not yet in a terminal state (Paid, Partially paid, or Denied).

What this means: The batch holds claims the insurer has not yet decided on.

What to do: Set every claim in the batch to paid, partially paid or denied, and then mark the batch settled.
Warning

Cannot void a settled batch.

What this means: The batch has already been closed as settled.

What to do: Settle the discrepancy with a new correcting claim in the next batch.
Info

No READY claims in this period.

What this means: The wizard found no claims with the Ready status in the chosen date range.

What to do: Check whether the claims were left in **Draft**, and whether the period covers the visit dates rather than the issue dates.
Warning

This insurer has linked claims and cannot be deleted.

What this means: Claims are attached to the insurer, so deleting it would take the settlement history with it.

What to do: Switch the **Active** toggle off. The insurer disappears from new claims and the history stays.
Info

No active insurers configured.

What this means: The batch wizard has nobody to settle with — the insurer list is empty, or all of them are inactive.

What to do: Add an insurer under **Settings → Insurers** and turn its **Active** toggle on.

Who has access

Clinic Admin Receptionist

Insurers and the column layout are configured by the administrator. Adding policies, creating claims and running batches are open to reception as well. The whole module belongs to the plan that includes insurer settlement — without it the Claims and Billing Batches entries do not appear in the menu.

Was this article helpful?

Didn't find an answer? Write to us.

Open the contact form