Pharmacy Programs Administrator (PPA)

Light integrates with the Pharmacy Programs Administrator (PPA) to handle claiming for eligible pharmacy program encounters. Once connected, Light will automatically use PPA claiming for eligible encounters.

Before You Start

You'll need access to your PPA Portal — you'll be grabbing a couple of details from there.

• ✅ Active PPA Portal account at app.ppaonline.com.au/home
• ✅ A generated API Key from the PPA Portal (see Step 1 below)

Step 1: Generate an API Key in PPA Portal

1. Log in to the PPA Portal at app.ppaonline.com.au/home
2. Generate your Integration API Key — if you're not sure how, PPA have a user guide for that. Contact PPA directly or refer to the PPA Portal User Guide for Integration and API User Keys
3. Copy your PPA User ID and PPA API Key — you'll need both in the next step

Step 2: Connect PPA in Light

1. Navigate to Settings in Light
2. Click Integrations in the settings sidebar
3. Find the Pharmacy Programs Administrator Account Details section
4. Enter your PPA User ID
5. Enter your PPA API Key
6. Click Save

Step 3: Choose Your Service Provider

Choose the service provider you'll use to submit claims. If your account is linked to multiple providers, select the one that matches this site.

Step 4: Confirm Connection

After saving, you'll see a success confirmation indicating that Light is connected to PPA. From this point, Light will use PPA claiming for eligible encounters.

Your API key will expire and PPA will send you reminders to regenerate it.

Claiming Programs

Once connected, Light automatically evaluates encounters for claim eligibility across supported PPA programs.

NIP and VIP Claims

Claims for the National Immunisation Program (NIP) and Vaccine Incentive Program (VIP) are evaluated automatically when you record vaccination encounters through the AIR integration.

CVCP Claims

The COVID-19 Vaccination in Community Pharmacy (CVCP) Program is also supported. When you record a vaccination encounter with an eligible COVID-19 vaccine, Light automatically evaluates whether a CVCP claim can be made and prepares it for submission.

CVCP claims are evaluated per vaccine episode, so multi-dose encounters produce individual claims. Light prevents duplicate claims for the same episode — if a claim has already been submitted, it won't be created again.

To submit or amend a CVCP claim:

1. Open the vaccination service on the booking
2. Find the Claims card
3. Review the prepared claim details
4. Click Submit Claim or Amend Claim

Reviewing Claims

The Claims screen gives you a central place to track and reconcile all your PPA claims.

How to get there

1. Tap Claims in the sidebar

Filtering claims

• By date — tap the date filter at the top and use the ▾ to switch between created date and submitted date.
• By status — filter by the current state of the claim (e.g., Submitted, Accepted, Rejected).
• By integration — filter claims by which integration they were submitted through.
• By claim type — filter claims by their program type (e.g., NIP, VIP, CVCP).

Status cards

The status cards at the top of the screen give you a quick overview of your claims. Hover over a status card to see a tooltip explaining what that status means. Tap a card to filter the table to just that status, and tap it again to clear.

Scrolling through claims

Claims are split across pages. Use the page controls at the bottom to move between pages.

Updating Your API Key

To update the API Key in Light:

1. Navigate to Settings → Integrations
2. Find the Pharmacy Programs Administrator Account Details section
3. Enter the new API Key
4. Click Save