How To Use medibill

medibill is an internal reference and fee intelligence tool for looking up MBS items, tracking fee/descriptor changes, and maintaining clinic pricing overlays.

This tool is for internal reference only. It is not legal, clinical, or billing advice. Clinicians and practices remain responsible for checking current official sources and claiming requirements.

1. Dashboard

Start on Dashboard to see latest import status, total items, pending changes, recent fee changes, and import failures.

2. Search Items

Go to Items and search by item number or keyword. Use filters for category and active/inactive status.

• Use Strict text mode for tighter matches when broad terms return noise.
• Search relevance favors exact item number, descriptor phrase, category matches, and practical summaries.
• Click an item number to open full detail.

3. Categories

Open Categories to see category cards and counts. Click a category to view the mapped item list.

• Category detail pages show item number, descriptor, MBS fee, clinic fee, and active flag.
• Use item links to jump directly to item detail pages.

4. Item Detail

Each item page shows descriptor, version history, and change history.

• Update practical summary, requirements, and pitfalls.
• Set clinic-specific fee for the item.
• Review equivalent links and prior versions.

5. Review Changes

Open Change Review to process pending updates detected by imports.

• Mark reviewed when checked.
• Ignore if not relevant to your workflow.
• For new items, use Add to price list to place into clinic pricing.

6. Clinic Price List

Use Clinic Prices to compare MBS fee vs clinic fee and monitor dollar/% differences.

• Export the table as CSV from the page header.
• Edit item clinic fees from each item detail page.

7. Import Data

MBS imports are run from CLI (MVP).

docker compose exec medibill-app npm run import:mbs

Optional SIRA CSV import:

docker compose exec medibill-app npm run import:sira -- /path/to/sira.csv

Starter category auto-mapping:

docker compose exec medibill-app npm run categories:auto-map

Check Import Runs in the UI for status, timestamps, and summary counts.

8. Current MVP Limits

• No Medicare claiming, PRODA integration, invoicing, or payment workflows.
• SIRA is currently manual CSV import, not automatic feed sync.
• Authentication/roles are not yet enabled in this MVP slice.